@hunter-harness/workflow-harness 0.2.72 → 0.2.73

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 (174) 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 +3 -3
  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 +14 -10
  7. package/harness/bundles/general/claude-code/harness-plan/checklist.md +49 -9
  8. package/harness/bundles/general/claude-code/harness-plan/reference.md +83 -33
  9. package/harness/bundles/general/claude-code/harness-pull/SKILL.md +1 -1
  10. package/harness/bundles/general/claude-code/harness-push/SKILL.md +1 -1
  11. package/harness/bundles/general/claude-code/harness-review/SKILL.md +3 -3
  12. package/harness/bundles/general/claude-code/harness-run/SKILL.md +5 -5
  13. package/harness/bundles/general/claude-code/harness-run/checklist.md +4 -1
  14. package/harness/bundles/general/claude-code/harness-run/reference.md +3 -3
  15. package/harness/bundles/general/claude-code/harness-submit/SKILL.md +3 -3
  16. package/harness/bundles/general/claude-code/harness-sync/SKILL.md +1 -1
  17. package/harness/bundles/general/claude-code/harness-test/SKILL.md +3 -3
  18. package/harness/bundles/general/claude-code/scripts/harness_context.py +270 -0
  19. package/harness/bundles/general/claude-code/scripts/harness_gate.py +71 -2
  20. package/harness/bundles/general/claude-code/scripts/harness_test_guard.py +8 -5
  21. package/harness/bundles/general/codebuddy/.harness-build.json +1 -1
  22. package/harness/bundles/general/codebuddy/harness-archive/SKILL.md +3 -3
  23. package/harness/bundles/general/codebuddy/harness-codebase-map/SKILL.md +1 -1
  24. package/harness/bundles/general/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  25. package/harness/bundles/general/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  26. package/harness/bundles/general/codebuddy/harness-plan/SKILL.md +14 -10
  27. package/harness/bundles/general/codebuddy/harness-plan/checklist.md +49 -9
  28. package/harness/bundles/general/codebuddy/harness-plan/reference.md +83 -33
  29. package/harness/bundles/general/codebuddy/harness-pull/SKILL.md +1 -1
  30. package/harness/bundles/general/codebuddy/harness-push/SKILL.md +1 -1
  31. package/harness/bundles/general/codebuddy/harness-review/SKILL.md +3 -3
  32. package/harness/bundles/general/codebuddy/harness-run/SKILL.md +5 -5
  33. package/harness/bundles/general/codebuddy/harness-run/checklist.md +4 -1
  34. package/harness/bundles/general/codebuddy/harness-run/reference.md +3 -3
  35. package/harness/bundles/general/codebuddy/harness-submit/SKILL.md +3 -3
  36. package/harness/bundles/general/codebuddy/harness-sync/SKILL.md +1 -1
  37. package/harness/bundles/general/codebuddy/harness-test/SKILL.md +3 -3
  38. package/harness/bundles/general/codebuddy/scripts/harness_context.py +270 -0
  39. package/harness/bundles/general/codebuddy/scripts/harness_gate.py +71 -2
  40. package/harness/bundles/general/codebuddy/scripts/harness_test_guard.py +8 -5
  41. package/harness/bundles/general/codex/.harness-build.json +1 -1
  42. package/harness/bundles/general/codex/harness-archive/SKILL.md +3 -3
  43. package/harness/bundles/general/codex/harness-codebase-map/SKILL.md +1 -1
  44. package/harness/bundles/general/codex/harness-knowledge-ingest/SKILL.md +1 -1
  45. package/harness/bundles/general/codex/harness-knowledge-query/SKILL.md +1 -1
  46. package/harness/bundles/general/codex/harness-plan/SKILL.md +14 -10
  47. package/harness/bundles/general/codex/harness-plan/checklist.md +49 -9
  48. package/harness/bundles/general/codex/harness-plan/reference.md +83 -33
  49. package/harness/bundles/general/codex/harness-pull/SKILL.md +1 -1
  50. package/harness/bundles/general/codex/harness-push/SKILL.md +1 -1
  51. package/harness/bundles/general/codex/harness-review/SKILL.md +3 -3
  52. package/harness/bundles/general/codex/harness-run/SKILL.md +5 -5
  53. package/harness/bundles/general/codex/harness-run/checklist.md +4 -1
  54. package/harness/bundles/general/codex/harness-run/reference.md +3 -3
  55. package/harness/bundles/general/codex/harness-submit/SKILL.md +3 -3
  56. package/harness/bundles/general/codex/harness-sync/SKILL.md +1 -1
  57. package/harness/bundles/general/codex/harness-test/SKILL.md +3 -3
  58. package/harness/bundles/general/codex/scripts/harness_context.py +270 -0
  59. package/harness/bundles/general/codex/scripts/harness_gate.py +71 -2
  60. package/harness/bundles/general/codex/scripts/harness_test_guard.py +8 -5
  61. package/harness/bundles/general/cursor/.harness-build.json +1 -1
  62. package/harness/bundles/general/cursor/harness-archive/SKILL.md +3 -3
  63. package/harness/bundles/general/cursor/harness-codebase-map/SKILL.md +1 -1
  64. package/harness/bundles/general/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  65. package/harness/bundles/general/cursor/harness-knowledge-query/SKILL.md +1 -1
  66. package/harness/bundles/general/cursor/harness-plan/SKILL.md +14 -10
  67. package/harness/bundles/general/cursor/harness-plan/checklist.md +49 -9
  68. package/harness/bundles/general/cursor/harness-plan/reference.md +83 -33
  69. package/harness/bundles/general/cursor/harness-pull/SKILL.md +1 -1
  70. package/harness/bundles/general/cursor/harness-push/SKILL.md +1 -1
  71. package/harness/bundles/general/cursor/harness-review/SKILL.md +3 -3
  72. package/harness/bundles/general/cursor/harness-run/SKILL.md +5 -5
  73. package/harness/bundles/general/cursor/harness-run/checklist.md +4 -1
  74. package/harness/bundles/general/cursor/harness-run/reference.md +3 -3
  75. package/harness/bundles/general/cursor/harness-submit/SKILL.md +3 -3
  76. package/harness/bundles/general/cursor/harness-sync/SKILL.md +1 -1
  77. package/harness/bundles/general/cursor/harness-test/SKILL.md +3 -3
  78. package/harness/bundles/general/cursor/scripts/harness_context.py +270 -0
  79. package/harness/bundles/general/cursor/scripts/harness_gate.py +71 -2
  80. package/harness/bundles/general/cursor/scripts/harness_test_guard.py +8 -5
  81. package/harness/bundles/java/claude-code/.harness-build.json +1 -1
  82. package/harness/bundles/java/claude-code/harness-apidoc/SKILL.md +3 -3
  83. package/harness/bundles/java/claude-code/harness-archive/SKILL.md +3 -3
  84. package/harness/bundles/java/claude-code/harness-codebase-map/SKILL.md +1 -1
  85. package/harness/bundles/java/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
  86. package/harness/bundles/java/claude-code/harness-knowledge-query/SKILL.md +1 -1
  87. package/harness/bundles/java/claude-code/harness-package/SKILL.md +3 -3
  88. package/harness/bundles/java/claude-code/harness-plan/SKILL.md +14 -10
  89. package/harness/bundles/java/claude-code/harness-plan/checklist.md +49 -9
  90. package/harness/bundles/java/claude-code/harness-plan/reference.md +83 -33
  91. package/harness/bundles/java/claude-code/harness-pull/SKILL.md +1 -1
  92. package/harness/bundles/java/claude-code/harness-push/SKILL.md +1 -1
  93. package/harness/bundles/java/claude-code/harness-review/SKILL.md +3 -3
  94. package/harness/bundles/java/claude-code/harness-run/SKILL.md +5 -5
  95. package/harness/bundles/java/claude-code/harness-run/checklist.md +1 -1
  96. package/harness/bundles/java/claude-code/harness-submit/SKILL.md +3 -3
  97. package/harness/bundles/java/claude-code/harness-sync/SKILL.md +1 -1
  98. package/harness/bundles/java/claude-code/harness-test/SKILL.md +3 -3
  99. package/harness/bundles/java/claude-code/scripts/harness_context.py +270 -0
  100. package/harness/bundles/java/claude-code/scripts/harness_gate.py +71 -2
  101. package/harness/bundles/java/claude-code/scripts/harness_test_guard.py +8 -5
  102. package/harness/bundles/java/codebuddy/.harness-build.json +1 -1
  103. package/harness/bundles/java/codebuddy/harness-apidoc/SKILL.md +3 -3
  104. package/harness/bundles/java/codebuddy/harness-archive/SKILL.md +3 -3
  105. package/harness/bundles/java/codebuddy/harness-codebase-map/SKILL.md +1 -1
  106. package/harness/bundles/java/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  107. package/harness/bundles/java/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  108. package/harness/bundles/java/codebuddy/harness-package/SKILL.md +3 -3
  109. package/harness/bundles/java/codebuddy/harness-plan/SKILL.md +14 -10
  110. package/harness/bundles/java/codebuddy/harness-plan/checklist.md +49 -9
  111. package/harness/bundles/java/codebuddy/harness-plan/reference.md +83 -33
  112. package/harness/bundles/java/codebuddy/harness-pull/SKILL.md +1 -1
  113. package/harness/bundles/java/codebuddy/harness-push/SKILL.md +1 -1
  114. package/harness/bundles/java/codebuddy/harness-review/SKILL.md +3 -3
  115. package/harness/bundles/java/codebuddy/harness-run/SKILL.md +5 -5
  116. package/harness/bundles/java/codebuddy/harness-run/checklist.md +1 -1
  117. package/harness/bundles/java/codebuddy/harness-submit/SKILL.md +3 -3
  118. package/harness/bundles/java/codebuddy/harness-sync/SKILL.md +1 -1
  119. package/harness/bundles/java/codebuddy/harness-test/SKILL.md +3 -3
  120. package/harness/bundles/java/codebuddy/scripts/harness_context.py +270 -0
  121. package/harness/bundles/java/codebuddy/scripts/harness_gate.py +71 -2
  122. package/harness/bundles/java/codebuddy/scripts/harness_test_guard.py +8 -5
  123. package/harness/bundles/java/codex/.harness-build.json +1 -1
  124. package/harness/bundles/java/codex/harness-apidoc/SKILL.md +3 -3
  125. package/harness/bundles/java/codex/harness-archive/SKILL.md +3 -3
  126. package/harness/bundles/java/codex/harness-codebase-map/SKILL.md +1 -1
  127. package/harness/bundles/java/codex/harness-knowledge-ingest/SKILL.md +1 -1
  128. package/harness/bundles/java/codex/harness-knowledge-query/SKILL.md +1 -1
  129. package/harness/bundles/java/codex/harness-package/SKILL.md +3 -3
  130. package/harness/bundles/java/codex/harness-plan/SKILL.md +14 -10
  131. package/harness/bundles/java/codex/harness-plan/checklist.md +49 -9
  132. package/harness/bundles/java/codex/harness-plan/reference.md +83 -33
  133. package/harness/bundles/java/codex/harness-pull/SKILL.md +1 -1
  134. package/harness/bundles/java/codex/harness-push/SKILL.md +1 -1
  135. package/harness/bundles/java/codex/harness-review/SKILL.md +3 -3
  136. package/harness/bundles/java/codex/harness-run/SKILL.md +5 -5
  137. package/harness/bundles/java/codex/harness-run/checklist.md +1 -1
  138. package/harness/bundles/java/codex/harness-submit/SKILL.md +3 -3
  139. package/harness/bundles/java/codex/harness-sync/SKILL.md +1 -1
  140. package/harness/bundles/java/codex/harness-test/SKILL.md +3 -3
  141. package/harness/bundles/java/codex/scripts/harness_context.py +270 -0
  142. package/harness/bundles/java/codex/scripts/harness_gate.py +71 -2
  143. package/harness/bundles/java/codex/scripts/harness_test_guard.py +8 -5
  144. package/harness/bundles/java/cursor/.harness-build.json +1 -1
  145. package/harness/bundles/java/cursor/harness-apidoc/SKILL.md +3 -3
  146. package/harness/bundles/java/cursor/harness-archive/SKILL.md +3 -3
  147. package/harness/bundles/java/cursor/harness-codebase-map/SKILL.md +1 -1
  148. package/harness/bundles/java/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  149. package/harness/bundles/java/cursor/harness-knowledge-query/SKILL.md +1 -1
  150. package/harness/bundles/java/cursor/harness-package/SKILL.md +3 -3
  151. package/harness/bundles/java/cursor/harness-plan/SKILL.md +14 -10
  152. package/harness/bundles/java/cursor/harness-plan/checklist.md +49 -9
  153. package/harness/bundles/java/cursor/harness-plan/reference.md +83 -33
  154. package/harness/bundles/java/cursor/harness-pull/SKILL.md +1 -1
  155. package/harness/bundles/java/cursor/harness-push/SKILL.md +1 -1
  156. package/harness/bundles/java/cursor/harness-review/SKILL.md +3 -3
  157. package/harness/bundles/java/cursor/harness-run/SKILL.md +5 -5
  158. package/harness/bundles/java/cursor/harness-run/checklist.md +1 -1
  159. package/harness/bundles/java/cursor/harness-submit/SKILL.md +3 -3
  160. package/harness/bundles/java/cursor/harness-sync/SKILL.md +1 -1
  161. package/harness/bundles/java/cursor/harness-test/SKILL.md +3 -3
  162. package/harness/bundles/java/cursor/scripts/harness_context.py +270 -0
  163. package/harness/bundles/java/cursor/scripts/harness_gate.py +71 -2
  164. package/harness/bundles/java/cursor/scripts/harness_test_guard.py +8 -5
  165. package/harness/manifests/general/claude-code.json +22 -22
  166. package/harness/manifests/general/codebuddy.json +22 -22
  167. package/harness/manifests/general/codex.json +22 -22
  168. package/harness/manifests/general/cursor.json +22 -22
  169. package/harness/manifests/java/claude-code.json +23 -23
  170. package/harness/manifests/java/codebuddy.json +23 -23
  171. package/harness/manifests/java/codex.json +23 -23
  172. package/harness/manifests/java/cursor.json +23 -23
  173. package/hunter-workflow-family.json +5 -5
  174. package/package.json +1 -1
