@hunter-harness/workflow-harness 0.2.14 → 0.2.15

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 (166) 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 +1 -1
  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-run/reference.md +3 -1
  10. package/harness/bundles/general/claude-code/harness-submit/SKILL.md +1 -1
  11. package/harness/bundles/general/claude-code/harness-sync/SKILL.md +1 -1
  12. package/harness/bundles/general/claude-code/harness-test/SKILL.md +1 -1
  13. package/harness/bundles/general/claude-code/scripts/harness_archive.py +80 -0
  14. package/harness/bundles/general/claude-code/scripts/harness_change.py +256 -16
  15. package/harness/bundles/general/claude-code/scripts/harness_events.py +14 -0
  16. package/harness/bundles/general/claude-code/scripts/harness_integration.py +64 -7
  17. package/harness/bundles/general/claude-code/scripts/harness_plan_finalize.py +85 -0
  18. package/harness/bundles/general/claude-code/scripts/harness_preflight.py +146 -77
  19. package/harness/bundles/general/claude-code/scripts/harness_state.py +12 -4
  20. package/harness/bundles/general/codebuddy/.harness-build.json +1 -1
  21. package/harness/bundles/general/codebuddy/harness-archive/SKILL.md +1 -1
  22. package/harness/bundles/general/codebuddy/harness-codebase-map/SKILL.md +1 -1
  23. package/harness/bundles/general/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  24. package/harness/bundles/general/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  25. package/harness/bundles/general/codebuddy/harness-plan/SKILL.md +1 -1
  26. package/harness/bundles/general/codebuddy/harness-review/SKILL.md +1 -1
  27. package/harness/bundles/general/codebuddy/harness-run/SKILL.md +1 -1
  28. package/harness/bundles/general/codebuddy/harness-run/reference.md +3 -1
  29. package/harness/bundles/general/codebuddy/harness-submit/SKILL.md +1 -1
  30. package/harness/bundles/general/codebuddy/harness-sync/SKILL.md +1 -1
  31. package/harness/bundles/general/codebuddy/harness-test/SKILL.md +1 -1
  32. package/harness/bundles/general/codebuddy/scripts/harness_archive.py +80 -0
  33. package/harness/bundles/general/codebuddy/scripts/harness_change.py +256 -16
  34. package/harness/bundles/general/codebuddy/scripts/harness_events.py +14 -0
  35. package/harness/bundles/general/codebuddy/scripts/harness_integration.py +64 -7
  36. package/harness/bundles/general/codebuddy/scripts/harness_plan_finalize.py +85 -0
  37. package/harness/bundles/general/codebuddy/scripts/harness_preflight.py +146 -77
  38. package/harness/bundles/general/codebuddy/scripts/harness_state.py +12 -4
  39. package/harness/bundles/general/codex/.harness-build.json +1 -1
  40. package/harness/bundles/general/codex/harness-archive/SKILL.md +1 -1
  41. package/harness/bundles/general/codex/harness-codebase-map/SKILL.md +1 -1
  42. package/harness/bundles/general/codex/harness-knowledge-ingest/SKILL.md +1 -1
  43. package/harness/bundles/general/codex/harness-knowledge-query/SKILL.md +1 -1
  44. package/harness/bundles/general/codex/harness-plan/SKILL.md +1 -1
  45. package/harness/bundles/general/codex/harness-review/SKILL.md +1 -1
  46. package/harness/bundles/general/codex/harness-run/SKILL.md +1 -1
  47. package/harness/bundles/general/codex/harness-run/reference.md +3 -1
  48. package/harness/bundles/general/codex/harness-submit/SKILL.md +1 -1
  49. package/harness/bundles/general/codex/harness-sync/SKILL.md +1 -1
  50. package/harness/bundles/general/codex/harness-test/SKILL.md +1 -1
  51. package/harness/bundles/general/codex/scripts/harness_archive.py +80 -0
  52. package/harness/bundles/general/codex/scripts/harness_change.py +256 -16
  53. package/harness/bundles/general/codex/scripts/harness_events.py +14 -0
  54. package/harness/bundles/general/codex/scripts/harness_integration.py +64 -7
  55. package/harness/bundles/general/codex/scripts/harness_plan_finalize.py +85 -0
  56. package/harness/bundles/general/codex/scripts/harness_preflight.py +146 -77
  57. package/harness/bundles/general/codex/scripts/harness_state.py +12 -4
  58. package/harness/bundles/general/cursor/.harness-build.json +1 -1
  59. package/harness/bundles/general/cursor/harness-archive/SKILL.md +1 -1
  60. package/harness/bundles/general/cursor/harness-codebase-map/SKILL.md +1 -1
  61. package/harness/bundles/general/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  62. package/harness/bundles/general/cursor/harness-knowledge-query/SKILL.md +1 -1
  63. package/harness/bundles/general/cursor/harness-plan/SKILL.md +1 -1
  64. package/harness/bundles/general/cursor/harness-review/SKILL.md +1 -1
  65. package/harness/bundles/general/cursor/harness-run/SKILL.md +1 -1
  66. package/harness/bundles/general/cursor/harness-run/reference.md +3 -1
  67. package/harness/bundles/general/cursor/harness-submit/SKILL.md +1 -1
  68. package/harness/bundles/general/cursor/harness-sync/SKILL.md +1 -1
  69. package/harness/bundles/general/cursor/harness-test/SKILL.md +1 -1
  70. package/harness/bundles/general/cursor/scripts/harness_archive.py +80 -0
  71. package/harness/bundles/general/cursor/scripts/harness_change.py +256 -16
  72. package/harness/bundles/general/cursor/scripts/harness_events.py +14 -0
  73. package/harness/bundles/general/cursor/scripts/harness_integration.py +64 -7
  74. package/harness/bundles/general/cursor/scripts/harness_plan_finalize.py +85 -0
  75. package/harness/bundles/general/cursor/scripts/harness_preflight.py +146 -77
  76. package/harness/bundles/general/cursor/scripts/harness_state.py +12 -4
  77. package/harness/bundles/java/claude-code/.harness-build.json +1 -1
  78. package/harness/bundles/java/claude-code/harness-apidoc/SKILL.md +1 -1
  79. package/harness/bundles/java/claude-code/harness-archive/SKILL.md +1 -1
  80. package/harness/bundles/java/claude-code/harness-codebase-map/SKILL.md +1 -1
  81. package/harness/bundles/java/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
  82. package/harness/bundles/java/claude-code/harness-knowledge-query/SKILL.md +1 -1
  83. package/harness/bundles/java/claude-code/harness-package/SKILL.md +1 -1
  84. package/harness/bundles/java/claude-code/harness-plan/SKILL.md +1 -1
  85. package/harness/bundles/java/claude-code/harness-review/SKILL.md +1 -1
  86. package/harness/bundles/java/claude-code/harness-run/SKILL.md +1 -1
  87. package/harness/bundles/java/claude-code/harness-submit/SKILL.md +1 -1
  88. package/harness/bundles/java/claude-code/harness-sync/SKILL.md +1 -1
  89. package/harness/bundles/java/claude-code/harness-test/SKILL.md +1 -1
  90. package/harness/bundles/java/claude-code/scripts/harness_archive.py +80 -0
  91. package/harness/bundles/java/claude-code/scripts/harness_change.py +256 -16
  92. package/harness/bundles/java/claude-code/scripts/harness_events.py +14 -0
  93. package/harness/bundles/java/claude-code/scripts/harness_integration.py +64 -7
  94. package/harness/bundles/java/claude-code/scripts/harness_plan_finalize.py +85 -0
  95. package/harness/bundles/java/claude-code/scripts/harness_preflight.py +146 -77
  96. package/harness/bundles/java/claude-code/scripts/harness_state.py +12 -4
  97. package/harness/bundles/java/codebuddy/.harness-build.json +1 -1
  98. package/harness/bundles/java/codebuddy/harness-apidoc/SKILL.md +1 -1
  99. package/harness/bundles/java/codebuddy/harness-archive/SKILL.md +1 -1
  100. package/harness/bundles/java/codebuddy/harness-codebase-map/SKILL.md +1 -1
  101. package/harness/bundles/java/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  102. package/harness/bundles/java/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  103. package/harness/bundles/java/codebuddy/harness-package/SKILL.md +1 -1
  104. package/harness/bundles/java/codebuddy/harness-plan/SKILL.md +1 -1
  105. package/harness/bundles/java/codebuddy/harness-review/SKILL.md +1 -1
  106. package/harness/bundles/java/codebuddy/harness-run/SKILL.md +1 -1
  107. package/harness/bundles/java/codebuddy/harness-submit/SKILL.md +1 -1
  108. package/harness/bundles/java/codebuddy/harness-sync/SKILL.md +1 -1
  109. package/harness/bundles/java/codebuddy/harness-test/SKILL.md +1 -1
  110. package/harness/bundles/java/codebuddy/scripts/harness_archive.py +80 -0
  111. package/harness/bundles/java/codebuddy/scripts/harness_change.py +256 -16
  112. package/harness/bundles/java/codebuddy/scripts/harness_events.py +14 -0
  113. package/harness/bundles/java/codebuddy/scripts/harness_integration.py +64 -7
  114. package/harness/bundles/java/codebuddy/scripts/harness_plan_finalize.py +85 -0
  115. package/harness/bundles/java/codebuddy/scripts/harness_preflight.py +146 -77
  116. package/harness/bundles/java/codebuddy/scripts/harness_state.py +12 -4
  117. package/harness/bundles/java/codex/.harness-build.json +1 -1
  118. package/harness/bundles/java/codex/harness-apidoc/SKILL.md +1 -1
  119. package/harness/bundles/java/codex/harness-archive/SKILL.md +1 -1
  120. package/harness/bundles/java/codex/harness-codebase-map/SKILL.md +1 -1
  121. package/harness/bundles/java/codex/harness-knowledge-ingest/SKILL.md +1 -1
  122. package/harness/bundles/java/codex/harness-knowledge-query/SKILL.md +1 -1
  123. package/harness/bundles/java/codex/harness-package/SKILL.md +1 -1
  124. package/harness/bundles/java/codex/harness-plan/SKILL.md +1 -1
  125. package/harness/bundles/java/codex/harness-review/SKILL.md +1 -1
  126. package/harness/bundles/java/codex/harness-run/SKILL.md +1 -1
  127. package/harness/bundles/java/codex/harness-submit/SKILL.md +1 -1
  128. package/harness/bundles/java/codex/harness-sync/SKILL.md +1 -1
  129. package/harness/bundles/java/codex/harness-test/SKILL.md +1 -1
  130. package/harness/bundles/java/codex/scripts/harness_archive.py +80 -0
  131. package/harness/bundles/java/codex/scripts/harness_change.py +256 -16
  132. package/harness/bundles/java/codex/scripts/harness_events.py +14 -0
  133. package/harness/bundles/java/codex/scripts/harness_integration.py +64 -7
  134. package/harness/bundles/java/codex/scripts/harness_plan_finalize.py +85 -0
  135. package/harness/bundles/java/codex/scripts/harness_preflight.py +146 -77
  136. package/harness/bundles/java/codex/scripts/harness_state.py +12 -4
  137. package/harness/bundles/java/cursor/.harness-build.json +1 -1
  138. package/harness/bundles/java/cursor/harness-apidoc/SKILL.md +1 -1
  139. package/harness/bundles/java/cursor/harness-archive/SKILL.md +1 -1
  140. package/harness/bundles/java/cursor/harness-codebase-map/SKILL.md +1 -1
  141. package/harness/bundles/java/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  142. package/harness/bundles/java/cursor/harness-knowledge-query/SKILL.md +1 -1
  143. package/harness/bundles/java/cursor/harness-package/SKILL.md +1 -1
  144. package/harness/bundles/java/cursor/harness-plan/SKILL.md +1 -1
  145. package/harness/bundles/java/cursor/harness-review/SKILL.md +1 -1
  146. package/harness/bundles/java/cursor/harness-run/SKILL.md +1 -1
  147. package/harness/bundles/java/cursor/harness-submit/SKILL.md +1 -1
  148. package/harness/bundles/java/cursor/harness-sync/SKILL.md +1 -1
  149. package/harness/bundles/java/cursor/harness-test/SKILL.md +1 -1
  150. package/harness/bundles/java/cursor/scripts/harness_archive.py +80 -0
  151. package/harness/bundles/java/cursor/scripts/harness_change.py +256 -16
  152. package/harness/bundles/java/cursor/scripts/harness_events.py +14 -0
  153. package/harness/bundles/java/cursor/scripts/harness_integration.py +64 -7
  154. package/harness/bundles/java/cursor/scripts/harness_plan_finalize.py +85 -0
  155. package/harness/bundles/java/cursor/scripts/harness_preflight.py +146 -77
  156. package/harness/bundles/java/cursor/scripts/harness_state.py +12 -4
  157. package/harness/manifests/general/claude-code.json +19 -19
  158. package/harness/manifests/general/codebuddy.json +19 -19
  159. package/harness/manifests/general/codex.json +19 -19
  160. package/harness/manifests/general/cursor.json +19 -19
  161. package/harness/manifests/java/claude-code.json +20 -20
  162. package/harness/manifests/java/codebuddy.json +20 -20
  163. package/harness/manifests/java/codex.json +20 -20
  164. package/harness/manifests/java/cursor.json +20 -20
  165. package/hunter-workflow-family.json +1 -1
  166. package/package.json +1 -1
