@hunter-harness/workflow-harness 0.2.20 → 0.2.22

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 (202) hide show
  1. package/harness/bundles/general/claude-code/.harness-build.json +1 -1
  2. package/harness/bundles/general/claude-code/CONTEXT.md +20 -0
  3. package/harness/bundles/general/claude-code/harness-archive/SKILL.md +1 -1
  4. package/harness/bundles/general/claude-code/harness-archive/checklist.md +14 -0
  5. package/harness/bundles/general/claude-code/harness-archive/templates/render-summary.mjs +24 -3
  6. package/harness/bundles/general/claude-code/harness-codebase-map/SKILL.md +1 -1
  7. package/harness/bundles/general/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
  8. package/harness/bundles/general/claude-code/harness-knowledge-query/SKILL.md +1 -1
  9. package/harness/bundles/general/claude-code/harness-plan/SKILL.md +1 -1
  10. package/harness/bundles/general/claude-code/harness-review/SKILL.md +1 -1
  11. package/harness/bundles/general/claude-code/harness-run/SKILL.md +1 -1
  12. package/harness/bundles/general/claude-code/harness-run/checklist.md +6 -0
  13. package/harness/bundles/general/claude-code/harness-submit/SKILL.md +1 -1
  14. package/harness/bundles/general/claude-code/harness-submit/checklist.md +12 -0
  15. package/harness/bundles/general/claude-code/harness-sync/SKILL.md +1 -1
  16. package/harness/bundles/general/claude-code/harness-test/SKILL.md +1 -1
  17. package/harness/bundles/general/claude-code/harness-test/checklist.md +6 -0
  18. package/harness/bundles/general/claude-code/protocols/model-routing-protocol.md +22 -0
  19. package/harness/bundles/general/claude-code/scripts/harness_archive.py +606 -28
  20. package/harness/bundles/general/claude-code/scripts/harness_environment.py +459 -0
  21. package/harness/bundles/general/claude-code/scripts/harness_events.py +252 -15
  22. package/harness/bundles/general/claude-code/scripts/harness_integration.py +34 -0
  23. package/harness/bundles/general/claude-code/scripts/harness_ledger.py +127 -0
  24. package/harness/bundles/general/claude-code/scripts/harness_migration_head.py +220 -0
  25. package/harness/bundles/general/codebuddy/.harness-build.json +1 -1
  26. package/harness/bundles/general/codebuddy/CONTEXT.md +20 -0
  27. package/harness/bundles/general/codebuddy/harness-archive/SKILL.md +1 -1
  28. package/harness/bundles/general/codebuddy/harness-archive/checklist.md +14 -0
  29. package/harness/bundles/general/codebuddy/harness-archive/templates/render-summary.mjs +24 -3
  30. package/harness/bundles/general/codebuddy/harness-codebase-map/SKILL.md +1 -1
  31. package/harness/bundles/general/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  32. package/harness/bundles/general/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  33. package/harness/bundles/general/codebuddy/harness-plan/SKILL.md +1 -1
  34. package/harness/bundles/general/codebuddy/harness-review/SKILL.md +1 -1
  35. package/harness/bundles/general/codebuddy/harness-run/SKILL.md +1 -1
  36. package/harness/bundles/general/codebuddy/harness-run/checklist.md +6 -0
  37. package/harness/bundles/general/codebuddy/harness-submit/SKILL.md +1 -1
  38. package/harness/bundles/general/codebuddy/harness-submit/checklist.md +12 -0
  39. package/harness/bundles/general/codebuddy/harness-sync/SKILL.md +1 -1
  40. package/harness/bundles/general/codebuddy/harness-test/SKILL.md +1 -1
  41. package/harness/bundles/general/codebuddy/harness-test/checklist.md +6 -0
  42. package/harness/bundles/general/codebuddy/protocols/model-routing-protocol.md +22 -0
  43. package/harness/bundles/general/codebuddy/scripts/harness_archive.py +606 -28
  44. package/harness/bundles/general/codebuddy/scripts/harness_environment.py +459 -0
  45. package/harness/bundles/general/codebuddy/scripts/harness_events.py +252 -15
  46. package/harness/bundles/general/codebuddy/scripts/harness_integration.py +34 -0
  47. package/harness/bundles/general/codebuddy/scripts/harness_ledger.py +127 -0
  48. package/harness/bundles/general/codebuddy/scripts/harness_migration_head.py +220 -0
  49. package/harness/bundles/general/codex/.harness-build.json +1 -1
  50. package/harness/bundles/general/codex/CONTEXT.md +20 -0
  51. package/harness/bundles/general/codex/harness-archive/SKILL.md +1 -1
  52. package/harness/bundles/general/codex/harness-archive/checklist.md +14 -0
  53. package/harness/bundles/general/codex/harness-archive/templates/render-summary.mjs +24 -3
  54. package/harness/bundles/general/codex/harness-codebase-map/SKILL.md +1 -1
  55. package/harness/bundles/general/codex/harness-knowledge-ingest/SKILL.md +1 -1
  56. package/harness/bundles/general/codex/harness-knowledge-query/SKILL.md +1 -1
  57. package/harness/bundles/general/codex/harness-plan/SKILL.md +1 -1
  58. package/harness/bundles/general/codex/harness-review/SKILL.md +1 -1
  59. package/harness/bundles/general/codex/harness-run/SKILL.md +1 -1
  60. package/harness/bundles/general/codex/harness-run/checklist.md +6 -0
  61. package/harness/bundles/general/codex/harness-submit/SKILL.md +1 -1
  62. package/harness/bundles/general/codex/harness-submit/checklist.md +12 -0
  63. package/harness/bundles/general/codex/harness-sync/SKILL.md +1 -1
  64. package/harness/bundles/general/codex/harness-test/SKILL.md +1 -1
  65. package/harness/bundles/general/codex/harness-test/checklist.md +6 -0
  66. package/harness/bundles/general/codex/protocols/model-routing-protocol.md +22 -0
  67. package/harness/bundles/general/codex/scripts/harness_archive.py +606 -28
  68. package/harness/bundles/general/codex/scripts/harness_environment.py +459 -0
  69. package/harness/bundles/general/codex/scripts/harness_events.py +252 -15
  70. package/harness/bundles/general/codex/scripts/harness_integration.py +34 -0
  71. package/harness/bundles/general/codex/scripts/harness_ledger.py +127 -0
  72. package/harness/bundles/general/codex/scripts/harness_migration_head.py +220 -0
  73. package/harness/bundles/general/cursor/.harness-build.json +1 -1
  74. package/harness/bundles/general/cursor/CONTEXT.md +20 -0
  75. package/harness/bundles/general/cursor/harness-archive/SKILL.md +1 -1
  76. package/harness/bundles/general/cursor/harness-archive/checklist.md +14 -0
  77. package/harness/bundles/general/cursor/harness-archive/templates/render-summary.mjs +24 -3
  78. package/harness/bundles/general/cursor/harness-codebase-map/SKILL.md +1 -1
  79. package/harness/bundles/general/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  80. package/harness/bundles/general/cursor/harness-knowledge-query/SKILL.md +1 -1
  81. package/harness/bundles/general/cursor/harness-plan/SKILL.md +1 -1
  82. package/harness/bundles/general/cursor/harness-review/SKILL.md +1 -1
  83. package/harness/bundles/general/cursor/harness-run/SKILL.md +1 -1
  84. package/harness/bundles/general/cursor/harness-run/checklist.md +6 -0
  85. package/harness/bundles/general/cursor/harness-submit/SKILL.md +1 -1
  86. package/harness/bundles/general/cursor/harness-submit/checklist.md +12 -0
  87. package/harness/bundles/general/cursor/harness-sync/SKILL.md +1 -1
  88. package/harness/bundles/general/cursor/harness-test/SKILL.md +1 -1
  89. package/harness/bundles/general/cursor/harness-test/checklist.md +6 -0
  90. package/harness/bundles/general/cursor/protocols/model-routing-protocol.md +22 -0
  91. package/harness/bundles/general/cursor/scripts/harness_archive.py +606 -28
  92. package/harness/bundles/general/cursor/scripts/harness_environment.py +459 -0
  93. package/harness/bundles/general/cursor/scripts/harness_events.py +252 -15
  94. package/harness/bundles/general/cursor/scripts/harness_integration.py +34 -0
  95. package/harness/bundles/general/cursor/scripts/harness_ledger.py +127 -0
  96. package/harness/bundles/general/cursor/scripts/harness_migration_head.py +220 -0
  97. package/harness/bundles/java/claude-code/.harness-build.json +1 -1
  98. package/harness/bundles/java/claude-code/CONTEXT.md +20 -0
  99. package/harness/bundles/java/claude-code/harness-apidoc/SKILL.md +1 -1
  100. package/harness/bundles/java/claude-code/harness-archive/SKILL.md +1 -1
  101. package/harness/bundles/java/claude-code/harness-archive/checklist.md +14 -0
  102. package/harness/bundles/java/claude-code/harness-archive/templates/render-summary.mjs +24 -3
  103. package/harness/bundles/java/claude-code/harness-codebase-map/SKILL.md +1 -1
  104. package/harness/bundles/java/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
  105. package/harness/bundles/java/claude-code/harness-knowledge-query/SKILL.md +1 -1
  106. package/harness/bundles/java/claude-code/harness-package/SKILL.md +1 -1
  107. package/harness/bundles/java/claude-code/harness-plan/SKILL.md +1 -1
  108. package/harness/bundles/java/claude-code/harness-review/SKILL.md +1 -1
  109. package/harness/bundles/java/claude-code/harness-run/SKILL.md +1 -1
  110. package/harness/bundles/java/claude-code/harness-submit/SKILL.md +1 -1
  111. package/harness/bundles/java/claude-code/harness-submit/checklist.md +12 -0
  112. package/harness/bundles/java/claude-code/harness-sync/SKILL.md +1 -1
  113. package/harness/bundles/java/claude-code/harness-test/SKILL.md +1 -1
  114. package/harness/bundles/java/claude-code/protocols/model-routing-protocol.md +22 -0
  115. package/harness/bundles/java/claude-code/scripts/harness_archive.py +606 -28
  116. package/harness/bundles/java/claude-code/scripts/harness_environment.py +459 -0
  117. package/harness/bundles/java/claude-code/scripts/harness_events.py +252 -15
  118. package/harness/bundles/java/claude-code/scripts/harness_integration.py +34 -0
  119. package/harness/bundles/java/claude-code/scripts/harness_ledger.py +127 -0
  120. package/harness/bundles/java/claude-code/scripts/harness_migration_head.py +220 -0
  121. package/harness/bundles/java/codebuddy/.harness-build.json +1 -1
  122. package/harness/bundles/java/codebuddy/CONTEXT.md +20 -0
  123. package/harness/bundles/java/codebuddy/harness-apidoc/SKILL.md +1 -1
  124. package/harness/bundles/java/codebuddy/harness-archive/SKILL.md +1 -1
  125. package/harness/bundles/java/codebuddy/harness-archive/checklist.md +14 -0
  126. package/harness/bundles/java/codebuddy/harness-archive/templates/render-summary.mjs +24 -3
  127. package/harness/bundles/java/codebuddy/harness-codebase-map/SKILL.md +1 -1
  128. package/harness/bundles/java/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  129. package/harness/bundles/java/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  130. package/harness/bundles/java/codebuddy/harness-package/SKILL.md +1 -1
  131. package/harness/bundles/java/codebuddy/harness-plan/SKILL.md +1 -1
  132. package/harness/bundles/java/codebuddy/harness-review/SKILL.md +1 -1
  133. package/harness/bundles/java/codebuddy/harness-run/SKILL.md +1 -1
  134. package/harness/bundles/java/codebuddy/harness-submit/SKILL.md +1 -1
  135. package/harness/bundles/java/codebuddy/harness-submit/checklist.md +12 -0
  136. package/harness/bundles/java/codebuddy/harness-sync/SKILL.md +1 -1
  137. package/harness/bundles/java/codebuddy/harness-test/SKILL.md +1 -1
  138. package/harness/bundles/java/codebuddy/protocols/model-routing-protocol.md +22 -0
  139. package/harness/bundles/java/codebuddy/scripts/harness_archive.py +606 -28
  140. package/harness/bundles/java/codebuddy/scripts/harness_environment.py +459 -0
  141. package/harness/bundles/java/codebuddy/scripts/harness_events.py +252 -15
  142. package/harness/bundles/java/codebuddy/scripts/harness_integration.py +34 -0
  143. package/harness/bundles/java/codebuddy/scripts/harness_ledger.py +127 -0
  144. package/harness/bundles/java/codebuddy/scripts/harness_migration_head.py +220 -0
  145. package/harness/bundles/java/codex/.harness-build.json +1 -1
  146. package/harness/bundles/java/codex/CONTEXT.md +20 -0
  147. package/harness/bundles/java/codex/harness-apidoc/SKILL.md +1 -1
  148. package/harness/bundles/java/codex/harness-archive/SKILL.md +1 -1
  149. package/harness/bundles/java/codex/harness-archive/checklist.md +14 -0
  150. package/harness/bundles/java/codex/harness-archive/templates/render-summary.mjs +24 -3
  151. package/harness/bundles/java/codex/harness-codebase-map/SKILL.md +1 -1
  152. package/harness/bundles/java/codex/harness-knowledge-ingest/SKILL.md +1 -1
  153. package/harness/bundles/java/codex/harness-knowledge-query/SKILL.md +1 -1
  154. package/harness/bundles/java/codex/harness-package/SKILL.md +1 -1
  155. package/harness/bundles/java/codex/harness-plan/SKILL.md +1 -1
  156. package/harness/bundles/java/codex/harness-review/SKILL.md +1 -1
  157. package/harness/bundles/java/codex/harness-run/SKILL.md +1 -1
  158. package/harness/bundles/java/codex/harness-submit/SKILL.md +1 -1
  159. package/harness/bundles/java/codex/harness-submit/checklist.md +12 -0
  160. package/harness/bundles/java/codex/harness-sync/SKILL.md +1 -1
  161. package/harness/bundles/java/codex/harness-test/SKILL.md +1 -1
  162. package/harness/bundles/java/codex/protocols/model-routing-protocol.md +22 -0
  163. package/harness/bundles/java/codex/scripts/harness_archive.py +606 -28
  164. package/harness/bundles/java/codex/scripts/harness_environment.py +459 -0
  165. package/harness/bundles/java/codex/scripts/harness_events.py +252 -15
  166. package/harness/bundles/java/codex/scripts/harness_integration.py +34 -0
  167. package/harness/bundles/java/codex/scripts/harness_ledger.py +127 -0
  168. package/harness/bundles/java/codex/scripts/harness_migration_head.py +220 -0
  169. package/harness/bundles/java/cursor/.harness-build.json +1 -1
  170. package/harness/bundles/java/cursor/CONTEXT.md +20 -0
  171. package/harness/bundles/java/cursor/harness-apidoc/SKILL.md +1 -1
  172. package/harness/bundles/java/cursor/harness-archive/SKILL.md +1 -1
  173. package/harness/bundles/java/cursor/harness-archive/checklist.md +14 -0
  174. package/harness/bundles/java/cursor/harness-archive/templates/render-summary.mjs +24 -3
  175. package/harness/bundles/java/cursor/harness-codebase-map/SKILL.md +1 -1
  176. package/harness/bundles/java/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  177. package/harness/bundles/java/cursor/harness-knowledge-query/SKILL.md +1 -1
  178. package/harness/bundles/java/cursor/harness-package/SKILL.md +1 -1
  179. package/harness/bundles/java/cursor/harness-plan/SKILL.md +1 -1
  180. package/harness/bundles/java/cursor/harness-review/SKILL.md +1 -1
  181. package/harness/bundles/java/cursor/harness-run/SKILL.md +1 -1
  182. package/harness/bundles/java/cursor/harness-submit/SKILL.md +1 -1
  183. package/harness/bundles/java/cursor/harness-submit/checklist.md +12 -0
  184. package/harness/bundles/java/cursor/harness-sync/SKILL.md +1 -1
  185. package/harness/bundles/java/cursor/harness-test/SKILL.md +1 -1
  186. package/harness/bundles/java/cursor/protocols/model-routing-protocol.md +22 -0
  187. package/harness/bundles/java/cursor/scripts/harness_archive.py +606 -28
  188. package/harness/bundles/java/cursor/scripts/harness_environment.py +459 -0
  189. package/harness/bundles/java/cursor/scripts/harness_events.py +252 -15
  190. package/harness/bundles/java/cursor/scripts/harness_integration.py +34 -0
  191. package/harness/bundles/java/cursor/scripts/harness_ledger.py +127 -0
  192. package/harness/bundles/java/cursor/scripts/harness_migration_head.py +220 -0
  193. package/harness/manifests/general/claude-code.json +33 -21
  194. package/harness/manifests/general/codebuddy.json +33 -21
  195. package/harness/manifests/general/codex.json +33 -21
  196. package/harness/manifests/general/cursor.json +33 -21
  197. package/harness/manifests/java/claude-code.json +33 -21
  198. package/harness/manifests/java/codebuddy.json +33 -21
  199. package/harness/manifests/java/codex.json +33 -21
  200. package/harness/manifests/java/cursor.json +33 -21
  201. package/hunter-workflow-family.json +1 -1
  202. package/package.json +1 -1
