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,15 +1,15 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
3
3
  import { dirname, join, relative, resolve, sep } from "node:path";
4
- import { dump } from "./yaml.js";
5
- import { extractJsonText } from "./agent-response.js";
6
- import { CRITERION_ID_RE, CRITERION_STATUSES, DONE_CRITERIA_SCHEMA, SEVERITY_LEVEL_CAP, agentViewpoints, correctViewpointLevels, isRecord, levelCapForFindings, parseMarkdown, preserveStoredFindingSeverities, sanitizeCommentText, } from "./grade-core.js";
7
- import { applicableDoneCriteria, deterministicResults, gradePlanFilename } from "./grade-plan.js";
8
- import { gradeContentHash, gradeResultPath, markdownDocumentId, readGradeResult, writeGradeResult, } from "./grade-result.js";
9
- import { gradeMarkdownDocument, resolveGradeReferenceId, scoreDocument, summarizeDoneCriteria, } from "./grade-markdown.js";
10
- import { assertRubric, createGradeSourceContext, gradeSourceHashes, repoRelativePath, resolveSafeMarkdownPath, resolveSafeRepositoryPath, } from "./grade-targets.js";
11
- import { specdojoRootDir } from "./specdojo-config.js";
12
- import { resolveSpecdojoPath } from "./template-resolution.js";
4
+ import { dump } from "../shared/yaml.js";
5
+ import { extractJsonText } from "../shared/agent-response.js";
6
+ import { CRITERION_ID_RE, CRITERION_STATUSES, DONE_CRITERIA_SCHEMA, SEVERITY_LEVEL_CAP, agentViewpoints, correctViewpointLevels, isRecord, levelCapForFindings, parseMarkdown, preserveStoredFindingSeverities, sanitizeCommentText, } from "./core.js";
7
+ import { applicableDoneCriteria, deterministicResults, gradePlanFilename } from "./plan.js";
8
+ import { gradeContentHash, gradeResultPath, markdownDocumentId, readGradeResult, writeGradeResult, } from "./result.js";
9
+ import { gradeMarkdownDocument, resolveGradeReferenceId, scoreDocument, summarizeDoneCriteria, } from "./markdown.js";
10
+ import { assertRubric, createGradeSourceContext, gradeSourceHashes, repoRelativePath, resolveSafeMarkdownPath, resolveSafeRepositoryPath, } from "./targets.js";
11
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
12
+ import { resolveSpecdojoPath } from "../docs/template-resolution.js";
13
13
  export function normalizeGradeExecutorLine(line) {
14
14
  let normalized = line.replace(/^\s*(?:>\s*)*(?:[-*+]\s+)?/, "");
15
15
  const wrappedMarker = normalized.match(/^\*\*(\[(?:END )?(?:VIEWPOINT[^\]]*|DONE_CRITERIA)\])\*\*\s*$/);
@@ -1,12 +1,12 @@
1
1
  import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
2
2
  import { dirname, join, resolve } from "node:path";
