specdojo 0.3.0 → 0.4.0

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 (245) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/README.md +77 -18
  3. package/dist/catalog/build-references.js +144 -0
  4. package/dist/catalog/build-render.js +32 -0
  5. package/dist/{catalog-build.js → catalog/build.js} +18 -295
  6. package/dist/{catalog.js → catalog/catalog.js} +11 -11
  7. package/dist/{catalog-generate.js → catalog/generate.js} +13 -16
  8. package/dist/catalog/paths.js +1 -0
  9. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +5 -5
  10. package/dist/{catalog-plan.js → catalog/plan.js} +9 -9
  11. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +6 -6
  12. package/dist/{agent.js → commands/agent.js} +11 -11
  13. package/dist/{build-command.js → commands/build.js} +2 -2
  14. package/dist/{init-command.js → commands/init.js} +103 -37
  15. package/dist/{orchestrator.js → commands/orchestrator.js} +2 -2
  16. package/dist/{watch.js → commands/watch.js} +3 -3
  17. package/dist/dashboard/dashboard-timeline.js +175 -0
  18. package/dist/{dashboard.js → dashboard/dashboard.js} +16 -549
  19. package/dist/dashboard/exec-records.js +105 -0
  20. package/dist/dashboard/routines.js +256 -0
  21. package/dist/dashboard/shared.js +14 -0
  22. package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
  23. package/dist/{timeline.js → dashboard/timeline.js} +1 -1
  24. package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
  25. package/dist/{deliverable-trash.js → deliverable/trash.js} +7 -7
  26. package/dist/{devcontainer-command.js → devcontainer/command.js} +5 -3
  27. package/dist/{devcontainer-scaffold.js → devcontainer/scaffold.js} +94 -2
  28. package/dist/{doc-index.js → docs/doc-index.js} +3 -3
  29. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +2 -2
  30. package/dist/{index-command.js → docs/index-command.js} +1 -1
  31. package/dist/docs/template-resolution.js +1 -0
  32. package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +3 -3
  33. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  34. package/dist/{yaml-pages.js → docs/yaml-pages.js} +5 -5
  35. package/dist/{exec-agent-config.js → exec/agent-config.js} +33 -4
  36. package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
  37. package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
  38. package/dist/{exec.js → exec/commands.js} +22 -467
  39. package/dist/exec/core.js +457 -0
  40. package/dist/{exec-events.js → exec/events.js} +2 -2
  41. package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
  42. package/dist/exec/exec.js +2 -0
  43. package/dist/exec/format.js +1 -0
  44. package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
  45. package/dist/{exec-limit.js → exec/limit.js} +93 -12
  46. package/dist/{exec-parent-validation.js → exec/parent-validation.js} +4 -4
  47. package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +16 -2
  48. package/dist/{exec-plans.js → exec/plans-core.js} +97 -468
  49. package/dist/exec/plans-generation.js +249 -0
  50. package/dist/exec/plans-storage.js +131 -0
  51. package/dist/exec/plans.js +3 -0
  52. package/dist/{exec-project.js → exec/project.js} +1 -1
  53. package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
  54. package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
  55. package/dist/{exec-register.js → exec/register.js} +92 -9
  56. package/dist/exec/repo-integration-git.js +23 -0
  57. package/dist/exec/repo-integration-sync.js +264 -0
  58. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +13 -287
  59. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  60. package/dist/exec/reporter-output.js +206 -0
  61. package/dist/{exec-reporter.js → exec/reporter.js} +29 -216
  62. package/dist/{exec-results.js → exec/results.js} +277 -36
  63. package/dist/exec/run/agent-pipeline.js +276 -0
  64. package/dist/exec/run/agent.js +583 -0
  65. package/dist/exec/run/in-place.js +570 -0
  66. package/dist/exec/run/job.js +746 -0
  67. package/dist/exec/run/lifecycle-commands.js +530 -0
  68. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  69. package/dist/exec/run/mode-shared.js +140 -0
  70. package/dist/exec/run/register-command.js +252 -0
  71. package/dist/exec/run/register-core.js +411 -0
  72. package/dist/exec/run/register-mode.js +210 -0
  73. package/dist/exec/run/register-resume.js +398 -0
  74. package/dist/exec/run/register-state.js +325 -0
  75. package/dist/exec/run/register-worktree.js +540 -0
  76. package/dist/exec/run/run.js +11 -0
  77. package/dist/exec/run/schedule-mode.js +294 -0
  78. package/dist/exec/run/schedule-prepare.js +366 -0
  79. package/dist/exec/run/schedule-task.js +599 -0
  80. package/dist/exec/run/shared.js +449 -0
  81. package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
  82. package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
  83. package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
  84. package/dist/exec/schedule/gantt-chart.js +2 -0
  85. package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
  86. package/dist/exec/schedule/index.js +1 -0
  87. package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
  88. package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
  89. package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
  90. package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
  91. package/dist/exec/shared.js +63 -0
  92. package/dist/exec/slot-lock.js +1 -0
  93. package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
  94. package/dist/{exec-task-repos.js → exec/task-repos.js} +2 -2
  95. package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
  96. package/dist/{exec-trial.js → exec/trial-commands.js} +23 -388
  97. package/dist/exec/trial-core.js +371 -0
  98. package/dist/exec/trial.js +2 -0
  99. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  100. package/dist/exec/worktree-ops-commit.js +672 -0
  101. package/dist/exec/worktree-ops-lifecycle.js +297 -0
  102. package/dist/exec/worktree-ops-merge.js +344 -0
  103. package/dist/exec/worktree-ops.js +3 -0
  104. package/dist/exec/worktree.js +305 -0
  105. package/dist/grade/apply.js +734 -0
  106. package/dist/grade/command-apply.js +250 -0
  107. package/dist/grade/command-inspect.js +138 -0
  108. package/dist/grade/command-plan.js +101 -0
  109. package/dist/grade/command-shared.js +68 -0
  110. package/dist/grade/core.js +307 -0
  111. package/dist/grade/grade.js +19 -0
  112. package/dist/grade/markdown.js +274 -0
  113. package/dist/grade/pipeline-state.js +184 -0
  114. package/dist/grade/plan.js +507 -0
  115. package/dist/{grade-result.js → grade/result.js} +7 -96
  116. package/dist/grade/target-discovery.js +265 -0
  117. package/dist/grade/targets.js +435 -0
  118. package/dist/{job.js → job/definition.js} +32 -574
  119. package/dist/job/job.js +568 -0
  120. package/dist/{kata-command.js → kata/command.js} +4 -4
  121. package/dist/{kata.js → kata/kata.js} +5 -5
  122. package/dist/register/approach.js +134 -0
  123. package/dist/register/command-types.js +1 -0
  124. package/dist/register/core.js +369 -0
  125. package/dist/register/create-commands.js +352 -0
  126. package/dist/{register-date.js → register/date.js} +1 -1
  127. package/dist/register/derivation.js +163 -0
  128. package/dist/{register-event-merge.js → register/event-merge.js} +32 -3
  129. package/dist/{register-events.js → register/events.js} +12 -6
  130. package/dist/{register-history.js → register/history.js} +7 -6
  131. package/dist/{register-item.js → register/item.js} +28 -10
  132. package/dist/register/lifecycle-lock.js +5 -0
  133. package/dist/register/maintenance-commands.js +193 -0
  134. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  135. package/dist/register/migration.js +268 -0
  136. package/dist/register/register.js +404 -0
  137. package/dist/register/renumber.js +341 -0
  138. package/dist/register/transition-commands.js +248 -0
  139. package/dist/register/update.js +230 -0
  140. package/dist/register/views.js +296 -0
  141. package/dist/{review-grade.js → review/grade.js} +2 -2
  142. package/dist/{review-plan.js → review/plan.js} +5 -5
  143. package/dist/routine/definition.js +401 -0
  144. package/dist/{routine.js → routine/routine.js} +50 -419
  145. package/dist/{schedule-approach.js → schedule/approach.js} +9 -9
  146. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  147. package/dist/{schedule.js → schedule/schedule.js} +9 -9
  148. package/dist/schedule/strategy-generate-document.js +273 -0
  149. package/dist/schedule/strategy-generate-scope.js +199 -0
  150. package/dist/schedule/strategy-generate.js +348 -0
  151. package/dist/shared/agent-types.js +23 -0
  152. package/dist/shared/artifact-path.js +9 -0
  153. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  154. package/dist/shared/catalog-render.js +115 -0
  155. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  156. package/dist/shared/fs.js +30 -0
  157. package/dist/shared/git.js +316 -0
  158. package/dist/shared/grade-result.js +94 -0
  159. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  160. package/dist/shared/plan-templates.js +114 -0
  161. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +3 -1
  162. package/dist/shared/random.js +4 -0
  163. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  164. package/dist/shared/schedule-paths.js +9 -0
  165. package/dist/{specdojo-config.js → shared/specdojo-config.js} +96 -9
  166. package/dist/{exec-shared.js → shared/text.js} +0 -134
  167. package/dist/shared/time.js +28 -0
  168. package/dist/shared/yaml.js +28 -0
  169. package/dist/specdojo.js +22 -22
  170. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +29 -17
  171. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  172. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -2
  173. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  174. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  175. package/docs/ja/specdojo/guides/exec-config-guide.md +97 -22
  176. package/docs/ja/specdojo/guides/exec-operation-guide.md +145 -12
  177. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  178. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +51 -18
  179. package/docs/ja/specdojo/guides/quick-start-guide.md +81 -16
  180. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -1
  181. package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -1
  182. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  183. package/docs/ja/specdojo/guides/routine-operation-guide.md +6 -6
  184. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  185. package/docs/ja/specdojo/references/command-reference.md +52 -28
  186. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +17 -11
  187. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  188. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  189. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  190. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  191. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  192. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +20 -0
  193. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +23 -0
  194. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  195. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  196. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +26 -0
  197. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  198. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +70 -7
  199. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  200. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -1
  201. package/package.json +4 -5
  202. package/templates/antigravity/README.md +7 -3
  203. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  204. package/templates/antigravity/exec-defaults-snippet.yaml +10 -13
  205. package/templates/claude/README.md +27 -3
  206. package/templates/claude/agents/claude-executor.md +0 -1
  207. package/templates/claude/agents/claude-reporter.md +2 -1
  208. package/templates/claude/agents/claude-review-executor.md +0 -1
  209. package/templates/codex/README.md +23 -4
  210. package/templates/devcontainer/devcontainer.json +2 -2
  211. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +69 -0
  212. package/templates/devcontainer/remote-host/ssh-config.sample +16 -0
  213. package/templates/init-agent-members.yaml +75 -25
  214. package/templates/init-exec-defaults.yaml +26 -8
  215. package/templates/opencode/README.md +17 -3
  216. package/templates/opencode/agents/opencode-executor.md +0 -1
  217. package/templates/opencode/agents/opencode-reporter.md +2 -1
  218. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  219. package/dist/exec-run.js +0 -6182
  220. package/dist/exec-schedule-gantt-chart.js +0 -2
  221. package/dist/exec-worktree-ops.js +0 -1292
  222. package/dist/exec-worktree.js +0 -446
  223. package/dist/grade.js +0 -3193
  224. package/dist/register.js +0 -2407
  225. package/dist/schedule-strategy-generate.js +0 -812
  226. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  227. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  228. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  229. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  230. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  231. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  232. /package/dist/{exec-types.js → exec/types.js} +0 -0
  233. /package/dist/{review-types.js → review/types.js} +0 -0
  234. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  235. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  236. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  237. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  238. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  239. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  240. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  241. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  242. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  243. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  244. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  245. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -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;