@@ -0,0 +1,220 @@
1
+ #!/usr/bin/env python3
2
+ """Migration head single-source consistency check (Wave-2 H-7).
3
+
4
+ Canonical file (default ``.harness/config/migration-head.json``)::
5
+
6
+ {
7
+ "schemaVersion": 1,
8
+ "head": "005_example",
9
+ "sources": [
10
+ {"path": "backend/app/config.py", "pattern": "EXPECTED_ALEMBIC_HEAD\\s*=\\s*[\\\"']([^\\\"']+)[\\\"']"},
11
+ {"path": "integration/manifest.json", "jsonPointer": "/migrationHead"}
12
+ ]
13
+ }
14
+
15
+ Each source must resolve to the same ``head`` value. This harness repo may not
16
+ ship alembic; consumer projects declare the canonical file and run::
17
+
18
+ python harness_migration_head.py check --project . --json
19
+ """
20
+
21
+ from __future__ import annotations
22
+
23
+ import argparse
24
+ import json
25
+ import re
26
+ import sys
27
+ from pathlib import Path
28
+ from typing import Any
29
+
30
+ DEFAULT_REL = ".harness/config/migration-head.json"
31
+
32
+
33
+ def emit_json(payload: dict[str, Any], *, as_json: bool) -> None:
34
+ if as_json:
35
+ sys.stdout.write(json.dumps(payload, ensure_ascii=False, indent=2) + "\n")
36
+ else:
37
+ code = payload.get("code") or ("OK" if payload.get("ok") else "FAIL")
38
+ sys.stdout.write(f"{code}\n")
39
+
40
+
41
+ def emit_error(code: str, message: str, *, as_json: bool, extra: dict[str, Any] | None = None) -> int:
42
+ payload: dict[str, Any] = {"ok": False, "code": code, "message": message}
43
+ if extra:
44
+ payload.update(extra)
45
+ stream = sys.stdout if as_json else sys.stderr
46
+ if as_json:
47
+ stream.write(json.dumps(payload, ensure_ascii=False, indent=2) + "\n")
48
+ else:
49
+ stream.write(f"{code}: {message}\n")
50
+ return 1
51
+
52
+
53
+ def _read_json_pointer(data: Any, pointer: str) -> Any:
54
+ if not pointer.startswith("/"):
55
+ raise ValueError(f"jsonPointer must start with /: {pointer}")
56
+ cur = data
57
+ for part in pointer.lstrip("/").split("/"):
58
+ part = part.replace("~1", "/").replace("~0", "~")
59
+ if isinstance(cur, dict) and part in cur:
60
+ cur = cur[part]
61
+ else:
62
+ raise KeyError(pointer)
63
+ return cur
64
+
65
+
66
+ def _extract_source(project: Path, source: dict[str, Any]) -> str:
67
+ rel = str(source.get("path") or "").strip().replace("\\", "/")
68
+ if not rel or rel.startswith("/") or ".." in rel.split("/"):
69
+ raise ValueError(f"invalid source path: {rel}")
70
+ target = (project / rel).resolve()
71
+ try:
72
+ target.relative_to(project.resolve())
73
+ except ValueError as exc:
74
+ raise ValueError(f"source escapes project: {rel}") from exc
75
+ if not target.is_file():
76
+ raise FileNotFoundError(rel)
77
+ text = target.read_text(encoding="utf-8-sig")
78
+ if "jsonPointer" in source and source["jsonPointer"]:
79
+ data = json.loads(text)
80
+ value = _read_json_pointer(data, str(source["jsonPointer"]))
81
+ if value is None or (isinstance(value, str) and not value.strip()):
82
+ raise ValueError(f"empty value at {source['jsonPointer']} in {rel}")
83
+ return str(value).strip()
84
+ pattern = str(source.get("pattern") or "").strip()
85
+ if not pattern:
86
+ raise ValueError(f"source {rel} requires pattern or jsonPointer")
87
+ match = re.search(pattern, text, flags=re.MULTILINE)
88
+ if not match:
89
+ raise ValueError(f"pattern did not match in {rel}")
90
+ return str(match.group(1) if match.lastindex else match.group(0)).strip()
91
+
92
+
93
+ def check_migration_head(
94
+ project: Path,
95
+ *,
96
+ config_rel: str = DEFAULT_REL,
97
+ ) -> dict[str, Any]:
98
+ project = project.resolve()
99
+ config_path = (project / config_rel).resolve()
100
+ try:
101
+ config_path.relative_to(project)
102
+ except ValueError:
103
+ return {
104
+ "ok": False,
105
+ "code": "MIGRATION_HEAD_CONFIG_ESCAPE",
106
+ "message": f"config path escapes project: {config_rel}",
107
+ }
108
+ if not config_path.is_file():
109
+ return {
110
+ "ok": False,
111
+ "code": "MIGRATION_HEAD_MISSING",
112
+ "message": f"canonical migration-head file missing: {config_rel}",
113
+ "configPath": str(config_path),
114
+ }
115
+ try:
116
+ data = json.loads(config_path.read_text(encoding="utf-8-sig"))
117
+ except (OSError, json.JSONDecodeError) as exc:
118
+ return {
119
+ "ok": False,
120
+ "code": "MIGRATION_HEAD_UNREADABLE",
121
+ "message": str(exc),
122
+ "configPath": str(config_path),
123
+ }
124
+ if not isinstance(data, dict) or data.get("schemaVersion") != 1:
125
+ return {
126
+ "ok": False,
127
+ "code": "MIGRATION_HEAD_SCHEMA_INVALID",
128
+ "message": "migration-head.json must be schemaVersion 1 object",
129
+ "configPath": str(config_path),
130
+ }
131
+ head = str(data.get("head") or "").strip()
132
+ sources = data.get("sources")
133
+ if not head:
134
+ return {
135
+ "ok": False,
136
+ "code": "MIGRATION_HEAD_EMPTY",
137
+ "message": "head must be a non-empty string",
138
+ "configPath": str(config_path),
139
+ }
140
+ if not isinstance(sources, list) or not sources:
141
+ return {
142
+ "ok": False,
143
+ "code": "MIGRATION_HEAD_SOURCES_EMPTY",
144
+ "message": "sources must be a non-empty array",
145
+ "configPath": str(config_path),
146
+ }
147
+
148
+ observed: list[dict[str, Any]] = []
149
+ drifts: list[dict[str, Any]] = []
150
+ for index, source in enumerate(sources):
151
+ if not isinstance(source, dict):
152
+ return {
153
+ "ok": False,
154
+ "code": "MIGRATION_HEAD_SOURCE_INVALID",
155
+ "message": f"sources[{index}] must be an object",
156
+ }
157
+ try:
158
+ value = _extract_source(project, source)
159
+ except (OSError, ValueError, KeyError, json.JSONDecodeError) as exc:
160
+ return {
161
+ "ok": False,
162
+ "code": "MIGRATION_HEAD_SOURCE_UNREADABLE",
163
+ "message": str(exc),
164
+ "index": index,
165
+ "path": source.get("path"),
166
+ }
167
+ item = {"path": source.get("path"), "value": value}
168
+ observed.append(item)
169
+ if value != head:
170
+ drifts.append({**item, "expected": head})
171
+
172
+ if drifts:
173
+ return {
174
+ "ok": False,
175
+ "code": "MIGRATION_HEAD_DRIFT",
176
+ "message": "one or more sources disagree with canonical head",
177
+ "head": head,
178
+ "drifts": drifts,
179
+ "observed": observed,
180
+ "configPath": str(config_path),
181
+ }
182
+ return {
183
+ "ok": True,
184
+ "code": "MIGRATION_HEAD_OK",
185
+ "head": head,
186
+ "observed": observed,
187
+ "configPath": str(config_path),
188
+ "sourceCount": len(observed),
189
+ }
190
+
191
+
192
+ def build_parser() -> argparse.ArgumentParser:
193
+ parser = argparse.ArgumentParser(prog="harness_migration_head.py")
194
+ sub = parser.add_subparsers(dest="command", required=True)
195
+ check = sub.add_parser("check", help="verify sources match canonical head")
196
+ check.add_argument("--project", required=True)
197
+ check.add_argument("--config", default=DEFAULT_REL)
198
+ check.add_argument("--json", action="store_true")
199
+ return parser
200
+
201
+
202
+ def main(argv: list[str] | None = None) -> int:
203
+ args = build_parser().parse_args(argv)
204
+ as_json = bool(getattr(args, "json", False))
205
+ if args.command == "check":
206
+ result = check_migration_head(Path(args.project), config_rel=str(args.config))
207
+ if not result.get("ok"):
208
+ return emit_error(
209
+ str(result.get("code") or "MIGRATION_HEAD_FAIL"),
210
+ str(result.get("message") or "check failed"),
211
+ as_json=as_json,
212
+ extra={k: v for k, v in result.items() if k not in {"ok", "code", "message"}},
213
+ )
214
+ emit_json(result, as_json=as_json)
215
+ return 0
216
+ return emit_error("UNKNOWN_COMMAND", f"unknown command: {args.command}", as_json=as_json)
217
+
218
+
219
+ if __name__ == "__main__":
220
+ raise SystemExit(main())
@@ -7,7 +7,7 @@
7
7
  "files": [
8
8
  {
9
9
  "path": ".harness-build.json",
10
- "sha256": "164e3dc420cf0c1297b2107160216e08a03966f12dc24dccb65cfaadf2d8b6de"
10
+ "sha256": "57a39f9da39468c1a12e3c5563396b784a7b08aee2a566941fc58baeef1b4c25"
11
11
  },
12
12
  {
13
13
  "path": "agents/harness-evaluator.md",
@@ -23,7 +23,7 @@
23
23
  },
24
24
  {
25
25
  "path": "CONTEXT.md",
26
- "sha256": "2318aba4ff5ae4db0a0bff6380d1e9f4ed697caf9a4b2c1458ad2cdda1acb9e8"
26
+ "sha256": "4838854cc45e8bd47552fb34e41cadca3121eeaa4597196568f35e25534d5a33"
27
27
  },
28
28
  {
29
29
  "path": "contracts/ci-metrics.schema.json",
@@ -35,7 +35,7 @@
35
35
  },
36
36
  {
37
37
  "path": "harness-archive/checklist.md",
38
- "sha256": "c996b57c4f90a9a5285e59c7391e0628e9627974f030b2629bb477c36ad77aa5"
38
+ "sha256": "dedc3cb106e692015f31a98465342d0ea6367ff56f87602602ce7a2818a792a6"
39
39
  },
40
40
  {
41
41
  "path": "harness-archive/reference.md",
@@ -47,11 +47,11 @@
47
47
  },
48
48
  {
49
49
  "path": "harness-archive/SKILL.md",
50
- "sha256": "de3cdccf65400963dd3a8a5d2eb41a422ed1cef951c43e7896e016a26d471392"
50
+ "sha256": "085b72b54ece886c659676bfbfea192b999eea5a3553ff57a2dbacb97e5ab36e"
51
51
  },
52
52
  {
53
53
  "path": "harness-archive/templates/render-summary.mjs",
54
- "sha256": "f15d2b541649fe677d56de46bc7ac8deccaeab12e57c530f5cd64fb340f17df4"
54
+ "sha256": "7478a27f71b006b206443fee7ac8c2ee9722d21c78e6b2a82d3a1300de41d391"
55
55
  },
56
56
  {
57
57
  "path": "harness-archive/templates/summary-data-template.json",
@@ -67,7 +67,7 @@
67
67
  },
68
68
  {
69
69
  "path": "harness-codebase-map/SKILL.md",
70
- "sha256": "c67a91e1f274a29cea77d1da8f602a889fb9085e7a82370e5cf5a6064d195139"
70
+ "sha256": "0a4f638cc0175e80d7df1546ab7a64699ac0b3af30bc3a094a85d865a206480e"
71
71
  },
72
72
  {
73
73
  "path": "harness-codebase-map/templates/ARCHITECTURE.md",
@@ -131,11 +131,11 @@
131
131
  },
132
132
  {
133
133
  "path": "harness-knowledge-ingest/SKILL.md",
134
- "sha256": "3fa651d2ce8962e83f05b518df1a09fafa7e5a01ea9e6038776a753ab241c261"
134
+ "sha256": "63c7c6eb50847f2be59bc887e4b9530ec6d324f424d6d7f66deba1c81d24a424"
135
135
  },
136
136
  {
137
137
  "path": "harness-knowledge-query/SKILL.md",
138
- "sha256": "7dccc07f4fbfd5dc2dee1db50c53d1eb8b4990d106f8a592e64f383e056921f1"
138
+ "sha256": "282f0f4202a43dabadfda7e4a5824ae1c4fef2db76465025c34503c3a164c916"
139
139
  },
140
140
  {
141
141
  "path": "harness-plan/checklist.md",
@@ -151,7 +151,7 @@
151
151
  },
152
152
  {
153
153
  "path": "harness-plan/SKILL.md",
154
- "sha256": "58ee9c2ab2485b895b2aa971025e5d1c330cf140babbb3857f7bc2ea8331e958"
154
+ "sha256": "3c0aa49a75534ce38decef0844201dac582842727af208ea6a6efa8bca17d9db"
155
155
  },
156
156
  {
157
157
  "path": "harness-review/checklist.md",
@@ -167,11 +167,11 @@
167
167
  },
168
168
  {
169
169
  "path": "harness-review/SKILL.md",
170
- "sha256": "8bddef05374f53c1956752c434d70bfa65063136ad111d67f1616ca9ff74e598"
170
+ "sha256": "72aaade0adccea1ad8221a4bd0ad0ee03b475dd80a2b8749ff07c84586be929c"
171
171
  },
172
172
  {
173
173
  "path": "harness-run/checklist.md",
174
- "sha256": "8f8be29c43b2a37885d0ef729ca4a1cb748869d65de0498b0e38f3e1cc7f317a"
174
+ "sha256": "62063fd4c20a12eb9295fb5bade31e10adb2f5a4fd8600446b2109b959c82961"
175
175
  },
176
176
  {
177
177
  "path": "harness-run/protocols.md",
@@ -183,11 +183,11 @@
183
183
  },
184
184
  {
185
185
  "path": "harness-run/SKILL.md",
186
- "sha256": "7cf03717705f385cbca018145306c4281ff95324d19294856b2b4d45f7cd3686"
186
+ "sha256": "ceb7c2e2710598e935cd9fb3e40f6d95811e9a23028bfa10e0727f1832eaa701"
187
187
  },
188
188
  {
189
189
  "path": "harness-submit/checklist.md",
190
- "sha256": "2ebc0bc1ac5ce8cf13760ca967870b318633adaebbe0492a99152497d3285582"
190
+ "sha256": "1bf4a0dce64db7b977222f0cb2f2830543fc2a662ea1b8351069e25bbf823c15"
191
191
  },
192
192
  {
193
193
  "path": "harness-submit/reference.md",
@@ -195,7 +195,7 @@
195
195
  },
196
196
  {
197
197
  "path": "harness-submit/SKILL.md",
198
- "sha256": "cd1b2470ee449a04b4a6065c1e4108f28840831a6c4293ee3ae634ef488e774a"
198
+ "sha256": "250a869b8948c3454e92f487fac5056007610095fa6286213df110f0cc6bef45"
199
199
  },
200
200
  {
201
201
  "path": "harness-sync/reference.md",
@@ -203,11 +203,11 @@
203
203
  },
204
204
  {
205
205
  "path": "harness-sync/SKILL.md",
206
- "sha256": "5d8b90759a12971b45c424915e4055d812680c23b3596a77dfb86ceb69107500"
206
+ "sha256": "6abb7075f4fd2292414cca2209d08ba727018477cee9134fa0a4185fc24db6e8"
207
207
  },
208
208
  {
209
209
  "path": "harness-test/checklist.md",
210
- "sha256": "5d7a734ba1832690bc9a405e062f83ae81a56b2c2d86d23e381c841b74c68ba1"
210
+ "sha256": "499bc792815fc364123452f81b00c4043211289538f6f7dd62d19355d60d2e9e"
211
211
  },
212
212
  {
213
213
  "path": "harness-test/pitfalls-java.md",
@@ -227,7 +227,7 @@
227
227
  },
228
228
  {
229
229
  "path": "harness-test/SKILL.md",
230
- "sha256": "d284a936c3fec8cc427babc880ccdc17110432c8b19933952795f34e948f059c"
230
+ "sha256": "9570ea77016e87c19ddfb17d738d1e14dde69dc84d7ece12d5f2a753e2c596a0"
231
231
  },
232
232
  {
233
233
  "path": "protocols/archive-report-protocol.md",
@@ -241,6 +241,10 @@
241
241
  "path": "protocols/ledger-protocol.md",
242
242
  "sha256": "50f9deffcf71de009c56bd2cdd44fb05c7b18faf19ec56b00ff76e8ce897ecf7"
243
243
  },
244
+ {
245
+ "path": "protocols/model-routing-protocol.md",
246
+ "sha256": "1ce493d7dcc7a0c32b07b2d0118fdca40d72ca2487a63566f3c997293269f06e"
247
+ },
244
248
  {
245
249
  "path": "protocols/powershell-protocol.md",
246
250
  "sha256": "f723f18eee08125e75f387e655f7e604eb603f636cd6809dd6b5948748f32d04"
@@ -271,7 +275,7 @@
271
275
  },
272
276
  {
273
277
  "path": "scripts/harness_archive.py",
274
- "sha256": "739671addbac6096860342910dd046178db04d130b34df129667ddd3523449cb"
278
+ "sha256": "07594f290d6cb15602db231e92345fa239439efc9bd9120c6681bd49bf30f176"
275
279
  },
276
280
  {
277
281
  "path": "scripts/harness_change.py",
@@ -285,9 +289,13 @@
285
289
  "path": "scripts/harness_deploy.py",
286
290
  "sha256": "48a95b696cd4df411cc206b80b16b436018e7648bd2daa55f110ceee2e403271"
287
291
  },
292
+ {
293
+ "path": "scripts/harness_environment.py",
294
+ "sha256": "4f6269ef2e21cf9fc327a101cfa2f2eabce840242a718c548bf496ea924d43e9"
295
+ },
288
296
  {
289
297
  "path": "scripts/harness_events.py",
290
- "sha256": "dcc4c1e4c2967ec7a07c103890f45f2903fc2784adebe3d6c5ae8e92037efd4f"
298
+ "sha256": "e6dae6ccb341b22178bd9ef7578df85154c6e9a1d19c86e3769dc7098e50a546"
291
299
  },
292
300
  {
293
301
  "path": "scripts/harness_gate.py",
@@ -295,11 +303,15 @@
295
303
  },
296
304
  {
297
305
  "path": "scripts/harness_integration.py",
298
- "sha256": "ab963ef60b554118858124a6a8ed3af09bdc0bf78a873251825aee225ad77ad4"
306
+ "sha256": "78904ed2a6254be6671a2627863759c68a9576ef41584f423c5cde3faa6d6b25"
299
307
  },
300
308
  {
301
309
  "path": "scripts/harness_ledger.py",
302
- "sha256": "7885b89510a8975c93fe367f9e557735ed70eb6d913f302b6aea3fa193af0f23"
310
+ "sha256": "11340d0e84fc3905d2d7383683ac94d2b9ab13655e56a26e460d7e9b0b515f1a"
311
+ },
312
+ {
313
+ "path": "scripts/harness_migration_head.py",
314
+ "sha256": "6bce06ce5c077185d6e40e1655c37ef98b2f8e6e39d64b2f3f3c45f12854ed51"
303
315
  },
304
316
  {
305
317
  "path": "scripts/harness_paths.py",
@@ -7,7 +7,7 @@
7
7
  "files": [
8
8
  {
9
9
  "path": ".harness-build.json",
10
- "sha256": "21328353c5edb426d87d42d53c2c61e10accdabc06d2aac4f28c5bccfbe37c95"
10
+ "sha256": "62efd128eb92b24dc3616d6fa96879642ce82c0316f8decd09027bf1f80191b9"
11
11
  },
12
12
  {
13
13
  "path": "agents/harness-evaluator.md",
@@ -23,7 +23,7 @@
23
23
  },
24
24
  {
25
25
  "path": "CONTEXT.md",
26
- "sha256": "2318aba4ff5ae4db0a0bff6380d1e9f4ed697caf9a4b2c1458ad2cdda1acb9e8"
26
+ "sha256": "4838854cc45e8bd47552fb34e41cadca3121eeaa4597196568f35e25534d5a33"
27
27
  },
28
28
  {
29
29
  "path": "contracts/ci-metrics.schema.json",
@@ -35,7 +35,7 @@
35
35
  },
36
36
  {
37
37
  "path": "harness-archive/checklist.md",
38
- "sha256": "c996b57c4f90a9a5285e59c7391e0628e9627974f030b2629bb477c36ad77aa5"
38
+ "sha256": "dedc3cb106e692015f31a98465342d0ea6367ff56f87602602ce7a2818a792a6"
39
39
  },
40
40
  {
41
41
  "path": "harness-archive/reference.md",
@@ -47,11 +47,11 @@
47
47
  },
48
48
  {
49
49
  "path": "harness-archive/SKILL.md",
50
- "sha256": "1aa6760b6d589c6e11f7f9509de10fcf2d45004f353d909b044477c1e60e60fc"
50
+ "sha256": "c964748038cc80fbf868e04ccef4cc126ca4055273490d6653756bacc42c6414"
51
51
  },
52
52
  {
53
53
  "path": "harness-archive/templates/render-summary.mjs",
54
- "sha256": "f15d2b541649fe677d56de46bc7ac8deccaeab12e57c530f5cd64fb340f17df4"
54
+ "sha256": "7478a27f71b006b206443fee7ac8c2ee9722d21c78e6b2a82d3a1300de41d391"
55
55
  },
56
56
  {
57
57
  "path": "harness-archive/templates/summary-data-template.json",
@@ -67,7 +67,7 @@
67
67
  },
68
68
  {
69
69
  "path": "harness-codebase-map/SKILL.md",
70
- "sha256": "78388513d79e0b2d9108d97aa9edc07cb388db8af8020577227fd7fb779a6f81"
70
+ "sha256": "a5ac7f32b1255e3a61e56e37a5cb70b8c3752f8e98539a9ff2bfbe216ed4db3a"
71
71
  },
72
72
  {
73
73
  "path": "harness-codebase-map/templates/ARCHITECTURE.md",
@@ -131,11 +131,11 @@
131
131
  },
132
132
  {
133
133
  "path": "harness-knowledge-ingest/SKILL.md",
134
- "sha256": "05332ae01141a8b8e44ebb06d03da2134e0b20f51988902eeebae051ddb88240"
134
+ "sha256": "97198897c5025a4597f8628dc06d0657711dfb28acdb23769b0a892bb61a9ce0"
135
135
  },
136
136
  {
137
137
  "path": "harness-knowledge-query/SKILL.md",
138
- "sha256": "b852730e5299f2fada7bf09da2286f47117e6a0a64c536a6ba655387bc9955ef"
138
+ "sha256": "e052f9cfe3ffcb6d517ae9c28d05cb54306ef0bbc9a6145a6597d224df96bc6f"
139
139
  },
140
140
  {
141
141
  "path": "harness-plan/checklist.md",
@@ -151,7 +151,7 @@
151
151
  },
152
152
  {
153
153
  "path": "harness-plan/SKILL.md",
154
- "sha256": "d42b3311fd19d2f7226e2cd72e4b5d97d53407e60ccba02ccec51e63c855fe60"
154
+ "sha256": "93e1449ebc172a0097b498a6b6d9268590ef72ccbf75f9b957634468696fd0b5"
155
155
  },
156
156
  {
157
157
  "path": "harness-review/checklist.md",
@@ -167,11 +167,11 @@
167
167
  },
168
168
  {
169
169
  "path": "harness-review/SKILL.md",
170
- "sha256": "a5a6e53df88bf2d00441f74f0e8c0a7c7b6281ee085ebb337f03c42529e11476"
170
+ "sha256": "e9c51dd7ddcbb9ebb9bbdcbb2d1a05e26c1338733348343dd95179b290eac23b"
171
171
  },
172
172
  {
173
173
  "path": "harness-run/checklist.md",
174
- "sha256": "8f8be29c43b2a37885d0ef729ca4a1cb748869d65de0498b0e38f3e1cc7f317a"
174
+ "sha256": "62063fd4c20a12eb9295fb5bade31e10adb2f5a4fd8600446b2109b959c82961"
175
175
  },
176
176
  {
177
177
  "path": "harness-run/protocols.md",
@@ -183,11 +183,11 @@
183
183
  },
184
184
  {
185
185
  "path": "harness-run/SKILL.md",
186
- "sha256": "bd353d21a0ca8b4d0b90eb059f1d9c716cfe2b86ba90a204b1999c4063174eb0"
186
+ "sha256": "5768720e3d4c3bf4b88879357bc769cc53a5507bac209af6d7eb340108958b69"
187
187
  },
188
188
  {
189
189
  "path": "harness-submit/checklist.md",
190
- "sha256": "2ebc0bc1ac5ce8cf13760ca967870b318633adaebbe0492a99152497d3285582"
190
+ "sha256": "1bf4a0dce64db7b977222f0cb2f2830543fc2a662ea1b8351069e25bbf823c15"
191
191
  },
192
192
  {
193
193
  "path": "harness-submit/reference.md",
@@ -195,7 +195,7 @@
195
195
  },
196
196
  {
197
197
  "path": "harness-submit/SKILL.md",
198
- "sha256": "e709b820e4ab0890cd9433a0b773a0f3a8838f84c89c3238e8082b13257e2d66"
198
+ "sha256": "8f91e881c08635bda10b8205075a071724e33aae1afa326583f0753c07445d77"
199
199
  },
200
200
  {
201
201
  "path": "harness-sync/reference.md",
@@ -203,11 +203,11 @@
203
203
  },
204
204
  {
205
205
  "path": "harness-sync/SKILL.md",
206
- "sha256": "a464f31481c4f047df8d626a9f9e0b5cb2c98308a6e7ead4bd38154d3dfd4ff3"
206
+ "sha256": "438803003a681c3d46a59503ffdee78b9ee71ad7aaa7c6596a399d27618b1298"
207
207
  },
208
208
  {
209
209
  "path": "harness-test/checklist.md",
210
- "sha256": "5d7a734ba1832690bc9a405e062f83ae81a56b2c2d86d23e381c841b74c68ba1"
210
+ "sha256": "499bc792815fc364123452f81b00c4043211289538f6f7dd62d19355d60d2e9e"
211
211
  },
212
212
  {
213
213
  "path": "harness-test/pitfalls-java.md",
@@ -227,7 +227,7 @@
227
227
  },
228
228
  {
229
229
  "path": "harness-test/SKILL.md",
230
- "sha256": "4c411b5587863864f1114acc3288f827773b471e2b8d7dcd8d0992fdd6470b53"
230
+ "sha256": "ff247ca159b6b163d034a3e55e38d0d7488ca39f0519f401b6f5afa75ab1407d"
231
231
  },
232
232
  {
233
233
  "path": "protocols/archive-report-protocol.md",
@@ -241,6 +241,10 @@
241
241
  "path": "protocols/ledger-protocol.md",
242
242
  "sha256": "50f9deffcf71de009c56bd2cdd44fb05c7b18faf19ec56b00ff76e8ce897ecf7"
243
243
  },
244
+ {
245
+ "path": "protocols/model-routing-protocol.md",
246
+ "sha256": "1ce493d7dcc7a0c32b07b2d0118fdca40d72ca2487a63566f3c997293269f06e"
247
+ },
244
248
  {
245
249
  "path": "protocols/powershell-protocol.md",
246
250
  "sha256": "f723f18eee08125e75f387e655f7e604eb603f636cd6809dd6b5948748f32d04"
@@ -271,7 +275,7 @@
271
275
  },
272
276
  {
273
277
  "path": "scripts/harness_archive.py",
274
- "sha256": "739671addbac6096860342910dd046178db04d130b34df129667ddd3523449cb"
278
+ "sha256": "07594f290d6cb15602db231e92345fa239439efc9bd9120c6681bd49bf30f176"
275
279
  },
276
280
  {
277
281
  "path": "scripts/harness_change.py",
@@ -285,9 +289,13 @@
285
289
  "path": "scripts/harness_deploy.py",
286
290
  "sha256": "48a95b696cd4df411cc206b80b16b436018e7648bd2daa55f110ceee2e403271"
287
291
  },
292
+ {
293
+ "path": "scripts/harness_environment.py",
294
+ "sha256": "4f6269ef2e21cf9fc327a101cfa2f2eabce840242a718c548bf496ea924d43e9"
295
+ },
288
296
  {
289
297
  "path": "scripts/harness_events.py",
290
- "sha256": "dcc4c1e4c2967ec7a07c103890f45f2903fc2784adebe3d6c5ae8e92037efd4f"
298
+ "sha256": "e6dae6ccb341b22178bd9ef7578df85154c6e9a1d19c86e3769dc7098e50a546"
291
299
  },
292
300
  {
293
301
  "path": "scripts/harness_gate.py",
@@ -295,11 +303,15 @@
295
303
  },
296
304
  {
297
305
  "path": "scripts/harness_integration.py",
298
- "sha256": "ab963ef60b554118858124a6a8ed3af09bdc0bf78a873251825aee225ad77ad4"
306
+ "sha256": "78904ed2a6254be6671a2627863759c68a9576ef41584f423c5cde3faa6d6b25"
299
307
  },
300
308
  {
301
309
  "path": "scripts/harness_ledger.py",
302
- "sha256": "7885b89510a8975c93fe367f9e557735ed70eb6d913f302b6aea3fa193af0f23"
310
+ "sha256": "11340d0e84fc3905d2d7383683ac94d2b9ab13655e56a26e460d7e9b0b515f1a"
311
+ },
312
+ {
313
+ "path": "scripts/harness_migration_head.py",
314
+ "sha256": "6bce06ce5c077185d6e40e1655c37ef98b2f8e6e39d64b2f3f3c45f12854ed51"
303
315
  },
304
316
  {
305
317
  "path": "scripts/harness_paths.py",