specdojo 0.3.1 → 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 (241) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.md +77 -18
  3. package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
  4. package/dist/catalog/build-render.js +32 -0
  5. package/dist/{catalog-build.js → catalog/build.js} +9 -9
  6. package/dist/{catalog.js → catalog/catalog.js} +10 -10
  7. package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
  8. package/dist/catalog/paths.js +1 -0
  9. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
  10. package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
  11. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
  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} +98 -32
  15. package/dist/{orchestrator.js → commands/orchestrator.js} +2 -2
  16. package/dist/{watch.js → commands/watch.js} +3 -3
  17. package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
  18. package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
  19. package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
  20. package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
  21. package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
  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} +5 -5
  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} +1 -1
  29. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
  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} +1 -1
  33. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  34. package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
  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-commands.js → exec/commands.js} +22 -18
  39. package/dist/{exec-core.js → exec/core.js} +11 -11
  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-core.js → exec/plans-core.js} +68 -114
  49. package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
  50. package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
  51. package/dist/{exec-plans.js → exec/plans.js} +3 -3
  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 → exec/repo-integration-git.js} +2 -2
  57. package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
  58. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +13 -10
  59. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  60. package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
  61. package/dist/{exec-reporter.js → exec/reporter.js} +29 -12
  62. package/dist/{exec-results.js → exec/results.js} +256 -22
  63. package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +32 -12
  64. package/dist/{exec-run-agent.js → exec/run/agent.js} +79 -27
  65. package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
  66. package/dist/{exec-run-job.js → exec/run/job.js} +64 -35
  67. package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
  68. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  69. package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
  70. package/dist/{exec-run-register-command.js → exec/run/register-command.js} +18 -10
  71. package/dist/{exec-run-register-core.js → exec/run/register-core.js} +46 -21
  72. package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +20 -16
  73. package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +22 -17
  74. package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
  75. package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +54 -23
  76. package/dist/{exec-run.js → exec/run/run.js} +11 -11
  77. package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
  78. package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
  79. package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
  80. package/dist/{exec-run-shared.js → exec/run/shared.js} +61 -11
  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-commands.js → exec/trial-commands.js} +20 -22
  97. package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
  98. package/dist/{exec-trial.js → exec/trial.js} +2 -2
  99. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  100. package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
  101. package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
  102. package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
  103. package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
  104. package/dist/exec/worktree.js +305 -0
  105. package/dist/{grade-apply.js → grade/apply.js} +9 -9
  106. package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
  107. package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
  108. package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
  109. package/dist/{grade-core.js → grade/core.js} +3 -3
  110. package/dist/grade/grade.js +19 -0
  111. package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
  112. package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
  113. package/dist/{grade-plan.js → grade/plan.js} +5 -5
  114. package/dist/{grade-result.js → grade/result.js} +5 -94
  115. package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
  116. package/dist/{grade-targets.js → grade/targets.js} +11 -8
  117. package/dist/{job-definition.js → job/definition.js} +25 -6
  118. package/dist/{job.js → job/job.js} +12 -11
  119. package/dist/{kata-command.js → kata/command.js} +3 -3
  120. package/dist/{kata.js → kata/kata.js} +5 -5
  121. package/dist/register/approach.js +134 -0
  122. package/dist/{register-core.js → register/core.js} +13 -7
  123. package/dist/{register-create-commands.js → register/create-commands.js} +115 -8
  124. package/dist/{register-date.js → register/date.js} +1 -1
  125. package/dist/register/derivation.js +163 -0
  126. package/dist/{register-event-merge.js → register/event-merge.js} +32 -3
  127. package/dist/{register-events.js → register/events.js} +9 -3
  128. package/dist/{register-history.js → register/history.js} +7 -6
  129. package/dist/{register-item.js → register/item.js} +23 -5
  130. package/dist/register/lifecycle-lock.js +5 -0
  131. package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
  132. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  133. package/dist/{register-migration.js → register/migration.js} +4 -4
  134. package/dist/{register.js → register/register.js} +32 -27
  135. package/dist/{register-renumber.js → register/renumber.js} +38 -11
  136. package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
  137. package/dist/{register-update.js → register/update.js} +5 -5
  138. package/dist/{register-views.js → register/views.js} +47 -7
  139. package/dist/{review-grade.js → review/grade.js} +2 -2
  140. package/dist/{review-plan.js → review/plan.js} +3 -3
  141. package/dist/{routine-definition.js → routine/definition.js} +2 -2
  142. package/dist/{routine.js → routine/routine.js} +49 -22
  143. package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
  144. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  145. package/dist/{schedule.js → schedule/schedule.js} +6 -6
  146. package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
  147. package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
  148. package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
  149. package/dist/shared/agent-types.js +23 -0
  150. package/dist/shared/artifact-path.js +9 -0
  151. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  152. package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
  153. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  154. package/dist/shared/fs.js +30 -0
  155. package/dist/{exec-worktree.js → shared/git.js} +83 -241
  156. package/dist/shared/grade-result.js +94 -0
  157. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  158. package/dist/shared/plan-templates.js +114 -0
  159. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +3 -1
  160. package/dist/shared/random.js +4 -0
  161. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  162. package/dist/shared/schedule-paths.js +9 -0
  163. package/dist/{specdojo-config.js → shared/specdojo-config.js} +93 -5
  164. package/dist/{exec-shared.js → shared/text.js} +0 -134
  165. package/dist/shared/time.js +28 -0
  166. package/dist/specdojo.js +22 -22
  167. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +29 -17
  168. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  169. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -2
  170. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  171. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  172. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -16
  173. package/docs/ja/specdojo/guides/exec-operation-guide.md +145 -12
  174. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  175. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +31 -0
  176. package/docs/ja/specdojo/guides/quick-start-guide.md +81 -16
  177. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -1
  178. package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -1
  179. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  180. package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
  181. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  182. package/docs/ja/specdojo/references/command-reference.md +52 -28
  183. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +17 -11
  184. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  185. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  186. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  187. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  188. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  189. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +20 -0
  190. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +23 -0
  191. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  192. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  193. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +26 -0
  194. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  195. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +70 -7
  196. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  197. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -1
  198. package/package.json +1 -1
  199. package/templates/antigravity/README.md +5 -1
  200. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  201. package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
  202. package/templates/claude/README.md +27 -3
  203. package/templates/claude/agents/claude-executor.md +0 -1
  204. package/templates/claude/agents/claude-reporter.md +2 -1
  205. package/templates/claude/agents/claude-review-executor.md +0 -1
  206. package/templates/codex/README.md +23 -4
  207. package/templates/devcontainer/devcontainer.json +2 -2
  208. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +69 -0
  209. package/templates/devcontainer/remote-host/ssh-config.sample +16 -0
  210. package/templates/init-agent-members.yaml +75 -25
  211. package/templates/init-exec-defaults.yaml +24 -8
  212. package/templates/opencode/README.md +17 -3
  213. package/templates/opencode/agents/opencode-executor.md +0 -1
  214. package/templates/opencode/agents/opencode-reporter.md +2 -1
  215. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  216. package/dist/exec-schedule-gantt-chart.js +0 -2
  217. package/dist/exec.js +0 -2
  218. package/dist/grade.js +0 -19
  219. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  220. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  221. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  222. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  223. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  224. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  225. /package/dist/{exec-types.js → exec/types.js} +0 -0
  226. /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
  227. /package/dist/{register-command-types.js → register/command-types.js} +0 -0
  228. /package/dist/{review-types.js → review/types.js} +0 -0
  229. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  230. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  231. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  232. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  233. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  234. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  235. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  236. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  237. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  238. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  239. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  240. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
  241. /package/dist/{yaml.js → shared/yaml.js} +0 -0
