specdojo 0.3.1 → 0.4.1

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 (260) hide show
  1. package/.github/agents/specdojo-orchestrator.md +61 -2
  2. package/CHANGELOG.md +90 -0
  3. package/README.md +85 -25
  4. package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
  5. package/dist/catalog/build-render.js +32 -0
  6. package/dist/{catalog-build.js → catalog/build.js} +9 -9
  7. package/dist/{catalog.js → catalog/catalog.js} +10 -10
  8. package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
  9. package/dist/catalog/paths.js +1 -0
  10. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
  11. package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
  12. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
  13. package/dist/{agent.js → commands/agent.js} +11 -11
  14. package/dist/{build-command.js → commands/build.js} +2 -2
  15. package/dist/{init-command.js → commands/init.js} +168 -45
  16. package/dist/commands/night-orchestrator.js +287 -0
  17. package/dist/{orchestrator.js → commands/orchestrator.js} +12 -5
  18. package/dist/{watch.js → commands/watch.js} +3 -3
  19. package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
  20. package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
  21. package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
  22. package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
  23. package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
  24. package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
  25. package/dist/{timeline.js → dashboard/timeline.js} +1 -1
  26. package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
  27. package/dist/{deliverable-trash.js → deliverable/trash.js} +5 -5
  28. package/dist/{devcontainer-command.js → devcontainer/command.js} +8 -4
  29. package/dist/devcontainer/scaffold.js +418 -0
  30. package/dist/{doc-index.js → docs/doc-index.js} +1 -1
  31. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
  32. package/dist/{index-command.js → docs/index-command.js} +1 -1
  33. package/dist/docs/template-resolution.js +1 -0
  34. package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +1 -1
  35. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  36. package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
  37. package/dist/{exec-agent-config.js → exec/agent-config.js} +92 -5
  38. package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
  39. package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
  40. package/dist/{exec-commands.js → exec/commands.js} +22 -18
  41. package/dist/{exec-core.js → exec/core.js} +11 -11
  42. package/dist/{exec-events.js → exec/events.js} +2 -2
  43. package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
  44. package/dist/exec/exec.js +2 -0
  45. package/dist/exec/format.js +1 -0
  46. package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
  47. package/dist/{exec-limit.js → exec/limit.js} +93 -12
  48. package/dist/{exec-parent-validation.js → exec/parent-validation.js} +18 -4
  49. package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +29 -2
  50. package/dist/{exec-plans-core.js → exec/plans-core.js} +68 -114
  51. package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
  52. package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
  53. package/dist/{exec-plans.js → exec/plans.js} +3 -3
  54. package/dist/{exec-project.js → exec/project.js} +1 -1
  55. package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
  56. package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
  57. package/dist/{exec-register.js → exec/register.js} +114 -9
  58. package/dist/{exec-repo-integration-git.js → exec/repo-integration-git.js} +2 -2
  59. package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
  60. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +14 -11
  61. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  62. package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
  63. package/dist/{exec-reporter.js → exec/reporter.js} +142 -25
  64. package/dist/{exec-results.js → exec/results.js} +287 -31
  65. package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +35 -12
  66. package/dist/{exec-run-agent.js → exec/run/agent.js} +115 -28
  67. package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
  68. package/dist/{exec-run-job.js → exec/run/job.js} +65 -36
  69. package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
  70. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  71. package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
  72. package/dist/{exec-run-register-command.js → exec/run/register-command.js} +38 -11
  73. package/dist/{exec-run-register-core.js → exec/run/register-core.js} +63 -21
  74. package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +58 -31
  75. package/dist/exec/run/register-post-review.js +420 -0
  76. package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +48 -27
  77. package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
  78. package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +119 -24
  79. package/dist/{exec-run.js → exec/run/run.js} +11 -11
  80. package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
  81. package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
  82. package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
  83. package/dist/{exec-run-shared.js → exec/run/shared.js} +78 -30
  84. package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
  85. package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
  86. package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
  87. package/dist/exec/schedule/gantt-chart.js +2 -0
  88. package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
  89. package/dist/exec/schedule/index.js +1 -0
  90. package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
  91. package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
  92. package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
  93. package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
  94. package/dist/exec/shared.js +63 -0
  95. package/dist/exec/slot-lock.js +1 -0
  96. package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
  97. package/dist/{exec-task-repos.js → exec/task-repos.js} +104 -17
  98. package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
  99. package/dist/{exec-trial-commands.js → exec/trial-commands.js} +20 -22
  100. package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
  101. package/dist/{exec-trial.js → exec/trial.js} +2 -2
  102. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  103. package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
  104. package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
  105. package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
  106. package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
  107. package/dist/exec/worktree.js +305 -0
  108. package/dist/{grade-apply.js → grade/apply.js} +9 -9
  109. package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
  110. package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
  111. package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
  112. package/dist/{grade-core.js → grade/core.js} +3 -3
  113. package/dist/grade/grade.js +19 -0
  114. package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
  115. package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
  116. package/dist/{grade-plan.js → grade/plan.js} +5 -5
  117. package/dist/{grade-result.js → grade/result.js} +5 -94
  118. package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
  119. package/dist/{grade-targets.js → grade/targets.js} +11 -8
  120. package/dist/{job-definition.js → job/definition.js} +25 -6
  121. package/dist/{job.js → job/job.js} +12 -11
  122. package/dist/{kata-command.js → kata/command.js} +3 -3
  123. package/dist/{kata.js → kata/kata.js} +5 -5
  124. package/dist/register/approach.js +134 -0
  125. package/dist/{register-core.js → register/core.js} +26 -8
  126. package/dist/{register-create-commands.js → register/create-commands.js} +171 -8
  127. package/dist/{register-date.js → register/date.js} +1 -1
  128. package/dist/register/derivation.js +163 -0
  129. package/dist/{register-event-merge.js → register/event-merge.js} +44 -3
  130. package/dist/{register-events.js → register/events.js} +13 -3
  131. package/dist/{register-history.js → register/history.js} +7 -6
  132. package/dist/{register-item.js → register/item.js} +32 -5
  133. package/dist/register/lifecycle-lock.js +5 -0
  134. package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
  135. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  136. package/dist/{register-migration.js → register/migration.js} +5 -4
  137. package/dist/{register.js → register/register.js} +32 -27
  138. package/dist/{register-renumber.js → register/renumber.js} +38 -11
  139. package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
  140. package/dist/{register-update.js → register/update.js} +5 -5
  141. package/dist/{register-views.js → register/views.js} +47 -7
  142. package/dist/{review-grade.js → review/grade.js} +2 -2
  143. package/dist/{review-plan.js → review/plan.js} +3 -3
  144. package/dist/{routine-definition.js → routine/definition.js} +2 -2
  145. package/dist/{routine.js → routine/routine.js} +49 -22
  146. package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
  147. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  148. package/dist/{schedule.js → schedule/schedule.js} +6 -6
  149. package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
  150. package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
  151. package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
  152. package/dist/shared/agent-types.js +23 -0
  153. package/dist/shared/artifact-path.js +9 -0
  154. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  155. package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
  156. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  157. package/dist/shared/fs.js +30 -0
  158. package/dist/shared/git.js +346 -0
  159. package/dist/shared/grade-result.js +94 -0
  160. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  161. package/dist/shared/plan-templates.js +114 -0
  162. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +6 -3
  163. package/dist/shared/random.js +4 -0
  164. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  165. package/dist/shared/schedule-paths.js +9 -0
  166. package/dist/{specdojo-config.js → shared/specdojo-config.js} +162 -21
  167. package/dist/{exec-shared.js → shared/text.js} +4 -135
  168. package/dist/shared/time.js +28 -0
  169. package/dist/shared/workspace-scaffold.js +69 -0
  170. package/dist/specdojo.js +22 -22
  171. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +31 -18
  172. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  173. package/docs/ja/specdojo/exec-templates/xep-register-template.md +3 -2
  174. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  175. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  176. package/docs/ja/specdojo/exec-templates/xrp-register-post-run-template.md +46 -0
  177. package/docs/ja/specdojo/guides/branch-workflow-guide.md +34 -1
  178. package/docs/ja/specdojo/guides/docs-structure-guide.md +2 -0
  179. package/docs/ja/specdojo/guides/exec-config-guide.md +169 -26
  180. package/docs/ja/specdojo/guides/exec-operation-guide.md +184 -13
  181. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  182. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +40 -3
  183. package/docs/ja/specdojo/guides/quick-start-guide.md +89 -21
  184. package/docs/ja/specdojo/guides/register-operation-guide.md +44 -1
  185. package/docs/ja/specdojo/guides/remote-host-development-guide.md +61 -6
  186. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
  188. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +1 -1
  189. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  190. package/docs/ja/specdojo/guides/waza-guide.md +1 -1
  191. package/docs/ja/specdojo/references/command-reference.md +124 -55
  192. package/docs/ja/specdojo/references/specdojo-config-reference.md +33 -7
  193. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +22 -13
  194. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  195. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  196. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  197. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  198. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  199. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +111 -17
  200. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +28 -0
  201. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  202. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  203. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +38 -0
  204. package/docs/specdojo/schemas/v1/register-events.schema.yaml +5 -0
  205. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +91 -7
  206. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  207. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +36 -1
  208. package/package.json +17 -17
  209. package/templates/antigravity/README.md +6 -2
  210. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  211. package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
  212. package/templates/antigravity/orchestrator.md +61 -2
  213. package/templates/claude/README.md +27 -3
  214. package/templates/claude/agents/claude-executor.md +0 -1
  215. package/templates/claude/agents/claude-reporter.md +2 -1
  216. package/templates/claude/agents/claude-review-executor.md +0 -1
  217. package/templates/claude/agents/specdojo-orchestrator.md +61 -2
  218. package/templates/codex/README.md +40 -4
  219. package/templates/codex/agents/specdojo-orchestrator.toml +61 -2
  220. package/templates/codex/orchestrator.md +61 -2
  221. package/templates/devcontainer/devcontainer.json +5 -2
  222. package/templates/devcontainer/post-create.sh +15 -7
  223. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +102 -0
  224. package/templates/devcontainer/remote-host/ssh-config.sample +19 -0
  225. package/templates/devcontainer/vim/vimrc +37 -0
  226. package/templates/init-agent-members.yaml +75 -25
  227. package/templates/init-exec-defaults.yaml +44 -9
  228. package/templates/opencode/README.md +17 -3
  229. package/templates/opencode/agents/opencode-executor.md +0 -1
  230. package/templates/opencode/agents/opencode-reporter.md +2 -1
  231. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  232. package/templates/opencode/agents/specdojo-orchestrator.md +61 -2
  233. package/dist/devcontainer-scaffold.js +0 -165
  234. package/dist/exec-schedule-gantt-chart.js +0 -2
  235. package/dist/exec-worktree.js +0 -474
  236. package/dist/exec.js +0 -2
  237. package/dist/grade.js +0 -19
  238. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  239. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  240. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  241. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  242. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  243. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  244. /package/dist/{exec-types.js → exec/types.js} +0 -0
  245. /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
  246. /package/dist/{register-command-types.js → register/command-types.js} +0 -0
  247. /package/dist/{review-types.js → review/types.js} +0 -0
  248. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  249. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  250. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  251. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  252. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  253. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  254. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  255. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  256. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  257. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  258. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  259. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
  260. /package/dist/{yaml.js → shared/yaml.js} +0 -0
