@hunter-harness/workflow-harness 0.2.53 → 0.2.54
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.
- package/harness/bundles/general/claude-code/.harness-build.json +1 -1
- package/harness/bundles/general/claude-code/harness-archive/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-plan/SKILL.md +3 -2
- package/harness/bundles/general/claude-code/harness-review/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-run/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-submit/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-sync/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-test/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/scripts/harness_context.py +52 -0
- package/harness/bundles/general/claude-code/scripts/harness_events_sync.py +150 -3
- package/harness/bundles/general/codebuddy/.harness-build.json +1 -1
- package/harness/bundles/general/codebuddy/harness-archive/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-plan/SKILL.md +3 -2
- package/harness/bundles/general/codebuddy/harness-review/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-run/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-submit/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-sync/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-test/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/scripts/harness_context.py +52 -0
- package/harness/bundles/general/codebuddy/scripts/harness_events_sync.py +150 -3
- package/harness/bundles/general/codex/.harness-build.json +1 -1
- package/harness/bundles/general/codex/harness-archive/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-plan/SKILL.md +3 -2
- package/harness/bundles/general/codex/harness-review/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-run/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-submit/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-sync/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-test/SKILL.md +1 -1
- package/harness/bundles/general/codex/scripts/harness_context.py +52 -0
- package/harness/bundles/general/codex/scripts/harness_events_sync.py +150 -3
- package/harness/bundles/general/cursor/.harness-build.json +1 -1
- package/harness/bundles/general/cursor/harness-archive/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-plan/SKILL.md +3 -2
- package/harness/bundles/general/cursor/harness-review/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-run/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-submit/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-sync/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-test/SKILL.md +1 -1
- package/harness/bundles/general/cursor/scripts/harness_context.py +52 -0
- package/harness/bundles/general/cursor/scripts/harness_events_sync.py +150 -3
- package/harness/bundles/java/claude-code/.harness-build.json +1 -1
- package/harness/bundles/java/claude-code/harness-apidoc/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-archive/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-package/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-plan/SKILL.md +3 -2
- package/harness/bundles/java/claude-code/harness-review/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-run/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-submit/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-sync/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-test/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/scripts/harness_context.py +52 -0
- package/harness/bundles/java/claude-code/scripts/harness_events_sync.py +150 -3
- package/harness/bundles/java/codebuddy/.harness-build.json +1 -1
- package/harness/bundles/java/codebuddy/harness-apidoc/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-archive/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-package/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-plan/SKILL.md +3 -2
- package/harness/bundles/java/codebuddy/harness-review/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-run/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-submit/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-sync/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-test/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/scripts/harness_context.py +52 -0
- package/harness/bundles/java/codebuddy/scripts/harness_events_sync.py +150 -3
- package/harness/bundles/java/codex/.harness-build.json +1 -1
- package/harness/bundles/java/codex/harness-apidoc/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-archive/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-package/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-plan/SKILL.md +3 -2
- package/harness/bundles/java/codex/harness-review/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-run/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-submit/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-sync/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-test/SKILL.md +1 -1
- package/harness/bundles/java/codex/scripts/harness_context.py +52 -0
- package/harness/bundles/java/codex/scripts/harness_events_sync.py +150 -3
- package/harness/bundles/java/cursor/.harness-build.json +1 -1
- package/harness/bundles/java/cursor/harness-apidoc/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-archive/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-package/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-plan/SKILL.md +3 -2
- package/harness/bundles/java/cursor/harness-review/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-run/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-submit/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-sync/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-test/SKILL.md +1 -1
- package/harness/bundles/java/cursor/scripts/harness_context.py +52 -0
- package/harness/bundles/java/cursor/scripts/harness_events_sync.py +150 -3
- package/harness/manifests/general/claude-code.json +15 -15
- package/harness/manifests/general/codebuddy.json +15 -15
- package/harness/manifests/general/codex.json +15 -15
- package/harness/manifests/general/cursor.json +15 -15
- package/harness/manifests/java/claude-code.json +17 -17
- package/harness/manifests/java/codebuddy.json +17 -17
- package/harness/manifests/java/codex.json +17 -17
- package/harness/manifests/java/cursor.json +17 -17
- package/hunter-workflow-family.json +4 -4
- package/package.json +1 -1
|
@@ -21,7 +21,7 @@ disallowed-tools:
|
|
|
21
21
|
- Bash(awk *)
|
|
22
22
|
- Bash(curl *)
|
|
23
23
|
---
|
|
24
|
-
<!-- generated by harness_deploy.py; core=
|
|
24
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; overlay=none; agent=claude-code; do not edit -->
|
|
25
25
|
# harness-archive — 变更归档
|
|
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=
|
|
23
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
11
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
11
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
24
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; overlay=none; agent=claude-code; do not edit -->
|
|
25
25
|
# harness-plan — 需求规划
|
|
26
26
|
|
|
27
27
|
## Purpose
|
|
@@ -85,7 +85,7 @@ disallowed-tools:
|
|
|
85
85
|
| 阶段 | 动作 |
|
|
86
86
|
|------|------|
|
|
87
87
|
| 0 | 用当前解释器运行 `harness_runtime.py doctor`,后续消费绝对 argv;git status;脏工作区 → baseline 隔离 + `decision`,不询问 |
|
|
88
|
-
| 0.5 |
|
|
88
|
+
| 0.5 | 确定英文 `change-name` 后,根据需求生成一次简洁的中文展示标题(建议 6~24 个可见字符,保留必要产品名),执行 `harness_context.py prepare --phase plan --executor <tool> [--change <id>] --title "<中文标题>" --json`;英文名继续作为目录与稳定标识。以其唯一 change/executionRoot 初始化 plan-run-id 与 attempt(首次为 1),用同一身份追加 `phase.start`;从第一条知识查询起保留事件证据,并在 finalizer 中复用该身份 |
|
|
89
89
|
| 1 | `harness-knowledge-query` 单次远端 query(失败记 `issue`,不建立本地索引或离线回退) |
|
|
90
90
|
| 2 | 歧义优先检查 + 复杂度分级;先确认会改变实现方向的语义歧义 |
|
|
91
91
|
| 3 | 按复杂度执行有预算的代码探索;简单修复不得扩散到无关模块 |
|
|
@@ -113,6 +113,7 @@ change-name 范围变更 → 提示重命名或记 🟡WARN(→ `reference.md`
|
|
|
113
113
|
| 规则 | 要点 |
|
|
114
114
|
|------|------|
|
|
115
115
|
| 产物路径 | 只写 `.harness/changes/<cn>/`;禁止 superpowers 输入 |
|
|
116
|
+
| Change 标题 | 首次 Plan 同时确定英文 `change-name` 与中文展示标题;英文名保持目录和机器标识不变,中文标题由 `prepare --title` 持久化,后续阶段只复用、不重新生成 |
|
|
116
117
|
| 设计审批包 | 一次 blocking user confirmation 含 worktree(读 `harness.json` `defaultWorktree`) |
|
|
117
118
|
| 阶段 8 | spec/plan/detail/scenarios/gate-policy/worktree 六项标准产物先进入 staging;仅 finalizer 校验成功后发布并写唯一 `phase.end`/log;随后 `verify` 必须确认 start/end、收据完整覆盖六项标准产物、哈希、全部任务表和非空场景清单一致,失败不得手工补终态 |
|
|
118
119
|
| Plan 结束 | **禁止**询问执行模式;只提示 `/harness-run` |
|
|
@@ -22,7 +22,7 @@ disallowed-tools:
|
|
|
22
22
|
- Bash(curl *)
|
|
23
23
|
- Bash(codegraph *)
|
|
24
24
|
---
|
|
25
|
-
<!-- generated by harness_deploy.py; core=
|
|
25
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
25
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
24
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
22
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
26
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; overlay=none; agent=claude-code; do not edit -->
|
|
27
27
|
# harness-test — 测试执行
|
|
28
28
|
|
|
29
29
|
## Purpose
|
|
@@ -23,6 +23,8 @@ PHASE_GRAPH = {
|
|
|
23
23
|
"submit": (),
|
|
24
24
|
}
|
|
25
25
|
|
|
26
|
+
DISPLAY_TITLE_MAX_LENGTH = 80
|
|
27
|
+
|
|
26
28
|
|
|
27
29
|
def _now() -> dt.datetime:
|
|
28
30
|
return dt.datetime.now(dt.timezone.utc)
|
|
@@ -35,6 +37,41 @@ def _read_json(path: Path) -> dict[str, Any]:
|
|
|
35
37
|
return data
|
|
36
38
|
|
|
37
39
|
|
|
40
|
+
def _normalize_display_title(value: Any) -> str | None:
|
|
41
|
+
if value is None:
|
|
42
|
+
return None
|
|
43
|
+
if not isinstance(value, str):
|
|
44
|
+
raise ValueError("display title must be text")
|
|
45
|
+
title = value.strip()
|
|
46
|
+
if not title:
|
|
47
|
+
raise ValueError("display title must not be empty")
|
|
48
|
+
if len(title) > DISPLAY_TITLE_MAX_LENGTH:
|
|
49
|
+
raise ValueError(
|
|
50
|
+
f"display title exceeds {DISPLAY_TITLE_MAX_LENGTH} characters"
|
|
51
|
+
)
|
|
52
|
+
if any(ord(character) < 32 or ord(character) == 127 for character in title):
|
|
53
|
+
raise ValueError("display title contains control characters")
|
|
54
|
+
return title
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
def _ensure_display_title(contract_root: Path, value: Any) -> str | None:
|
|
58
|
+
path = contract_root / "meta" / "change-title.json"
|
|
59
|
+
if path.is_file():
|
|
60
|
+
payload = _read_json(path)
|
|
61
|
+
return _normalize_display_title(payload.get("displayTitle"))
|
|
62
|
+
title = _normalize_display_title(value)
|
|
63
|
+
if title is None:
|
|
64
|
+
return None
|
|
65
|
+
_write_json_atomic(
|
|
66
|
+
path,
|
|
67
|
+
{
|
|
68
|
+
"schemaVersion": 1,
|
|
69
|
+
"displayTitle": title,
|
|
70
|
+
},
|
|
71
|
+
)
|
|
72
|
+
return title
|
|
73
|
+
|
|
74
|
+
|
|
38
75
|
def _write_json_atomic(path: Path, payload: dict[str, Any]) -> None:
|
|
39
76
|
path.parent.mkdir(parents=True, exist_ok=True)
|
|
40
77
|
fd, raw = tempfile.mkstemp(prefix=f".{path.name}.", dir=str(path.parent))
|
|
@@ -243,6 +280,7 @@ def prepare_context(
|
|
|
243
280
|
phase: str,
|
|
244
281
|
executor: str,
|
|
245
282
|
change: str | None = None,
|
|
283
|
+
display_title: str | None = None,
|
|
246
284
|
ttl_seconds: int = 3600,
|
|
247
285
|
) -> dict[str, Any]:
|
|
248
286
|
project = Path(project).resolve()
|
|
@@ -265,6 +303,16 @@ def prepare_context(
|
|
|
265
303
|
contract_root, contract, state_root = _contract(project, change)
|
|
266
304
|
except (OSError, ValueError, json.JSONDecodeError) as exc:
|
|
267
305
|
return {"ok": False, "code": str(exc).split(":", 1)[0], "error": str(exc)}
|
|
306
|
+
try:
|
|
307
|
+
resolved_display_title = _ensure_display_title(
|
|
308
|
+
contract_root, display_title
|
|
309
|
+
)
|
|
310
|
+
except (OSError, ValueError, json.JSONDecodeError) as exc:
|
|
311
|
+
return {
|
|
312
|
+
"ok": False,
|
|
313
|
+
"code": "DISPLAY_TITLE_INVALID",
|
|
314
|
+
"error": str(exc),
|
|
315
|
+
}
|
|
268
316
|
lifecycle = contract.get("lifecycle")
|
|
269
317
|
if (
|
|
270
318
|
isinstance(lifecycle, dict)
|
|
@@ -343,6 +391,7 @@ def prepare_context(
|
|
|
343
391
|
"executionRoot": str(execution_root),
|
|
344
392
|
"preparedAt": now.isoformat(),
|
|
345
393
|
"receiptHash": latest.get("receiptHash") if latest else None,
|
|
394
|
+
"displayTitle": resolved_display_title,
|
|
346
395
|
},
|
|
347
396
|
)
|
|
348
397
|
next_phases = (
|
|
@@ -363,6 +412,7 @@ def prepare_context(
|
|
|
363
412
|
"latestTransition": latest,
|
|
364
413
|
"lease": lease,
|
|
365
414
|
"recovery": recovery,
|
|
415
|
+
"displayTitle": resolved_display_title,
|
|
366
416
|
}
|
|
367
417
|
|
|
368
418
|
|
|
@@ -657,6 +707,7 @@ def build_parser() -> argparse.ArgumentParser:
|
|
|
657
707
|
prepare.add_argument("--change")
|
|
658
708
|
prepare.add_argument("--phase", required=True)
|
|
659
709
|
prepare.add_argument("--executor", required=True)
|
|
710
|
+
prepare.add_argument("--title")
|
|
660
711
|
prepare.add_argument("--ttl-seconds", type=int, default=3600)
|
|
661
712
|
close = sub.add_parser("close")
|
|
662
713
|
close.add_argument("--json", action="store_true")
|
|
@@ -688,6 +739,7 @@ def main(argv: list[str] | None = None) -> int:
|
|
|
688
739
|
phase=args.phase,
|
|
689
740
|
executor=args.executor,
|
|
690
741
|
change=args.change,
|
|
742
|
+
display_title=args.title,
|
|
691
743
|
ttl_seconds=args.ttl_seconds,
|
|
692
744
|
)
|
|
693
745
|
elif args.command == "close":
|
|
@@ -40,6 +40,7 @@ WHITELIST = {
|
|
|
40
40
|
"phase",
|
|
41
41
|
"status",
|
|
42
42
|
"note",
|
|
43
|
+
"message",
|
|
43
44
|
"attempt",
|
|
44
45
|
"name",
|
|
45
46
|
"code",
|
|
@@ -49,11 +50,25 @@ WHITELIST = {
|
|
|
49
50
|
"exit_code",
|
|
50
51
|
"duration_ms",
|
|
51
52
|
"schemaVersion",
|
|
53
|
+
"summary",
|
|
52
54
|
}
|
|
53
55
|
|
|
54
56
|
MAX_BATCH_SIZE = 100
|
|
55
57
|
ACCEPTED_STATUSES = {"accepted", "duplicate_accepted"}
|
|
56
58
|
QUARANTINE_STATUSES = {"id_conflict", "rejected", "rejected_schema"}
|
|
59
|
+
DISPLAY_TITLE_MAX_LENGTH = 200
|
|
60
|
+
EVENT_SUMMARY_MAX_LENGTH = 500
|
|
61
|
+
|
|
62
|
+
PHASE_LABELS = {
|
|
63
|
+
"plan": "计划",
|
|
64
|
+
"run": "编码",
|
|
65
|
+
"test": "测试",
|
|
66
|
+
"review": "评审",
|
|
67
|
+
"package": "打包",
|
|
68
|
+
"apidoc": "接口文档",
|
|
69
|
+
"submit": "提交",
|
|
70
|
+
"archive": "归档",
|
|
71
|
+
}
|
|
57
72
|
|
|
58
73
|
|
|
59
74
|
def _yaml_scalar(text: str, key: str) -> str | None:
|
|
@@ -87,8 +102,139 @@ def load_endpoint(project: Path) -> dict[str, str] | None:
|
|
|
87
102
|
}
|
|
88
103
|
|
|
89
104
|
|
|
105
|
+
def _summary_text(value: Any) -> str:
|
|
106
|
+
if not isinstance(value, str):
|
|
107
|
+
return ""
|
|
108
|
+
text = re.sub(r"\s+", " ", value).strip()
|
|
109
|
+
text = "".join(character for character in text if ord(character) >= 32 and ord(character) != 127)
|
|
110
|
+
return text[:EVENT_SUMMARY_MAX_LENGTH].rstrip()
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
def build_event_summary(event: dict[str, Any]) -> str:
|
|
114
|
+
explicit = _summary_text(event.get("summary"))
|
|
115
|
+
if explicit:
|
|
116
|
+
return explicit
|
|
117
|
+
|
|
118
|
+
event_type = _summary_text(event.get("type"))
|
|
119
|
+
phase = _summary_text(event.get("phase"))
|
|
120
|
+
phase_label = PHASE_LABELS.get(phase, phase or "当前")
|
|
121
|
+
note = _summary_text(event.get("note"))
|
|
122
|
+
message = _summary_text(event.get("message"))
|
|
123
|
+
decision = _summary_text(event.get("decision"))
|
|
124
|
+
reason = _summary_text(event.get("reason"))
|
|
125
|
+
name = _summary_text(event.get("name"))
|
|
126
|
+
code = _summary_text(event.get("code"))
|
|
127
|
+
status = _summary_text(event.get("status"))
|
|
128
|
+
|
|
129
|
+
if event_type == "decision" and decision:
|
|
130
|
+
return _summary_text(f"{decision};原因:{reason}" if reason else decision)
|
|
131
|
+
if event_type == "issue":
|
|
132
|
+
detail = message or note or code
|
|
133
|
+
if detail and reason and reason != detail:
|
|
134
|
+
return _summary_text(f"{detail};原因:{reason}")
|
|
135
|
+
return detail or "发现一项需要处理的问题。"
|
|
136
|
+
if event_type == "issue.resolve":
|
|
137
|
+
detail = message or note or code
|
|
138
|
+
return _summary_text(f"问题已解决:{detail}" if detail else "已解决此前记录的问题。")
|
|
139
|
+
if event_type == "phase.start":
|
|
140
|
+
return _summary_text(
|
|
141
|
+
f"开始执行{phase_label}阶段:{note}" if note else f"开始执行{phase_label}阶段。"
|
|
142
|
+
)
|
|
143
|
+
if event_type in {"phase.end", "phase.auto_sealed"}:
|
|
144
|
+
detail = note or status
|
|
145
|
+
return _summary_text(
|
|
146
|
+
f"{phase_label}阶段已结束:{detail}" if detail else f"{phase_label}阶段已结束。"
|
|
147
|
+
)
|
|
148
|
+
if event_type == "command":
|
|
149
|
+
detail = name or note
|
|
150
|
+
return _summary_text(f"执行步骤:{detail}" if detail else "执行了一项工作步骤。")
|
|
151
|
+
if event_type == "verification":
|
|
152
|
+
detail = name or note or status
|
|
153
|
+
return _summary_text(f"完成验证:{detail}" if detail else "完成了一项结果验证。")
|
|
154
|
+
if event_type == "artifact":
|
|
155
|
+
detail = name or note
|
|
156
|
+
return _summary_text(f"生成或更新产物:{detail}" if detail else "生成或更新了一项交付内容。")
|
|
157
|
+
if event_type == "correction":
|
|
158
|
+
detail = note or reason or message
|
|
159
|
+
return _summary_text(f"调整执行方式:{detail}" if detail else "根据当前结果调整了执行方式。")
|
|
160
|
+
if event_type == "change.rename":
|
|
161
|
+
return note or message or "更新了变更名称。"
|
|
162
|
+
if event_type in {"recovery", "phase.recovery", "attempt.recovery"}:
|
|
163
|
+
return note or reason or message or "恢复了中断的运行状态。"
|
|
164
|
+
if event_type == "heartbeat":
|
|
165
|
+
return "客户端保持在线,并同步了最新运行状态。"
|
|
166
|
+
|
|
167
|
+
return note or message or name or reason or code or "记录了一项运行事件。"
|
|
168
|
+
|
|
169
|
+
|
|
90
170
|
def sanitize(event: dict[str, Any]) -> dict[str, Any]:
|
|
91
|
-
|
|
171
|
+
payload = {key: event[key] for key in WHITELIST if key in event}
|
|
172
|
+
payload["summary"] = build_event_summary(event)
|
|
173
|
+
return payload
|
|
174
|
+
|
|
175
|
+
|
|
176
|
+
def _valid_display_title(value: Any) -> str | None:
|
|
177
|
+
if not isinstance(value, str):
|
|
178
|
+
return None
|
|
179
|
+
title = value.strip()
|
|
180
|
+
if (
|
|
181
|
+
not title
|
|
182
|
+
or len(title) > DISPLAY_TITLE_MAX_LENGTH
|
|
183
|
+
or any(ord(character) < 32 or ord(character) == 127 for character in title)
|
|
184
|
+
):
|
|
185
|
+
return None
|
|
186
|
+
return title
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
def _safe_file_within(change_dir: Path, path: Path) -> Path | None:
|
|
190
|
+
try:
|
|
191
|
+
root = change_dir.resolve()
|
|
192
|
+
resolved = path.resolve()
|
|
193
|
+
except OSError:
|
|
194
|
+
return None
|
|
195
|
+
if path.is_symlink() or not resolved.is_relative_to(root) or not resolved.is_file():
|
|
196
|
+
return None
|
|
197
|
+
return resolved
|
|
198
|
+
|
|
199
|
+
|
|
200
|
+
def load_display_title(change_dir: Path, change_key: str) -> str:
|
|
201
|
+
metadata_path = _safe_file_within(
|
|
202
|
+
change_dir, change_dir / "meta" / "change-title.json"
|
|
203
|
+
)
|
|
204
|
+
if metadata_path is not None:
|
|
205
|
+
try:
|
|
206
|
+
payload = json.loads(metadata_path.read_text(encoding="utf-8-sig"))
|
|
207
|
+
except (OSError, json.JSONDecodeError):
|
|
208
|
+
payload = None
|
|
209
|
+
if isinstance(payload, dict):
|
|
210
|
+
title = _valid_display_title(payload.get("displayTitle"))
|
|
211
|
+
if title is not None:
|
|
212
|
+
return title
|
|
213
|
+
|
|
214
|
+
# Legacy migration: older Plan runs already wrote a human title into the
|
|
215
|
+
# approved design H1 but had no structured title metadata.
|
|
216
|
+
design_path = _safe_file_within(
|
|
217
|
+
change_dir, change_dir / "spec" / f"{change_key}-design.md"
|
|
218
|
+
)
|
|
219
|
+
if design_path is not None:
|
|
220
|
+
try:
|
|
221
|
+
with design_path.open("r", encoding="utf-8-sig") as stream:
|
|
222
|
+
for _ in range(40):
|
|
223
|
+
line = stream.readline()
|
|
224
|
+
if not line:
|
|
225
|
+
break
|
|
226
|
+
if not line.startswith("# "):
|
|
227
|
+
continue
|
|
228
|
+
candidate = re.sub(
|
|
229
|
+
r"\s+(?:设计文档|设计方案|设计)$", "", line[2:].strip()
|
|
230
|
+
)
|
|
231
|
+
title = _valid_display_title(candidate)
|
|
232
|
+
if title is not None and title != change_key:
|
|
233
|
+
return title
|
|
234
|
+
break
|
|
235
|
+
except OSError:
|
|
236
|
+
pass
|
|
237
|
+
return change_key
|
|
92
238
|
|
|
93
239
|
|
|
94
240
|
def cursor_path(change_dir: Path) -> Path:
|
|
@@ -252,6 +398,7 @@ def sync_change(
|
|
|
252
398
|
resolved_key = change_key or change_dir.name
|
|
253
399
|
rid = run_id or run_id_for(change_dir)
|
|
254
400
|
project_id = endpoint["project_id"]
|
|
401
|
+
display_title = load_display_title(change_dir, resolved_key)
|
|
255
402
|
|
|
256
403
|
# Always heartbeat so the console can separate connection vs run status.
|
|
257
404
|
try:
|
|
@@ -264,7 +411,7 @@ def sync_change(
|
|
|
264
411
|
"run_id": rid,
|
|
265
412
|
"change_key": resolved_key,
|
|
266
413
|
"client_time": client_time,
|
|
267
|
-
"title":
|
|
414
|
+
"title": display_title,
|
|
268
415
|
},
|
|
269
416
|
)
|
|
270
417
|
except (urllib.error.URLError, TimeoutError, OSError, json.JSONDecodeError) as exc:
|
|
@@ -337,7 +484,7 @@ def sync_change(
|
|
|
337
484
|
"protocol_version": "hunter-progress-sync/v1",
|
|
338
485
|
"run_id": rid,
|
|
339
486
|
"change_key": resolved_key,
|
|
340
|
-
"title":
|
|
487
|
+
"title": display_title,
|
|
341
488
|
"events": batch,
|
|
342
489
|
},
|
|
343
490
|
)
|
|
@@ -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=
|
|
6
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
6
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
5
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
5
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
6
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; overlay=none; agent=codebuddy; do not edit -->
|
|
7
7
|
# harness-plan — 需求规划
|
|
8
8
|
|
|
9
9
|
## Purpose
|
|
@@ -67,7 +67,7 @@ description: 将需求转化为设计文档+实施计划+完整测试场景表
|
|
|
67
67
|
| 阶段 | 动作 |
|
|
68
68
|
|------|------|
|
|
69
69
|
| 0 | 用当前解释器运行 `harness_runtime.py doctor`,后续消费绝对 argv;git status;脏工作区 → baseline 隔离 + `decision`,不询问 |
|
|
70
|
-
| 0.5 |
|
|
70
|
+
| 0.5 | 确定英文 `change-name` 后,根据需求生成一次简洁的中文展示标题(建议 6~24 个可见字符,保留必要产品名),执行 `harness_context.py prepare --phase plan --executor <tool> [--change <id>] --title "<中文标题>" --json`;英文名继续作为目录与稳定标识。以其唯一 change/executionRoot 初始化 plan-run-id 与 attempt(首次为 1),用同一身份追加 `phase.start`;从第一条知识查询起保留事件证据,并在 finalizer 中复用该身份 |
|
|
71
71
|
| 1 | `harness-knowledge-query` 单次远端 query(失败记 `issue`,不建立本地索引或离线回退) |
|
|
72
72
|
| 2 | 歧义优先检查 + 复杂度分级;先确认会改变实现方向的语义歧义 |
|
|
73
73
|
| 3 | 按复杂度执行有预算的代码探索;简单修复不得扩散到无关模块 |
|
|
@@ -95,6 +95,7 @@ change-name 范围变更 → 提示重命名或记 🟡WARN(→ `reference.md`
|
|
|
95
95
|
| 规则 | 要点 |
|
|
96
96
|
|------|------|
|
|
97
97
|
| 产物路径 | 只写 `.harness/changes/<cn>/`;禁止 superpowers 输入 |
|
|
98
|
+
| Change 标题 | 首次 Plan 同时确定英文 `change-name` 与中文展示标题;英文名保持目录和机器标识不变,中文标题由 `prepare --title` 持久化,后续阶段只复用、不重新生成 |
|
|
98
99
|
| 设计审批包 | 一次 blocking user confirmation 含 worktree(读 `harness.json` `defaultWorktree`) |
|
|
99
100
|
| 阶段 8 | spec/plan/detail/scenarios/gate-policy/worktree 六项标准产物先进入 staging;仅 finalizer 校验成功后发布并写唯一 `phase.end`/log;随后 `verify` 必须确认 start/end、收据完整覆盖六项标准产物、哈希、全部任务表和非空场景清单一致,失败不得手工补终态 |
|
|
100
101
|
| Plan 结束 | **禁止**询问执行模式;只提示 `/harness-run` |
|
|
@@ -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=
|
|
7
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
6
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
6
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
7
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; 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=
|
|
6
|
+
<!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; overlay=none; agent=codebuddy; do not edit -->
|
|
7
7
|
# harness-test — 测试执行
|
|
8
8
|
|
|
9
9
|
## Purpose
|