@@ -0,0 +1,305 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { existsSync, lstatSync, mkdirSync, rmSync, unlinkSync } from "node:fs";
3
+ import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
4
+ import { describeGitProcessFailure, formatGitCommandFailure, GitCommandError, gitEnvironment, gitOutput, gitResult, } from "../shared/git.js";
5
+ export { appendGitFailureLog, appendGitResultFailureLog, describeGitProcessFailure, formatGitCommandFailure, formatGitResultFailure, GIT_LOCAL_ENV_VARS, GIT_OUTPUT_MAX_BUFFER, GitCommandError, gitEnvironment, gitOutput, gitResult, isGitDubiousOwnership, isGitIndexLockContention, isGitNotRepositoryWithGitMetadata, runGitWithTransientRetry, summarizeGitArguments, summarizeGitHookFailure, summarizeGitStderr, transientGitFailureReason, } from "../shared/git.js";
6
+ export function worktreeNameFromTaskId(value) {
7
+ const slug = value
8
+ .trim()
9
+ .replace(/[^A-Za-z0-9._-]+/g, "-")
10
+ .replace(/-+/g, "-")
11
+ .replace(/^-+|-+$/g, "");
12
+ if (!slug)
13
+ throw new Error(`Task ID cannot be used as a worktree name: ${value}`);
14
+ return slug;
15
+ }
16
+ export function resolveWorktreeBase(repoRoot, override, configured) {
17
+ const value = override?.trim() || configured?.trim() || "../worktrees";
18
+ return isAbsolute(value) ? resolve(value) : resolve(repoRoot, value);
19
+ }
20
+ export function listRegisteredWorktrees(repoRoot) {
21
+ const output = gitOutput(repoRoot, ["worktree", "list", "--porcelain"]);
22
+ const result = [];
23
+ let currentPath;
24
+ let currentBranch;
25
+ function pushCurrent() {
26
+ if (currentPath)
27
+ result.push({ path: currentPath, branch: currentBranch });
28
+ currentPath = undefined;
29
+ currentBranch = undefined;
30
+ }
31
+ for (const line of output.split(/\r?\n/)) {
32
+ if (line.startsWith("worktree ")) {
33
+ pushCurrent();
34
+ currentPath = resolve(line.slice("worktree ".length));
35
+ }
36
+ else if (currentPath && line.startsWith("branch refs/heads/")) {
37
+ currentBranch = line.slice("branch refs/heads/".length);
38
+ }
39
+ else if (line === "") {
40
+ pushCurrent();
41
+ }
42
+ }
43
+ pushCurrent();
44
+ return result;
45
+ }
46
+ export function findExecWorktree(repoRoot, taskId) {
47
+ const name = worktreeNameFromTaskId(taskId);
48
+ const branch = `exec/${name}`;
49
+ const registered = listRegisteredWorktrees(repoRoot).find((item) => item.branch === branch);
50
+ if (!registered)
51
+ return null;
52
+ return { path: registered.path, branch, name, created: false };
53
+ }
54
+ export function execBranchExists(repoRoot, taskId) {
55
+ const branch = `exec/${worktreeNameFromTaskId(taskId)}`;
56
+ return (gitResult(repoRoot, ["show-ref", "--verify", "--quiet", `refs/heads/${branch}`]).status === 0);
57
+ }
58
+ function pathEntryExists(target) {
59
+ try {
60
+ lstatSync(target);
61
+ return true;
62
+ }
63
+ catch {
64
+ return false;
65
+ }
66
+ }
67
+ function trackedPackageLockDirs(worktreePath) {
68
+ const output = gitOutput(worktreePath, [
69
+ "ls-files",
70
+ "-z",
71
+ "--",
72
+ "package-lock.json",
73
+ "*/package-lock.json",
74
+ ]);
75
+ const dirs = new Set();
76
+ for (const entry of output.split("\0")) {
77
+ if (!entry)
78
+ continue;
79
+ dirs.add(resolve(worktreePath, entry.slice(0, -"package-lock.json".length) || "."));
80
+ }
81
+ return [...dirs].sort();
82
+ }
83
+ function runNpmCi(packageDir) {
84
+ const command = process.platform === "win32" ? "npm.cmd" : "npm";
85
+ const result = spawnSync(command, ["ci", "--include=dev"], {
86
+ cwd: packageDir,
87
+ env: { ...gitEnvironment(), CI: "true", LEFTHOOK: "0" },
88
+ stdio: "inherit",
89
+ });
90
+ if (result.error) {
91
+ throw new Error(`npm ci could not start in ${packageDir}: ${result.error.message}`);
92
+ }
93
+ if (result.status !== 0) {
94
+ throw new Error(`npm ci failed in ${packageDir} (exit ${result.status ?? "unknown"})`);
95
+ }
96
+ }
97
+ function removeLegacyNodeModulesLink(packageDir) {
98
+ const target = join(packageDir, "node_modules");
99
+ if (!pathEntryExists(target) || !lstatSync(target).isSymbolicLink())
100
+ return;
101
+ unlinkSync(target);
102
+ }
103
+ // Git worktree は独自の作業ツリーを持つだけで node_modules は引き継がないため、
104
+ // tracked package-lock.json ごとに npm ci を実行し、worktree 内へ独立して依存を配置する。
105
+ // 旧方式の共有 symlink は npm に辿らせず、先に link 自体だけを削除する。
106
+ // lock が無い worktree は導入しない。依存が無いまま検証が失敗したときに原因を追えるよう、
107
+ // 導入しなかったことをログに残す(PJR-86Q5)。
108
+ export function installWorktreeDependencies(worktreePath, npmCi = runNpmCi) {
109
+ const packageDirs = trackedPackageLockDirs(resolve(worktreePath));
110
+ if (packageDirs.length === 0) {
111
+ process.stdout.write(`Skipping worktree dependencies: no tracked package-lock.json in ${worktreePath}\n`);
112
+ return;
113
+ }
114
+ for (const packageDir of packageDirs) {
115
+ if (!existsSync(join(packageDir, "package.json"))) {
116
+ throw new Error(`package.json is missing next to package-lock.json: ${packageDir}`);
117
+ }
118
+ removeLegacyNodeModulesLink(packageDir);
119
+ process.stdout.write(`Installing worktree dependencies: ${relative(worktreePath, packageDir) || "."}\n`);
120
+ npmCi(packageDir);
121
+ }
122
+ }
123
+ const SPECDOJO_CONFIG_REL = join(".specdojo", "specdojo.config.json");
124
+ // 生成物の失敗は成果物の失敗と混同されやすい。準備段階であることと、生成物が worktree ごとに
125
+ // 作り直しになる理由をメッセージ本体へ含める。
126
+ export function formatWorktreeBuildFailure(worktreePath, detail) {
127
+ return (`Worktree preparation failed: specdojo build ${detail} in ${worktreePath}. ` +
128
+ `Generated docs are gitignored and must be rebuilt per worktree, so this is a ` +
129
+ `preparation failure, not a task deliverable failure.`);
130
+ }
131
+ // build は worktree 内で完結させる。依存と同じく、worktree の checkout にある CLI を使うため、
132
+ // 実行元プロセスの entry(テストランナー等)へは依存しない。SpecDojo 自身のリポジトリでは
133
+ // src の entry を worktree の tsx で、CLI を依存として使うリポジトリでは
134
+ // node_modules/.bin/specdojo を使う。
135
+ export function resolveWorktreeBuildCommand(worktreePath) {
136
+ const root = resolve(worktreePath);
137
+ const sourceEntry = join(root, "src", "specdojo.ts");
138
+ const localTsx = join(root, "node_modules", ".bin", "tsx");
139
+ if (existsSync(sourceEntry) && existsSync(localTsx)) {
140
+ return { command: process.execPath, args: [localTsx, sourceEntry, "build"] };
141
+ }
142
+ const installedCli = join(root, "node_modules", ".bin", process.platform === "win32" ? "specdojo.cmd" : "specdojo");
143
+ if (existsSync(installedCli))
144
+ return { command: installedCli, args: ["build"] };
145
+ const builtEntry = join(root, "dist", "specdojo.js");
146
+ if (existsSync(builtEntry))
147
+ return { command: process.execPath, args: [builtEntry, "build"] };
148
+ return null;
149
+ }
150
+ // worktree を cwd にして build を実行する。child は cwd から .specdojo/specdojo.config.json を
151
+ // 辿るため、生成先は worktree 側になる。
152
+ function runWorktreeBuild(worktreePath) {
153
+ const resolved = resolveWorktreeBuildCommand(worktreePath);
154
+ if (!resolved) {
155
+ process.stdout.write(`Skipping worktree artifact generation: no SpecDojo CLI in ${worktreePath}\n`);
156
+ return;
157
+ }
158
+ process.stdout.write("Generating worktree artifacts: specdojo build\n");
159
+ const result = spawnSync(resolved.command, resolved.args, {
160
+ cwd: worktreePath,
161
+ env: { ...gitEnvironment(), CI: "true", LEFTHOOK: "0" },
162
+ stdio: "inherit",
163
+ });
164
+ if (result.error) {
165
+ throw new Error(formatWorktreeBuildFailure(worktreePath, `could not start: ${result.error.message}`));
166
+ }
167
+ if (result.status !== 0) {
168
+ throw new Error(formatWorktreeBuildFailure(worktreePath, `exited with ${result.status ?? "unknown"}`));
169
+ }
170
+ }
171
+ // 生成物(docs/**/generated と .specdojo/doc-index.json)は .gitignore 済みで worktree へ
172
+ // 複製されない。生成物の存在を前提とする検証は、成果物と無関係に失敗するため、依存の install
173
+ // 直後にまとめて生成する。生成対象が増えても追従が要らないよう、scope を絞らず build を通しで
174
+ // 実行する(全 scope で数秒。npm ci に対して無視できる)。
175
+ export function generateWorktreeArtifacts(worktreePath, build = runWorktreeBuild) {
176
+ const root = resolve(worktreePath);
177
+ // SpecDojo の設定を持たないリポジトリには生成物が無い。build は失敗するだけなので実行しない。
178
+ if (!existsSync(join(root, SPECDOJO_CONFIG_REL)))
179
+ return;
180
+ build(root);
181
+ }
182
+ /**
183
+ * Path of a task worktree. Without `repoDirName` (projects without `repos`) the worktree is
184
+ * `<base>/<task-name>/`; with it, each repository gets `<base>/<task-name>/<repoDirName>/`.
185
+ */
186
+ export function execWorktreePath(worktreeBase, taskId, repoDirName) {
187
+ const name = worktreeNameFromTaskId(taskId);
188
+ return resolve(repoDirName ? join(worktreeBase, name, repoDirName) : join(worktreeBase, name));
189
+ }
190
+ function branchTip(repoRoot, branch) {
191
+ const args = ["rev-parse", "--verify", "--quiet", `refs/heads/${branch}^{commit}`];
192
+ const result = gitResult(repoRoot, args);
193
+ if (result.status === 1 && !result.error)
194
+ return undefined;
195
+ if (result.status !== 0 || result.error) {
196
+ const stderr = typeof result.stderr === "string" ? result.stderr : "";
197
+ throw new GitCommandError(formatGitCommandFailure(args, stderr, describeGitProcessFailure(result)), args, stderr);
198
+ }
199
+ if (typeof result.stdout !== "string")
200
+ return undefined;
201
+ return result.stdout.trim();
202
+ }
203
+ function assertExpectedBranchTip(repoRoot, branch, expectedCommit) {
204
+ const actualCommit = branchTip(repoRoot, branch);
205
+ if (actualCommit === expectedCommit)
206
+ return;
207
+ throw new Error(`Existing branch ${branch} points to ${actualCommit ?? "an unreadable commit"}; ` +
208
+ `expected ${expectedCommit}. Refusing to delete or reuse it.`);
209
+ }
210
+ function recoverWorktreeAddAfterTransientFailure(params) {
211
+ const { repoRoot, worktreePath, branch, expectedCommit, branchWasCreatedByAdd } = params;
212
+ let registered = listRegisteredWorktrees(repoRoot);
213
+ const registeredAtPath = registered.find((item) => item.path === worktreePath);
214
+ if (registeredAtPath) {
215
+ if (registeredAtPath.branch !== branch) {
216
+ throw new Error(`Worktree ${worktreePath} uses branch ${registeredAtPath.branch ?? "(detached)"}; ` +
217
+ `expected ${branch}. Refusing to remove it after a transient Git failure.`);
218
+ }
219
+ assertExpectedBranchTip(repoRoot, branch, expectedCommit);
220
+ if (existsSync(worktreePath))
221
+ return true;
222
+ // The add registered the worktree but did not leave its directory behind. Prune only the
223
+ // missing registration; a live worktree at another path is never removed by this recovery.
224
+ gitOutput(repoRoot, ["worktree", "prune", "--expire=now"]);
225
+ registered = listRegisteredWorktrees(repoRoot);
226
+ if (registered.some((item) => item.path === worktreePath)) {
227
+ throw new Error(`Failed to prune incomplete worktree registration: ${worktreePath}`);
228
+ }
229
+ }
230
+ const registeredForBranch = registered.find((item) => item.branch === branch);
231
+ if (registeredForBranch) {
232
+ throw new Error(`Branch ${branch} is already checked out at ${registeredForBranch.path}; ` +
233
+ `refusing to alter it after a transient Git failure.`);
234
+ }
235
+ // ensureExecWorktree rejected a pre-existing unregistered path before starting `worktree add`,
236
+ // so an unregistered entry appearing here belongs to the failed attempt and is safe to remove.
237
+ if (existsSync(worktreePath))
238
+ rmSync(worktreePath, { recursive: true, force: true });
239
+ const actualCommit = branchTip(repoRoot, branch);
240
+ if (actualCommit === undefined)
241
+ return false;
242
+ assertExpectedBranchTip(repoRoot, branch, expectedCommit);
243
+ if (branchWasCreatedByAdd)
244
+ gitOutput(repoRoot, ["branch", "-D", branch]);
245
+ return false;
246
+ }
247
+ export function ensureExecWorktree(opts) {
248
+ const repoRoot = resolve(opts.repoRoot);
249
+ const baseRelative = relative(repoRoot, resolve(opts.worktreeBase));
250
+ if (baseRelative === "" || (!baseRelative.startsWith(`..${sep}`) && baseRelative !== "..")) {
251
+ throw new Error(`Worktree base must be outside the repository: ${opts.worktreeBase}`);
252
+ }
253
+ const name = worktreeNameFromTaskId(opts.taskId);
254
+ const branch = `exec/${name}`;
255
+ const worktreePath = execWorktreePath(opts.worktreeBase, opts.taskId, opts.repoDirName);
256
+ const registered = listRegisteredWorktrees(repoRoot);
257
+ const registeredAtPath = registered.find((item) => item.path === worktreePath);
258
+ if (registeredAtPath) {
259
+ if (!existsSync(worktreePath)) {
260
+ throw new Error(`Registered worktree path does not exist: ${worktreePath}`);
261
+ }
262
+ if (registeredAtPath.branch !== branch) {
263
+ throw new Error(`Worktree ${worktreePath} uses branch ${registeredAtPath.branch ?? "(detached)"}; expected ${branch}`);
264
+ }
265
+ (opts.installDependencies ?? installWorktreeDependencies)(worktreePath);
266
+ (opts.generateArtifacts ?? generateWorktreeArtifacts)(worktreePath);
267
+ return { path: worktreePath, branch, name, created: false };
268
+ }
269
+ if (existsSync(worktreePath)) {
270
+ throw new Error(`Worktree path already exists but is not registered: ${worktreePath}`);
271
+ }
272
+ mkdirSync(dirname(worktreePath), { recursive: true });
273
+ const expectedCommit = gitOutput(repoRoot, [
274
+ "rev-parse",
275
+ "--verify",
276
+ `${opts.startPoint ?? "HEAD"}^{commit}`,
277
+ ]).trim();
278
+ const branchExists = branchTip(repoRoot, branch) !== undefined;
279
+ const registeredForBranch = registered.find((item) => item.branch === branch);
280
+ if (registeredForBranch) {
281
+ throw new Error(`Branch ${branch} is already checked out at ${registeredForBranch.path}`);
282
+ }
283
+ if (branchExists)
284
+ assertExpectedBranchTip(repoRoot, branch, expectedCommit);
285
+ const args = branchExists
286
+ ? ["worktree", "add", worktreePath, branch]
287
+ : [
288
+ "worktree",
289
+ "add",
290
+ worktreePath,
291
+ "-b",
292
+ branch,
293
+ ...(opts.startPoint ? [opts.startPoint] : []),
294
+ ];
295
+ gitOutput(repoRoot, args, () => recoverWorktreeAddAfterTransientFailure({
296
+ repoRoot,
297
+ worktreePath,
298
+ branch,
299
+ expectedCommit,
300
+ branchWasCreatedByAdd: !branchExists,
301
+ }));
302
+ (opts.installDependencies ?? installWorktreeDependencies)(worktreePath);
303
+ (opts.generateArtifacts ?? generateWorktreeArtifacts)(worktreePath);
304
+ return { path: worktreePath, branch, name, created: true };
305
+ }
@@ -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;