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,184 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
|
|
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
|
+
function gradePipelineStateDirectory(projectOption, rootDir = specdojoRootDir()) {
|
|
9
|
+
const { project } = resolveProject(projectOption);
|
|
10
|
+
return resolve(rootDir, getProjectExecutionPath(project), "grade", "pipeline");
|
|
11
|
+
}
|
|
12
|
+
function gradePipelineStatePath(documentPath, projectOption, rootDir = specdojoRootDir()) {
|
|
13
|
+
const relativeDocument = relativePathFromRoot(resolve(rootDir, documentPath), rootDir);
|
|
14
|
+
const stem = basename(relativeDocument, extname(relativeDocument)).replace(/[^A-Za-z0-9._-]/g, "-");
|
|
15
|
+
const digest = createHash("sha256").update(relativeDocument).digest("hex").slice(0, 12);
|
|
16
|
+
return join(gradePipelineStateDirectory(projectOption, rootDir), `${stem}-${digest}.json`);
|
|
17
|
+
}
|
|
18
|
+
function parseGradePipelineState(value, path) {
|
|
19
|
+
if (!isRecord(value))
|
|
20
|
+
throw new Error(`${path}: grade pipeline state must be an object`);
|
|
21
|
+
const integer = (key, minimum) => {
|
|
22
|
+
const candidate = value[key];
|
|
23
|
+
if (!Number.isSafeInteger(candidate) || candidate < minimum) {
|
|
24
|
+
throw new Error(`${path}: ${key} must be an integer >= ${minimum}`);
|
|
25
|
+
}
|
|
26
|
+
return candidate;
|
|
27
|
+
};
|
|
28
|
+
const text = (key) => {
|
|
29
|
+
const candidate = value[key];
|
|
30
|
+
if (typeof candidate !== "string" || !candidate.trim()) {
|
|
31
|
+
throw new Error(`${path}: ${key} must be a non-empty string`);
|
|
32
|
+
}
|
|
33
|
+
return candidate;
|
|
34
|
+
};
|
|
35
|
+
const target = value.target;
|
|
36
|
+
if (target !== "kata" && target !== "deliverable") {
|
|
37
|
+
throw new Error(`${path}: target must be kata or deliverable`);
|
|
38
|
+
}
|
|
39
|
+
const stageFailed = value.stage_failed;
|
|
40
|
+
if (stageFailed !== null && (!Number.isSafeInteger(stageFailed) || stageFailed < 1)) {
|
|
41
|
+
throw new Error(`${path}: stage_failed must be null or a positive integer`);
|
|
42
|
+
}
|
|
43
|
+
const state = {
|
|
44
|
+
version: integer("version", 1),
|
|
45
|
+
project_id: text("project_id"),
|
|
46
|
+
target,
|
|
47
|
+
document: text("document"),
|
|
48
|
+
content_hash: text("content_hash"),
|
|
49
|
+
stage_completed: integer("stage_completed", 0),
|
|
50
|
+
stage_failed: stageFailed,
|
|
51
|
+
stage_total: integer("stage_total", 1),
|
|
52
|
+
consecutive_failures: integer("consecutive_failures", 0),
|
|
53
|
+
max_failures: integer("max_failures", 1),
|
|
54
|
+
last_run_id: text("last_run_id"),
|
|
55
|
+
updated_at: text("updated_at"),
|
|
56
|
+
};
|
|
57
|
+
if (state.version !== 1)
|
|
58
|
+
throw new Error(`${path}: unsupported grade pipeline state version`);
|
|
59
|
+
if (!/^[a-f0-9]{64}$/.test(state.content_hash)) {
|
|
60
|
+
throw new Error(`${path}: content_hash must be a SHA-256 hex digest`);
|
|
61
|
+
}
|
|
62
|
+
if (isAbsolute(state.document) ||
|
|
63
|
+
!state.document.startsWith("docs/") ||
|
|
64
|
+
state.document.split("/").includes("..")) {
|
|
65
|
+
throw new Error(`${path}: document must be a repository-relative path below docs/`);
|
|
66
|
+
}
|
|
67
|
+
if (state.stage_completed >= state.stage_total) {
|
|
68
|
+
throw new Error(`${path}: completed pipeline state must be removed`);
|
|
69
|
+
}
|
|
70
|
+
if (state.stage_failed !== null && state.stage_failed !== state.stage_completed + 1) {
|
|
71
|
+
throw new Error(`${path}: stage_failed must immediately follow stage_completed`);
|
|
72
|
+
}
|
|
73
|
+
if ((state.stage_failed === null && state.consecutive_failures !== 0) ||
|
|
74
|
+
(state.stage_failed !== null && state.consecutive_failures < 1)) {
|
|
75
|
+
throw new Error(`${path}: consecutive_failures does not match stage_failed`);
|
|
76
|
+
}
|
|
77
|
+
return state;
|
|
78
|
+
}
|
|
79
|
+
export function loadGradePipelineStates(projectOption, rootDir = specdojoRootDir()) {
|
|
80
|
+
const states = new Map();
|
|
81
|
+
const projectId = resolveProject(projectOption).id;
|
|
82
|
+
for (const path of listFilesRecursive(gradePipelineStateDirectory(projectOption, rootDir))) {
|
|
83
|
+
if (!path.endsWith(".json"))
|
|
84
|
+
continue;
|
|
85
|
+
const state = parseGradePipelineState(JSON.parse(readFileSync(path, "utf8")), relativePathFromRoot(path, rootDir));
|
|
86
|
+
if (state.project_id !== projectId) {
|
|
87
|
+
throw new Error(`${relativePathFromRoot(path, rootDir)}: project_id must be ${projectId}`);
|
|
88
|
+
}
|
|
89
|
+
states.set(state.document, state);
|
|
90
|
+
}
|
|
91
|
+
return states;
|
|
92
|
+
}
|
|
93
|
+
export function currentGradePipelineState(document, path, state, target) {
|
|
94
|
+
if (!state || state.document !== path || (target !== undefined && state.target !== target)) {
|
|
95
|
+
return undefined;
|
|
96
|
+
}
|
|
97
|
+
return state.content_hash === pipelineContentHash(document) ? state : undefined;
|
|
98
|
+
}
|
|
99
|
+
export function isIncompleteGradePipelineState(state) {
|
|
100
|
+
return state !== undefined && state.consecutive_failures < state.max_failures;
|
|
101
|
+
}
|
|
102
|
+
export function readGradePipelineState(opts) {
|
|
103
|
+
const absolute = resolveSafeMarkdownPath(opts.path);
|
|
104
|
+
const relativeDocument = repoRelativePath(absolute);
|
|
105
|
+
const statePath = gradePipelineStatePath(relativeDocument, opts.project);
|
|
106
|
+
if (!existsSync(statePath))
|
|
107
|
+
return undefined;
|
|
108
|
+
const state = parseGradePipelineState(JSON.parse(readFileSync(statePath, "utf8")), repoRelativePath(statePath));
|
|
109
|
+
const projectId = resolveProject(opts.project).id;
|
|
110
|
+
if (state.project_id !== projectId) {
|
|
111
|
+
throw new Error(`${repoRelativePath(statePath)}: project_id must be ${projectId}`);
|
|
112
|
+
}
|
|
113
|
+
const document = parseMarkdown(readFileSync(absolute, "utf8"), relativeDocument);
|
|
114
|
+
return currentGradePipelineState(document, relativeDocument, state, opts.target);
|
|
115
|
+
}
|
|
116
|
+
export function listExhaustedGradePipelineStates(opts) {
|
|
117
|
+
const states = loadGradePipelineStates(opts.project);
|
|
118
|
+
return [...states.values()]
|
|
119
|
+
.filter((state) => {
|
|
120
|
+
if (state.target !== opts.target || state.consecutive_failures < state.max_failures)
|
|
121
|
+
return false;
|
|
122
|
+
const absolute = resolve(specdojoRootDir(), state.document);
|
|
123
|
+
if (!existsSync(absolute))
|
|
124
|
+
return false;
|
|
125
|
+
const document = parseMarkdown(readFileSync(absolute, "utf8"), state.document);
|
|
126
|
+
return currentGradePipelineState(document, state.document, state, opts.target) !== undefined;
|
|
127
|
+
})
|
|
128
|
+
.sort((left, right) => left.document.localeCompare(right.document));
|
|
129
|
+
}
|
|
130
|
+
export function recordGradePipelineStage(opts) {
|
|
131
|
+
const absolute = resolveSafeMarkdownPath(opts.path);
|
|
132
|
+
const relativeDocument = repoRelativePath(absolute);
|
|
133
|
+
const statePath = gradePipelineStatePath(relativeDocument, opts.project);
|
|
134
|
+
if (opts.status === "complete") {
|
|
135
|
+
if (existsSync(statePath))
|
|
136
|
+
unlinkSync(statePath);
|
|
137
|
+
return undefined;
|
|
138
|
+
}
|
|
139
|
+
if (!Number.isSafeInteger(opts.stage) ||
|
|
140
|
+
opts.stage < 1 ||
|
|
141
|
+
!Number.isSafeInteger(opts.stageTotal) ||
|
|
142
|
+
opts.stageTotal < opts.stage ||
|
|
143
|
+
!Number.isSafeInteger(opts.maxFailures) ||
|
|
144
|
+
opts.maxFailures < 1) {
|
|
145
|
+
throw new Error("grade pipeline stage, total, and failure limit are invalid");
|
|
146
|
+
}
|
|
147
|
+
const document = parseMarkdown(readFileSync(absolute, "utf8"), relativeDocument);
|
|
148
|
+
const previous = readGradePipelineState({
|
|
149
|
+
target: opts.target,
|
|
150
|
+
project: opts.project,
|
|
151
|
+
path: relativeDocument,
|
|
152
|
+
});
|
|
153
|
+
const previousCompleted = previous?.stage_completed ?? 0;
|
|
154
|
+
if (opts.stage !== previousCompleted + 1) {
|
|
155
|
+
throw new Error(`grade pipeline stage ${opts.stage} must immediately follow completed stage ${previousCompleted}`);
|
|
156
|
+
}
|
|
157
|
+
const stageCompleted = opts.status === "passed" ? opts.stage : Math.min(previousCompleted, opts.stage - 1);
|
|
158
|
+
if (stageCompleted >= opts.stageTotal) {
|
|
159
|
+
if (existsSync(statePath))
|
|
160
|
+
unlinkSync(statePath);
|
|
161
|
+
return undefined;
|
|
162
|
+
}
|
|
163
|
+
const state = {
|
|
164
|
+
version: 1,
|
|
165
|
+
project_id: resolveProject(opts.project).id,
|
|
166
|
+
target: opts.target,
|
|
167
|
+
document: relativeDocument,
|
|
168
|
+
content_hash: pipelineContentHash(document),
|
|
169
|
+
stage_completed: stageCompleted,
|
|
170
|
+
stage_failed: opts.status === "failed" ? opts.stage : null,
|
|
171
|
+
stage_total: opts.stageTotal,
|
|
172
|
+
consecutive_failures: opts.status === "failed"
|
|
173
|
+
? previous?.stage_failed === opts.stage
|
|
174
|
+
? previous.consecutive_failures + 1
|
|
175
|
+
: 1
|
|
176
|
+
: 0,
|
|
177
|
+
max_failures: opts.maxFailures,
|
|
178
|
+
last_run_id: opts.runId,
|
|
179
|
+
updated_at: (opts.now ?? new Date()).toISOString(),
|
|
180
|
+
};
|
|
181
|
+
mkdirSync(dirname(statePath), { recursive: true });
|
|
182
|
+
writeFileSync(statePath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
|
|
183
|
+
return state;
|
|
184
|
+
}
|