3
- import { extractJsonArrayText } from "./agent-response.js";
4
- import { applyGradeSubmission, buildGradeSubmissionFromAnalysis, parseGradeSubmission, validateGradeReporterFidelity, } from "./grade-apply.js";
5
- import { addGradeSelectionOptions as addSelection, commandError, requireNonNegativeInteger, requireTarget, } from "./grade-command-shared.js";
6
- import { discoverGradeTargets } from "./grade-target-discovery.js";
7
- import { applyGradeFindingTranslations, gradeFindingTranslationInput, gradeResultPathForDocument, readGradeResult, readGradeResultForDocument, writeGradeResult, } from "./grade-result.js";
8
- import { loadViewpoints, repoRelativePath, resolveDeliverableDoneCriteria, resolveGradeActor, resolveProject, resolveSafeRepositoryPath, } from "./grade-targets.js";
9
- import { getProjectExecutionPath, loadMemberRoster, specdojoRootDir } from "./specdojo-config.js";
3
+ import { extractJsonArrayText } from "../shared/agent-response.js";
4
+ import { applyGradeSubmission, buildGradeSubmissionFromAnalysis, parseGradeSubmission, validateGradeReporterFidelity, } from "./apply.js";
5
+ import { addGradeSelectionOptions as addSelection, commandError, requireNonNegativeInteger, requireTarget, } from "./command-shared.js";
6
+ import { discoverGradeTargets } from "./target-discovery.js";
7
+ import { applyGradeFindingTranslations, gradeFindingTranslationInput, gradeResultPathForDocument, readGradeResult, readGradeResultForDocument, writeGradeResult, } from "./result.js";
8
+ import { loadViewpoints, repoRelativePath, resolveDeliverableDoneCriteria, resolveGradeActor, resolveProject, resolveSafeRepositoryPath, } from "./targets.js";
9
+ import { getProjectExecutionPath, loadMemberRoster, specdojoRootDir, } from "../shared/specdojo-config.js";
10
10
  export function renderGradeFindingTranslationPlan(result, translationIndex) {
11
11
  const messages = gradeFindingTranslationInput(result, translationIndex);
12
12
  return [
@@ -1,9 +1,9 @@
1
- import { addGradeSelectionOptions as addSelection, commandError, collectPathOption, requirePipelineStatus, requirePositiveInteger, requireTarget, } from "./grade-command-shared.js";
2
- import { discoverGradeTargets } from "./grade-target-discovery.js";
3
- import { listExhaustedGradePipelineStates, readGradePipelineState, recordGradePipelineStage, } from "./grade-pipeline-state.js";
4
- import { migrateInlineGrades, validateGradeResultForDocument } from "./grade-markdown.js";
5
- import { readGradeResultForDocument } from "./grade-result.js";
6
- import { repoRelativePath, resolveSafeMarkdownPath } from "./grade-targets.js";
1
+ import { addGradeSelectionOptions as addSelection, commandError, collectPathOption, requirePipelineStatus, requirePositiveInteger, requireTarget, } from "./command-shared.js";
2
+ import { discoverGradeTargets } from "./target-discovery.js";
3
+ import { listExhaustedGradePipelineStates, readGradePipelineState, recordGradePipelineStage, } from "./pipeline-state.js";
4
+ import { migrateInlineGrades, validateGradeResultForDocument } from "./markdown.js";
5
+ import { readGradeResultForDocument } from "./result.js";
6
+ import { repoRelativePath, resolveSafeMarkdownPath } from "./targets.js";
7
7
  export function registerGradeInspectionCommands(grade) {
8
8
  addSelection(grade.command("validate").description("Validate stored grade hashes and finding counts")).action((options) => {
9
9
  try {
@@ -1,9 +1,9 @@
1
1
  import { join } from "node:path";
2
- import { discoverGradeTargets } from "./grade-target-discovery.js";
3
- import { writeGradePlans } from "./grade-plan.js";
4
- import { loadViewpoints, repoRelativePath, resolveDeliverableDoneCriteria, resolveProject, } from "./grade-targets.js";
5
- import { getProjectExecutionPath } from "./specdojo-config.js";
6
- import { addGradeSelectionOptions as addSelection, commandError, requireTarget, } from "./grade-command-shared.js";
2
+ import { discoverGradeTargets } from "./target-discovery.js";
3
+ import { writeGradePlans } from "./plan.js";
4
+ import { loadViewpoints, repoRelativePath, resolveDeliverableDoneCriteria, resolveProject, } from "./targets.js";
5
+ import { getProjectExecutionPath } from "../shared/specdojo-config.js";
6
+ import { addGradeSelectionOptions as addSelection, commandError, requireTarget, } from "./command-shared.js";
7
7
  export function registerGradePlanCommands(grade) {
8
8
  addSelection(grade.command("list").description("Print selected document paths without writing grade plans")).action((options) => {
9
9
  try {
@@ -1,9 +1,9 @@
1
1
  import { createHash } from "node:crypto";
2
- import { dump, load } from "./yaml.js";
2
+ import { dump, load } from "../shared/yaml.js";
3
3
  import remarkParse from "remark-parse";
4
4
  import { unified } from "unified";
5
- import { viewpointAppliesToDocument } from "./review-plan.js";
6
- import { gradeContentHash } from "./grade-result.js";
5
+ import { viewpointAppliesToDocument } from "../review/plan.js";
6
+ import { gradeContentHash } from "./result.js";
7
7
  export const GRADE_TARGETS = ["kata", "deliverable"];
8
8
  export const FINDING_RE = /^[ \t]*<!--[ \t]*specdojo:finding[ \t]+id=([^ \t]+)[ \t]+severity=(blocker|major|minor|note)[ \t]+rule=([^ \t]+)(?:[ \t]+line=([1-9][0-9]*))?[ \t]+(.*?)[ \t]*-->[ \t]*(?:\r?\n|$)/gm;
9
9
  export const KATA_DIRS = ["rulebooks", "recipes", "samples", "templates"];
@@ -0,0 +1,19 @@
1
+ import { registerGradeApplyCommands } from "./command-apply.js";
2
+ import { registerGradeInspectionCommands } from "./command-inspect.js";
3
+ import { registerGradePlanCommands } from "./command-plan.js";
4
+ export * from "./apply.js";
5
+ export { renderGradeFindingTranslationPlan } from "./command-apply.js";
6
+ export * from "./core.js";
7
+ export * from "./markdown.js";
8
+ export * from "./pipeline-state.js";
9
+ export * from "./plan.js";
10
+ export * from "./target-discovery.js";
11
+ export * from "./targets.js";
12
+ export function registerGradeCommand(program) {
13
+ const grade = program
14
+ .command("grade")
15
+ .description("Continuously assess Kata and deliverable content quality");
16
+ registerGradePlanCommands(grade);
17
+ registerGradeApplyCommands(grade);
18
+ registerGradeInspectionCommands(grade);
19
+ }
@@ -1,10 +1,10 @@
1
1
  import { readFileSync, writeFileSync } from "node:fs";
2
- import { FINDING_RE, insertFindings, isRecord, legacyInlineContentHash, parseMarkdown, preservePreviousFindingSeverities, serializeMarkdown, withoutFindingComments, } from "./grade-core.js";
3
- import { discoverGradeTargets } from "./grade-target-discovery.js";
4
- import { applicableDoneCriteria, deterministicResults } from "./grade-plan.js";
5
- import { gradeContentHash, gradeResultPath, markdownDocumentId, readGradeResultForDocument, resolveGradeResultsDirectory, validateGradeResult, writeGradeResult, } from "./grade-result.js";
6
- import { assertRubric, relativePathFromRoot, repoRelativePath, resolveSafeMarkdownPath, } from "./grade-targets.js";
7
- import { specdojoRootDir } from "./specdojo-config.js";
2
+ import { FINDING_RE, insertFindings, isRecord, legacyInlineContentHash, parseMarkdown, preservePreviousFindingSeverities, serializeMarkdown, withoutFindingComments, } from "./core.js";
3
+ import { discoverGradeTargets } from "./target-discovery.js";
4
+ import { applicableDoneCriteria, deterministicResults } from "./plan.js";
5
+ import { gradeContentHash, gradeResultPath, markdownDocumentId, readGradeResultForDocument, resolveGradeResultsDirectory, validateGradeResult, writeGradeResult, } from "./result.js";
6
+ import { assertRubric, relativePathFromRoot, repoRelativePath, resolveSafeMarkdownPath, } from "./targets.js";
7
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
8
8
  export function scoreDocument(input, rubric, doc, target) {
9
9
  const definitions = new Map((doc.viewpoints ?? []).map((viewpoint) => [viewpoint.id, viewpoint]));
10
10
  const categoryLevels = new Map();
@@ -1,10 +1,10 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
3
3
  import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
4
- import { listFilesRecursive } from "./exec-shared.js";
5
- import { isRecord, parseMarkdown, pipelineContentHash, } from "./grade-core.js";
6
- import { relativePathFromRoot, repoRelativePath, resolveProject, resolveSafeMarkdownPath, } from "./grade-targets.js";
7
- import { getProjectExecutionPath, specdojoRootDir } from "./specdojo-config.js";
4
+ import { listFilesRecursive } from "../shared/fs.js";
5
+ import { isRecord, parseMarkdown, pipelineContentHash, } from "./core.js";
6
+ import { relativePathFromRoot, repoRelativePath, resolveProject, resolveSafeMarkdownPath, } from "./targets.js";
7
+ import { getProjectExecutionPath, specdojoRootDir } from "../shared/specdojo-config.js";
8
8
  function gradePipelineStateDirectory(projectOption, rootDir = specdojoRootDir()) {
9
9
  const { project } = resolveProject(projectOption);
10
10
  return resolve(rootDir, getProjectExecutionPath(project), "grade", "pipeline");
@@ -1,11 +1,11 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
3
3
  import { basename, extname, join } from "node:path";
4
- import { dump } from "./yaml.js";
5
- import { GRADE_PLAN_EMBEDDED_DOCUMENT_CHARACTER_LIMIT, agentViewpoints, gradedViewpoints, levelCapForFindings, parseMarkdown, } from "./grade-core.js";
6
- import { gradeResultPath, readGradeResult, readGradeResultForDocument } from "./grade-result.js";
7
- import { assertRubric, loadKataReferences, parseGradeReferenceExample, repoRelativePath, resolveGradeReferencePathsFromCatalog, resolveSafeMarkdownPath, resolveSafeRepositoryPath, selectGradeReferenceExampleFromCatalog, } from "./grade-targets.js";
8
- import { viewpointAppliesToDocument } from "./review-plan.js";
4
+ import { dump } from "../shared/yaml.js";
5
+ import { GRADE_PLAN_EMBEDDED_DOCUMENT_CHARACTER_LIMIT, agentViewpoints, gradedViewpoints, levelCapForFindings, parseMarkdown, } from "./core.js";
6
+ import { gradeResultPath, readGradeResult, readGradeResultForDocument } from "./result.js";
7
+ import { assertRubric, loadKataReferences, parseGradeReferenceExample, repoRelativePath, resolveGradeReferencePathsFromCatalog, resolveSafeMarkdownPath, resolveSafeRepositoryPath, selectGradeReferenceExampleFromCatalog, } from "./targets.js";
8
+ import { viewpointAppliesToDocument } from "../review/plan.js";
9
9
  export function deterministicResults(document, definitions, target) {
10
10
  const results = [];
11
11
  const metadata = document.data.specdojo;
@@ -1,93 +1,10 @@
1
- import { createHash } from "node:crypto";
2
1
  import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
3
- import { dirname, join, relative, resolve, sep } from "node:path";
4
- import { dump, load } from "./yaml.js";
5
- import { getProjectExecutionPath, loadConfig, specdojoRootDir } from "./specdojo-config.js";
6
- import { resolveSpecdojoPath } from "./template-resolution.js";
2
+ import { dirname, relative, sep } from "node:path";
3
+ import { dump } from "../shared/yaml.js";
4
+ import { resolveSpecdojoPath } from "../docs/template-resolution.js";
5
+ import { SEVERITIES, gradeContentHash, markdownDocumentId, resolveGradeResultsDirectory, gradeResultFileName, gradeResultPath, gradeResultPathForDocument, parseGradeResult, gradeFindingDisplayMessage, readGradeResult, readGradeResultForDocument, gradeFindingCount, } from "../shared/grade-result.js";
6
+ export { SEVERITIES, gradeContentHash, markdownDocumentId, resolveGradeResultsDirectory, gradeResultFileName, gradeResultPath, gradeResultPathForDocument, parseGradeResult, gradeFindingDisplayMessage, readGradeResult, readGradeResultForDocument, gradeFindingCount, };
7
7
  const GRADE_RESULT_SCHEMA = "docs/specdojo/schemas/v1/grade-result.schema.yaml";
8
- const DOCUMENT_ID_RE = /^[a-z0-9][a-z0-9-:]*$/;
9
- const SEVERITIES = ["blocker", "major", "minor", "note"];
10
- function isRecord(value) {
11
- return typeof value === "object" && value !== null && !Array.isArray(value);
12
- }
13
- export function gradeContentHash(content) {
14
- return createHash("sha256").update(content).digest("hex");
15
- }
16
- export function markdownDocumentId(content, path) {
17
- const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
18
- if (!match)
19
- throw new Error(`${path}: Markdown frontmatter is required`);
20
- const parsed = load(match[1]);
21
- const specdojo = isRecord(parsed) && isRecord(parsed.specdojo) ? parsed.specdojo : undefined;
22
- const id = specdojo?.id;
23
- if (typeof id !== "string" || !DOCUMENT_ID_RE.test(id)) {
24
- throw new Error(`${path}: specdojo.id is required to store a grade result`);
25
- }
26
- return id;
27
- }
28
- export function resolveGradeResultsDirectory(projectOption, rootDir = specdojoRootDir()) {
29
- const { config } = loadConfig();
30
- if (!config)
31
- throw new Error("grade commands require .specdojo/specdojo.config.json");
32
- const projectId = projectOption?.trim() || config.current_project || Object.keys(config.projects)[0] || "";
33
- const project = config.projects[projectId];
34
- if (!project)
35
- throw new Error(`Unknown project: ${projectId}`);
36
- return resolve(rootDir, getProjectExecutionPath(project), "grade", "results");
37
- }
38
- // ファイル名では名前空間区切りの ":" を "." に置き換える(Windows で ":" は使えない)。
39
- // DOCUMENT_ID_RE は "." を許さないため、置換後も元の id と一対一に対応する。
40
- export function gradeResultFileName(documentId) {
41
- if (!DOCUMENT_ID_RE.test(documentId)) {
42
- throw new Error(`Invalid grade result document id: ${documentId}`);
43
- }
44
- return `${documentId.replace(/:/g, ".")}.yaml`;
45
- }
46
- export function gradeResultPath(resultsDirectory, documentId) {
47
- return join(resultsDirectory, gradeResultFileName(documentId));
48
- }
49
- export function gradeResultPathForDocument(opts) {
50
- const rootDir = opts.rootDir ?? specdojoRootDir();
51
- const absolute = resolve(rootDir, opts.documentPath);
52
- const content = readFileSync(absolute, "utf8");
53
- return gradeResultPath(resolveGradeResultsDirectory(opts.project, rootDir), markdownDocumentId(content, opts.documentPath));
54
- }
55
- export function parseGradeResult(content, path) {
56
- const parsed = load(content);
57
- if (!isRecord(parsed))
58
- throw new Error(`${path}: grade result must be a mapping`);
59
- const result = parsed;
60
- if (result.version !== 1 ||
61
- typeof result.document !== "string" ||
62
- typeof result.path !== "string" ||
63
- (result.target !== "kata" && result.target !== "deliverable") ||
64
- typeof result.rubric !== "string" ||
65
- (result.verdict !== "pass" && result.verdict !== "needs-work" && result.verdict !== "fail") ||
66
- !Number.isSafeInteger(result.score) ||
67
- typeof result.graded_at !== "string" ||
68
- typeof result.graded_by !== "string" ||
69
- typeof result.content_hash !== "string" ||
70
- !isRecord(result.categories) ||
71
- !isRecord(result.viewpoints) ||
72
- !isRecord(result.finding_counts) ||
73
- !Array.isArray(result.findings)) {
74
- throw new Error(`${path}: invalid grade result`);
75
- }
76
- if (result.source_hashes !== undefined &&
77
- (!isRecord(result.source_hashes) ||
78
- Object.values(result.source_hashes).some((hash) => typeof hash !== "string" || !/^[a-f0-9]{64}$/.test(hash)))) {
79
- throw new Error(`${path}: source_hashes must map sources to SHA-256 hex digests`);
80
- }
81
- return result;
82
- }
83
- export function readGradeResult(path) {
84
- if (!existsSync(path))
85
- return undefined;
86
- return parseGradeResult(readFileSync(path, "utf8"), path);
87
- }
88
- export function readGradeResultForDocument(opts) {
89
- return readGradeResult(gradeResultPathForDocument(opts));
90
- }
91
8
  export function renderGradeResult(result, path) {
92
9
  const schemaRef = relative(dirname(path), resolveSpecdojoPath(GRADE_RESULT_SCHEMA))
93
10
  .split(sep)
@@ -108,12 +25,6 @@ export function writeGradeResult(path, result, dryRun = false) {
108
25
  }
109
26
  return true;
110
27
  }
111
- export function gradeFindingCount(result) {
112
- return SEVERITIES.reduce((sum, severity) => sum + result.finding_counts[severity], 0);
113
- }
114
- export function gradeFindingDisplayMessage(finding) {
115
- return finding.message_ja?.trim() || finding.message;
116
- }
117
28
  function isJapaneseFindingMessage(message) {
118
29
  // 英語の finding は対象文書の日本語を inline code で引用できるため、その引用は
119
30
  // 言語判定から外す。引用以外に仮名がある文、または漢字だけの短文を日本語と扱う。
@@ -1,12 +1,12 @@
1
1
  import { existsSync, readFileSync } from "node:fs";
2
2
  import { join } from "node:path";
3
- import { buildScheduleIndex } from "./exec-schedule-index.js";
4
- import { listFilesRecursive } from "./exec-shared.js";
5
- import { gradeContentHash, gradeFindingCount, readGradeResultForDocument } from "./grade-result.js";
6
- import { KATA_DIRS, isRecord, legacyInlineContentHash, parseMarkdown, } from "./grade-core.js";
7
- import { currentGradePipelineState, isIncompleteGradePipelineState, loadGradePipelineStates, } from "./grade-pipeline-state.js";
8
- import { comparisonSourceKeys, createGradeSourceContext, currentSourceHashes, dependencySourceKeys, gradedComparisonSources, isGeneratedGradeTarget, isTrashedGradeTarget, loadDeliverableCatalog, loadViewpointsIfConfigured, relativePathFromRoot, resolveProject, resolveSafeMarkdownPath, sourceHashesChanged, } from "./grade-targets.js";
9
- import { getProjectExecutionPath, specdojoRootDir } from "./specdojo-config.js";
3
+ import { buildScheduleIndex } from "../shared/schedule-index.js";
4
+ import { listFilesRecursive } from "../shared/fs.js";
5
+ import { gradeContentHash, gradeFindingCount, readGradeResultForDocument } from "./result.js";
6
+ import { KATA_DIRS, isRecord, legacyInlineContentHash, parseMarkdown, } from "./core.js";
7
+ import { currentGradePipelineState, isIncompleteGradePipelineState, loadGradePipelineStates, } from "./pipeline-state.js";
8
+ import { comparisonSourceKeys, createGradeSourceContext, currentSourceHashes, dependencySourceKeys, gradedComparisonSources, isGeneratedGradeTarget, isTrashedGradeTarget, loadDeliverableCatalog, loadViewpointsIfConfigured, relativePathFromRoot, resolveProject, resolveSafeMarkdownPath, sourceHashesChanged, } from "./targets.js";
9
+ import { getProjectExecutionPath, specdojoRootDir } from "../shared/specdojo-config.js";
10
10
  export function discoverGradeTargets(opts, rootDir = specdojoRootDir()) {
11
11
  validateGradeTargetFilters(opts);
12
12
  let candidates;
@@ -1,14 +1,14 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { existsSync, readFileSync } from "node:fs";
3
3
  import { extname, isAbsolute, join, relative, resolve } from "node:path";
4
- import { load } from "./yaml.js";
5
- import { collectResolvedDeliverables, loadCatalogDocs } from "./catalog-build.js";
6
- import { isTrashedPath, resolveBasePath } from "./catalog-paths.js";
7
- import { listFilesRecursive } from "./exec-shared.js";
8
- import { gradeContentHash } from "./grade-result.js";
9
- import { GRADE_TARGETS, KATA_DIRS, KATA_REFERENCE_EXTENSIONS, KATA_REFERENCE_FIELDS, gradedViewpoints, isRecord, parseMarkdown, } from "./grade-core.js";
10
- import { resolveViewpointsDoc } from "./review-plan.js";
11
- import { assertValidActor, getProjectCatalogPath, getProjectMembersPath, getProjectRolesPath, getProjectSchedulePath, getProjectViewpointsPath, loadConfig, specdojoRootDir, } from "./specdojo-config.js";
4
+ import { load } from "../shared/yaml.js";
5
+ import { collectResolvedDeliverables, loadCatalogDocs } from "../catalog/build.js";
6
+ import { isTrashedPath, resolveBasePath } from "../catalog/paths.js";
7
+ import { listFilesRecursive } from "../shared/fs.js";
8
+ import { gradeContentHash } from "./result.js";
9
+ import { GRADE_TARGETS, KATA_DIRS, KATA_REFERENCE_EXTENSIONS, KATA_REFERENCE_FIELDS, gradedViewpoints, isRecord, parseMarkdown, } from "./core.js";
10
+ import { resolveViewpointsDoc } from "../review/plan.js";
11
+ import { assertValidActor, getProjectCatalogPath, getProjectMembersPath, getProjectRolesPath, getProjectSchedulePath, getProjectViewpointsPath, loadConfig, resolveAgentMember, specdojoRootDir, } from "../shared/specdojo-config.js";
12
12
  export function resolveProject(projectOption) {
13
13
  const { config } = loadConfig();
14
14
  if (!config)
@@ -39,6 +39,9 @@ export function resolveGradeActor(actor, roster) {
39
39
  throw new Error("--by must be a non-empty agent-members.yaml nickname");
40
40
  if (!roster)
41
41
  throw new Error("members_path is required for grade apply --by");
42
+ const resolvedAgent = resolveAgentMember(roster, normalized);
43
+ if (resolvedAgent)
44
+ return resolvedAgent.nickname;
42
45
  assertValidActor(normalized, roster);
43
46
  if (roster.members.filter((member) => member.nickname === normalized).length !== 1) {
44
47
  throw new Error(`Duplicate actor nickname in members_path: ${normalized}`);
@@ -1,8 +1,8 @@
1
1
  import { existsSync, readFileSync } from "node:fs";
2
2
  import { basename, join, resolve } from "node:path";
3
- import { load } from "./yaml.js";
4
- import { listFilesRecursive, readJson } from "./exec-shared.js";
5
- import { getProjectExecutionPath, getProjectJobsPath, loadConfig, loadEnv, specdojoRootDir, } from "./specdojo-config.js";
3
+ import { load } from "../shared/yaml.js";
4
+ import { listFilesRecursive, readJson } from "../shared/fs.js";
5
+ import { getProjectExecutionPath, getProjectJobsPath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
6
6
  function isRecord(value) {
7
7
  return typeof value === "object" && value !== null && !Array.isArray(value);
8
8
  }
@@ -117,7 +117,11 @@ export function jobRunUsesReviewedIntegration(definition, opts) {
117
117
  return jobDeclaresReview(definition) || !!opts.worktree;
118
118
  }
119
119
  function isJobRunState(value) {
120
- return value === "running" || value === "succeeded" || value === "failed" || value === "noop";
120
+ return (value === "running" ||
121
+ value === "succeeded" ||
122
+ value === "partial" ||
123
+ value === "failed" ||
124
+ value === "noop");
121
125
  }
122
126
  function isJobTaskDefinition(value) {
123
127
  if (!isRecord(value))
@@ -130,6 +134,10 @@ function isJobTaskDefinition(value) {
130
134
  return false;
131
135
  if (value.mode === "command") {
132
136
  return (typeof value.command === "string" &&
137
+ (value.partial_exit_code === undefined ||
138
+ (Number.isSafeInteger(value.partial_exit_code) &&
139
+ Number(value.partial_exit_code) >= 1 &&
140
+ Number(value.partial_exit_code) <= 255)) &&
133
141
  (value.precondition === undefined ||
134
142
  (isRecord(value.precondition) &&
135
143
  typeof value.precondition.command === "string" &&
@@ -371,6 +379,13 @@ export function parseJobDefinition(value, fileName) {
371
379
  const command = typeof value.task.command === "string" ? value.task.command.trim() : "";
372
380
  if (!command)
373
381
  errors.push("task.command is required for command mode");
382
+ const partialExitCode = value.task.partial_exit_code;
383
+ if (partialExitCode !== undefined &&
384
+ (!Number.isSafeInteger(partialExitCode) ||
385
+ Number(partialExitCode) < 1 ||
386
+ Number(partialExitCode) > 255)) {
387
+ errors.push("task.partial_exit_code must be an exit code from 1 to 255");
388
+ }
374
389
  let precondition;
375
390
  if (value.task.precondition !== undefined) {
376
391
  if (!isRecord(value.task.precondition)) {
@@ -438,6 +453,9 @@ export function parseJobDefinition(value, fileName) {
438
453
  mode: "command",
439
454
  ...(precondition ? { precondition } : {}),
440
455
  command,
456
+ ...(Number.isSafeInteger(partialExitCode)
457
+ ? { partial_exit_code: Number(partialExitCode) }
458
+ : {}),
441
459
  ...(analysis ? { analysis } : {}),
442
460
  ...common,
443
461
  };
@@ -460,8 +478,9 @@ export function parseJobDefinition(value, fileName) {
460
478
  }
461
479
  if (value.task.analysis !== undefined ||
462
480
  value.task.command !== undefined ||
463
- value.task.precondition !== undefined) {
464
- errors.push("task.command, task.precondition, and task.analysis are only allowed in command mode");
481
+ value.task.precondition !== undefined ||
482
+ value.task.partial_exit_code !== undefined) {
483
+ errors.push("task.command, task.precondition, task.partial_exit_code, and task.analysis are only allowed in command mode");
465
484
  }
466
485
  if (value.task.capabilities !== undefined && !validStringList(value.task.capabilities)) {
467
486
  errors.push("task.capabilities must be a non-empty string list");
@@ -2,15 +2,16 @@ import { createHash } from "node:crypto";
2
2
  import { spawn, spawnSync } from "node:child_process";
3
3
  import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
4
4
  import { join, relative, resolve } from "node:path";
5
- import { buildSpecdojoFrontmatter } from "./frontmatter-namespace.js";
6
- import { formatMarkdownFile } from "./exec-format.js";
7
- import { execTemplatePath, injectCommonConventions, MISSING } from "./exec-plans.js";
8
- import { expandTemplate, listFilesRecursive, writeJson } from "./exec-shared.js";
9
- import { gitEnvironment } from "./exec-worktree.js";
10
- import { isJobAgentTask, isJobCommandTask, getPath, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseInputValue, parseJobInputs, renderJobTemplate, resolveJobPaths, validateJobInputValue, } from "./job-definition.js";
11
- import { specdojoRootDir } from "./specdojo-config.js";
12
- import { selfRunCommand } from "./spawn-self.js";
13
- export { isJobAgentTask, isJobCommandTask, jobDeclaresReview, jobRunUsesReviewedIntegration, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseJobDefinition, parseJobInputs, renderJobTemplate, resolveJobPaths, resolveJobReviewAgentNominations, } from "./job-definition.js";
5
+ import { buildSpecdojoFrontmatter } from "../docs/frontmatter-namespace.js";
6
+ import { listFilesRecursive, writeJson } from "../shared/fs.js";
7
+ import { gitEnvironment } from "../shared/git.js";
8
+ import { formatMarkdownFile } from "../shared/markdown-format.js";
9
+ import { execTemplatePath, injectCommonConventions, MISSING } from "../shared/plan-templates.js";
10
+ import { expandTemplate } from "../shared/text.js";
11
+ import { isJobAgentTask, isJobCommandTask, getPath, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseInputValue, parseJobInputs, renderJobTemplate, resolveJobPaths, validateJobInputValue, } from "./definition.js";
12
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
13
+ import { selfRunCommand } from "../shared/spawn-self.js";
14
+ export { isJobAgentTask, isJobCommandTask, jobDeclaresReview, jobRunUsesReviewedIntegration, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseJobDefinition, parseJobInputs, renderJobTemplate, resolveJobPaths, resolveJobReviewAgentNominations, } from "./definition.js";
14
15
  export function jobCheckpoint(paths, jobId) {
15
16
  return deriveJobState(paths).jobs[jobId]?.checkpoint ?? {};
16
17
  }
@@ -255,7 +256,7 @@ export async function generateJobPlan(paths, definition, record) {
255
256
  "```",
256
257
  "",
257
258
  commandTask.analysis
258
- ? "コマンドが成功した場合だけ、上記の判断を reporter agent が evidence に基づいて行う。"
259
+ ? "コマンドが成功または設定済みの部分成功になった場合、上記の判断を reporter agent が evidence に基づいて行う。"
259
260
  : "コマンドの終了コードから Run の成否を直接決定する。",
260
261
  ].join("\n")
261
262
  : "",
@@ -380,7 +381,7 @@ export async function materializeJobRun(opts) {
380
381
  if (record.idempotency_key !== idempotencyKey || record.job_id !== definition.id) {
381
382
  throw new Error(`Job Run identity collision: ${runId}`);
382
383
  }
383
- if (record.state === "succeeded" || record.state === "noop") {
384
+ if (record.state === "succeeded" || record.state === "partial" || record.state === "noop") {
384
385
  return {
385
386
  definition,
386
387
  record,
@@ -1,8 +1,8 @@
1
1
  import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";
2
2
  import { basename, dirname, extname, join, relative, resolve } from "node:path";
3
- import { load } from "./yaml.js";
4
- import { readSpecdojoNamespace } from "./frontmatter-namespace.js";
5
- import { specdojoResourceCandidates } from "./template-resolution.js";
3
+ import { load } from "../shared/yaml.js";
4
+ import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
5
+ import { specdojoResourceCandidates, } from "../docs/template-resolution.js";
6
6
  export const KATA_RESOURCE_KINDS = [
7
7
  "rulebook",
8
8
  "standard",
@@ -1,9 +1,9 @@
1
1
  import { existsSync, readFileSync } from "node:fs";
2
- import { specdojoRootDir } from "./specdojo-config.js";
3
- import { readSpecdojoNamespace } from "./frontmatter-namespace.js";
4
- import { practiceLocalId } from "./practice-id.js";
5
- import { resolveSpecdojoPathIfExists, resolveSpecdojoReferencePathIfExists, specdojoResourceCandidates, } from "./template-resolution.js";
6
- import { readYamlSchemaModelineRef } from "./yaml-schema-modeline.js";
2
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
3
+ import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
4
+ import { practiceLocalId } from "../shared/practice-id.js";
5
+ import { resolveSpecdojoPathIfExists, resolveSpecdojoReferencePathIfExists, specdojoResourceCandidates, } from "../docs/template-resolution.js";
6
+ import { readYamlSchemaModelineRef } from "../shared/yaml-schema-modeline.js";
7
7
  // 実践の型(rulebook / recipe / sample / template)の解決を 1 か所に集約する。
8
8
  // plan 生成(明示パスの注入)と validate(参照先の存在確認)の両方から使う。
9
9
  const MISSING = "_MISSING_";
@@ -0,0 +1,134 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { isAbsolute, resolve } from "node:path";
3
+ import { collectResolvedDeliverables, loadCatalogDocs } from "../catalog/build.js";
4
+ import { resolveBasePath } from "../catalog/paths.js";
5
+ import { collectDocIndexEntries } from "../docs/doc-index.js";
6
+ import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
7
+ import { getProjectCatalogPath, loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
8
+ import { APPROACHES } from "../shared/agent-types.js";
9
+ import { load } from "../shared/yaml.js";
10
+ const MAINTENANCE_TARGET_KIND = {
11
+ "rulebook-maintenance": "rulebook",
12
+ "recipe-maintenance": "recipe",
13
+ "sample-maintenance": "sample",
14
+ "template-maintenance": "template",
15
+ };
16
+ function resolvedIndexPath(repoRoot, indexedPath) {
17
+ const withoutLine = indexedPath.replace(/:\d+$/, "");
18
+ return resolve(isAbsolute(withoutLine) ? withoutLine : resolve(repoRoot, withoutLine));
19
+ }
20
+ function catalogDeliverableDocIds(catalogPath, repoRoot, projectId) {
21
+ const ids = new Set();
22
+ if (!existsSync(catalogPath))
23
+ return ids;
24
+ for (const loaded of loadCatalogDocs(catalogPath)) {
25
+ const deliverables = [];
26
+ collectResolvedDeliverables(loaded.doc.groups, resolveBasePath("", loaded.doc.base_path), deliverables);
27
+ for (const deliverable of deliverables) {
28
+ // register の対象指定では、PJR-H72A が定める成果物 local_id の canonical 形式も
29
+ // 受け付ける。文書が既にあれば、その frontmatter の実 ID も同じ成果物として扱う。
30
+ ids.add(`${projectId}:${deliverable.item.local_id}`);
31
+ const path = resolve(repoRoot, deliverable.resolvedPath);
32
+ if (existsSync(path)) {
33
+ try {
34
+ const id = readSpecdojoNamespace(readFileSync(path, "utf8")).id;
35
+ if (typeof id === "string" && id.trim()) {
36
+ ids.add(id.trim());
37
+ continue;
38
+ }
39
+ }
40
+ catch {
41
+ // 読み取り不能・不正 frontmatter は配置規約による ID へフォールバックする。
42
+ }
43
+ }
44
+ const normalizedPath = deliverable.resolvedPath.replaceAll("\\", "/").replace(/^\/+/, "");
45
+ if (/^docs\/[a-z]{2}\/product(?:\/|$)/.test(normalizedPath)) {
46
+ ids.add(deliverable.item.local_id);
47
+ }
48
+ }
49
+ }
50
+ return ids;
51
+ }
52
+ function targetDocumentType(path) {
53
+ if (!existsSync(path))
54
+ return undefined;
55
+ const content = readFileSync(path, "utf8");
56
+ if (path.endsWith(".md")) {
57
+ const type = readSpecdojoNamespace(content).type;
58
+ return typeof type === "string" ? type : undefined;
59
+ }
60
+ const parsed = load(content);
61
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
62
+ return undefined;
63
+ const type = parsed.type;
64
+ return typeof type === "string" ? type : undefined;
65
+ }
66
+ // register の個票に approach を書く時点で、対象が一意かつ実行方式に合うことを保証する。
67
+ // kata は都度 docs から収集した索引、成果物は DCT を正本として解決し、生成済みの
68
+ // .specdojo/doc-index.json の鮮度や成果物文書の作成済み・未作成には依存しない。
69
+ export function validateRegisterApproachTargets(opts) {
70
+ const approachText = opts.approach?.trim();
71
+ const targets = [...new Set((opts.targets ?? []).map((target) => target.trim()).filter(Boolean))];
72
+ let approach;
73
+ if (approachText !== undefined) {
74
+ if (!APPROACHES.includes(approachText)) {
75
+ throw new Error(`Invalid approach: "${approachText}". Must be one of: ${APPROACHES.join(", ")}`);
76
+ }
77
+ approach = approachText;
78
+ if (targets.length !== 1) {
79
+ throw new Error(`Approach "${approach}" requires exactly one --target doc id (received ${targets.length})`);
80
+ }
81
+ }
82
+ if (!approach && !opts.validateTargetsWithoutApproach)
83
+ return;
84
+ if (targets.length === 0)
85
+ return;
86
+ const entries = collectDocIndexEntries(resolve(opts.repoRoot, "docs"), opts.repoRoot);
87
+ if (!approach) {
88
+ for (const target of targets) {
89
+ if (!entries[target]) {
90
+ throw new Error(`Target document id is not resolvable via the document index: ${target}`);
91
+ }
92
+ }
93
+ return;
94
+ }
95
+ const expectedKind = MAINTENANCE_TARGET_KIND[approach];
96
+ const [targetId] = targets;
97
+ if (expectedKind) {
98
+ const indexedPath = entries[targetId];
99
+ if (!indexedPath) {
100
+ throw new Error(`Target document id is not resolvable via the document index: ${targetId}`);
101
+ }
102
+ const actualKind = targetDocumentType(resolvedIndexPath(opts.repoRoot, indexedPath));
103
+ if (actualKind !== expectedKind) {
104
+ throw new Error(`Approach "${approach}" requires a ${expectedKind} document target, but ${targetId} has type "${actualKind ?? "unknown"}"`);
105
+ }
106
+ return;
107
+ }
108
+ if (!opts.catalogPath) {
109
+ throw new Error(`Approach "${approach}" requires a deliverable target, but catalog_path is not configured for project ${opts.projectId}`);
110
+ }
111
+ const deliverableDocIds = catalogDeliverableDocIds(opts.catalogPath, opts.repoRoot, opts.projectId);
112
+ if (!deliverableDocIds.has(targetId)) {
113
+ throw new Error(`Approach "${approach}" requires a deliverable document from the project catalog, but ${targetId} is not a catalog deliverable`);
114
+ }
115
+ }
116
+ export function validateRegisterApproachTargetsForProject(opts) {
117
+ const repoRoot = specdojoRootDir();
118
+ const { config, configPath } = loadConfig();
119
+ const project = config?.projects[opts.projectId];
120
+ if (!project) {
121
+ throw new Error(`Unknown project: ${opts.projectId} (check ${configPath})`);
122
+ }
123
+ const catalogPath = getProjectCatalogPath(project);
124
+ validateRegisterApproachTargets({
125
+ repoRoot,
126
+ projectId: opts.projectId,
127
+ ...(catalogPath ? { catalogPath: resolve(repoRoot, catalogPath) } : {}),
128
+ ...(opts.approach !== undefined ? { approach: opts.approach } : {}),
129
+ ...(opts.targets !== undefined ? { targets: opts.targets } : {}),
130
+ ...(opts.validateTargetsWithoutApproach !== undefined
131
+ ? { validateTargetsWithoutApproach: opts.validateTargetsWithoutApproach }
132
+ : {}),
133
+ });
134
+ }