@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.
Files changed (122) 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 +3 -2
  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-sync/SKILL.md +1 -1
  11. package/harness/bundles/general/claude-code/harness-test/SKILL.md +1 -1
  12. package/harness/bundles/general/claude-code/scripts/harness_context.py +52 -0
  13. package/harness/bundles/general/claude-code/scripts/harness_events_sync.py +150 -3
  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 +3 -2
  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-sync/SKILL.md +1 -1
  24. package/harness/bundles/general/codebuddy/harness-test/SKILL.md +1 -1
  25. package/harness/bundles/general/codebuddy/scripts/harness_context.py +52 -0
  26. package/harness/bundles/general/codebuddy/scripts/harness_events_sync.py +150 -3
  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 +3 -2
  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-sync/SKILL.md +1 -1
  37. package/harness/bundles/general/codex/harness-test/SKILL.md +1 -1
  38. package/harness/bundles/general/codex/scripts/harness_context.py +52 -0
  39. package/harness/bundles/general/codex/scripts/harness_events_sync.py +150 -3
  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 +3 -2
  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-sync/SKILL.md +1 -1
  50. package/harness/bundles/general/cursor/harness-test/SKILL.md +1 -1
  51. package/harness/bundles/general/cursor/scripts/harness_context.py +52 -0
  52. package/harness/bundles/general/cursor/scripts/harness_events_sync.py +150 -3
  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 +3 -2
  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-submit/SKILL.md +1 -1
  64. package/harness/bundles/java/claude-code/harness-sync/SKILL.md +1 -1
  65. package/harness/bundles/java/claude-code/harness-test/SKILL.md +1 -1
  66. package/harness/bundles/java/claude-code/scripts/harness_context.py +52 -0
  67. package/harness/bundles/java/claude-code/scripts/harness_events_sync.py +150 -3
  68. package/harness/bundles/java/codebuddy/.harness-build.json +1 -1
  69. package/harness/bundles/java/codebuddy/harness-apidoc/SKILL.md +1 -1
  70. package/harness/bundles/java/codebuddy/harness-archive/SKILL.md +1 -1
  71. package/harness/bundles/java/codebuddy/harness-codebase-map/SKILL.md +1 -1
  72. package/harness/bundles/java/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  73. package/harness/bundles/java/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  74. package/harness/bundles/java/codebuddy/harness-package/SKILL.md +1 -1
  75. package/harness/bundles/java/codebuddy/harness-plan/SKILL.md +3 -2
  76. package/harness/bundles/java/codebuddy/harness-review/SKILL.md +1 -1
  77. package/harness/bundles/java/codebuddy/harness-run/SKILL.md +1 -1
  78. package/harness/bundles/java/codebuddy/harness-submit/SKILL.md +1 -1
  79. package/harness/bundles/java/codebuddy/harness-sync/SKILL.md +1 -1
  80. package/harness/bundles/java/codebuddy/harness-test/SKILL.md +1 -1
  81. package/harness/bundles/java/codebuddy/scripts/harness_context.py +52 -0
  82. package/harness/bundles/java/codebuddy/scripts/harness_events_sync.py +150 -3
  83. package/harness/bundles/java/codex/.harness-build.json +1 -1
  84. package/harness/bundles/java/codex/harness-apidoc/SKILL.md +1 -1
  85. package/harness/bundles/java/codex/harness-archive/SKILL.md +1 -1
  86. package/harness/bundles/java/codex/harness-codebase-map/SKILL.md +1 -1
  87. package/harness/bundles/java/codex/harness-knowledge-ingest/SKILL.md +1 -1
  88. package/harness/bundles/java/codex/harness-knowledge-query/SKILL.md +1 -1
  89. package/harness/bundles/java/codex/harness-package/SKILL.md +1 -1
  90. package/harness/bundles/java/codex/harness-plan/SKILL.md +3 -2
  91. package/harness/bundles/java/codex/harness-review/SKILL.md +1 -1
  92. package/harness/bundles/java/codex/harness-run/SKILL.md +1 -1
  93. package/harness/bundles/java/codex/harness-submit/SKILL.md +1 -1
  94. package/harness/bundles/java/codex/harness-sync/SKILL.md +1 -1
  95. package/harness/bundles/java/codex/harness-test/SKILL.md +1 -1
  96. package/harness/bundles/java/codex/scripts/harness_context.py +52 -0
  97. package/harness/bundles/java/codex/scripts/harness_events_sync.py +150 -3
  98. package/harness/bundles/java/cursor/.harness-build.json +1 -1
  99. package/harness/bundles/java/cursor/harness-apidoc/SKILL.md +1 -1
  100. package/harness/bundles/java/cursor/harness-archive/SKILL.md +1 -1
  101. package/harness/bundles/java/cursor/harness-codebase-map/SKILL.md +1 -1
  102. package/harness/bundles/java/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  103. package/harness/bundles/java/cursor/harness-knowledge-query/SKILL.md +1 -1
  104. package/harness/bundles/java/cursor/harness-package/SKILL.md +1 -1
  105. package/harness/bundles/java/cursor/harness-plan/SKILL.md +3 -2
  106. package/harness/bundles/java/cursor/harness-review/SKILL.md +1 -1
  107. package/harness/bundles/java/cursor/harness-run/SKILL.md +1 -1
  108. package/harness/bundles/java/cursor/harness-submit/SKILL.md +1 -1
  109. package/harness/bundles/java/cursor/harness-sync/SKILL.md +1 -1
  110. package/harness/bundles/java/cursor/harness-test/SKILL.md +1 -1
  111. package/harness/bundles/java/cursor/scripts/harness_context.py +52 -0
  112. package/harness/bundles/java/cursor/scripts/harness_events_sync.py +150 -3
  113. package/harness/manifests/general/claude-code.json +15 -15
  114. package/harness/manifests/general/codebuddy.json +15 -15
  115. package/harness/manifests/general/codex.json +15 -15
  116. package/harness/manifests/general/cursor.json +15 -15
  117. package/harness/manifests/java/claude-code.json +17 -17
  118. package/harness/manifests/java/codebuddy.json +17 -17
  119. package/harness/manifests/java/codex.json +17 -17
  120. package/harness/manifests/java/cursor.json +17 -17
  121. package/hunter-workflow-family.json +4 -4
  122. package/package.json +1 -1