@@ -367,10 +367,41 @@ def _resolve_agents_root(skills_root: Path, agents_root: Path | None) -> tuple[P
367
367
  if skills_root.name == "skills" and skills_root.parent.name in (".claude", ".codebuddy"):
368
368
  return (skills_root.parent / "agents").resolve(), None
369
369
  if skills_root.name == "skills" and skills_root.parent.name in (".agents", ".cursor"):
370
- return None, "CUSTOM_AGENTS_UNSUPPORTED"
370
+ # These adapters (Codex/Cursor) may provide agent roles via host
371
+ # capability manifest rather than local .md files. Return None without
372
+ # a hard error; the caller checks runtime.json for host capabilities.
373
+ return None, None
371
374
  return (skills_root / "agents").resolve(), None
372
375
 
373
376
 
377
+ def _read_host_capabilities(skills_root: Path) -> set[str]:
378
+ """Read agent capabilities declared by the host adapter (retro §5.3).
379
+
380
+ Adapter installs may declare available agent roles in
381
+ `meta/runtime.json` under `agentCapabilities` (list of role names).
382
+ Returns an empty set if the file or field is absent.
383
+ """
384
+ # runtime.json lives in the change's meta/ dir, but agent capabilities are
385
+ # project-level. Check the adapter's runtime.json at the project root.
386
+ candidates = [
387
+ skills_root.parent / "runtime.json",
388
+ skills_root / "runtime.json",
389
+ ]
390
+ for path in candidates:
391
+ if not path.is_file():
392
+ continue
393
+ try:
394
+ data = json.loads(path.read_text(encoding="utf-8-sig"))
395
+ except (OSError, json.JSONDecodeError):
396
+ continue
397
+ if not isinstance(data, dict):
398
+ continue
399
+ caps = data.get("agentCapabilities")
400
+ if isinstance(caps, list):
401
+ return {str(c) for c in caps if isinstance(c, str)}
402
+ return set()
403
+
404
+
374
405
  def cmd_check_agents(
375
406
  skills_root: Path,
376
407
  agent: str,
@@ -388,98 +419,136 @@ def cmd_check_agents(
388
419
  "reason": "agent name is empty",
389
420
  }
390
421
 
391
- resolved_agents_root, capability_error = _resolve_agents_root(skills_root, agents_root)
392
- if capability_error is not None:
393
- return {
394
- "ok": True,
395
- "action": "check-agents",
396
- "agent": agent_name,
397
- "usable": False,
398
- "definitionValid": False,
399
- "runtimeSupported": False,
400
- "reasonCode": capability_error,
401
- "reason": "current adapter runtime does not support custom agent definitions; use main-session fallback",
402
- }
403
-
404
- assert resolved_agents_root is not None
405
- # Accept bare name or with .md
406
- filename = agent_name if agent_name.endswith(".md") else f"{agent_name}.md"
407
- agent_path = resolved_agents_root / filename
408
-
409
- if not agent_path.is_file():
422
+ resolved_agents_root, _ = _resolve_agents_root(skills_root, agents_root)
423
+ host_capabilities = _read_host_capabilities(skills_root)
424
+ host_callable = agent_name in host_capabilities
425
+
426
+ # Three independent fields (retro §5.3):
427
+ # - definitionPresent: local .md file exists
428
+ # - hostCallable: host adapter declares this agent role
429
+ # - toolContractValid: tools declaration is valid (non-empty list)
430
+ definition_present = False
431
+ tool_contract_valid = False
432
+ agent_path: Path | None = None
433
+ meta: dict[str, Any] | None = None
434
+
435
+ if resolved_agents_root is not None:
436
+ filename = agent_name if agent_name.endswith(".md") else f"{agent_name}.md"
437
+ agent_path = resolved_agents_root / filename
438
+ definition_present = agent_path.is_file()
439
+
440
+ # If no local definition and host doesn't declare the role, we can't
441
+ # determine usability. Distinguish "host says no" from "unknown".
442
+ if not definition_present and not host_callable:
443
+ # Check if this adapter is known to not support custom agents
444
+ adapter_name = skills_root.parent.name
445
+ if adapter_name in (".agents", ".cursor"):
446
+ # Codex/Cursor: may support via host manifest. If runtime.json
447
+ # has agentCapabilities but this role isn't listed, it's a
448
+ # genuine "not available". If no agentCapabilities field at all,
449
+ # we can't know — return UNKNOWN.
450
+ runtime_path = skills_root.parent / "runtime.json"
451
+ if not runtime_path.is_file():
452
+ return {
453
+ "ok": True,
454
+ "action": "check-agents",
455
+ "agent": agent_name,
456
+ "usable": False,
457
+ "definitionPresent": False,
458
+ "hostCallable": False,
459
+ "toolContractValid": False,
460
+ "reasonCode": "UNKNOWN",
461
+ "reason": (
462
+ "no local agent definition and no host capability manifest; "
463
+ "cannot determine agent availability"
464
+ ),
465
+ }
410
466
  return {
411
467
  "ok": False,
412
468
  "action": "check-agents",
413
469
  "agent": agent_name,
414
- "path": str(agent_path),
415
- "agentsRoot": str(resolved_agents_root),
470
+ "path": str(agent_path) if agent_path else None,
471
+ "agentsRoot": str(resolved_agents_root) if resolved_agents_root else None,
416
472
  "usable": False,
417
- "definitionValid": False,
418
- "runtimeSupported": True,
473
+ "definitionPresent": False,
474
+ "hostCallable": False,
475
+ "toolContractValid": False,
419
476
  "reasonCode": "AGENT_DEFINITION_NOT_FOUND",
420
- "reason": f"agent file not found: {agent_path}",
477
+ "reason": f"agent file not found and host does not declare role: {agent_name}",
421
478
  }
422
479
 
423
- try:
424
- text = agent_path.read_text(encoding="utf-8")
425
- except OSError as exc:
426
- return {
427
- "ok": False,
428
- "action": "check-agents",
429
- "agent": agent_name,
430
- "path": str(agent_path),
431
- "usable": False,
432
- "reason": f"cannot read agent file: {exc}",
433
- }
480
+ # If definition present, validate frontmatter and tools
481
+ if definition_present and agent_path is not None:
482
+ try:
483
+ text = agent_path.read_text(encoding="utf-8")
484
+ except OSError as exc:
485
+ return {
486
+ "ok": False,
487
+ "action": "check-agents",
488
+ "agent": agent_name,
489
+ "path": str(agent_path),
490
+ "usable": False,
491
+ "definitionPresent": True,
492
+ "hostCallable": host_callable,
493
+ "toolContractValid": False,
494
+ "reason": f"cannot read agent file: {exc}",
495
+ }
496
+
497
+ meta, err = parse_frontmatter(text)
498
+ if err or meta is None:
499
+ return {
500
+ "ok": False,
501
+ "action": "check-agents",
502
+ "agent": agent_name,
503
+ "path": str(agent_path),
504
+ "usable": False,
505
+ "definitionPresent": True,
506
+ "hostCallable": host_callable,
507
+ "toolContractValid": False,
508
+ "reason": f"frontmatter parse failed: {err or 'unknown'}",
509
+ }
510
+
511
+ tools = meta.get("tools")
512
+ if tools is None:
513
+ tool_contract_valid = False
514
+ elif isinstance(tools, list) and len(tools) > 0:
515
+ tool_contract_valid = True
516
+ else:
517
+ tool_contract_valid = False
434
518
 
435
- meta, err = parse_frontmatter(text)
436
- if err or meta is None:
437
- return {
438
- "ok": False,
439
- "action": "check-agents",
440
- "agent": agent_name,
441
- "path": str(agent_path),
442
- "usable": False,
443
- "reason": f"frontmatter parse failed: {err or 'unknown'}",
444
- }
519
+ # usable = hostCallable (host provides the agent role, tools validated by host)
520
+ # OR definitionPresent AND toolContractValid (definition-based adapters)
521
+ usable = host_callable or (
522
+ definition_present and tool_contract_valid
523
+ )
445
524
 
446
- tools = meta.get("tools")
447
- if tools is None:
448
- return {
449
- "ok": False,
450
- "action": "check-agents",
451
- "agent": agent_name,
452
- "path": str(agent_path),
453
- "usable": False,
454
- "reason": "tools declaration missing",
455
- "frontmatter": meta,
456
- }
457
- if not isinstance(tools, list) or len(tools) == 0:
458
- return {
459
- "ok": False,
460
- "action": "check-agents",
461
- "agent": agent_name,
462
- "path": str(agent_path),
463
- "usable": False,
464
- "reason": "tools declaration empty or invalid",
465
- "frontmatter": meta,
466
- }
525
+ name_field = meta.get("name") if meta else None
526
+ tools_field = meta.get("tools") if meta else None
527
+
528
+ reason_code = "READY" if usable else "AGENT_DEFINITION_NOT_FOUND"
529
+ if not definition_present and host_callable:
530
+ reason_code = "DEFINITION_NOT_FOUND_HOST_CAPABLE"
467
531
 
468
- name_field = meta.get("name")
469
532
  return {
470
533
  "ok": True,
471
534
  "action": "check-agents",
472
535
  "agent": agent_name,
473
- "path": str(agent_path),
474
- "agentsRoot": str(resolved_agents_root),
475
- "usable": True,
476
- "definitionValid": True,
477
- "runtimeSupported": True,
478
- "reasonCode": "READY",
479
- "reason": "agent file exists; frontmatter parsed; tools declared",
536
+ "path": str(agent_path) if agent_path else None,
537
+ "agentsRoot": str(resolved_agents_root) if resolved_agents_root else None,
538
+ "usable": usable,
539
+ "definitionPresent": definition_present,
540
+ "hostCallable": host_callable,
541
+ "toolContractValid": tool_contract_valid,
542
+ "reasonCode": reason_code,
543
+ "reason": (
544
+ "agent available; "
545
+ f"definition={'present' if definition_present else 'absent'}, "
546
+ f"hostCallable={host_callable}, "
547
+ f"tools={'valid' if tool_contract_valid else 'invalid'}"
548
+ ),
480
549
  "name": name_field,
481
- "tools": tools,
482
- "frontmatterKeys": sorted(meta.keys()),
550
+ "tools": tools_field,
551
+ "frontmatterKeys": sorted(meta.keys()) if meta else [],
483
552
  }
484
553
 
485
554
 
@@ -268,6 +268,7 @@ def capture_current_state(
268
268
  changed: list[str] = []
269
269
  baseline_created = previous is None
270
270
  unresolved: list[str] = []
271
+ unresolved_reasons: list[dict[str, str]] = []
271
272
  if previous:
272
273
  old_segments = previous.get("segments") or {}
273
274
  for name, segment in fresh["segments"].items():
@@ -276,13 +277,17 @@ def capture_current_state(
276
277
  segment["capturedAt"] = old.get("capturedAt", segment["capturedAt"])
277
278
  else:
278
279
  changed.append(name)
279
- else:
280
- # A first observation establishes the baseline; it is not evidence
281
- # that every segment changed during the current phase.
282
- unresolved = sorted(fresh["segments"])
280
+ # First observation establishes the baseline; it is not evidence that
281
+ # segments changed, nor that they are "unresolved". Segments are only
282
+ # unresolved when they genuinely fail to read/compute (retro §5.6).
283
+ # On first capture, all successfully-captured segments are baseline,
284
+ # not unresolved.
283
285
  fresh["baselineCreated"] = baseline_created
284
286
  fresh["changedSegments"] = sorted(changed)
285
287
  fresh["unresolvedSegments"] = unresolved
288
+ fresh["unresolvedReasons"] = unresolved_reasons
289
+ fresh["comparisonAvailable"] = not baseline_created
290
+ fresh["baselineStatus"] = "created" if baseline_created else "reused"
286
291
  write_snapshot(change_dir, fresh)
287
292
  return fresh, changed
288
293
 
@@ -325,7 +330,10 @@ def main(argv: list[str] | None = None) -> int:
325
330
  - set(snapshot.get("unresolvedSegments") or [])
326
331
  ),
327
332
  "baselineCreated": bool(snapshot.get("baselineCreated")),
333
+ "baselineStatus": snapshot.get("baselineStatus", "reused"),
334
+ "comparisonAvailable": bool(snapshot.get("comparisonAvailable", True)),
328
335
  "unresolvedSegments": list(snapshot.get("unresolvedSegments") or []),
336
+ "unresolvedReasons": list(snapshot.get("unresolvedReasons") or []),
329
337
  "git": snapshot["git"],
330
338
  }
331
339
  if args.json:
@@ -7,7 +7,7 @@
7
7
  "files": [
8
8
  {
9
9
  "path": ".harness-build.json",
10
- "sha256": "321719a52cbbebc37c233882e6a903ef6d78a69ca351f94bc1550b96b5e332ca"
10
+ "sha256": "f7e5fcab41c868a1acf53d59f58cad0ca69f7da5dca394b3081de73b6e530074"
11
11
  },
12
12
  {
13
13
  "path": "agents/harness-evaluator.md",
@@ -47,7 +47,7 @@
47
47
  },
48
48
  {
49
49
  "path": "harness-archive/SKILL.md",
50
- "sha256": "f0a31cc0b90b32483d070c11b4a49646d78d78ad840e4cb1ffad4c1372317538"
50
+ "sha256": "55d393fc6b7accab0802115fc6628c68545e1069cbc1aa0e16c412d6a8edfa5a"
51
51
  },
52
52
  {
53
53
  "path": "harness-archive/templates/render-summary.mjs",
@@ -67,7 +67,7 @@
67
67
  },
68
68
  {
69
69
  "path": "harness-codebase-map/SKILL.md",
70
- "sha256": "4392f5e5245eb54b5c4ee62a5773ae291422bb9a508b24c67a584757758c5d5a"
70
+ "sha256": "8901d29948bd75933d22dea87d15b9b47eeab660063af3e4c13718e7e5fdc4a4"
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": "5d1f1d77b45aba4a98fa0951e0103362cc92e5c163e241d57ad36aa5d62055e6"
134
+ "sha256": "013252318d6a27d6c62bcf5247e0e3a2f78187fe7758950edf93e44340943fd9"
135
135
  },
136
136
  {
137
137
  "path": "harness-knowledge-query/SKILL.md",
138
- "sha256": "11c82d1926fa46301e489885410cfc859ef3a408daaa7d2fd854df3656b74ae1"
138
+ "sha256": "5e0d111527aa23bc2ecd60e9808a8d65e23f21344920447c247aa8592ad176fd"
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": "ff7188f94be8193d144d826ac8280633a9af459454c2dba31fc0d6675a180fde"
154
+ "sha256": "c73337d7896b89c67ecdbc623145ee1ffad679302b72eeb054b7d1508dee4a86"
155
155
  },
156
156
  {
157
157
  "path": "harness-review/checklist.md",
@@ -167,7 +167,7 @@
167
167
  },
168
168
  {
169
169
  "path": "harness-review/SKILL.md",
170
- "sha256": "77283d06a288c8ce9e0054bfca83e15028d715d707a0d6b046b949bd4459cf99"
170
+ "sha256": "ec00e56acc221f34ab5b2717a560473670a897c8bf75039bae290a6d875c17df"
171
171
  },
172
172
  {
173
173
  "path": "harness-run/checklist.md",
@@ -179,11 +179,11 @@
179
179
  },
180
180
  {
181
181
  "path": "harness-run/reference.md",
182
- "sha256": "2be487368210d50b22062cefcf6e9b4ef4ff2eb148531e0c85b180f41f2e8b33"
182
+ "sha256": "0c47bca05013669fb1f1a6d6d232aa7771657a5b9727f666811bc2d9e640850c"
183
183
  },
184
184
  {
185
185
  "path": "harness-run/SKILL.md",
186
- "sha256": "ee144ce1d964c0f1f2f54f9630e78ef836b26ba93c987fb9102468be91949035"
186
+ "sha256": "9b3b608914a7bbf698c3a28a45e5d4cd6a8156bd49c9a780da5e1adbbde02408"
187
187
  },
188
188
  {
189
189
  "path": "harness-submit/checklist.md",
@@ -195,7 +195,7 @@
195
195
  },
196
196
  {
197
197
  "path": "harness-submit/SKILL.md",
198
- "sha256": "8c741b04f23ff886f115ba3d98760e39f4af40380e2a60fb5daac12370a72766"
198
+ "sha256": "279bb2546f41d617fe4402caa5cad7db788643407ba47b5cfe0dae00b1c18e72"
199
199
  },
200
200
  {
201
201
  "path": "harness-sync/reference.md",
@@ -203,7 +203,7 @@
203
203
  },
204
204
  {
205
205
  "path": "harness-sync/SKILL.md",
206
- "sha256": "8f2870bfbcd92bce35df0e29e4b5bb393f3a908445f1f4177dc2e75b01174924"
206
+ "sha256": "6dc61858ea0293876a79be8130de7c3f7699f1f8510a50fac6a6da01d62b4673"
207
207
  },
208
208
  {
209
209
  "path": "harness-test/checklist.md",
@@ -227,7 +227,7 @@
227
227
  },
228
228
  {
229
229
  "path": "harness-test/SKILL.md",
230
- "sha256": "8d40922eb0656f8f1ebbf056222024d692c0e485e684658f0fd970d01fdaa758"
230
+ "sha256": "a7c8d010c05c216c17ba353525ce06e3c8d39f5ec9182be29b4420f567fe36a7"
231
231
  },
232
232
  {
233
233
  "path": "protocols/archive-report-protocol.md",
@@ -271,11 +271,11 @@
271
271
  },
272
272
  {
273
273
  "path": "scripts/harness_archive.py",
274
- "sha256": "fb06714be150da72628875322039199d9c49ad7b23df48ea64fcd2d8fe031e80"
274
+ "sha256": "3e4802a07b2f798243bdcfe4733830b59ea4a387a751189e23017a4dc2ebc80b"
275
275
  },
276
276
  {
277
277
  "path": "scripts/harness_change.py",
278
- "sha256": "5776dbccf20b9840b656a929dddd35bd683a9835c4583bb25baaeca79a87989b"
278
+ "sha256": "fa3cbaaf48cd22c4b043d96a4ced7005122fcdc076f47de3b89cd36e42c97e14"
279
279
  },
280
280
  {
281
281
  "path": "scripts/harness_check_gate.py",
@@ -287,7 +287,7 @@
287
287
  },
288
288
  {
289
289
  "path": "scripts/harness_events.py",
290
- "sha256": "9ce57f47112df1eede3e3c77e8dd13103bf9069a8697bf2b088bf80ed24ef1c8"
290
+ "sha256": "a44614a8bb497820619feaf2531569942a7a61de2dfe4d3f0646aece23636f62"
291
291
  },
292
292
  {
293
293
  "path": "scripts/harness_gate.py",
@@ -295,7 +295,7 @@
295
295
  },
296
296
  {
297
297
  "path": "scripts/harness_integration.py",
298
- "sha256": "bb71c00afc08a19772adb61408080ee8994e98f3015b1560efb2d3a5ed2cb610"
298
+ "sha256": "6b078d7d1d053e4c46bc320496fab3060d883b256d517a56f0b078eec2fa0ce0"
299
299
  },
300
300
  {
301
301
  "path": "scripts/harness_ledger.py",
@@ -311,11 +311,11 @@
311
311
  },
312
312
  {
313
313
  "path": "scripts/harness_plan_finalize.py",
314
- "sha256": "8557e392b34711811a7fa220a2c388c60fec79e916fbd61b42f3e6e6dc50b22c"
314
+ "sha256": "5534eb277e29e3473149a0f113ea107dc17b6cade742d7de920befb87e46fdfa"
315
315
  },
316
316
  {
317
317
  "path": "scripts/harness_preflight.py",
318
- "sha256": "a8734badda02f10db95ae41054c3d6dc37487d2d17e5ac6b680887de210f3fa9"
318
+ "sha256": "ee9859b06abd14d002fac68cf0045270532df24ea5c24ca62db852ec7cf0d10b"
319
319
  },
320
320
  {
321
321
  "path": "scripts/harness_profile.py",
@@ -335,7 +335,7 @@
335
335
  },
336
336
  {
337
337
  "path": "scripts/harness_state.py",
338
- "sha256": "5a35c8ceb1d1cbb1e52347f150139029dd78e57ed47b6d9f2a69066ce33b6084"
338
+ "sha256": "abadf62081ffa514c7efd41b538e824b05398fdc6f4b0d64a5d618207ee64e4d"
339
339
  },
340
340
  {
341
341
  "path": "scripts/harness_sync.py",
@@ -7,7 +7,7 @@
7
7
  "files": [
8
8
  {
9
9
  "path": ".harness-build.json",
10
- "sha256": "d76290e3f633c27daab8493c850f185458bfdb65e11878136896d7aa9d168b57"
10
+ "sha256": "3db926579d1b6f197e95e36f03babba6c5704a16a4ec791dee48bd5816262de5"
11
11
  },
12
12
  {
13
13
  "path": "agents/harness-evaluator.md",
@@ -47,7 +47,7 @@
47
47
  },
48
48
  {
49
49
  "path": "harness-archive/SKILL.md",
50
- "sha256": "cce6f057fe4b0faf7caa274fbde05c97c5524e0cef354abe40dbde07f7778274"
50
+ "sha256": "a2afbdbbf05d0830155a5aa6bb596873d6d27f424e4a4d6347c26304b6a6e9d4"
51
51
  },
52
52
  {
53
53
  "path": "harness-archive/templates/render-summary.mjs",
@@ -67,7 +67,7 @@
67
67
  },
68
68
  {
69
69
  "path": "harness-codebase-map/SKILL.md",
70
- "sha256": "6345761e31ad06350baaee5393f1bdd8ff8becd452521f146441b01c54b9b1fd"
70
+ "sha256": "b91e96a7a8971ab551f6f326dc7c7514b4e321a0221e192782e2a725fab44a09"
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": "b89b9149509f4a0fc7f9e0f424ada604ebd3a79d6ab8ac5c0269585e4d67258f"
134
+ "sha256": "0208b532e3aebf9614e9c80ed35fe630f5d935b2039467d59c9afeb846df32aa"
135
135
  },
136
136
  {
137
137
  "path": "harness-knowledge-query/SKILL.md",
138
- "sha256": "529e7072d4e75c52731c7089259b764a3939815e97b27d4a7cd2bf72364e4246"
138
+ "sha256": "6f2e9629cf3318de0bd24a109ab60aa34ba699a8fee5bbef27876f6edbced4f7"
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": "9ad2064cf276af212113a3c8078bddec5675fb84845d58ee743e0ac577018841"
154
+ "sha256": "5019a13cbb81d6585fec0cfec793e31e4694b674d3d9945c0aa6ddb39e3b8230"
155
155
  },
156
156
  {
157
157
  "path": "harness-review/checklist.md",
@@ -167,7 +167,7 @@
167
167
  },
168
168
  {
169
169
  "path": "harness-review/SKILL.md",
170
- "sha256": "121f9ba5d53d801b3a900159d25abcb3a7c89da8f799875ac64f35e7c5d27ddf"
170
+ "sha256": "811470bf9eb8266d2f3340f59b46da4dd4824c6e88e049497c51107a9dfb750f"
171
171
  },
172
172
  {
173
173
  "path": "harness-run/checklist.md",
@@ -179,11 +179,11 @@
179
179
  },
180
180
  {
181
181
  "path": "harness-run/reference.md",
182
- "sha256": "2be487368210d50b22062cefcf6e9b4ef4ff2eb148531e0c85b180f41f2e8b33"
182
+ "sha256": "0c47bca05013669fb1f1a6d6d232aa7771657a5b9727f666811bc2d9e640850c"
183
183
  },
184
184
  {
185
185
  "path": "harness-run/SKILL.md",
186
- "sha256": "eb904aeebe3a2820104f9f5b589253334e44dee12d2faf438268831612c23806"
186
+ "sha256": "184b17c93ab65d067d90784b1e009061e21448fe966e270843aa1bc80cf4b12a"
187
187
  },
188
188
  {
189
189
  "path": "harness-submit/checklist.md",
@@ -195,7 +195,7 @@
195
195
  },
196
196
  {
197
197
  "path": "harness-submit/SKILL.md",
198
- "sha256": "c28b90c16d71b75a15e05ca20b2b43714740a70150d7849f5d6f9917cd1e5a44"
198
+ "sha256": "b1358cb2146913a1547e9e96c12e1831d8aafefcf7da60bda01c2b06f01ddeef"
199
199
  },
200
200
  {
201
201
  "path": "harness-sync/reference.md",
@@ -203,7 +203,7 @@
203
203
  },
204
204
  {
205
205
  "path": "harness-sync/SKILL.md",
206
- "sha256": "5fc25c700b48fa3b87c1c8562c16eb5c554cbd3ecb730311a794fc4db2385239"
206
+ "sha256": "442f749a753af4be7cee441ebc07381210992a4548ce418a917028a88d62cfe5"
207
207
  },
208
208
  {
209
209
  "path": "harness-test/checklist.md",
@@ -227,7 +227,7 @@
227
227
  },
228
228
  {
229
229
  "path": "harness-test/SKILL.md",
230
- "sha256": "7dc970324056a16f90cd515b2a57c86f51251041b24a4a71342445245a3f2938"
230
+ "sha256": "4bc0e82e304f4a37c643081ad6ee77fff92ab3b459b309d6e217932a45038628"
231
231
  },
232
232
  {
233
233
  "path": "protocols/archive-report-protocol.md",
@@ -271,11 +271,11 @@
271
271
  },
272
272
  {
273
273
  "path": "scripts/harness_archive.py",
274
- "sha256": "fb06714be150da72628875322039199d9c49ad7b23df48ea64fcd2d8fe031e80"
274
+ "sha256": "3e4802a07b2f798243bdcfe4733830b59ea4a387a751189e23017a4dc2ebc80b"
275
275
  },
276
276
  {
277
277
  "path": "scripts/harness_change.py",
278
- "sha256": "5776dbccf20b9840b656a929dddd35bd683a9835c4583bb25baaeca79a87989b"
278
+ "sha256": "fa3cbaaf48cd22c4b043d96a4ced7005122fcdc076f47de3b89cd36e42c97e14"
279
279
  },
280
280
  {
281
281
  "path": "scripts/harness_check_gate.py",
@@ -287,7 +287,7 @@
287
287
  },
288
288
  {
289
289
  "path": "scripts/harness_events.py",
290
- "sha256": "9ce57f47112df1eede3e3c77e8dd13103bf9069a8697bf2b088bf80ed24ef1c8"
290
+ "sha256": "a44614a8bb497820619feaf2531569942a7a61de2dfe4d3f0646aece23636f62"
291
291
  },
292
292
  {
293
293
  "path": "scripts/harness_gate.py",
@@ -295,7 +295,7 @@
295
295
  },
296
296
  {
297
297
  "path": "scripts/harness_integration.py",
298
- "sha256": "bb71c00afc08a19772adb61408080ee8994e98f3015b1560efb2d3a5ed2cb610"
298
+ "sha256": "6b078d7d1d053e4c46bc320496fab3060d883b256d517a56f0b078eec2fa0ce0"
299
299
  },
300
300
  {
301
301
  "path": "scripts/harness_ledger.py",
@@ -311,11 +311,11 @@
311
311
  },
312
312
  {
313
313
  "path": "scripts/harness_plan_finalize.py",
314
- "sha256": "8557e392b34711811a7fa220a2c388c60fec79e916fbd61b42f3e6e6dc50b22c"
314
+ "sha256": "5534eb277e29e3473149a0f113ea107dc17b6cade742d7de920befb87e46fdfa"
315
315
  },
316
316
  {
317
317
  "path": "scripts/harness_preflight.py",
318
- "sha256": "a8734badda02f10db95ae41054c3d6dc37487d2d17e5ac6b680887de210f3fa9"
318
+ "sha256": "ee9859b06abd14d002fac68cf0045270532df24ea5c24ca62db852ec7cf0d10b"
319
319
  },
320
320
  {
321
321
  "path": "scripts/harness_profile.py",
@@ -335,7 +335,7 @@
335
335
  },
336
336
  {
337
337
  "path": "scripts/harness_state.py",
338
- "sha256": "5a35c8ceb1d1cbb1e52347f150139029dd78e57ed47b6d9f2a69066ce33b6084"
338
+ "sha256": "abadf62081ffa514c7efd41b538e824b05398fdc6f4b0d64a5d618207ee64e4d"
339
339
  },
340
340
  {
341
341
  "path": "scripts/harness_sync.py",