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.
- package/CHANGELOG.md +65 -0
- package/README.md +77 -18
- package/dist/catalog/build-references.js +144 -0
- package/dist/catalog/build-render.js +32 -0
- package/dist/{catalog-build.js → catalog/build.js} +18 -295
- package/dist/{catalog.js → catalog/catalog.js} +11 -11
- package/dist/{catalog-generate.js → catalog/generate.js} +13 -16
- package/dist/catalog/paths.js +1 -0
- package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +5 -5
- package/dist/{catalog-plan.js → catalog/plan.js} +9 -9
- package/dist/{catalog-scaffold.js → catalog/scaffold.js} +6 -6
- package/dist/{agent.js → commands/agent.js} +11 -11
- package/dist/{build-command.js → commands/build.js} +2 -2
- package/dist/{init-command.js → commands/init.js} +103 -37
- package/dist/{orchestrator.js → commands/orchestrator.js} +2 -2
- package/dist/{watch.js → commands/watch.js} +3 -3
- package/dist/dashboard/dashboard-timeline.js +175 -0
- package/dist/{dashboard.js → dashboard/dashboard.js} +16 -549
- package/dist/dashboard/exec-records.js +105 -0
- package/dist/dashboard/routines.js +256 -0
- package/dist/dashboard/shared.js +14 -0
- package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
- package/dist/{timeline.js → dashboard/timeline.js} +1 -1
- package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
- package/dist/{deliverable-trash.js → deliverable/trash.js} +7 -7
- package/dist/{devcontainer-command.js → devcontainer/command.js} +5 -3
- package/dist/{devcontainer-scaffold.js → devcontainer/scaffold.js} +94 -2
- package/dist/{doc-index.js → docs/doc-index.js} +3 -3
- package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +2 -2
- package/dist/{index-command.js → docs/index-command.js} +1 -1
- package/dist/docs/template-resolution.js +1 -0
- package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +3 -3
- package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
- package/dist/{yaml-pages.js → docs/yaml-pages.js} +5 -5
- package/dist/{exec-agent-config.js → exec/agent-config.js} +33 -4
- package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
- package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
- package/dist/{exec.js → exec/commands.js} +22 -467
- package/dist/exec/core.js +457 -0
- package/dist/{exec-events.js → exec/events.js} +2 -2
- package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
- package/dist/exec/exec.js +2 -0
- package/dist/exec/format.js +1 -0
- package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
- package/dist/{exec-limit.js → exec/limit.js} +93 -12
- package/dist/{exec-parent-validation.js → exec/parent-validation.js} +4 -4
- package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +16 -2
- package/dist/{exec-plans.js → exec/plans-core.js} +97 -468
- package/dist/exec/plans-generation.js +249 -0
- package/dist/exec/plans-storage.js +131 -0
- package/dist/exec/plans.js +3 -0
- package/dist/{exec-project.js → exec/project.js} +1 -1
- package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
- package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
- package/dist/{exec-register.js → exec/register.js} +92 -9
- package/dist/exec/repo-integration-git.js +23 -0
- package/dist/exec/repo-integration-sync.js +264 -0
- package/dist/{exec-repo-integration.js → exec/repo-integration.js} +13 -287
- package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
- package/dist/exec/reporter-output.js +206 -0
- package/dist/{exec-reporter.js → exec/reporter.js} +29 -216
- package/dist/{exec-results.js → exec/results.js} +277 -36
- package/dist/exec/run/agent-pipeline.js +276 -0
- package/dist/exec/run/agent.js +583 -0
- package/dist/exec/run/in-place.js +570 -0
- package/dist/exec/run/job.js +746 -0
- package/dist/exec/run/lifecycle-commands.js +530 -0
- package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
- package/dist/exec/run/mode-shared.js +140 -0
- package/dist/exec/run/register-command.js +252 -0
- package/dist/exec/run/register-core.js +411 -0
- package/dist/exec/run/register-mode.js +210 -0
- package/dist/exec/run/register-resume.js +398 -0
- package/dist/exec/run/register-state.js +325 -0
- package/dist/exec/run/register-worktree.js +540 -0
- package/dist/exec/run/run.js +11 -0
- package/dist/exec/run/schedule-mode.js +294 -0
- package/dist/exec/run/schedule-prepare.js +366 -0
- package/dist/exec/run/schedule-task.js +599 -0
- package/dist/exec/run/shared.js +449 -0
- package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
- package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
- package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
- package/dist/exec/schedule/gantt-chart.js +2 -0
- package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
- package/dist/exec/schedule/index.js +1 -0
- package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
- package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
- package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
- package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
- package/dist/exec/shared.js +63 -0
- package/dist/exec/slot-lock.js +1 -0
- package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
- package/dist/{exec-task-repos.js → exec/task-repos.js} +2 -2
- package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
- package/dist/{exec-trial.js → exec/trial-commands.js} +23 -388
- package/dist/exec/trial-core.js +371 -0
- package/dist/exec/trial.js +2 -0
- package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
- package/dist/exec/worktree-ops-commit.js +672 -0
- package/dist/exec/worktree-ops-lifecycle.js +297 -0
- package/dist/exec/worktree-ops-merge.js +344 -0
- package/dist/exec/worktree-ops.js +3 -0
- package/dist/exec/worktree.js +305 -0
- package/dist/grade/apply.js +734 -0
- package/dist/grade/command-apply.js +250 -0
- package/dist/grade/command-inspect.js +138 -0
- package/dist/grade/command-plan.js +101 -0
- package/dist/grade/command-shared.js +68 -0
- package/dist/grade/core.js +307 -0
- package/dist/grade/grade.js +19 -0
- package/dist/grade/markdown.js +274 -0
- package/dist/grade/pipeline-state.js +184 -0
- package/dist/grade/plan.js +507 -0
- package/dist/{grade-result.js → grade/result.js} +7 -96
- package/dist/grade/target-discovery.js +265 -0
- package/dist/grade/targets.js +435 -0
- package/dist/{job.js → job/definition.js} +32 -574
- package/dist/job/job.js +568 -0
- package/dist/{kata-command.js → kata/command.js} +4 -4
- package/dist/{kata.js → kata/kata.js} +5 -5
- package/dist/register/approach.js +134 -0
- package/dist/register/command-types.js +1 -0
- package/dist/register/core.js +369 -0
- package/dist/register/create-commands.js +352 -0
- package/dist/{register-date.js → register/date.js} +1 -1
- package/dist/register/derivation.js +163 -0
- package/dist/{register-event-merge.js → register/event-merge.js} +32 -3
- package/dist/{register-events.js → register/events.js} +12 -6
- package/dist/{register-history.js → register/history.js} +7 -6
- package/dist/{register-item.js → register/item.js} +28 -10
- package/dist/register/lifecycle-lock.js +5 -0
- package/dist/register/maintenance-commands.js +193 -0
- package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
- package/dist/register/migration.js +268 -0
- package/dist/register/register.js +404 -0
- package/dist/register/renumber.js +341 -0
- package/dist/register/transition-commands.js +248 -0
- package/dist/register/update.js +230 -0
- package/dist/register/views.js +296 -0
- package/dist/{review-grade.js → review/grade.js} +2 -2
- package/dist/{review-plan.js → review/plan.js} +5 -5
- package/dist/routine/definition.js +401 -0
- package/dist/{routine.js → routine/routine.js} +50 -419
- package/dist/{schedule-approach.js → schedule/approach.js} +9 -9
- package/dist/{schedule-build.js → schedule/build.js} +7 -4
- package/dist/{schedule.js → schedule/schedule.js} +9 -9
- package/dist/schedule/strategy-generate-document.js +273 -0
- package/dist/schedule/strategy-generate-scope.js +199 -0
- package/dist/schedule/strategy-generate.js +348 -0
- package/dist/shared/agent-types.js +23 -0
- package/dist/shared/artifact-path.js +9 -0
- package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
- package/dist/shared/catalog-render.js +115 -0
- package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
- package/dist/shared/fs.js +30 -0
- package/dist/shared/git.js +316 -0
- package/dist/shared/grade-result.js +94 -0
- package/dist/{package-paths.js → shared/package-paths.js} +3 -3
- package/dist/shared/plan-templates.js +114 -0
- package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +3 -1
- package/dist/shared/random.js +4 -0
- package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
- package/dist/shared/schedule-paths.js +9 -0
- package/dist/{specdojo-config.js → shared/specdojo-config.js} +96 -9
- package/dist/{exec-shared.js → shared/text.js} +0 -134
- package/dist/shared/time.js +28 -0
- package/dist/shared/yaml.js +28 -0
- package/dist/specdojo.js +22 -22
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +29 -17
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -2
- package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
- package/docs/ja/specdojo/guides/exec-config-guide.md +97 -22
- package/docs/ja/specdojo/guides/exec-operation-guide.md +145 -12
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +51 -18
- package/docs/ja/specdojo/guides/quick-start-guide.md +81 -16
- package/docs/ja/specdojo/guides/register-operation-guide.md +2 -1
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -1
- package/docs/ja/specdojo/guides/review-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +6 -6
- package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
- package/docs/ja/specdojo/references/command-reference.md +52 -28
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +17 -11
- package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
- package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +20 -0
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
- package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +70 -7
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -1
- package/package.json +4 -5
- package/templates/antigravity/README.md +7 -3
- package/templates/antigravity/agent-members-snippet.yaml +108 -12
- package/templates/antigravity/exec-defaults-snippet.yaml +10 -13
- package/templates/claude/README.md +27 -3
- package/templates/claude/agents/claude-executor.md +0 -1
- package/templates/claude/agents/claude-reporter.md +2 -1
- package/templates/claude/agents/claude-review-executor.md +0 -1
- package/templates/codex/README.md +23 -4
- package/templates/devcontainer/devcontainer.json +2 -2
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +69 -0
- package/templates/devcontainer/remote-host/ssh-config.sample +16 -0
- package/templates/init-agent-members.yaml +75 -25
- package/templates/init-exec-defaults.yaml +26 -8
- package/templates/opencode/README.md +17 -3
- package/templates/opencode/agents/opencode-executor.md +0 -1
- package/templates/opencode/agents/opencode-reporter.md +2 -1
- package/templates/opencode/agents/opencode-review-executor.md +0 -1
- package/dist/exec-run.js +0 -6182
- package/dist/exec-schedule-gantt-chart.js +0 -2
- package/dist/exec-worktree-ops.js +0 -1292
- package/dist/exec-worktree.js +0 -446
- package/dist/grade.js +0 -3193
- package/dist/register.js +0 -2407
- package/dist/schedule-strategy-generate.js +0 -812
- package/templates/claude/agents/claude-expert-review-executor.md +0 -14
- /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
- /package/dist/{catalog-types.js → catalog/types.js} +0 -0
- /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
- /package/dist/{role-types.js → exec/role-types.js} +0 -0
- /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
- /package/dist/{exec-types.js → exec/types.js} +0 -0
- /package/dist/{review-types.js → review/types.js} +0 -0
- /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
- /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
- /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
- /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
- /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
- /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
- /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
- /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
- /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
- /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
- /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
- /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)だけで決まる。
|