specdojo 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (245) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/README.md +77 -18
  3. package/dist/catalog/build-references.js +144 -0
  4. package/dist/catalog/build-render.js +32 -0
  5. package/dist/{catalog-build.js → catalog/build.js} +18 -295
  6. package/dist/{catalog.js → catalog/catalog.js} +11 -11
  7. package/dist/{catalog-generate.js → catalog/generate.js} +13 -16
  8. package/dist/catalog/paths.js +1 -0
  9. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +5 -5
  10. package/dist/{catalog-plan.js → catalog/plan.js} +9 -9
  11. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +6 -6
  12. package/dist/{agent.js → commands/agent.js} +11 -11
  13. package/dist/{build-command.js → commands/build.js} +2 -2
  14. package/dist/{init-command.js → commands/init.js} +103 -37
  15. package/dist/{orchestrator.js → commands/orchestrator.js} +2 -2
  16. package/dist/{watch.js → commands/watch.js} +3 -3
  17. package/dist/dashboard/dashboard-timeline.js +175 -0
  18. package/dist/{dashboard.js → dashboard/dashboard.js} +16 -549
  19. package/dist/dashboard/exec-records.js +105 -0
  20. package/dist/dashboard/routines.js +256 -0
  21. package/dist/dashboard/shared.js +14 -0
  22. package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
  23. package/dist/{timeline.js → dashboard/timeline.js} +1 -1
  24. package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
  25. package/dist/{deliverable-trash.js → deliverable/trash.js} +7 -7
  26. package/dist/{devcontainer-command.js → devcontainer/command.js} +5 -3
  27. package/dist/{devcontainer-scaffold.js → devcontainer/scaffold.js} +94 -2
  28. package/dist/{doc-index.js → docs/doc-index.js} +3 -3
  29. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +2 -2
  30. package/dist/{index-command.js → docs/index-command.js} +1 -1
  31. package/dist/docs/template-resolution.js +1 -0
  32. package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +3 -3
  33. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  34. package/dist/{yaml-pages.js → docs/yaml-pages.js} +5 -5
  35. package/dist/{exec-agent-config.js → exec/agent-config.js} +33 -4
  36. package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
  37. package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
  38. package/dist/{exec.js → exec/commands.js} +22 -467
  39. package/dist/exec/core.js +457 -0
  40. package/dist/{exec-events.js → exec/events.js} +2 -2
  41. package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
  42. package/dist/exec/exec.js +2 -0
  43. package/dist/exec/format.js +1 -0
  44. package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
  45. package/dist/{exec-limit.js → exec/limit.js} +93 -12
  46. package/dist/{exec-parent-validation.js → exec/parent-validation.js} +4 -4
  47. package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +16 -2
  48. package/dist/{exec-plans.js → exec/plans-core.js} +97 -468
  49. package/dist/exec/plans-generation.js +249 -0
  50. package/dist/exec/plans-storage.js +131 -0
  51. package/dist/exec/plans.js +3 -0
  52. package/dist/{exec-project.js → exec/project.js} +1 -1
  53. package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
  54. package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
  55. package/dist/{exec-register.js → exec/register.js} +92 -9
  56. package/dist/exec/repo-integration-git.js +23 -0
  57. package/dist/exec/repo-integration-sync.js +264 -0
  58. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +13 -287
  59. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  60. package/dist/exec/reporter-output.js +206 -0
  61. package/dist/{exec-reporter.js → exec/reporter.js} +29 -216
  62. package/dist/{exec-results.js → exec/results.js} +277 -36
  63. package/dist/exec/run/agent-pipeline.js +276 -0
  64. package/dist/exec/run/agent.js +583 -0
  65. package/dist/exec/run/in-place.js +570 -0
  66. package/dist/exec/run/job.js +746 -0
  67. package/dist/exec/run/lifecycle-commands.js +530 -0
  68. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  69. package/dist/exec/run/mode-shared.js +140 -0
  70. package/dist/exec/run/register-command.js +252 -0
  71. package/dist/exec/run/register-core.js +411 -0
  72. package/dist/exec/run/register-mode.js +210 -0
  73. package/dist/exec/run/register-resume.js +398 -0
  74. package/dist/exec/run/register-state.js +325 -0
  75. package/dist/exec/run/register-worktree.js +540 -0
  76. package/dist/exec/run/run.js +11 -0
  77. package/dist/exec/run/schedule-mode.js +294 -0
  78. package/dist/exec/run/schedule-prepare.js +366 -0
  79. package/dist/exec/run/schedule-task.js +599 -0
  80. package/dist/exec/run/shared.js +449 -0
  81. package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
  82. package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
  83. package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
  84. package/dist/exec/schedule/gantt-chart.js +2 -0
  85. package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
  86. package/dist/exec/schedule/index.js +1 -0
  87. package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
  88. package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
  89. package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
  90. package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
  91. package/dist/exec/shared.js +63 -0
  92. package/dist/exec/slot-lock.js +1 -0
  93. package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
  94. package/dist/{exec-task-repos.js → exec/task-repos.js} +2 -2
  95. package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
  96. package/dist/{exec-trial.js → exec/trial-commands.js} +23 -388
  97. package/dist/exec/trial-core.js +371 -0
  98. package/dist/exec/trial.js +2 -0
  99. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  100. package/dist/exec/worktree-ops-commit.js +672 -0
  101. package/dist/exec/worktree-ops-lifecycle.js +297 -0
  102. package/dist/exec/worktree-ops-merge.js +344 -0
  103. package/dist/exec/worktree-ops.js +3 -0
  104. package/dist/exec/worktree.js +305 -0
  105. package/dist/grade/apply.js +734 -0
  106. package/dist/grade/command-apply.js +250 -0
  107. package/dist/grade/command-inspect.js +138 -0
  108. package/dist/grade/command-plan.js +101 -0
  109. package/dist/grade/command-shared.js +68 -0
  110. package/dist/grade/core.js +307 -0
  111. package/dist/grade/grade.js +19 -0
  112. package/dist/grade/markdown.js +274 -0
  113. package/dist/grade/pipeline-state.js +184 -0
  114. package/dist/grade/plan.js +507 -0
  115. package/dist/{grade-result.js → grade/result.js} +7 -96
  116. package/dist/grade/target-discovery.js +265 -0
  117. package/dist/grade/targets.js +435 -0
  118. package/dist/{job.js → job/definition.js} +32 -574
  119. package/dist/job/job.js +568 -0
  120. package/dist/{kata-command.js → kata/command.js} +4 -4
  121. package/dist/{kata.js → kata/kata.js} +5 -5
  122. package/dist/register/approach.js +134 -0
  123. package/dist/register/command-types.js +1 -0
  124. package/dist/register/core.js +369 -0
  125. package/dist/register/create-commands.js +352 -0
  126. package/dist/{register-date.js → register/date.js} +1 -1
  127. package/dist/register/derivation.js +163 -0
  128. package/dist/{register-event-merge.js → register/event-merge.js} +32 -3
  129. package/dist/{register-events.js → register/events.js} +12 -6
  130. package/dist/{register-history.js → register/history.js} +7 -6
  131. package/dist/{register-item.js → register/item.js} +28 -10
  132. package/dist/register/lifecycle-lock.js +5 -0
  133. package/dist/register/maintenance-commands.js +193 -0
  134. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  135. package/dist/register/migration.js +268 -0
  136. package/dist/register/register.js +404 -0
  137. package/dist/register/renumber.js +341 -0
  138. package/dist/register/transition-commands.js +248 -0
  139. package/dist/register/update.js +230 -0
  140. package/dist/register/views.js +296 -0
  141. package/dist/{review-grade.js → review/grade.js} +2 -2
  142. package/dist/{review-plan.js → review/plan.js} +5 -5
  143. package/dist/routine/definition.js +401 -0
  144. package/dist/{routine.js → routine/routine.js} +50 -419
  145. package/dist/{schedule-approach.js → schedule/approach.js} +9 -9
  146. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  147. package/dist/{schedule.js → schedule/schedule.js} +9 -9
  148. package/dist/schedule/strategy-generate-document.js +273 -0
  149. package/dist/schedule/strategy-generate-scope.js +199 -0
  150. package/dist/schedule/strategy-generate.js +348 -0
  151. package/dist/shared/agent-types.js +23 -0
  152. package/dist/shared/artifact-path.js +9 -0
  153. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  154. package/dist/shared/catalog-render.js +115 -0
  155. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  156. package/dist/shared/fs.js +30 -0
  157. package/dist/shared/git.js +316 -0
  158. package/dist/shared/grade-result.js +94 -0
  159. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  160. package/dist/shared/plan-templates.js +114 -0
  161. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +3 -1
  162. package/dist/shared/random.js +4 -0
  163. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  164. package/dist/shared/schedule-paths.js +9 -0
  165. package/dist/{specdojo-config.js → shared/specdojo-config.js} +96 -9
  166. package/dist/{exec-shared.js → shared/text.js} +0 -134
  167. package/dist/shared/time.js +28 -0
  168. package/dist/shared/yaml.js +28 -0
  169. package/dist/specdojo.js +22 -22
  170. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +29 -17
  171. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  172. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -2
  173. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  174. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  175. package/docs/ja/specdojo/guides/exec-config-guide.md +97 -22
  176. package/docs/ja/specdojo/guides/exec-operation-guide.md +145 -12
  177. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  178. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +51 -18
  179. package/docs/ja/specdojo/guides/quick-start-guide.md +81 -16
  180. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -1
  181. package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -1
  182. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  183. package/docs/ja/specdojo/guides/routine-operation-guide.md +6 -6
  184. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  185. package/docs/ja/specdojo/references/command-reference.md +52 -28
  186. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +17 -11
  187. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  188. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  189. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  190. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  191. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  192. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +20 -0
  193. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +23 -0
  194. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  195. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  196. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +26 -0
  197. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  198. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +70 -7
  199. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  200. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -1
  201. package/package.json +4 -5
  202. package/templates/antigravity/README.md +7 -3
  203. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  204. package/templates/antigravity/exec-defaults-snippet.yaml +10 -13
  205. package/templates/claude/README.md +27 -3
  206. package/templates/claude/agents/claude-executor.md +0 -1
  207. package/templates/claude/agents/claude-reporter.md +2 -1
  208. package/templates/claude/agents/claude-review-executor.md +0 -1
  209. package/templates/codex/README.md +23 -4
  210. package/templates/devcontainer/devcontainer.json +2 -2
  211. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +69 -0
  212. package/templates/devcontainer/remote-host/ssh-config.sample +16 -0
  213. package/templates/init-agent-members.yaml +75 -25
  214. package/templates/init-exec-defaults.yaml +26 -8
  215. package/templates/opencode/README.md +17 -3
  216. package/templates/opencode/agents/opencode-executor.md +0 -1
  217. package/templates/opencode/agents/opencode-reporter.md +2 -1
  218. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  219. package/dist/exec-run.js +0 -6182
  220. package/dist/exec-schedule-gantt-chart.js +0 -2
  221. package/dist/exec-worktree-ops.js +0 -1292
  222. package/dist/exec-worktree.js +0 -446
  223. package/dist/grade.js +0 -3193
  224. package/dist/register.js +0 -2407
  225. package/dist/schedule-strategy-generate.js +0 -812
  226. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  227. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  228. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  229. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  230. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  231. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  232. /package/dist/{exec-types.js → exec/types.js} +0 -0
  233. /package/dist/{review-types.js → review/types.js} +0 -0
  234. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  235. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  236. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  237. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  238. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  239. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  240. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  241. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  242. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  243. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  244. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  245. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