@@ -2,5 +2,5 @@
2
2
  "schemaVersion": 1,
3
3
  "overlay": "none",
4
4
  "agent": "claude-code",
5
- "coreHash": "f636ed002f37b71f"
5
+ "coreHash": "9f66b2de1ca64c6e"
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=f636ed002f37b71f; overlay=none; agent=claude-code; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=claude-code; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=claude-code; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=claude-code; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=claude-code; do not edit -->
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 | 先执行 `harness_context.py prepare --phase plan --executor <tool> [--change <id>] --json`,以其唯一 change/executionRoot 初始化 plan-run-id 与 attempt(首次为 1),用同一身份追加 `phase.start`;从第一条知识查询起保留事件证据,并在 finalizer 中复用该身份 |
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=f636ed002f37b71f; overlay=none; agent=claude-code; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=claude-code; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=claude-code; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=claude-code; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=claude-code; do not edit -->
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
- return {key: event[key] for key in WHITELIST if key in event}
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": resolved_key,
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": resolved_key,
487
+ "title": display_title,
341
488
  "events": batch,
342
489
  },
343
490
  )
@@ -2,5 +2,5 @@
2
2
  "schemaVersion": 1,
3
3
  "overlay": "none",
4
4
  "agent": "codebuddy",
5
- "coreHash": "f636ed002f37b71f"
5
+ "coreHash": "9f66b2de1ca64c6e"
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=f636ed002f37b71f; overlay=none; agent=codebuddy; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=codebuddy; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=codebuddy; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=codebuddy; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=codebuddy; do not edit -->
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 | 先执行 `harness_context.py prepare --phase plan --executor <tool> [--change <id>] --json`,以其唯一 change/executionRoot 初始化 plan-run-id 与 attempt(首次为 1),用同一身份追加 `phase.start`;从第一条知识查询起保留事件证据,并在 finalizer 中复用该身份 |
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=f636ed002f37b71f; overlay=none; agent=codebuddy; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=codebuddy; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=codebuddy; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=codebuddy; do not edit -->
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=f636ed002f37b71f; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=9f66b2de1ca64c6e; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-test — 测试执行
8
8
 
9
9
  ## Purpose