@@ -1,23 +1,23 @@
1
1
  import { existsSync } from "node:fs";
2
2
  import { join, resolve as pathResolve } from "node:path";
3
- import { validateCatalogLocalIds, validateRulebookKata } from "./catalog-build.js";
4
- import { acquireSchedulerLock, canBlockTask, canCancelTask, canClaimTask, canCompleteTask, canReleaseTask, canReopenTask, canUnblockTask, computeReadyIds, readAllEventFiles, releaseSchedulerLock, schedulerLockPath, writeEventFile, } from "./exec-events.js";
5
- import { eventsDirForProject, generatedDirForProject } from "./exec-project.js";
6
- import { assertValidActor, getProjectViewpointsPath, loadConfig, specdojoRootDir, } from "./specdojo-config.js";
7
- import { buildScheduleIndex, computeCpm, exitWithCode, printValidateResult, selectNextTask, validateAll, writeCpmFiles, writeGeneratedCore, writeScheduleHashAndDiff, } from "./exec-schedule.js";
8
- import { readReadySnapshot } from "./exec-schedule-ready.js";
9
- import { displayWidth, nowUtcIsoSeconds, padEndDisplay, requireNonEmpty } from "./exec-shared.js";
10
- import { archivePlan, buildInPlaceStem, generateDeliverablePlan, generateSinglePlan, resolveDeliverableTarget, stemFromPlanPath, } from "./exec-plans.js";
11
- import { runProviderScaffold, specdojoPackageRootDir } from "./exec-provider-scaffold.js";
12
- import { generateRegisterPlan, normalizePjrId, resolveRegisterRunTarget } from "./exec-register.js";
13
- import { scaffoldViewpoints } from "./review-plan.js";
14
- import { registerCycleCommand, registerResumeCommand, registerRunCommand, registerSlotsCommand, } from "./exec-run.js";
15
- import { buildTaskView } from "./exec-task-view.js";
16
- import { registerExecWorktreeCommands } from "./exec-worktree-command.js";
17
- import { registerExecTrialCommands } from "./exec-trial.js";
18
- import { registerExecHandoffCommands } from "./exec-handoff.js";
19
- import { resolveOwnerForLocalId } from "./exec-strategy.js";
20
- import { DEFAULT_EVENT_MESSAGES, KNOWN_OWNER_LABELS, KNOWN_OWNER_LABELS_TEXT, addCommonAddOptions, addForceOption, addLockOptions, addOwnerOptions, addProjectOptions, ensureActorCanClaimNext, findRosterMember, loadRosterForOpts, loadValidatedExecState, parseApproach, parseTaskMode, printCommandError, resolveClaimOwner, resolveForceOverride, resolveProjectContext, resolveProjectId, resolveSchedulerStrategy, runLockedEventCommand, runReleaseAllBlocked, runSimpleEventCommand, scaffoldClaimResult, } from "./exec-core.js";
3
+ import { validateCatalogLocalIds, validateRulebookKata } from "../catalog/build.js";
4
+ import { acquireSchedulerLock, canBlockTask, canCancelTask, canClaimTask, canCompleteTask, canReleaseTask, canReopenTask, canUnblockTask, computeReadyIds, readAllEventFiles, releaseSchedulerLock, schedulerLockPath, writeEventFile, } from "./events.js";
5
+ import { eventsDirForProject, generatedDirForProject } from "./project.js";
6
+ import { assertValidActor, getProjectViewpointsPath, loadConfig, specdojoRootDir, } from "../shared/specdojo-config.js";
7
+ import { buildScheduleIndex, computeCpm, exitWithCode, printValidateResult, selectNextTask, validateAll, writeCpmFiles, writeGeneratedCore, writeScheduleHashAndDiff, } from "./schedule/schedule.js";
8
+ import { readReadySnapshot } from "./schedule/ready.js";
9
+ import { displayWidth, nowUtcIsoSeconds, padEndDisplay, requireNonEmpty } from "./shared.js";
10
+ import { archivePlan, buildInPlaceStem, generateDeliverablePlan, generateSinglePlan, resolveDeliverableTarget, stemFromPlanPath, } from "./plans.js";
11
+ import { runProviderScaffold, specdojoPackageRootDir } from "../shared/provider-scaffold.js";
12
+ import { generateRegisterPlan, normalizePjrId, resolveRegisterRunTarget } from "./register.js";
13
+ import { scaffoldViewpoints } from "../review/plan.js";
14
+ import { registerCycleCommand, registerResumeCommand, registerRunCommand, registerSlotsCommand, } from "./run/run.js";
15
+ import { buildTaskView } from "./task-view.js";
16
+ import { registerExecWorktreeCommands } from "./worktree-command.js";
17
+ import { registerExecTrialCommands } from "./trial.js";
18
+ import { registerExecHandoffCommands } from "./handoff.js";
19
+ import { resolveOwnerForLocalId } from "./strategy.js";
20
+ import { DEFAULT_EVENT_MESSAGES, KNOWN_OWNER_LABELS, KNOWN_OWNER_LABELS_TEXT, addCommonAddOptions, addForceOption, addLockOptions, addOwnerOptions, addProjectOptions, ensureActorCanClaimNext, findRosterMember, loadRosterForOpts, loadValidatedExecState, parseApproach, parseTaskMode, printCommandError, resolveClaimOwner, resolveForceOverride, resolveProjectContext, resolveProjectId, resolveSchedulerStrategy, runLockedEventCommand, runReleaseAllBlocked, runSimpleEventCommand, scaffoldClaimResult, } from "./core.js";
21
21
  export function registerExecCommands(program) {
22
22
  const exec = program.command("exec").description("Execution helpers");
23
23
  registerExecHandoffCommands(exec);
@@ -184,6 +184,10 @@ export function registerExecCommands(program) {
184
184
  const generated = await generateRegisterPlan({
185
185
  executionPath,
186
186
  projectId,
187
+ ...(catalogPath ? { catalogPath } : {}),
188
+ ...(rolesPath ? { rolesPath } : {}),
189
+ ...(viewpointsPath ? { viewpointsPath } : {}),
190
+ ...(projectContext ? { projectContext } : {}),
187
191
  registerPaths,
188
192
  item,
189
193
  stem,
@@ -1,14 +1,14 @@
1
- import { acquireSchedulerLock, buildEvent, canReleaseTask, collectRepeatable, findDoingTasksForActor, foldEventsToState, readAllEventFiles, releaseSchedulerLock, writeEventFile, } from "./exec-events.js";
2
- import { activateResolvedProjectPaths, resolveProjectPaths } from "./exec-project.js";
3
- import { assertValidActor, loadConfig, loadMemberRoster, specdojoRootDir, } from "./specdojo-config.js";
4
- import { buildScheduleIndex, computeCpm, exitWithCode, printValidateResult, validateAll, writeCpmFiles, writeGeneratedCore, writeScheduleHashAndDiff, } from "./exec-schedule.js";
5
- import { qualifyTaskId, requireNonEmpty } from "./exec-shared.js";
6
- import { finalizeResultSectionsForDeliverable, targetDocIdsForScheduledTask, } from "./exec-plans.js";
7
- import { resetResultForClaim, scaffoldResult } from "./exec-results.js";
8
- import { discardStaleExecWorktree } from "./exec-worktree-ops.js";
9
- import { configuredProductRepos } from "./exec-task-repos.js";
10
- import { buildInitialStateFromStrategy } from "./exec-schedule-initial.js";
11
- import { buildPhaseModeIndex, resolveApproach, resolveTaskExecution, resolveTaskMode, } from "./exec-strategy.js";
1
+ import { acquireSchedulerLock, buildEvent, canReleaseTask, collectRepeatable, findDoingTasksForActor, foldEventsToState, readAllEventFiles, releaseSchedulerLock, writeEventFile, } from "./events.js";
2
+ import { activateResolvedProjectPaths, resolveProjectPaths } from "./project.js";
3
+ import { assertValidActor, loadConfig, loadMemberRoster, specdojoRootDir, } from "../shared/specdojo-config.js";
4
+ import { buildScheduleIndex, computeCpm, exitWithCode, printValidateResult, validateAll, writeCpmFiles, writeGeneratedCore, writeScheduleHashAndDiff, } from "./schedule/schedule.js";
5
+ import { qualifyTaskId, requireNonEmpty } from "./shared.js";
6
+ import { finalizeResultSectionsForDeliverable, targetDocIdsForScheduledTask } from "./plans.js";
7
+ import { resetResultForClaim, scaffoldResult } from "./results.js";
8
+ import { discardStaleExecWorktree } from "./worktree-ops.js";
9
+ import { configuredProductRepos } from "./task-repos.js";
10
+ import { buildInitialStateFromStrategy } from "./schedule/initial.js";
11
+ import { buildPhaseModeIndex, resolveApproach, resolveTaskExecution, resolveTaskMode, } from "./strategy.js";
12
12
  export const KNOWN_OWNER_LABELS = ["PO", "PM", "BA", "ARC", "DEV", "QE", "UX", "OPS"];
13
13
  export const KNOWN_OWNER_LABELS_TEXT = KNOWN_OWNER_LABELS.join("|");
14
14
  const KNOWN_APPROACHES = [
@@ -1,7 +1,7 @@
1
1
  import { extname, join, resolve } from "node:path";
2
2
  import { mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
3
- import { collectRepeatable, ensureDir, isUtcIsoSeconds, listFilesRecursive, nowUtcIsoSeconds, parseKeyValuePairs, randomHex, readJson, requireNonEmpty, safeSlug, sleepMs, toArtifactPath, tsForFilenameUtc, writeJson, } from "./exec-shared.js";
4
- import { eventsDirForProject, executionRootForProject } from "./exec-project.js";
3
+ import { collectRepeatable, ensureDir, isUtcIsoSeconds, listFilesRecursive, nowUtcIsoSeconds, parseKeyValuePairs, randomHex, readJson, requireNonEmpty, safeSlug, sleepMs, toArtifactPath, tsForFilenameUtc, writeJson, } from "./shared.js";
4
+ import { eventsDirForProject, executionRootForProject } from "./project.js";
5
5
  export { collectRepeatable };
6
6
  export function validateEventShape(obj, source) {
7
7
  const errs = [];
@@ -1,7 +1,7 @@
1
1
  import { readFileSync, renameSync, writeFileSync } from "node:fs";
2
2
  import { dirname, join, relative, sep } from "node:path";
3
- import { ensureDir, redactSensitiveText, safeSlug } from "./exec-shared.js";
4
- import { gitOutput } from "./exec-worktree.js";
3
+ import { ensureDir, redactSensitiveText, safeSlug } from "./shared.js";
4
+ import { gitOutput } from "./worktree.js";
5
5
  const MAX_LOG_BYTES = 64 * 1024;
6
6
  const MAX_CHANGE_FILES = 1_000;
7
7
  const MAX_FINAL_MESSAGE_LENGTH = 4_000;
@@ -29,7 +29,7 @@ function boundedLog(value) {
29
29
  truncated: true,
30
30
  };
31
31
  }
32
- export { redactSensitiveText } from "./exec-shared.js";
32
+ export { redactSensitiveText } from "./shared.js";
33
33
  function boundedText(value, limit) {
34
34
  return truncate(redactSensitiveText(typeof value === "string" ? value.trim() : ""), limit);
35
35
  }
@@ -311,6 +311,7 @@ export function buildExecutorEvidence(input) {
311
311
  },
312
312
  validations,
313
313
  ...(report.targetCoverage.length > 0 ? { target_coverage: report.targetCoverage } : {}),
314
+ ...(input.rateLimitEvents?.length ? { rate_limit_events: input.rateLimitEvents } : {}),
314
315
  final_message: report.finalMessage,
315
316
  ...(input.status === "succeeded"
316
317
  ? {}
@@ -374,6 +375,7 @@ export function recordExecutorEvidence(input) {
374
375
  diffStat,
375
376
  logRefPath: repoRelative(input.worktreePath, logPath),
376
377
  parentValidations: input.parentValidations,
378
+ rateLimitEvents: input.rateLimitEvents,
377
379
  });
378
380
  writeFileSync(logPath, logExcerpt, "utf8");
379
381
  writeFileSync(evidencePath, `${JSON.stringify(evidence, null, 2)}\n`, "utf8");
@@ -408,11 +410,12 @@ export function recordCommandEvidence(input) {
408
410
  writeFileSync(stderrPath, boundedStderr.content, "utf8");
409
411
  const stdoutRef = repoRelative(input.worktreePath, stdoutPath);
410
412
  const stderrRef = repoRelative(input.worktreePath, stderrPath);
411
- const succeeded = input.exitCode === 0 && !input.error;
413
+ const succeeded = !input.error && (input.exitCode === 0 || input.accepted === true);
414
+ const acceptedNonzero = succeeded && input.exitCode !== 0;
412
415
  const safeCommand = boundedText(input.command, 16_000);
413
416
  const summary = input.error
414
417
  ? `spawn failed: ${boundedText(input.error, MAX_VALIDATION_SUMMARY_LENGTH)}`
415
- : `exit ${input.exitCode ?? "unknown"}`;
418
+ : `exit ${input.exitCode ?? "unknown"}${acceptedNonzero ? " (accepted)" : ""}`;
416
419
  const evidence = {
417
420
  schema_version: 1,
418
421
  task_id: input.taskId,
@@ -423,7 +426,9 @@ export function recordCommandEvidence(input) {
423
426
  status: succeeded ? "succeeded" : "failed",
424
427
  started_at: input.startedAt,
425
428
  completed_at: input.completedAt,
426
- exit_code: input.exitCode,
429
+ // The stage exit code represents whether the executor pipeline may continue. The actual
430
+ // command exit code remains authoritative in command.exit_code below.
431
+ exit_code: succeeded ? 0 : input.exitCode,
427
432
  attempts: 1,
428
433
  },
429
434
  changes,
@@ -0,0 +1,2 @@
1
+ export { resolveClaimOwner } from "./core.js";
2
+ export { registerExecCommands } from "./commands.js";
@@ -0,0 +1 @@
1
+ export * from "../shared/markdown-format.js";
@@ -3,16 +3,16 @@ import { existsSync, lstatSync, mkdtempSync, readFileSync, readdirSync, rmSync,
3
3
  import { tmpdir } from "node:os";
4
4
  import { createInterface } from "node:readline/promises";
5
5
  import { join, posix, resolve } from "node:path";
6
- import { isAgentProtectedConfigPath } from "./exec-agent-protected-config.js";
7
- import { PROTECTION_HANDOFF_MARKER } from "./exec-protection-handoff.js";
8
- import { normalizePjrId, resolveRegisterRunTarget } from "./exec-register.js";
9
- import { refsTrailer, withCommitTrailers } from "./exec-repo-trace.js";
10
- import { configuredProductReposForProject } from "./exec-task-repos.js";
11
- import { parseSpecdojoDocument } from "./frontmatter-namespace.js";
12
- import { qualifyTaskId } from "./exec-shared.js";
13
- import { specdojoRootDir } from "./specdojo-config.js";
14
- import { findExecWorktree, gitEnvironment, gitOutput, gitResult } from "./exec-worktree.js";
15
- import { stageCommitTargets, stabilizeCommitTargets, unstageCommitTargets, worktreeStatusPaths, } from "./exec-worktree-ops.js";
6
+ import { isAgentProtectedConfigPath } from "./agent-protected-config.js";
7
+ import { PROTECTION_HANDOFF_MARKER } from "./protection-handoff.js";
8
+ import { normalizePjrId, resolveRegisterRunTarget } from "./register.js";
9
+ import { refsTrailer, withCommitTrailers } from "./repo-trace.js";
10
+ import { configuredProductReposForProject } from "./task-repos.js";
11
+ import { parseSpecdojoDocument } from "../docs/frontmatter-namespace.js";
12
+ import { qualifyTaskId } from "./shared.js";
13
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
14
+ import { findExecWorktree, formatGitResultFailure, gitEnvironment, gitOutput, gitResult, } from "./worktree.js";
15
+ import { stageCommitTargets, stabilizeCommitTargets, unstageCommitTargets, worktreeStatusPaths, } from "./worktree-ops.js";
16
16
  const HANDOFF_MECHANISM = "agent-config-write";
17
17
  const TRUNCATED_EVIDENCE_RE = /^\.\.\. \((?:\d+ 行を省略|文字数上限で切り詰め)\)$/m;
18
18
  function sectionAfterMarker(content) {
@@ -182,11 +182,12 @@ function applyAndCommit(repo, message) {
182
182
  throw new Error(gitApplyError(applied));
183
183
  try {
184
184
  stageCommitTargets(repo.root, repo.paths);
185
- const staged = gitResult(repo.root, ["diff", "--cached", "--quiet", "--", ...repo.paths]);
185
+ const stagedArgs = ["diff", "--cached", "--quiet", "--", ...repo.paths];
186
+ const staged = gitResult(repo.root, stagedArgs);
186
187
  if (staged.status !== 1) {
187
188
  if (staged.status === 0)
188
189
  throw new Error("The proposed patch produced no staged change.");
189
- throw new Error("Could not inspect the staged handoff change.");
190
+ throw new Error(`Could not inspect the staged handoff change: ${formatGitResultFailure(stagedArgs, staged)}`);
190
191
  }
191
192
  const commit = gitResult(repo.root, ["commit", "-m", message, "--", ...repo.paths]);
192
193
  if (commit.status !== 0) {
@@ -17,6 +17,12 @@ function limitKind(output) {
17
17
  return "oom";
18
18
  return "rate_limit";
19
19
  }
20
+ function outputLines(output) {
21
+ return output
22
+ .split(/\r?\n/)
23
+ .map((line) => line.trim())
24
+ .filter(Boolean);
25
+ }
20
26
  function diagnosticLine(output, kind) {
21
27
  const patterns = {
22
28
  rate_limit: /rate limit|too many requests|\b429\b|retry.after/i,
@@ -26,11 +32,11 @@ function diagnosticLine(output, kind) {
26
32
  timeout: /timeout|timed out/i,
27
33
  oom: /out of memory|\boom\b/i,
28
34
  };
29
- const lines = output
30
- .split(/\r?\n/)
31
- .map((line) => line.trim())
32
- .filter(Boolean);
33
- const matched = lines.find((line) => patterns[kind].test(line)) ?? lines.at(-1) ?? "limit reached";
35
+ const lines = outputLines(output);
36
+ // The provider prints its limit notice at the end; earlier matches can be transcript echoes.
37
+ const matched = [...lines].reverse().find((line) => patterns[kind].test(line)) ??
38
+ lines.at(-1) ??
39
+ "limit reached";
34
40
  return matched.length > RAW_MESSAGE_MAX_LENGTH
35
41
  ? `${matched.slice(0, RAW_MESSAGE_MAX_LENGTH)}…`
36
42
  : matched;
@@ -89,12 +95,28 @@ function parseProviderReset(output, observedAt) {
89
95
  if (!Number.isNaN(parsed.getTime()) && parsed > observedAt)
90
96
  return parsed;
91
97
  }
92
- const timeOnly = output.match(/resets?(?:\s+at)?\s+(\d{1,2}):(\d{2})\s*(am|pm)?(?:\s*\(([^)]+)\)|\s+(UTC|GMT|JST|(?:UTC|GMT)?[+-]\d{1,2}(?::?\d{2})?))?/i);
98
+ // Antigravity reports a relative reset such as "Resets in 4h36m50s".
99
+ const relative = output.match(/\bresets?\s+in\s+(\d+\s*[dhms](?:\s*\d+\s*[dhms])*)\b/i);
100
+ if (relative) {
101
+ const unitMilliseconds = {
102
+ d: 86_400_000,
103
+ h: 3_600_000,
104
+ m: 60_000,
105
+ s: 1000,
106
+ };
107
+ let totalMilliseconds = 0;
108
+ for (const part of relative[1].matchAll(/(\d+)\s*([dhms])/gi)) {
109
+ totalMilliseconds += Number.parseInt(part[1], 10) * unitMilliseconds[part[2].toLowerCase()];
110
+ }
111
+ if (totalMilliseconds > 0)
112
+ return new Date(observedAt.getTime() + totalMilliseconds);
113
+ }
114
+ const timeOnly = output.match(/(?:\bresets?(?:\s+at)?|\b(?:retry|try)\s+again\s+at)\s+(\d{1,2}):(\d{2})\s*(am|pm)?(?:\s*\(([^)]+)\)|\s+(UTC|GMT|JST|(?:UTC|GMT)?[+-]\d{1,2}(?::?\d{2})?))?/i);
93
115
  if (!timeOnly)
94
116
  return undefined;
95
- const offset = timezoneOffsetMinutes(timeOnly[4] ?? timeOnly[5]);
96
- if (offset === undefined)
97
- return undefined;
117
+ // Provider CLIs commonly omit the timezone for a reset shown in the operator's local time
118
+ // (for example, "try again at 1:29 AM"). In that form use the process-local offset.
119
+ const offset = timezoneOffsetMinutes(timeOnly[4] ?? timeOnly[5]) ?? -observedAt.getTimezoneOffset();
98
120
  let hour = Number.parseInt(timeOnly[1], 10);
99
121
  const minute = Number.parseInt(timeOnly[2], 10);
100
122
  const meridiem = timeOnly[3]?.toLowerCase();
@@ -108,12 +130,38 @@ function parseProviderReset(output, observedAt) {
108
130
  }
109
131
  return nextTimeOfDayUtc(observedAt, hour, minute, offset);
110
132
  }
133
+ const RESUME_HINT_PATTERN = /reset|retry|try\s+again/i;
134
+ // The agent output is the whole transcript: codex exec echoes the prompt and every command output
135
+ // before the limit notice. A first match over the whole text can therefore pick an echoed example
136
+ // such as "resets 4:10am (UTC)" from a config file. Read the resume time per line, starting from
137
+ // the last line, so the provider's own notice at the end wins over earlier echoes.
138
+ function parseResumeTime(output, observedAt) {
139
+ const lines = outputLines(output);
140
+ for (let index = lines.length - 1; index >= 0; index--) {
141
+ const line = lines[index];
142
+ if (!RESUME_HINT_PATTERN.test(line))
143
+ continue;
144
+ const retryAfter = parseRetryAfter(line, observedAt);
145
+ if (retryAfter)
146
+ return { retryAfter };
147
+ const providerReset = parseProviderReset(line, observedAt);
148
+ if (providerReset)
149
+ return { providerReset };
150
+ }
151
+ return {};
152
+ }
111
153
  export function normalizeAgentLimit(input) {
112
154
  const observedAt = input.observedAt ?? new Date();
113
155
  const kind = limitKind(input.output);
114
- const retryableKind = kind !== "quota_exhausted";
115
- const retryAfter = retryableKind ? parseRetryAfter(input.output, observedAt) : undefined;
116
- const providerReset = retryableKind ? parseProviderReset(input.output, observedAt) : undefined;
156
+ const { retryAfter: parsedRetryAfter, providerReset: parsedProviderReset } = parseResumeTime(input.output, observedAt);
157
+ // A quota/usage limit is normally not safe to auto-resume, but an explicit future retry/reset
158
+ // supplied by the provider is authoritative. Vague text such as "resets tomorrow" remains
159
+ // non-retryable and does not pick up a configured cooldown.
160
+ const retryableKind = kind !== "quota_exhausted" ||
161
+ parsedRetryAfter !== undefined ||
162
+ parsedProviderReset !== undefined;
163
+ const retryAfter = retryableKind ? parsedRetryAfter : undefined;
164
+ const providerReset = retryableKind ? parsedProviderReset : undefined;
117
165
  const configuredCooldown = input.cooldownSeconds?.[kind];
118
166
  const cooldown = retryableKind &&
119
167
  configuredCooldown !== undefined &&
@@ -143,6 +191,39 @@ export function normalizeAgentLimit(input) {
143
191
  ...(resumeSource ? { resume_source: resumeSource } : {}),
144
192
  };
145
193
  }
194
+ // Decide whether a pinned agent waits for its limit reset. Each skip reason has its own message so
195
+ // the run log tells an unreadable reset time apart from one that is too far away.
196
+ export function decidePinnedWait(limit, now, maxWaitSeconds) {
197
+ const limitLine = limit?.raw_message ?? "-";
198
+ const resumeAt = limit?.resume_at ? new Date(limit.resume_at) : undefined;
199
+ if (!resumeAt || Number.isNaN(resumeAt.getTime())) {
200
+ return {
201
+ action: "skip",
202
+ reason: "unreadable",
203
+ message: "Pinned-agent wait skipped: resume time could not be read from the agent output. " +
204
+ `Limit line: ${limitLine}`,
205
+ };
206
+ }
207
+ const source = limit?.resume_source ?? "unknown";
208
+ const waitMilliseconds = resumeAt.getTime() - now.getTime();
209
+ if (waitMilliseconds < 0) {
210
+ return {
211
+ action: "skip",
212
+ reason: "past",
213
+ message: `Pinned-agent wait skipped: resume time ${resumeAt.toISOString()} (${source}) ` +
214
+ `has already passed. Limit line: ${limitLine}`,
215
+ };
216
+ }
217
+ if (waitMilliseconds > maxWaitSeconds * 1000) {
218
+ return {
219
+ action: "skip",
220
+ reason: "exceeds",
221
+ message: `Pinned-agent wait skipped: resume time ${resumeAt.toISOString()} (${source}) is ` +
222
+ `${Math.ceil(waitMilliseconds / 1000)}s away and exceeds the limit of ${maxWaitSeconds}s.`,
223
+ };
224
+ }
225
+ return { action: "wait", resumeAt, waitMilliseconds };
226
+ }
146
227
  function metaString(meta, key) {
147
228
  const value = meta?.[key];
148
229
  return typeof value === "string" ? value : undefined;
@@ -1,9 +1,9 @@
1
1
  import { spawn } from "node:child_process";
2
2
  import { join } from "node:path";
3
- import { gitEnvironment } from "./exec-worktree.js";
4
- import { acquirePoolSlot, getActiveExecLocksDir, releaseLock } from "./exec-slot-lock.js";
5
- import { redactSensitiveText } from "./exec-evidence.js";
6
- import { PROJECT_REPO_WORKTREE_DIRNAME, REPO_NAME_PATTERN } from "./specdojo-config.js";
3
+ import { gitEnvironment } from "./worktree.js";
4
+ import { acquirePoolSlot, getActiveExecLocksDir, releaseLock } from "./slot-lock.js";
5
+ import { redactSensitiveText } from "./evidence.js";
6
+ import { PROJECT_REPO_WORKTREE_DIRNAME, REPO_NAME_PATTERN } from "../shared/specdojo-config.js";
7
7
  export const MAX_PARENT_VALIDATION_STREAM_BYTES = 1024 * 1024;
8
8
  const MAX_SUMMARY_LENGTH = 1_000;
9
9
  const CAPTURE_MARKER_RESERVE_BYTES = 256;
@@ -57,6 +57,20 @@ const PARENT_VALIDATION_REGISTRY = {
57
57
  displayCommand: "npm run lint:md",
58
58
  timeoutMs: 10 * 60 * 1_000,
59
59
  },
60
+ build: {
61
+ id: "build",
62
+ command: process.platform === "win32" ? "npm.cmd" : "npm",
63
+ args: ["run", "build"],
64
+ displayCommand: "npm run build",
65
+ timeoutMs: 10 * 60 * 1_000,
66
+ },
67
+ "format-check": {
68
+ id: "format-check",
69
+ command: process.platform === "win32" ? "npm.cmd" : "npm",
70
+ args: ["run", "format:check"],
71
+ displayCommand: "npm run format:check",
72
+ timeoutMs: 10 * 60 * 1_000,
73
+ },
60
74
  };
61
75
  function truncateHead(value, limit) {
62
76
  if (value.length <= limit)
@@ -1,6 +1,6 @@
1
1
  import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
2
2
  import { dirname, join, relative, resolve, sep } from "node:path";
3
- import { ensureDir, safeSlug } from "./exec-shared.js";
3
+ import { ensureDir, safeSlug } from "./shared.js";
4
4
  function emptyStage(actor) {
5
5
  return {
6
6
  status: "pending",
@@ -22,6 +22,7 @@ export function createPipelineState(input) {
22
22
  reporter: emptyStage(input.reporterActor),
23
23
  },
24
24
  ...(input.artifacts ? { artifacts: input.artifacts } : {}),
25
+ ...(input.integrationBranches ? { integration_branches: input.integrationBranches } : {}),
25
26
  };
26
27
  }
27
28
  function executionRelative(repoRoot, executionPath) {
@@ -39,6 +40,22 @@ function isStageState(value) {
39
40
  if (!value || typeof value !== "object" || Array.isArray(value))
40
41
  return false;
41
42
  const stage = value;
43
+ const events = stage.rate_limit_events;
44
+ const validEvents = events === undefined ||
45
+ (Array.isArray(events) &&
46
+ events.every((event) => {
47
+ if (!event || typeof event !== "object" || Array.isArray(event))
48
+ return false;
49
+ const record = event;
50
+ return ((record.action === "wait" || record.action === "fallback") &&
51
+ (record.trigger === undefined ||
52
+ record.trigger === "rate_limit" ||
53
+ record.trigger === "connection_error") &&
54
+ typeof record.from_actor === "string" &&
55
+ typeof record.to_actor === "string" &&
56
+ typeof record.resumed_at === "string" &&
57
+ (record.resume_at === undefined || typeof record.resume_at === "string"));
58
+ }));
42
59
  return ((stage.status === "pending" ||
43
60
  stage.status === "running" ||
44
61
  stage.status === "succeeded" ||
@@ -50,7 +67,8 @@ function isStageState(value) {
50
67
  stage.attempts >= 0 &&
51
68
  (typeof stage.started_at === "string" || stage.started_at === null) &&
52
69
  (typeof stage.completed_at === "string" || stage.completed_at === null) &&
53
- (typeof stage.artifact_ref === "string" || stage.artifact_ref === null));
70
+ (typeof stage.artifact_ref === "string" || stage.artifact_ref === null) &&
71
+ validEvents);
54
72
  }
55
73
  function isRepoIntegrationState(value) {
56
74
  if (!value || typeof value !== "object" || Array.isArray(value))
@@ -83,6 +101,12 @@ function isArtifactRefs(value) {
83
101
  typeof refs.result_ref === "string" &&
84
102
  !!refs.result_ref);
85
103
  }
104
+ function isIntegrationBranches(value) {
105
+ return (!!value &&
106
+ typeof value === "object" &&
107
+ !Array.isArray(value) &&
108
+ Object.entries(value).every(([repo, branch]) => /^[a-z0-9-]+$/.test(repo) && typeof branch === "string" && !!branch));
109
+ }
86
110
  export function isPipelineState(value) {
87
111
  if (!value || typeof value !== "object" || Array.isArray(value))
88
112
  return false;
@@ -100,6 +124,9 @@ export function isPipelineState(value) {
100
124
  }
101
125
  if (state.artifacts !== undefined && !isArtifactRefs(state.artifacts))
102
126
  return false;
127
+ if (state.integration_branches !== undefined &&
128
+ !isIntegrationBranches(state.integration_branches))
129
+ return false;
103
130
  const stages = state.stages;
104
131
  if (stages.integrate !== undefined && !isIntegrateStageState(stages.integrate))
105
132
  return false;