@@ -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",
@@ -39,6 +39,19 @@ function isStageState(value) {
39
39
  if (!value || typeof value !== "object" || Array.isArray(value))
40
40
  return false;
41
41
  const stage = value;
42
+ const events = stage.rate_limit_events;
43
+ const validEvents = events === undefined ||
44
+ (Array.isArray(events) &&
45
+ events.every((event) => {
46
+ if (!event || typeof event !== "object" || Array.isArray(event))
47
+ return false;
48
+ const record = event;
49
+ return ((record.action === "wait" || record.action === "fallback") &&
50
+ typeof record.from_actor === "string" &&
51
+ typeof record.to_actor === "string" &&
52
+ typeof record.resumed_at === "string" &&
53
+ (record.resume_at === undefined || typeof record.resume_at === "string"));
54
+ }));
42
55
  return ((stage.status === "pending" ||
43
56
  stage.status === "running" ||
44
57
  stage.status === "succeeded" ||
@@ -50,7 +63,8 @@ function isStageState(value) {
50
63
  stage.attempts >= 0 &&
51
64
  (typeof stage.started_at === "string" || stage.started_at === null) &&
52
65
  (typeof stage.completed_at === "string" || stage.completed_at === null) &&
53
- (typeof stage.artifact_ref === "string" || stage.artifact_ref === null));
66
+ (typeof stage.artifact_ref === "string" || stage.artifact_ref === null) &&
67
+ validEvents);
54
68
  }
55
69
  function isRepoIntegrationState(value) {
56
70
  if (!value || typeof value !== "object" || Array.isArray(value))