@@ -732,6 +732,16 @@ def prepare_context(
732
732
  )
733
733
  if not reselection.get("ok"):
734
734
  return reselection
735
+ # v2 计划的交接凭证由此补录:finalize 不写 context 事务,缺它 run 阶段进不去
736
+ if phase != "plan":
737
+ _bootstrap_v2_plan_transition(
738
+ project,
739
+ change,
740
+ contract_root=contract_root,
741
+ state_root=state_root,
742
+ to_phase=phase,
743
+ executor=executor,
744
+ )
735
745
  claim = _claim_prepared_context(
736
746
  project,
737
747
  change,
@@ -779,6 +789,150 @@ def prepare_context(
779
789
  }
780
790
 
781
791
 
792
+ def _plan_run_identity(change_dir: Path) -> tuple[str, int] | None:
793
+ """已存在的 plan `phase.start` 身份(run-id, attempt)。
794
+
795
+ finalize 按生命周期身份 fail-closed:重跑引导时换一个 run-id,整条链路就对不上。
796
+ 因此引导必须复用已有身份,而不是每次新生成。
797
+ """
798
+ for item in reversed(_read_ndjson(change_dir / "events.ndjson")):
799
+ if item.get("phase") != "plan" or item.get("type") != "phase.start":
800
+ continue
801
+ run_id = item.get("run_id")
802
+ if isinstance(run_id, str) and run_id:
803
+ attempt = item.get("attempt")
804
+ return run_id, attempt if isinstance(attempt, int) and attempt > 0 else 1
805
+ return None
806
+
807
+
808
+ def bootstrap_plan(
809
+ project: Path,
810
+ *,
811
+ change: str,
812
+ executor: str,
813
+ display_title: str | None = None,
814
+ stage: str = "plan",
815
+ ttl_seconds: int = 3600,
816
+ ) -> dict[str, Any]:
817
+ """阶段 0 一次性引导:doctor + prepare + capture + classify + phase.start。
818
+
819
+ 拆成五条子进程调用时,每条的完整 argv 都要调用方记住(少 `--project` 或
820
+ `--change-dir` 就白跑一轮),run-id 还要调用方自己保证小写字母开头。这些都是
821
+ 确定性工作,交给脚本做;调用方只需要一次调用和一份紧凑摘要。
822
+
823
+ 重跑安全:已有 plan `phase.start` 时复用同一 run-id / attempt,不追加第二条。
824
+ """
825
+ import uuid
826
+
827
+ import harness_change as hchg
828
+ import harness_events as he
829
+ import harness_gate as hg
830
+ import harness_runtime as hr
831
+ import harness_state as hs
832
+
833
+ project = Path(project).resolve()
834
+ changes_root = project / ".harness" / "changes"
835
+ if not changes_root.is_dir():
836
+ return {
837
+ "ok": False,
838
+ "code": "PROJECT_ROOT_INVALID",
839
+ "error": f"{changes_root} 不存在——先在该项目运行 hunter-harness init",
840
+ }
841
+
842
+ # 新 change 的目录此前没有任何脚本负责创建,靠的是后续 Write 的副作用;
843
+ # 引导阶段显式建立骨架,prepare 才有 contract 可读
844
+ change_dir = changes_root / change
845
+ created_change = not change_dir.is_dir()
846
+ if created_change:
847
+ (change_dir / "meta").mkdir(parents=True, exist_ok=True)
848
+ hchg.migrate_change(project, change)
849
+
850
+ prepared = prepare_context(
851
+ project,
852
+ phase="plan",
853
+ executor=executor,
854
+ change=change,
855
+ display_title=display_title,
856
+ ttl_seconds=ttl_seconds,
857
+ )
858
+ if not prepared.get("ok"):
859
+ return prepared
860
+
861
+ change_name = str(prepared["changeName"])
862
+ # executionRoot 是代码执行根(无 worktree 时等于项目根),change_dir 才是状态目录。
863
+ # 计划产物一律落 change_dir,混用会把 gate-policy/events 写到项目根去。
864
+ change_dir = (changes_root / change_name).resolve()
865
+ execution_root = Path(prepared["executionRoot"])
866
+
867
+ # doctor 失败不阻断引导:它是环境体检,结论随摘要返回给调用方判断
868
+ try:
869
+ health = hr.doctor(project, change_dir, agent=executor)
870
+ except Exception as exc: # noqa: BLE001 - 体检失败要报告而不是中断引导
871
+ health = {"ok": False, "code": "DOCTOR_FAILED", "error": str(exc)}
872
+
873
+ # 首次 capture 把当时的 HEAD 固定为不可变 changeBase(design §3.6)
874
+ snapshot, changed_segments = hs.capture_current_state(
875
+ project=project,
876
+ change_dir=change_dir,
877
+ change_name=change_name,
878
+ worktree_root=project,
879
+ )
880
+ git_state = snapshot.get("git") or {}
881
+
882
+ workflow = hg._load_workflow_policy(project=project)
883
+ classification = hg.classify_risk(change_dir, stage, workflow=workflow)
884
+ classification.setdefault("tierOverride", None)
885
+ classification["classifiedAt"] = _now().isoformat().replace("+00:00", "Z")
886
+ policy_path = change_dir / "meta" / "gate-policy.json"
887
+ hg._write_json(policy_path, hg.gate_policy_document(classification))
888
+
889
+ identity = _plan_run_identity(change_dir)
890
+ reused = identity is not None
891
+ if identity is None:
892
+ # v2 identity:必须小写字母开头,裸 UUID 有 10/16 概率数字开头被拒
893
+ run_id = f"plan_{uuid.uuid4()}"
894
+ attempt = 1
895
+ appended = he.append_event(
896
+ change_dir,
897
+ phase="plan",
898
+ type_="phase.start",
899
+ run_id=run_id,
900
+ attempt=attempt,
901
+ executor_tool=executor,
902
+ note=f"/harness-plan 引导:{change_name}",
903
+ )
904
+ if not appended.get("ok", True):
905
+ return appended
906
+ else:
907
+ run_id, attempt = identity
908
+
909
+ return {
910
+ "ok": True,
911
+ "code": "PLAN_BOOTSTRAPPED",
912
+ "changeName": change_name,
913
+ "displayTitle": prepared.get("displayTitle"),
914
+ "changeCreated": created_change,
915
+ "changeDir": str(change_dir),
916
+ "executionRoot": str(execution_root),
917
+ "runId": run_id,
918
+ "attempt": attempt,
919
+ "reused": reused,
920
+ "tier": classification.get("tier"),
921
+ "tierSource": classification.get("source"),
922
+ "defaultPhases": list(classification.get("defaultPhases") or []),
923
+ "conditionalPhases": list(classification.get("conditionalPhases") or []),
924
+ "requiredValidations": list(classification.get("requiredValidations") or []),
925
+ "gatePolicyPath": str(policy_path),
926
+ "plannedPhases": prepared.get("plannedPhases"),
927
+ "changeBase": git_state.get("base"),
928
+ "head": git_state.get("head"),
929
+ "changedSegments": sorted(changed_segments),
930
+ "legacyBootstrap": prepared.get("legacyBootstrap"),
931
+ "doctorOk": bool(health.get("ok", True)),
932
+ "doctor": health,
933
+ }
934
+
935
+
782
936
  def _invalidate_for_fixback(
783
937
  state_root: Path,
784
938
  *,
@@ -808,6 +962,90 @@ def _invalidate_for_fixback(
808
962
  return record
809
963
 
810
964
 
965
+ def _committed_publication_journal(contract_root: Path) -> Path | None:
966
+ """已 committed 的 v2 发布 journal —— plan 确实完成的机器证据。"""
967
+ journal_dir = contract_root / "meta" / "publication-journals"
968
+ if not journal_dir.is_dir():
969
+ return None
970
+ for path in sorted(journal_dir.glob("*.json")):
971
+ try:
972
+ payload = _read_json(path)
973
+ except (OSError, ValueError, json.JSONDecodeError):
974
+ continue
975
+ if isinstance(payload, dict) and payload.get("state") == "committed":
976
+ return path
977
+ return None
978
+
979
+
980
+ def _published_plan_artifacts(project: Path, contract_root: Path, change: str) -> list[dict[str, Any]]:
981
+ """交接携带的 v2 发布产物(存在者入账,缺失者跳过)。"""
982
+ entries: list[dict[str, Any]] = []
983
+ for rel in (
984
+ f"plans/{change}-design.md",
985
+ f"plans/{change}-plan.md",
986
+ f"plans/{change}-implementation-detail.md",
987
+ f"plans/{change}-test-scenarios.md",
988
+ "meta/scenario-manifest.json",
989
+ ):
990
+ candidate = contract_root / rel
991
+ if candidate.is_file():
992
+ entries.append(
993
+ {
994
+ "path": candidate.resolve().relative_to(project).as_posix(),
995
+ "sha256": _sha256(candidate),
996
+ }
997
+ )
998
+ return entries
999
+
1000
+
1001
+ def _bootstrap_v2_plan_transition(
1002
+ project: Path,
1003
+ change: str,
1004
+ *,
1005
+ contract_root: Path,
1006
+ state_root: Path,
1007
+ to_phase: str,
1008
+ executor: str,
1009
+ ) -> dict[str, Any] | None:
1010
+ """v2 发布已 committed 却没有交接凭证时,补录 plan → to_phase 凭证。
1011
+
1012
+ v2 plan finalize 只写 plan-events.ndjson 与发布 journal,不碰 context 事务
1013
+ 存储,于是 run 阶段 prepare 必报 HANDOFF_REQUIRED、begin 必报
1014
+ LEGACY_BOOTSTRAP_REQUIRED——两个错误都不给恢复路径,调用方只能读脚本源码
1015
+ 自己拼出 classify + configure-plan + close,参数全靠现编,可审计性更差。
1016
+
1017
+ committed 的发布 journal 是比人工 close 更强的完成证据:据此补录,并在凭证上
1018
+ 留 bootstrapSource/bootstrapEvidence,事后能与人工 close 区分。没有该证据时
1019
+ 返回 None,交接继续 fail-closed。
1020
+ """
1021
+ paths = _paths(state_root)
1022
+ if _read_ndjson(paths["transitions"]):
1023
+ return None
1024
+ if to_phase not in _allowed_next_phases(contract_root, "plan"):
1025
+ return None
1026
+ journal = _committed_publication_journal(contract_root)
1027
+ if journal is None:
1028
+ return None
1029
+ receipt: dict[str, Any] = {
1030
+ "schemaVersion": 1,
1031
+ "changeName": change,
1032
+ "fromPhase": "plan",
1033
+ "toPhase": to_phase,
1034
+ "status": "OK",
1035
+ "executor": executor,
1036
+ "productCommit": _head(project),
1037
+ "artifacts": _published_plan_artifacts(project, contract_root, change),
1038
+ "attempt": 1,
1039
+ "closedAt": _now().isoformat(),
1040
+ "previousReceiptHash": None,
1041
+ "bootstrapSource": "plan_publication_journal",
1042
+ "bootstrapEvidence": journal.resolve().relative_to(project).as_posix(),
1043
+ }
1044
+ receipt["receiptHash"] = _payload_hash(receipt)
1045
+ _append_ndjson(paths["transitions"], receipt)
1046
+ return receipt
1047
+
1048
+
811
1049
  def close_transition(
812
1050
  project: Path,
813
1051
  change: str,
@@ -1007,11 +1245,26 @@ def _begin_transition_unlocked(
1007
1245
  "message": "本次修复准备凭证与当前上下文不一致,未启动新阶段。",
1008
1246
  }
1009
1247
  transitions = _read_ndjson(paths["transitions"])
1248
+ if not transitions and phase != "plan":
1249
+ # prepare 之外的入口(或跳过了 prepare)同样要能从发布证据恢复
1250
+ _bootstrap_v2_plan_transition(
1251
+ project,
1252
+ change,
1253
+ contract_root=contract_root,
1254
+ state_root=state_root,
1255
+ to_phase=phase,
1256
+ executor=executor,
1257
+ )
1258
+ transitions = _read_ndjson(paths["transitions"])
1010
1259
  if not transitions:
1011
1260
  return {
1012
1261
  "ok": False,
1013
1262
  "code": "LEGACY_BOOTSTRAP_REQUIRED",
1014
1263
  "legacyBootstrap": True,
1264
+ "message": (
1265
+ "没有交接凭证。v2 计划应有 committed 的 meta/publication-journals/*.json "
1266
+ "作为补录证据;legacy 计划需先完成 plan 阶段的 close"
1267
+ ),
1015
1268
  }
1016
1269
  receipt = transitions[-1]
1017
1270
  if receipt.get("toPhase") != phase:
@@ -1256,6 +1509,14 @@ def build_parser() -> argparse.ArgumentParser:
1256
1509
  prepare.add_argument("--title")
1257
1510
  prepare.add_argument("--ttl-seconds", type=int, default=3600)
1258
1511
  prepare.add_argument("--trigger", choices=["review-fixback"])
1512
+ bootstrap = sub.add_parser("bootstrap-plan")
1513
+ bootstrap.add_argument("--json", action="store_true")
1514
+ bootstrap.add_argument("--project", required=True, type=Path)
1515
+ bootstrap.add_argument("--change", required=True)
1516
+ bootstrap.add_argument("--executor", required=True)
1517
+ bootstrap.add_argument("--title")
1518
+ bootstrap.add_argument("--stage", default="plan", choices=["plan", "post-run"])
1519
+ bootstrap.add_argument("--ttl-seconds", type=int, default=3600)
1259
1520
  close = sub.add_parser("close")
1260
1521
  close.add_argument("--json", action="store_true")
1261
1522
  close.add_argument("--project", required=True, type=Path)
@@ -1297,6 +1558,15 @@ def main(argv: list[str] | None = None) -> int:
1297
1558
  ttl_seconds=args.ttl_seconds,
1298
1559
  trigger=args.trigger,
1299
1560
  )
1561
+ elif args.command == "bootstrap-plan":
1562
+ result = bootstrap_plan(
1563
+ args.project,
1564
+ change=args.change,
1565
+ executor=args.executor,
1566
+ display_title=args.title,
1567
+ stage=args.stage,
1568
+ ttl_seconds=args.ttl_seconds,
1569
+ )
1300
1570
  elif args.command == "close":
1301
1571
  result = close_transition(
1302
1572
  args.project,
@@ -2024,6 +2024,70 @@ def _deferred_hint(deferred_ids: list[str], phase: str | None) -> str:
2024
2024
  )
2025
2025
 
2026
2026
 
2027
+ _PROJECT_ROOT_HELP = (
2028
+ "project root PATH (defaults to resolving from CWD). Takes a path, not a project name."
2029
+ )
2030
+
2031
+
2032
+ def _resolve_project(args: argparse.Namespace) -> Path:
2033
+ """--project 优先,未给时按 CWD 解析主项目根。
2034
+
2035
+ 其他 harness 脚本都把 --project 当项目根且列为必填,只有 gate 例外——调用方
2036
+ 按惯例传过来会被 argparse 拒掉。注意 begin/close 的 --project 是另一层语义
2037
+ (本阶段执行根/worktree),本函数只服务 classify/checkpoint。
2038
+ """
2039
+ raw = getattr(args, "project", None)
2040
+ if raw:
2041
+ return Path(raw).expanduser().resolve()
2042
+ return hc.resolve_main_project_root()
2043
+
2044
+
2045
+ # 门禁消费的场景字段。v2 plan finalize 派生的 scenario_manifest 一个都没有:
2046
+ # 它只带 scenario_id/coverage_dimension/execution_level/evidence_requirements/
2047
+ # risk_level/task_refs/requirement_refs。
2048
+ _V2_MANIFEST_REQUIRED_FIELDS = (
2049
+ "id",
2050
+ "priority",
2051
+ "requiredEvidenceKind",
2052
+ "ownerPhase",
2053
+ "executableTestId",
2054
+ "testFile",
2055
+ "testTitle",
2056
+ )
2057
+
2058
+
2059
+ def _v2_artifact_manifest_gap(manifest: Any) -> dict[str, Any] | None:
2060
+ """v2 plan artifact 包装的 scenario-manifest → 明确的不可消费错误。
2061
+
2062
+ 不能"解包 + 字段改名"了事:包装体里既没有 priority 也没有
2063
+ requiredEvidenceKind,`required_ids` 会算成空集,C9 随即返回
2064
+ NO_LEDGER_REQUIRED_SCENARIOS——那是把证据门禁对所有 v2 计划静默关掉,
2065
+ 比直接失败危险得多。所以这里点名缺口,让调用方回规划阶段补齐后重新发布。
2066
+
2067
+ v2 场景契约补齐这些字段后,解包逻辑加在这里。
2068
+ """
2069
+ if not isinstance(manifest, dict) or manifest.get("artifact_type") != "scenario_manifest":
2070
+ return None
2071
+ content = manifest.get("content")
2072
+ present: set[str] = set()
2073
+ if isinstance(content, dict) and isinstance(content.get("scenarios"), list):
2074
+ for scenario in content["scenarios"]:
2075
+ if isinstance(scenario, dict):
2076
+ present.update(scenario.keys())
2077
+ return {
2078
+ "ok": False,
2079
+ "code": "SCENARIO_MANIFEST_V2_UNSUPPORTED",
2080
+ "message": (
2081
+ "meta/scenario-manifest.json 是 v2 plan artifact 包装体,缺少门禁消费的场景字段;"
2082
+ "请在规划阶段补齐后重新发布,不要手改派生产物"
2083
+ ),
2084
+ "missingFields": [
2085
+ field for field in _V2_MANIFEST_REQUIRED_FIELDS if field not in present
2086
+ ],
2087
+ "artifactType": "scenario_manifest",
2088
+ }
2089
+
2090
+
2027
2091
  def _validate_scenario_coverage(
2028
2092
  change_dir: Path, phase: str | None = None
2029
2093
  ) -> dict[str, Any]:
@@ -2050,6 +2114,9 @@ def _validate_scenario_coverage(
2050
2114
  "code": "SCENARIO_MANIFEST_INVALID",
2051
2115
  "message": f"scenario-manifest.json unreadable: {exc}",
2052
2116
  }
2117
+ v2_gap = _v2_artifact_manifest_gap(manifest)
2118
+ if v2_gap is not None:
2119
+ return v2_gap
2053
2120
  scenarios = manifest.get("scenarios") if isinstance(manifest, dict) else None
2054
2121
  if not isinstance(scenarios, list):
2055
2122
  return {
@@ -3218,7 +3285,7 @@ def cmd_close(args: argparse.Namespace) -> int:
3218
3285
 
3219
3286
  def cmd_classify(args: argparse.Namespace) -> int:
3220
3287
  as_json = bool(args.json)
3221
- project = hc.resolve_main_project_root()
3288
+ project = _resolve_project(args)
3222
3289
  try:
3223
3290
  workflow = _load_workflow_policy(project=project)
3224
3291
  except (OSError, ValueError, hwp.PolicyValidationError) as exc:
@@ -3271,7 +3338,7 @@ def cmd_classify(args: argparse.Namespace) -> int:
3271
3338
 
3272
3339
  def cmd_checkpoint(args: argparse.Namespace) -> int:
3273
3340
  as_json = bool(args.json)
3274
- project = hc.resolve_main_project_root()
3341
+ project = _resolve_project(args)
3275
3342
  resolved = hc.resolve_change(project, args.change)
3276
3343
  if not resolved.get("ok"):
3277
3344
  return emit_error(
@@ -3425,6 +3492,7 @@ def build_parser() -> argparse.ArgumentParser:
3425
3492
  p_close.set_defaults(func=cmd_close)
3426
3493
 
3427
3494
  p_classify = sub.add_parser("classify", parents=[shared])
3495
+ p_classify.add_argument("--project", default=None, type=Path, help=_PROJECT_ROOT_HELP)
3428
3496
  p_classify.add_argument("--change", default=None)
3429
3497
  p_classify.add_argument("--stage", required=True, choices=["plan", "post-run"])
3430
3498
  p_classify.add_argument(
@@ -3436,6 +3504,7 @@ def build_parser() -> argparse.ArgumentParser:
3436
3504
  p_classify.set_defaults(func=cmd_classify)
3437
3505
 
3438
3506
  p_checkpoint = sub.add_parser("checkpoint", parents=[shared])
3507
+ p_checkpoint.add_argument("--project", default=None, type=Path, help=_PROJECT_ROOT_HELP)
3439
3508
  p_checkpoint.add_argument("checkpoint_action", choices=["status", "approve"])
3440
3509
  p_checkpoint.add_argument("--id", required=True)
3441
3510
  p_checkpoint.add_argument("--change", default=None)
@@ -332,12 +332,15 @@ def _matches_pattern(rel: str, pattern: str) -> bool:
332
332
 
333
333
 
334
334
  def _standard_test_path(rel: str) -> bool:
335
+ """路径中出现 test/tests 目录段即视为标准测试路径。
336
+
337
+ 此前只认 parts[0],于是 monorepo(packages/cli/tests/…)与"仓库根 + 同名
338
+ 子包"(kld-sdd/test/…)这类常见布局全被拒,调用方被迫先补 build-profile
339
+ 才能记录一次 stale-test-repair。段级匹配不放宽语义:testing/ 与
340
+ tests-helper/ 仍然不算,目录本身(末段)也不算文件。
341
+ """
335
342
  parts = rel.split("/")
336
- if len(parts) >= 2 and parts[0] in ("test", "tests"):
337
- return True
338
- if any(parts[index:index + 2] == ["src", "test"] for index in range(len(parts) - 1)):
339
- return True
340
- return False
343
+ return any(part in ("test", "tests") for part in parts[:-1])
341
344
 
342
345
 
343
346
  def _allowed_test_path(project: Path, rel: str) -> bool:
@@ -2,9 +2,9 @@
2
2
  "schema_version": 2,
3
3
  "profile": "general",
4
4
  "adapter": "claude-code",
5
- "bundle_version": "0.2.61",
5
+ "bundle_version": "0.2.62",
6
6
  "requires": {
7
- "minimumCliVersion": "0.2.80",
7
+ "minimumCliVersion": "0.2.83",
8
8
  "capabilities": [
9
9
  "sync@2",
10
10
  "rules-sync@1",
@@ -25,7 +25,7 @@
25
25
  "files": [
26
26
  {
27
27
  "path": ".harness-build.json",
28
- "sha256": "1cb4bc5f587d3c86cb1343d7c0a491dd9ef09b532a36c67bb3c5fe59750e2b34"
28
+ "sha256": "d9f35544ff9f74b44a07ac9b8ae6dc3ecf9aaf2f366e13002efea6f20f644f0c"
29
29
  },
30
30
  {
31
31
  "path": "agents/harness-evaluator.md",
@@ -97,7 +97,7 @@
97
97
  },
98
98
  {
99
99
  "path": "harness-archive/SKILL.md",
100
- "sha256": "e22e490c83330c513690b1a2425e0ce9c1aa8ed1526d87490e04558517d9d7ed"
100
+ "sha256": "99ddcf685d9018eddc846349f79510fa59700e06af332b2df48dbbcb839af002"
101
101
  },
102
102
  {
103
103
  "path": "harness-archive/templates/summary-data-template.json",
@@ -113,7 +113,7 @@
113
113
  },
114
114
  {
115
115
  "path": "harness-codebase-map/SKILL.md",
116
- "sha256": "794ecbc3eb5189a2777e8846e3b9eea0680cf4803aeb499976821707ec996e86"
116
+ "sha256": "9f73cbb074cc5c54db6a772622a1adc241c1334f7e16c982648186dc37f6c436"
117
117
  },
118
118
  {
119
119
  "path": "harness-codebase-map/templates/ARCHITECTURE.md",
@@ -153,15 +153,15 @@
153
153
  },
154
154
  {
155
155
  "path": "harness-knowledge-ingest/SKILL.md",
156
- "sha256": "f26d3b127970ad4a7107c54bffd5bd3727896fc024fa6bcc8de34264b4e70bad"
156
+ "sha256": "03182c4ea100bb48a7ffa595dac1dc92106efb71da7d26b6c899b83c6c1d6553"
157
157
  },
158
158
  {
159
159
  "path": "harness-knowledge-query/SKILL.md",
160
- "sha256": "ad68f04996900d3024afa45c8bd53f76ddf5866df648f1fd4d502a8fd093bc52"
160
+ "sha256": "305b8a05b1badf948ffa31d3085604383ff64cc4e215918261a27392f6066cc0"
161
161
  },
162
162
  {
163
163
  "path": "harness-plan/checklist.md",
164
- "sha256": "03584061a5d51b9c4349f13cbe66e757dd29bfc64ed6a4510f0bd731afd76568"
164
+ "sha256": "31c66e6e08595d6d97e5f57fcd6d99ced5b721b82c122fbb26bb8fba34c23d90"
165
165
  },
166
166
  {
167
167
  "path": "harness-plan/protocols.md",
@@ -169,19 +169,19 @@
169
169
  },
170
170
  {
171
171
  "path": "harness-plan/reference.md",
172
- "sha256": "e06263459603bba4be15f66455154836dc693c5d3f943abeb6774b30dbe304c7"
172
+ "sha256": "197f5b764d1054ef401f61f95055b468ab2a0c66ad482efc50a014ab7ea89711"
173
173
  },
174
174
  {
175
175
  "path": "harness-plan/SKILL.md",
176
- "sha256": "70df69ea0d39d0536ede8924a18df318a23731cae42175675dab5c26e321146a"
176
+ "sha256": "1c057efcdd31c03b44c8641067e7115732dfd6f0b8778224515bcbdfa5b3f7e3"
177
177
  },
178
178
  {
179
179
  "path": "harness-pull/SKILL.md",
180
- "sha256": "473133fca35a1b072077e5831ac72b88585fc89ac5779aea953d1cbadbe26a6c"
180
+ "sha256": "7de117584827afe783f4b1f7920c6cd056b845ff25d22519c1863ac59bc940a1"
181
181
  },
182
182
  {
183
183
  "path": "harness-push/SKILL.md",
184
- "sha256": "c1d0d48f32ce5eb6ccd580af72aded0ee3c8c90d79e8dad9a87a38a8fc4bf3d8"
184
+ "sha256": "777e071dbf7505c796c7e6d83ea1c3698d9b60b69a44ea4383c61ee25bae8fa7"
185
185
  },
186
186
  {
187
187
  "path": "harness-review/checklist.md",
@@ -197,11 +197,11 @@
197
197
  },
198
198
  {
199
199
  "path": "harness-review/SKILL.md",
200
- "sha256": "b92669096aa68db0b90bc8d64156c032e8414407c42e49ae7f9579331cb7db0b"
200
+ "sha256": "58f7ac2a668551202c434f62d647030049447d048c78206d4e32aca0901b4d73"
201
201
  },
202
202
  {
203
203
  "path": "harness-run/checklist.md",
204
- "sha256": "76d32970de25d4d56a04c6935846eabd37bc16767bccd979f9f3fdcbd5d39dd7"
204
+ "sha256": "3a184c988613c5c083767cc4f31f3670502e4810d0f8475c9a3aeec2acc7fe28"
205
205
  },
206
206
  {
207
207
  "path": "harness-run/protocols.md",
@@ -209,11 +209,11 @@
209
209
  },
210
210
  {
211
211
  "path": "harness-run/reference.md",
212
- "sha256": "a11250b12193017d716358c64338685218d4dc1c7022969eb3b52c48d9a2ff00"
212
+ "sha256": "3b670f0dda55d9ce615a75ddba9d750476e06164c33a91c73bac88ab2ff0c5ab"
213
213
  },
214
214
  {
215
215
  "path": "harness-run/SKILL.md",
216
- "sha256": "75eaa7f777c24ae00e3edabcb33314a7c1f5fc23711c00a5fc7ecb021ffe938d"
216
+ "sha256": "1408e8b112356317efa283c57d393d06a898929c4cfd2072679700bc9715fe37"
217
217
  },
218
218
  {
219
219
  "path": "harness-submit/checklist.md",
@@ -225,7 +225,7 @@
225
225
  },
226
226
  {
227
227
  "path": "harness-submit/SKILL.md",
228
- "sha256": "2aa02e05e6aa712327292ca8e5e746e61225ed1c4712dcc31289afb31914eb40"
228
+ "sha256": "8f8ce128909a19a64e7ca1ab000e31eb5f88191b8ff14de00b1b36ad1c766386"
229
229
  },
230
230
  {
231
231
  "path": "harness-sync/reference.md",
@@ -233,7 +233,7 @@
233
233
  },
234
234
  {
235
235
  "path": "harness-sync/SKILL.md",
236
- "sha256": "237f99046fa34030c96ab73031bc629eee2ec8a2538220819f382dd7e4da9b14"
236
+ "sha256": "ef000e9678579ea6ef54659e27cc388a395010dcf5cf6828d832eb0b3d6098b8"
237
237
  },
238
238
  {
239
239
  "path": "harness-test/checklist.md",
@@ -257,7 +257,7 @@
257
257
  },
258
258
  {
259
259
  "path": "harness-test/SKILL.md",
260
- "sha256": "3e64d3238a2da4c7d027b46abdb0a0bfe9c75b415548b6b01bec12061771de5f"
260
+ "sha256": "5b81b3dbaac69c614af08799b020b315da8b20edd80a570646aaa3f571a173e4"
261
261
  },
262
262
  {
263
263
  "path": "protocols/archive-report-protocol.md",
@@ -341,7 +341,7 @@
341
341
  },
342
342
  {
343
343
  "path": "scripts/harness_context.py",
344
- "sha256": "c3b4be68cf0034e30199e1cffb8a03c74e5d95267095b737a55bf6d96c1c1df3"
344
+ "sha256": "352ab9104dd4821930311411c353fe0b98e02ef0833f4f4ccf4f4190a5cb4eeb"
345
345
  },
346
346
  {
347
347
  "path": "scripts/harness_deploy.py",
@@ -373,7 +373,7 @@
373
373
  },
374
374
  {
375
375
  "path": "scripts/harness_gate.py",
376
- "sha256": "0a226076091d9c1d715a48164dfc0ca123e1839a47753f826729bfca4e327c7f"
376
+ "sha256": "390d03d088df4c164e03bf78b36515a71b41ff7b429e55a571d40b06b456c2b6"
377
377
  },
378
378
  {
379
379
  "path": "scripts/harness_headless.py",
@@ -457,7 +457,7 @@
457
457
  },
458
458
  {
459
459
  "path": "scripts/harness_test_guard.py",
460
- "sha256": "1b4420875a4dc2cfa14dd75b5a8bd4bf4da230bf916651262ae61f7ab5386a08"
460
+ "sha256": "a78392a115ba761581870aae54b2426e8e1d43a0e4749feb1e851786de2ddad6"
461
461
  },
462
462
  {
463
463
  "path": "scripts/harness_test_runner.py",