@@ -0,0 +1,265 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { join } from "node:path";
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
+ export function discoverGradeTargets(opts, rootDir = specdojoRootDir()) {
11
+ validateGradeTargetFilters(opts);
12
+ let candidates;
13
+ if (opts.paths && opts.paths.length > 0) {
14
+ candidates = opts.paths.map((path) => resolveSafeMarkdownPath(path, rootDir));
15
+ const generated = candidates.find((path) => isGeneratedGradeTarget(path, rootDir));
16
+ if (generated) {
17
+ throw new Error(`${relativePathFromRoot(generated, rootDir)}: generated documents cannot be graded`);
18
+ }
19
+ const trashed = candidates.find((path) => isTrashedGradeTarget(path, rootDir));
20
+ if (trashed) {
21
+ throw new Error(`${relativePathFromRoot(trashed, rootDir)}: trashed documents cannot be graded`);
22
+ }
23
+ }
24
+ else if (opts.target === "kata") {
25
+ // 対象の列挙は利用リポジトリ限定。eject されていない kata は評価対象にしない。
26
+ candidates = KATA_DIRS.flatMap((dir) => listFilesRecursive(join(rootDir, "docs/ja/specdojo", dir)).filter((entry) => entry.endsWith(".md")));
27
+ }
28
+ else {
29
+ candidates = [...loadDeliverableCatalog(opts.project, rootDir).keys()];
30
+ }
31
+ const unique = [...new Set(candidates)]
32
+ .filter((path) => !isGeneratedGradeTarget(path, rootDir))
33
+ .filter((path) => !isTrashedGradeTarget(path, rootDir))
34
+ .sort();
35
+ if (!opts.changedOnly &&
36
+ !opts.dependencyChanged &&
37
+ !opts.rulebookChanged &&
38
+ !opts.unreviewed &&
39
+ opts.verdict === undefined &&
40
+ opts.minScore === undefined &&
41
+ opts.maxFindings === undefined &&
42
+ !opts.ungraded &&
43
+ !opts.incomplete &&
44
+ !opts.rubricOutdated) {
45
+ return unique;
46
+ }
47
+ const pipelineStates = opts.incomplete
48
+ ? loadGradePipelineStates(opts.project, rootDir)
49
+ : new Map();
50
+ const sourceContext = createGradeSourceContext(opts.project, rootDir);
51
+ const viewpoints = opts.changedOnly || opts.rubricOutdated
52
+ ? loadViewpointsIfConfigured(opts.project, rootDir)
53
+ : undefined;
54
+ const currentRubricId = opts.rubricOutdated ? currentGradeRubricId(viewpoints) : undefined;
55
+ let scheduledDocuments;
56
+ if (opts.unreviewed) {
57
+ const { project } = resolveProject(opts.project);
58
+ const schedulePath = join(rootDir, getProjectExecutionPath(project), "../schedule");
59
+ try {
60
+ const index = buildScheduleIndex(schedulePath);
61
+ scheduledDocuments = new Set();
62
+ for (const node of index.nodes.values()) {
63
+ if (node.local_id)
64
+ scheduledDocuments.add(node.local_id);
65
+ if (node.target_local_ids) {
66
+ for (const tid of node.target_local_ids)
67
+ scheduledDocuments.add(tid);
68
+ }
69
+ }
70
+ }
71
+ catch {
72
+ scheduledDocuments = new Set();
73
+ }
74
+ }
75
+ const gradeDates = new Map();
76
+ function getMemoizedGradeDate(p) {
77
+ if (!gradeDates.has(p)) {
78
+ const res = readGradeResultForDocument({
79
+ documentPath: relativePathFromRoot(p, rootDir),
80
+ project: opts.project,
81
+ rootDir,
82
+ });
83
+ gradeDates.set(p, res ? new Date(res.graded_at).getTime() : 0);
84
+ }
85
+ return gradeDates.get(p);
86
+ }
87
+ function getRulebookPath(rulebookId) {
88
+ if (rulebookId.startsWith("specdojo:")) {
89
+ const id = rulebookId.slice("specdojo:".length);
90
+ return join(rootDir, "docs/ja/specdojo/rulebooks", `${id}.md`);
91
+ }
92
+ return undefined;
93
+ }
94
+ return unique.filter((path) => {
95
+ const rel = relativePathFromRoot(path, rootDir);
96
+ const content = readFileSync(path, "utf8");
97
+ const document = parseMarkdown(content, rel);
98
+ const pipelineState = currentGradePipelineState(document, rel, pipelineStates.get(rel), opts.target);
99
+ const result = readGradeResultForDocument({
100
+ documentPath: rel,
101
+ project: opts.project,
102
+ rootDir,
103
+ });
104
+ if (opts.verdict !== undefined && (result === undefined || result.verdict !== opts.verdict)) {
105
+ return false;
106
+ }
107
+ if (opts.minScore !== undefined && (result === undefined || result.score < opts.minScore)) {
108
+ return false;
109
+ }
110
+ if (opts.maxFindings !== undefined &&
111
+ (result === undefined || gradeFindingCount(result) > opts.maxFindings)) {
112
+ return false;
113
+ }
114
+ if (opts.unreviewed) {
115
+ if (!scheduledDocuments)
116
+ return false;
117
+ const id = document.data.specdojo?.id;
118
+ if (!id || scheduledDocuments.has(id.split(":").pop()))
119
+ return false;
120
+ if (result !== undefined && result.content_hash === gradeContentHash(content))
121
+ return false;
122
+ }
123
+ if (opts.incomplete && pipelineState) {
124
+ if (!isIncompleteGradePipelineState(pipelineState))
125
+ return false;
126
+ }
127
+ else if (opts.incomplete) {
128
+ return false;
129
+ }
130
+ if (opts.ungraded && result !== undefined)
131
+ return false;
132
+ if (currentRubricId !== undefined && !isGradeRubricOutdated(result, currentRubricId)) {
133
+ return false;
134
+ }
135
+ if (result === undefined) {
136
+ if (opts.dependencyChanged || opts.rulebookChanged)
137
+ return false;
138
+ return true;
139
+ }
140
+ const docDate = new Date(result.graded_at).getTime();
141
+ if (opts.rulebookChanged) {
142
+ const rb = document.data.specdojo?.rulebook;
143
+ if (!rb)
144
+ return false;
145
+ const rbPath = getRulebookPath(rb);
146
+ if (!rbPath || !existsSync(rbPath))
147
+ return false;
148
+ if (getMemoizedGradeDate(rbPath) <= docDate)
149
+ return false;
150
+ }
151
+ // 依存先の評価日時ではなく内容の hash で判定する。再評価しただけの依存先は変更扱いにしない。
152
+ if (opts.dependencyChanged) {
153
+ if (opts.target !== "deliverable")
154
+ return false;
155
+ const keys = dependencySourceKeys(path, sourceContext);
156
+ if (keys.length === 0)
157
+ return false;
158
+ const current = currentSourceHashes(keys, path, sourceContext);
159
+ if (!sourceHashesChanged(result.source_hashes, current))
160
+ return false;
161
+ }
162
+ if (opts.changedOnly && result.content_hash === gradeContentHash(content)) {
163
+ const metadata = isRecord(document.data.specdojo) ? document.data.specdojo : {};
164
+ const keys = comparisonSourceKeys(gradedComparisonSources(viewpoints, opts.target, metadata), path, sourceContext);
165
+ if (keys.length === 0)
166
+ return false;
167
+ const current = currentSourceHashes(keys, path, sourceContext);
168
+ if (!sourceHashesChanged(result.source_hashes, current))
169
+ return false;
170
+ }
171
+ return true;
172
+ });
173
+ }
174
+ function currentGradeRubricId(viewpoints) {
175
+ const id = viewpoints?.grade_rubric?.id;
176
+ if (typeof id !== "string" || id.length === 0) {
177
+ throw new Error("--rubric-outdated requires grade_rubric.id in the resolved review viewpoints");
178
+ }
179
+ return id;
180
+ }
181
+ // 保存済みの結果が現在の rubric 以外で付けられたかを判定する。rubric の記録がない結果は
182
+ // どの版で付けたか確かめられないため旧版として扱う。結果がない文書は --ungraded の対象である。
183
+ export function isGradeRubricOutdated(result, currentRubricId) {
184
+ if (result === undefined)
185
+ return false;
186
+ if (typeof result.rubric !== "string" || result.rubric.length === 0)
187
+ return true;
188
+ return result.rubric !== currentRubricId;
189
+ }
190
+ function validateGradeTargetFilters(filters) {
191
+ if (filters.verdict !== undefined &&
192
+ filters.verdict !== "pass" &&
193
+ filters.verdict !== "needs-work" &&
194
+ filters.verdict !== "fail") {
195
+ throw new Error("--verdict must be pass, needs-work, or fail");
196
+ }
197
+ if (filters.minScore !== undefined &&
198
+ (!Number.isSafeInteger(filters.minScore) || filters.minScore < 0 || filters.minScore > 100)) {
199
+ throw new Error("--min-score must be an integer between 0 and 100");
200
+ }
201
+ if (filters.maxFindings !== undefined &&
202
+ (!Number.isSafeInteger(filters.maxFindings) || filters.maxFindings < 0)) {
203
+ throw new Error("--max-findings must be a non-negative integer");
204
+ }
205
+ if (filters.ungraded &&
206
+ (filters.verdict !== undefined ||
207
+ filters.minScore !== undefined ||
208
+ filters.maxFindings !== undefined)) {
209
+ throw new Error("--ungraded cannot be combined with --verdict, --min-score, or --max-findings");
210
+ }
211
+ if (filters.ungraded && filters.rubricOutdated) {
212
+ throw new Error("--ungraded cannot be combined with --rubric-outdated");
213
+ }
214
+ }
215
+ function storedGradeScore(grade, path) {
216
+ const score = grade.score;
217
+ if (!Number.isSafeInteger(score) || score < 0 || score > 100) {
218
+ throw new Error(`${path}: specdojo.grade.score must be an integer between 0 and 100`);
219
+ }
220
+ return score;
221
+ }
222
+ function storedFindingCount(grade, path) {
223
+ const findings = grade.findings;
224
+ if (!isRecord(findings))
225
+ throw new Error(`${path}: specdojo.grade.findings is missing`);
226
+ return ["blocker", "major", "minor", "note"].reduce((total, severity) => {
227
+ const count = findings[severity];
228
+ if (!Number.isSafeInteger(count) || count < 0) {
229
+ throw new Error(`${path}: specdojo.grade.findings.${severity} must be a non-negative integer`);
230
+ }
231
+ return total + count;
232
+ }, 0);
233
+ }
234
+ function matchesParsedGradeTargetFilters(document, path, filters, incomplete = false) {
235
+ if (filters.dependencyChanged ||
236
+ filters.rulebookChanged ||
237
+ filters.unreviewed ||
238
+ filters.rubricOutdated) {
239
+ throw new Error("dependencyChanged, rulebookChanged, unreviewed, rubricOutdated cannot be evaluated individually without context");
240
+ }
241
+ const specdojo = document.data.specdojo;
242
+ const grade = isRecord(specdojo.grade) ? specdojo.grade : undefined;
243
+ if (filters.incomplete && !incomplete)
244
+ return false;
245
+ if (filters.ungraded && grade !== undefined)
246
+ return false;
247
+ if (filters.verdict !== undefined && grade?.verdict !== filters.verdict)
248
+ return false;
249
+ if (filters.minScore !== undefined &&
250
+ (grade === undefined || storedGradeScore(grade, path) < filters.minScore)) {
251
+ return false;
252
+ }
253
+ if (filters.maxFindings !== undefined &&
254
+ (grade === undefined || storedFindingCount(grade, path) > filters.maxFindings)) {
255
+ return false;
256
+ }
257
+ return !filters.changedOnly || grade?.content_hash !== legacyInlineContentHash(document);
258
+ }
259
+ export function matchesGradeTargetFilters(content, path, filters, pipelineState) {
260
+ validateGradeTargetFilters(filters);
261
+ const document = parseMarkdown(content, path);
262
+ const currentState = currentGradePipelineState(document, path, pipelineState);
263
+ return matchesParsedGradeTargetFilters(document, path, filters, isIncompleteGradePipelineState(currentState));
264
+ }
265
+ // grade の対象は grade_targets と文書の種類(document_kinds)だけで決まる。