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.
- package/CHANGELOG.md +47 -0
- package/README.md +77 -18
- package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
- package/dist/catalog/build-render.js +32 -0
- package/dist/{catalog-build.js → catalog/build.js} +9 -9
- package/dist/{catalog.js → catalog/catalog.js} +10 -10
- package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
- package/dist/catalog/paths.js +1 -0
- package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
- package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
- package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
- 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} +98 -32
- package/dist/{orchestrator.js → commands/orchestrator.js} +2 -2
- package/dist/{watch.js → commands/watch.js} +3 -3
- package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
- package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
- package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
- package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
- package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
- 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} +5 -5
- 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} +1 -1
- package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
- 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} +1 -1
- package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
- package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
- 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-commands.js → exec/commands.js} +22 -18
- package/dist/{exec-core.js → exec/core.js} +11 -11
- 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-core.js → exec/plans-core.js} +68 -114
- package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
- package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
- package/dist/{exec-plans.js → exec/plans.js} +3 -3
- 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 → exec/repo-integration-git.js} +2 -2
- package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
- package/dist/{exec-repo-integration.js → exec/repo-integration.js} +13 -10
- package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
- package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
- package/dist/{exec-reporter.js → exec/reporter.js} +29 -12
- package/dist/{exec-results.js → exec/results.js} +256 -22
- package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +32 -12
- package/dist/{exec-run-agent.js → exec/run/agent.js} +79 -27
- package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
- package/dist/{exec-run-job.js → exec/run/job.js} +64 -35
- package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
- package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
- package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
- package/dist/{exec-run-register-command.js → exec/run/register-command.js} +18 -10
- package/dist/{exec-run-register-core.js → exec/run/register-core.js} +46 -21
- package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +20 -16
- package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +22 -17
- package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
- package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +54 -23
- package/dist/{exec-run.js → exec/run/run.js} +11 -11
- package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
- package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
- package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
- package/dist/{exec-run-shared.js → exec/run/shared.js} +61 -11
- 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-commands.js → exec/trial-commands.js} +20 -22
- package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
- package/dist/{exec-trial.js → exec/trial.js} +2 -2
- package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
- package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
- package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
- package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
- package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
- package/dist/exec/worktree.js +305 -0
- package/dist/{grade-apply.js → grade/apply.js} +9 -9
- package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
- package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
- package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
- package/dist/{grade-core.js → grade/core.js} +3 -3
- package/dist/grade/grade.js +19 -0
- package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
- package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
- package/dist/{grade-plan.js → grade/plan.js} +5 -5
- package/dist/{grade-result.js → grade/result.js} +5 -94
- package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
- package/dist/{grade-targets.js → grade/targets.js} +11 -8
- package/dist/{job-definition.js → job/definition.js} +25 -6
- package/dist/{job.js → job/job.js} +12 -11
- package/dist/{kata-command.js → kata/command.js} +3 -3
- package/dist/{kata.js → kata/kata.js} +5 -5
- package/dist/register/approach.js +134 -0
- package/dist/{register-core.js → register/core.js} +13 -7
- package/dist/{register-create-commands.js → register/create-commands.js} +115 -8
- 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} +9 -3
- package/dist/{register-history.js → register/history.js} +7 -6
- package/dist/{register-item.js → register/item.js} +23 -5
- package/dist/register/lifecycle-lock.js +5 -0
- package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
- package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
- package/dist/{register-migration.js → register/migration.js} +4 -4
- package/dist/{register.js → register/register.js} +32 -27
- package/dist/{register-renumber.js → register/renumber.js} +38 -11
- package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
- package/dist/{register-update.js → register/update.js} +5 -5
- package/dist/{register-views.js → register/views.js} +47 -7
- package/dist/{review-grade.js → review/grade.js} +2 -2
- package/dist/{review-plan.js → review/plan.js} +3 -3
- package/dist/{routine-definition.js → routine/definition.js} +2 -2
- package/dist/{routine.js → routine/routine.js} +49 -22
- package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
- package/dist/{schedule-build.js → schedule/build.js} +7 -4
- package/dist/{schedule.js → schedule/schedule.js} +6 -6
- package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
- package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
- package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
- 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/{catalog-build-render.js → shared/catalog-render.js} +3 -32
- package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
- package/dist/shared/fs.js +30 -0
- package/dist/{exec-worktree.js → shared/git.js} +83 -241
- 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} +93 -5
- package/dist/{exec-shared.js → shared/text.js} +0 -134
- package/dist/shared/time.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 +91 -16
- 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 +31 -0
- 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 +5 -5
- 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 +1 -1
- package/templates/antigravity/README.md +5 -1
- package/templates/antigravity/agent-members-snippet.yaml +108 -12
- package/templates/antigravity/exec-defaults-snippet.yaml +8 -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 +24 -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-schedule-gantt-chart.js +0 -2
- package/dist/exec.js +0 -2
- package/dist/grade.js +0 -19
- 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/{grade-command-shared.js → grade/command-shared.js} +0 -0
- /package/dist/{register-command-types.js → register/command-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
- /package/dist/{yaml.js → shared/yaml.js} +0 -0
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
import { createInterface } from "node:readline/promises";
|
|
2
2
|
import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
|
|
3
3
|
import { dirname, join, relative } from "node:path";
|
|
4
|
-
import { dump, load } from "
|
|
5
|
-
import { runScaffold } from "
|
|
6
|
-
import { runDevcontainerScaffold } from "
|
|
7
|
-
import { runProviderScaffold } from "
|
|
8
|
-
import { generateDerivedViewFiles } from "
|
|
9
|
-
import { defaultWorktreeBase, projectGitignoreLayout, specdojoRootDir, } from "
|
|
10
|
-
import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "
|
|
11
|
-
import { specdojoPackageRootDir } from "
|
|
4
|
+
import { dump, load } from "../shared/yaml.js";
|
|
5
|
+
import { runScaffold } from "../catalog/scaffold.js";
|
|
6
|
+
import { runDevcontainerScaffold } from "../devcontainer/scaffold.js";
|
|
7
|
+
import { runProviderScaffold } from "../shared/provider-scaffold.js";
|
|
8
|
+
import { generateDerivedViewFiles } from "../register/register.js";
|
|
9
|
+
import { defaultWorktreeBase, projectGitignoreLayout, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
10
|
+
import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "../shared/specdojo-gitignore.js";
|
|
11
|
+
import { specdojoPackageRootDir } from "../shared/package-paths.js";
|
|
12
12
|
const PROVIDERS = ["claude", "codex", "opencode", "antigravity", "copilot"];
|
|
13
13
|
const PARENT_VALIDATION_SCRIPTS = {
|
|
14
14
|
"lint-ts": "lint:ts",
|
|
@@ -63,22 +63,53 @@ function parseCatalog(value) {
|
|
|
63
63
|
}
|
|
64
64
|
throw new Error(`Invalid catalog size: ${value}. Must be small, medium, large, or none`);
|
|
65
65
|
}
|
|
66
|
-
function
|
|
67
|
-
if (!/^prj-[0-9]{4,}$/.test(
|
|
68
|
-
throw new Error(`Invalid project ID: ${
|
|
66
|
+
function validateProjectId(projectId) {
|
|
67
|
+
if (!/^prj-[0-9]{4,}$/.test(projectId)) {
|
|
68
|
+
throw new Error(`Invalid project ID: ${projectId}. Expected prj-0001 style`);
|
|
69
69
|
}
|
|
70
|
-
|
|
70
|
+
return projectId;
|
|
71
|
+
}
|
|
72
|
+
function validateProjectName(projectName) {
|
|
73
|
+
if (!projectName.trim())
|
|
71
74
|
throw new Error("Project name must not be empty");
|
|
72
|
-
|
|
73
|
-
|
|
75
|
+
return projectName;
|
|
76
|
+
}
|
|
77
|
+
function validateNickname(nickname) {
|
|
78
|
+
if (!/^[a-z0-9][a-z0-9_-]{0,62}$/.test(nickname)) {
|
|
79
|
+
throw new Error(`Invalid nickname: ${nickname}`);
|
|
74
80
|
}
|
|
75
|
-
|
|
81
|
+
return nickname;
|
|
82
|
+
}
|
|
83
|
+
function validateDisplayName(displayName) {
|
|
84
|
+
if (!displayName.trim())
|
|
76
85
|
throw new Error("Display name must not be empty");
|
|
77
|
-
|
|
86
|
+
return displayName;
|
|
87
|
+
}
|
|
88
|
+
function validateExecProviders(providers, exec) {
|
|
89
|
+
if (exec && providers.length === 0) {
|
|
78
90
|
throw new Error("--exec requires at least one --provider");
|
|
79
91
|
}
|
|
92
|
+
return providers;
|
|
93
|
+
}
|
|
94
|
+
function validateAnswers(answers) {
|
|
95
|
+
validateProjectId(answers.projectId);
|
|
96
|
+
validateProjectName(answers.projectName);
|
|
97
|
+
validateNickname(answers.nickname);
|
|
98
|
+
validateDisplayName(answers.displayName);
|
|
99
|
+
validateExecProviders(answers.providers, answers.exec);
|
|
80
100
|
return answers;
|
|
81
101
|
}
|
|
102
|
+
async function promptUntilValid(prompter, prompt, parse) {
|
|
103
|
+
while (true) {
|
|
104
|
+
const answer = await prompter.question(prompt);
|
|
105
|
+
try {
|
|
106
|
+
return parse(answer);
|
|
107
|
+
}
|
|
108
|
+
catch (error) {
|
|
109
|
+
process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
}
|
|
82
113
|
export async function collectInitAnswers(options, prompter) {
|
|
83
114
|
if (!prompter) {
|
|
84
115
|
const answers = validateAnswers({
|
|
@@ -116,18 +147,21 @@ export async function collectInitAnswers(options, prompter) {
|
|
|
116
147
|
const displayNameDefault = options.displayName?.trim() || DEFAULTS.displayName;
|
|
117
148
|
const providerDefault = options.provider?.trim() || DEFAULTS.providers.join(",");
|
|
118
149
|
const execDefault = !!options.exec;
|
|
119
|
-
const catalogDefault = options.catalog?.trim() || "none";
|
|
120
150
|
const devcontainerDefault = !!options.devcontainer;
|
|
121
|
-
const
|
|
122
|
-
const
|
|
123
|
-
const
|
|
124
|
-
const
|
|
125
|
-
const
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
const exec =
|
|
129
|
-
|
|
130
|
-
|
|
151
|
+
const providerPrompt = `Orchestrator providers (${PROVIDERS.join(", ")}) [${providerDefault}]: `;
|
|
152
|
+
const projectId = await promptUntilValid(prompter, `Project ID [${projectDefault}]: `, (answer) => validateProjectId(answer.trim() || projectDefault));
|
|
153
|
+
const projectName = await promptUntilValid(prompter, `Project name [${nameDefault}]: `, (answer) => validateProjectName(answer.trim() || nameDefault));
|
|
154
|
+
const register = await promptUntilValid(prompter, `Create a project register? [${registerDefault ? "Y/n" : "y/N"}]: `, (answer) => parseBoolean(answer, registerDefault));
|
|
155
|
+
const nickname = await promptUntilValid(prompter, `Your nickname [${nicknameDefault}]: `, (answer) => validateNickname(answer.trim() || nicknameDefault));
|
|
156
|
+
const displayName = await promptUntilValid(prompter, `Your display name [${displayNameDefault}]: `, (answer) => validateDisplayName(answer.trim() || displayNameDefault));
|
|
157
|
+
let providers = await promptUntilValid(prompter, providerPrompt, (answer) => parseProviders(answer.trim() || providerDefault));
|
|
158
|
+
const exec = await promptUntilValid(prompter, `Delegate work to agents (exec)? [${execDefault ? "Y/n" : "y/N"}]: `, (answer) => parseBoolean(answer, execDefault));
|
|
159
|
+
if (exec && providers.length === 0) {
|
|
160
|
+
process.stderr.write("--exec requires at least one --provider\n");
|
|
161
|
+
providers = await promptUntilValid(prompter, providerPrompt, (answer) => validateExecProviders(parseProviders(answer.trim() || providerDefault), true));
|
|
162
|
+
}
|
|
163
|
+
const catalog = parseCatalog(options.catalog);
|
|
164
|
+
const devcontainer = await promptUntilValid(prompter, `Create a Dev Container? [${devcontainerDefault ? "Y/n" : "y/N"}]: `, (answer) => parseBoolean(answer, devcontainerDefault));
|
|
131
165
|
return validateAnswers({
|
|
132
166
|
projectId,
|
|
133
167
|
projectName,
|
|
@@ -242,11 +276,35 @@ function selectParentValidations(repoRoot, configured) {
|
|
|
242
276
|
}
|
|
243
277
|
return selected;
|
|
244
278
|
}
|
|
279
|
+
// 別名は向き先の実体が選ばれた provider に含まれる場合だけ残す。別名どうしの連鎖も辿る。
|
|
280
|
+
function selectAliases(aliases, memberNicknames) {
|
|
281
|
+
const targets = new Map(aliases.map((alias) => [alias.nickname, alias.alias_of]));
|
|
282
|
+
const resolvesToSelected = (nickname) => {
|
|
283
|
+
const seen = new Set();
|
|
284
|
+
let current = nickname;
|
|
285
|
+
while (!seen.has(current)) {
|
|
286
|
+
seen.add(current);
|
|
287
|
+
const target = targets.get(current);
|
|
288
|
+
if (!target)
|
|
289
|
+
return false;
|
|
290
|
+
if (memberNicknames.has(target))
|
|
291
|
+
return true;
|
|
292
|
+
current = target;
|
|
293
|
+
}
|
|
294
|
+
return false;
|
|
295
|
+
};
|
|
296
|
+
return aliases.filter((alias) => resolvesToSelected(alias.nickname));
|
|
297
|
+
}
|
|
298
|
+
// 次の手順の案内には、利用者が見慣れた別名を優先して示す(実体の名前でも同じ member が動く)。
|
|
299
|
+
function preferredAgentName(member, aliases) {
|
|
300
|
+
return aliases.find((alias) => alias.alias_of === member.nickname)?.nickname ?? member.nickname;
|
|
301
|
+
}
|
|
245
302
|
function writeExecConfiguration(repoRoot, packageRoot, providers, dryRun) {
|
|
246
303
|
const memberTemplate = loadInitTemplate(packageRoot, "init-agent-members.yaml");
|
|
247
304
|
const defaultsTemplate = loadInitTemplate(packageRoot, "init-exec-defaults.yaml");
|
|
248
305
|
const selected = new Set(providers);
|
|
249
306
|
const members = memberTemplate.members.filter((member) => member.provider && selected.has(member.provider));
|
|
307
|
+
const aliases = selectAliases(memberTemplate.aliases ?? [], new Set(members.map((member) => member.nickname)));
|
|
250
308
|
const providerDefaults = Object.fromEntries(Object.entries(defaultsTemplate.providers).filter(([provider]) => selected.has(provider)));
|
|
251
309
|
const { providers: _providers, ...commonDefaults } = defaultsTemplate;
|
|
252
310
|
const commonPipeline = commonDefaults.pipeline && typeof commonDefaults.pipeline === "object"
|
|
@@ -264,7 +322,7 @@ function writeExecConfiguration(repoRoot, packageRoot, providers, dryRun) {
|
|
|
264
322
|
else {
|
|
265
323
|
delete configuredDefaults.pipeline;
|
|
266
324
|
}
|
|
267
|
-
writeNewFile(repoRoot, ".specdojo/agent-members.yaml", dump({ version: 1, members }, { lineWidth: 120, noRefs: true }), dryRun);
|
|
325
|
+
writeNewFile(repoRoot, ".specdojo/agent-members.yaml", dump({ version: 1, members, ...(aliases.length > 0 ? { aliases } : {}) }, { lineWidth: 120, noRefs: true }), dryRun);
|
|
268
326
|
writeNewFile(repoRoot, ".specdojo/exec-defaults.yaml", dump({ ...configuredDefaults, providers: providerDefaults }, { lineWidth: 120, noRefs: true }), dryRun);
|
|
269
327
|
const primaryProvider = providers[0];
|
|
270
328
|
const executor = members.find((member) => member.provider === primaryProvider &&
|
|
@@ -274,7 +332,10 @@ function writeExecConfiguration(repoRoot, packageRoot, providers, dryRun) {
|
|
|
274
332
|
if (!executor || !reporter) {
|
|
275
333
|
throw new Error("init-agent-members.yaml must define an edit executor and reporter");
|
|
276
334
|
}
|
|
277
|
-
return {
|
|
335
|
+
return {
|
|
336
|
+
executor: preferredAgentName(executor, aliases),
|
|
337
|
+
reporter: preferredAgentName(reporter, aliases),
|
|
338
|
+
};
|
|
278
339
|
}
|
|
279
340
|
function scaffoldRegister(repoRoot, config, answers, dryRun) {
|
|
280
341
|
if (!answers.register)
|
|
@@ -392,18 +453,19 @@ export async function runInit(options, deps) {
|
|
|
392
453
|
await runDevcontainerScaffold({
|
|
393
454
|
packageRoot,
|
|
394
455
|
repoRoot,
|
|
456
|
+
workspaceName: options.workspaceName,
|
|
395
457
|
providers: answers.providers,
|
|
396
458
|
editors: [],
|
|
397
459
|
ollama: answers.providers.includes("opencode"),
|
|
398
460
|
cron: false,
|
|
399
|
-
tmux:
|
|
461
|
+
tmux: true,
|
|
400
462
|
force: false,
|
|
401
463
|
dryRun,
|
|
402
464
|
});
|
|
403
465
|
}
|
|
404
466
|
const firstProvider = answers.providers[0];
|
|
405
467
|
const script = firstProvider === "claude"
|
|
406
|
-
? "orch:
|
|
468
|
+
? "orch:opus"
|
|
407
469
|
: firstProvider === "antigravity"
|
|
408
470
|
? "orch:agy"
|
|
409
471
|
: `orch:${firstProvider}`;
|
|
@@ -414,7 +476,10 @@ export async function runInit(options, deps) {
|
|
|
414
476
|
(execAgents
|
|
415
477
|
? ` 2. To run an item without the orchestrator: npx specdojo exec run --register <id> --executor-by ${execAgents.executor} --reporter-by ${execAgents.reporter}\n`
|
|
416
478
|
: "") +
|
|
417
|
-
` ${execAgents ? "3" : "2"}. Review and commit the files created by specdojo init.\n`
|
|
479
|
+
` ${execAgents ? "3" : "2"}. Review and commit the files created by specdojo init.\n` +
|
|
480
|
+
(answers.catalog
|
|
481
|
+
? ""
|
|
482
|
+
: "When deliverables are ready, configure catalog_path in .specdojo/specdojo.config.json and run npx specdojo catalog scaffold (see docs/ja/specdojo/guides/quick-start-guide.md).\n"));
|
|
418
483
|
}
|
|
419
484
|
export function registerInitCommand(program) {
|
|
420
485
|
program
|
|
@@ -430,6 +495,7 @@ export function registerInitCommand(program) {
|
|
|
430
495
|
.option("--exec", "Configure executor and reporter agents", false)
|
|
431
496
|
.option("--catalog <size>", "Create a deliverables catalog (small|medium|large)")
|
|
432
497
|
.option("--devcontainer", "Create a Dev Container for the selected providers", false)
|
|
498
|
+
.option("--workspace-name <name>", "Override the Dev Container workspace parent name used under /workspaces")
|
|
433
499
|
.option("--dry-run", "Show planned files and changes without writing", false)
|
|
434
500
|
.action(async (options) => {
|
|
435
501
|
try {
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { spawn } from "node:child_process";
|
|
2
2
|
import { constants as osConstants } from "node:os";
|
|
3
3
|
import { resolve } from "node:path";
|
|
4
|
-
import { agentExtraRootArguments, resolveProductRepos } from "
|
|
5
|
-
import { loadConfig, specdojoRootDir, } from "
|
|
4
|
+
import { agentExtraRootArguments, resolveProductRepos } from "../exec/task-repos.js";
|
|
5
|
+
import { loadConfig, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
6
6
|
const ORCHESTRATOR_EXECUTABLES = {
|
|
7
7
|
claude: "claude",
|
|
8
8
|
codex: "codex",
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { watch as fsWatch, existsSync, readdirSync } from "node:fs";
|
|
2
2
|
import { spawn } from "node:child_process";
|
|
3
3
|
import { join, resolve } from "node:path";
|
|
4
|
-
import { getProjectCatalogPath, getProjectExecutionPath, getProjectRegisterPath, getProjectSchedulePath, loadConfig, loadEnv, specdojoRootDir, } from "
|
|
5
|
-
import { selfRunArgs } from "
|
|
6
|
-
import { isDctPlanFileName } from "
|
|
4
|
+
import { getProjectCatalogPath, getProjectExecutionPath, getProjectRegisterPath, getProjectSchedulePath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
5
|
+
import { selfRunArgs } from "../shared/spawn-self.js";
|
|
6
|
+
import { isDctPlanFileName } from "../catalog/plan.js";
|
|
7
7
|
const VALID_SCOPES = ["exec", "catalog", "register", "index", "all"];
|
|
8
8
|
const SKIP_DIRS = new Set([".git", "node_modules", "generated", "dist", ".vitepress"]);
|
|
9
9
|
// ================================
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { addWorkingDaysToDate } from "
|
|
2
|
-
import { buildScheduleIndex, defaultScheduleCalendar } from "
|
|
1
|
+
import { addWorkingDaysToDate } from "../exec/schedule/calendar.js";
|
|
2
|
+
import { buildScheduleIndex, defaultScheduleCalendar } from "../shared/schedule-index.js";
|
|
3
3
|
import { buildTimelineWaves } from "./timeline-build.js";
|
|
4
4
|
// tml-index の tracks を order → wave に集約し、planned_start_date と稼働日カレンダーで各トラックの
|
|
5
5
|
// 予定開始日・終了日を算出する。横軸は日付であり、wave 番号ではない。
|
|
@@ -1,16 +1,17 @@
|
|
|
1
1
|
import { mkdirSync, existsSync, readFileSync, writeFileSync, readdirSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
3
|
+
import { toArtifactPath } from "../shared/artifact-path.js";
|
|
4
|
+
import { readJson } from "../shared/fs.js";
|
|
5
|
+
import { readAllEventFiles } from "../exec/events.js";
|
|
6
|
+
import { getProjectExecutionPath, getProjectRoutinesPath, getProjectSchedulePath, getProjectTimelinePath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
7
|
+
import { resolveRegisterPaths, loadRegisterItems, } from "../register/register.js";
|
|
8
|
+
import { readRegisterEventsFromContent, registerEventFilePath, } from "../register/events.js";
|
|
8
9
|
import { buildTimelineWaves, loadTimelineIndex } from "./timeline-build.js";
|
|
9
10
|
import { buildTimelineGanttSvg, computeTimelineTrackSchedules, resolveDashboardCalendar, } from "./dashboard-timeline.js";
|
|
10
|
-
import { aggregateRoutines, buildDailyRoutineRows, formatZonedDateTime, ROUTINE_ROW_COLLAPSE_THRESHOLD, zonedDateKey, } from "./
|
|
11
|
-
import { buildExecRecordsMarkdown, collectExecRecords, EXEC_RECORDS_FILE
|
|
12
|
-
import { sanitizeDashboardCell } from "./
|
|
13
|
-
import { gradeFindingCount, parseGradeResult } from "
|
|
11
|
+
import { aggregateRoutines, buildDailyRoutineRows, formatZonedDateTime, ROUTINE_ROW_COLLAPSE_THRESHOLD, zonedDateKey, } from "./routines.js";
|
|
12
|
+
import { buildExecRecordsMarkdown, collectExecRecords, EXEC_RECORDS_FILE } from "./exec-records.js";
|
|
13
|
+
import { sanitizeDashboardCell } from "./shared.js";
|
|
14
|
+
import { gradeFindingCount, parseGradeResult } from "../grade/result.js";
|
|
14
15
|
// ================================
|
|
15
16
|
// Types
|
|
16
17
|
// ================================
|
|
@@ -177,7 +178,7 @@ function aggregateAttention(paths) {
|
|
|
177
178
|
}
|
|
178
179
|
return rows;
|
|
179
180
|
}
|
|
180
|
-
export { buildDailyRoutineRows, collapseFrequentRoutineRows, computeRoutineDue, formatZonedDateTime, readRoutineRunHistory, } from "./
|
|
181
|
+
export { buildDailyRoutineRows, collapseFrequentRoutineRows, computeRoutineDue, formatZonedDateTime, readRoutineRunHistory, } from "./routines.js";
|
|
181
182
|
// ================================
|
|
182
183
|
// Markdown rendering
|
|
183
184
|
// ================================
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { existsSync, readFileSync, readdirSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
|
-
import { load } from "
|
|
4
|
-
import { sanitizeDashboardCell } from "./
|
|
3
|
+
import { load } from "../shared/yaml.js";
|
|
4
|
+
import { sanitizeDashboardCell } from "./shared.js";
|
|
5
5
|
export const EXEC_RECORDS_FILE = "exec-records.md";
|
|
6
6
|
function readSpecdojoFrontmatter(filePath) {
|
|
7
7
|
try {
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { existsSync, readFileSync, readdirSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
|
-
import { load } from "
|
|
4
|
-
import { readJson } from "
|
|
5
|
-
import { cronMatches, cronOccurrences, isRoutineDue, routineActionKindLabel, } from "
|
|
3
|
+
import { load } from "../shared/yaml.js";
|
|
4
|
+
import { readJson } from "../shared/fs.js";
|
|
5
|
+
import { cronMatches, cronOccurrences, isRoutineDue, routineActionKindLabel, } from "../routine/routine.js";
|
|
6
6
|
// routine ファイル(rtn-*.yaml)を読み、状態ファイル generated/routine-state.json と突き合わせて
|
|
7
7
|
// 最終実行・実行結果・due 状況を得る。CLI 出力(routine list)の転記に依存しない。
|
|
8
8
|
export function aggregateRoutines(routinesPath) {
|
|
@@ -48,7 +48,7 @@ export function readRoutineRunHistory(historyPath) {
|
|
|
48
48
|
typeof value.scheduled_for === "string" &&
|
|
49
49
|
typeof value.started_at === "string" &&
|
|
50
50
|
typeof value.completed_at === "string" &&
|
|
51
|
-
["success", "failure", "skipped"].includes(value.result) &&
|
|
51
|
+
["success", "partial", "failure", "skipped"].includes(value.result) &&
|
|
52
52
|
Array.isArray(value.job_run_ids)) {
|
|
53
53
|
entries.push(value);
|
|
54
54
|
}
|
|
@@ -162,11 +162,12 @@ export function collapseFrequentRoutineRows(rows) {
|
|
|
162
162
|
const executed = group.filter((row) => row.result !== "予定" && row.result !== "未実行");
|
|
163
163
|
const latest = [...(executed.length > 0 ? executed : group)].sort((a, b) => b.scheduledFor.localeCompare(a.scheduledFor))[0];
|
|
164
164
|
const failures = executed.filter((row) => row.result === "failure").length;
|
|
165
|
+
const partials = executed.filter((row) => row.result === "partial").length;
|
|
165
166
|
collapsed.push({
|
|
166
167
|
...latest,
|
|
167
168
|
runCount: executed.length > 0 ? executed.length : group.length,
|
|
168
169
|
jobRunIds: [],
|
|
169
|
-
result: failures > 0 ? "failure" : latest.result,
|
|
170
|
+
result: failures > 0 ? "failure" : partials > 0 ? "partial" : latest.result,
|
|
170
171
|
});
|
|
171
172
|
}
|
|
172
173
|
return collapsed;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { stripTerminalControlSequences } from "
|
|
1
|
+
import { stripTerminalControlSequences } from "../shared/text.js";
|
|
2
2
|
const MAX_DASHBOARD_CELL_LENGTH = 200;
|
|
3
3
|
// dashboard の表へは event や subprocess 由来の文字列も入る。表へ埋める直前に
|
|
4
4
|
// ターミナル制御シーケンスと改行類を除き、列区切りをエスケープして長さを制限する。
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { existsSync, readdirSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
|
-
import {
|
|
3
|
+
import { readYaml } from "../shared/fs.js";
|
|
4
|
+
import { normalizeDateOnly } from "../shared/time.js";
|
|
4
5
|
const CATALOG_STATUSES = ["not_started", "draft", "primary"];
|
|
5
6
|
function isRecord(value) {
|
|
6
7
|
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { existsSync, mkdirSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { join, resolve } from "node:path";
|
|
3
|
-
import { getProjectCatalogPath, getProjectTimelinePath, loadConfig, loadEnv, specdojoRootDir, } from "
|
|
3
|
+
import { getProjectCatalogPath, getProjectTimelinePath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
4
4
|
import { buildTimeline, renderCatalogScaffoldMarkdown, renderTimelineOrderMarkdown, } from "./timeline-build.js";
|
|
5
5
|
function resolveTimelinePaths(opts) {
|
|
6
6
|
loadEnv();
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { existsSync } from "node:fs";
|
|
2
|
-
import { addProjectOption, printCommandError, resolveCatalogPath } from "
|
|
3
|
-
import { runGenerate } from "
|
|
4
|
-
import { specdojoRootDir } from "
|
|
5
|
-
import { resolveSpecdojoPath } from "
|
|
6
|
-
import { applyTrash, planTrash } from "./
|
|
2
|
+
import { addProjectOption, printCommandError, resolveCatalogPath } from "../catalog/catalog.js";
|
|
3
|
+
import { runGenerate } from "../catalog/generate.js";
|
|
4
|
+
import { specdojoRootDir } from "../shared/specdojo-config.js";
|
|
5
|
+
import { resolveSpecdojoPath } from "../docs/template-resolution.js";
|
|
6
|
+
import { applyTrash, planTrash } from "./trash.js";
|
|
7
7
|
function collectCommaSeparated(value, previous) {
|
|
8
8
|
return [
|
|
9
9
|
...previous,
|
|
@@ -10,11 +10,11 @@
|
|
|
10
10
|
// unrelated nested `evidence_refs[].path` field.
|
|
11
11
|
import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
|
|
12
12
|
import { basename, dirname, join, relative } from "node:path";
|
|
13
|
-
import { load } from "
|
|
14
|
-
import { isDctCatalogFileName } from "
|
|
15
|
-
import { resolveBasePath, resolveDeliverablePath } from "
|
|
16
|
-
import { readSpecdojoNamespace } from "
|
|
17
|
-
import { gitOutput } from "
|
|
13
|
+
import { load } from "../shared/yaml.js";
|
|
14
|
+
import { isDctCatalogFileName } from "../catalog/types.js";
|
|
15
|
+
import { resolveBasePath, resolveDeliverablePath } from "../catalog/paths.js";
|
|
16
|
+
import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
|
|
17
|
+
import { gitOutput } from "../shared/git.js";
|
|
18
18
|
function findCatalogFiles(catalogDir) {
|
|
19
19
|
return readdirSync(catalogDir).filter(isDctCatalogFileName).sort();
|
|
20
20
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { runDevcontainerScaffold } from "./
|
|
2
|
-
import { specdojoPackageRootDir } from "
|
|
3
|
-
import { specdojoRootDir } from "
|
|
1
|
+
import { runDevcontainerScaffold } from "./scaffold.js";
|
|
2
|
+
import { specdojoPackageRootDir } from "../shared/package-paths.js";
|
|
3
|
+
import { specdojoRootDir } from "../shared/specdojo-config.js";
|
|
4
4
|
export function registerDevcontainerCommands(program) {
|
|
5
5
|
const dc = program.command("devcontainer").description("Dev Container helpers");
|
|
6
6
|
dc.command("scaffold")
|
|
@@ -10,6 +10,7 @@ export function registerDevcontainerCommands(program) {
|
|
|
10
10
|
.option("--ollama", "Add Ollama connection settings", false)
|
|
11
11
|
.option("--cron", "Add cron support", false)
|
|
12
12
|
.option("--tmux", "Add tmux", false)
|
|
13
|
+
.option("--workspace-name <name>", "Override the workspace parent name used under /workspaces")
|
|
13
14
|
.option("--force", "Overwrite existing .devcontainer/", false)
|
|
14
15
|
.option("--dry-run", "Show planned files without writing", false)
|
|
15
16
|
.action(async (opts) => {
|
|
@@ -17,6 +18,7 @@ export function registerDevcontainerCommands(program) {
|
|
|
17
18
|
await runDevcontainerScaffold({
|
|
18
19
|
packageRoot: specdojoPackageRootDir(),
|
|
19
20
|
repoRoot: specdojoRootDir(),
|
|
21
|
+
workspaceName: opts.workspaceName === undefined ? undefined : String(opts.workspaceName),
|
|
20
22
|
providers: opts.provider
|
|
21
23
|
? String(opts.provider)
|
|
22
24
|
.split(",")
|
|
@@ -1,14 +1,90 @@
|
|
|
1
1
|
import { existsSync } from "node:fs";
|
|
2
2
|
import { readFile, writeFile, mkdir } from "node:fs/promises";
|
|
3
3
|
import * as path from "node:path";
|
|
4
|
+
function resolveWorkspaceName(repoRoot, override) {
|
|
5
|
+
const workspaceName = override ?? path.basename(path.dirname(path.resolve(repoRoot)));
|
|
6
|
+
if (workspaceName === "." || workspaceName === ".." || !/^[A-Za-z0-9._-]+$/.test(workspaceName)) {
|
|
7
|
+
throw new Error(`Invalid workspace name: ${JSON.stringify(workspaceName)}. Use only ASCII letters, numbers, dot, underscore, and hyphen.`);
|
|
8
|
+
}
|
|
9
|
+
return workspaceName;
|
|
10
|
+
}
|
|
4
11
|
function repositoryVolumePrefix(repoRoot) {
|
|
5
12
|
const repositoryName = path.basename(path.resolve(repoRoot)).toLowerCase();
|
|
6
13
|
const safeName = repositoryName.replace(/[^a-z0-9_.-]+/g, "-").replace(/^[._-]+|[._-]+$/g, "");
|
|
7
14
|
return safeName || "project";
|
|
8
15
|
}
|
|
16
|
+
function extractPortNumber(value) {
|
|
17
|
+
if (typeof value === "number") {
|
|
18
|
+
return Number.isInteger(value) && value > 0 && value <= 65535 ? value : undefined;
|
|
19
|
+
}
|
|
20
|
+
if (typeof value === "string") {
|
|
21
|
+
const trimmed = value.trim();
|
|
22
|
+
const withoutProto = trimmed.replace(/\/(tcp|udp)$/, "");
|
|
23
|
+
const parts = withoutProto.split(":");
|
|
24
|
+
const portStr = parts.length === 3 ? parts[1] : parts[0];
|
|
25
|
+
const parsed = parseInt(portStr, 10);
|
|
26
|
+
return !isNaN(parsed) && parsed > 0 && parsed <= 65535 ? parsed : undefined;
|
|
27
|
+
}
|
|
28
|
+
return undefined;
|
|
29
|
+
}
|
|
30
|
+
export function extractPublishedPorts(devcontainer) {
|
|
31
|
+
const ports = [];
|
|
32
|
+
const addPort = (val) => {
|
|
33
|
+
const port = extractPortNumber(val);
|
|
34
|
+
if (port !== undefined && !ports.includes(port)) {
|
|
35
|
+
ports.push(port);
|
|
36
|
+
}
|
|
37
|
+
};
|
|
38
|
+
const appPort = devcontainer.appPort;
|
|
39
|
+
if (Array.isArray(appPort)) {
|
|
40
|
+
for (const p of appPort)
|
|
41
|
+
addPort(p);
|
|
42
|
+
}
|
|
43
|
+
else if (appPort !== undefined) {
|
|
44
|
+
addPort(appPort);
|
|
45
|
+
}
|
|
46
|
+
const forwardPorts = devcontainer.forwardPorts;
|
|
47
|
+
if (Array.isArray(forwardPorts)) {
|
|
48
|
+
for (const p of forwardPorts)
|
|
49
|
+
addPort(p);
|
|
50
|
+
}
|
|
51
|
+
else if (forwardPorts !== undefined) {
|
|
52
|
+
addPort(forwardPorts);
|
|
53
|
+
}
|
|
54
|
+
return ports;
|
|
55
|
+
}
|
|
56
|
+
export function generateSshConfigSample(ports) {
|
|
57
|
+
const lines = [
|
|
58
|
+
"# 接続元端末の ~/.ssh/config 用設定サンプル",
|
|
59
|
+
"# <host> や <user> などのプレースホルダーは実際の接続先環境に合わせて変更してください。",
|
|
60
|
+
"",
|
|
61
|
+
"# 常時稼働ホストへの通常接続用",
|
|
62
|
+
"Host <host>",
|
|
63
|
+
" HostName <host>",
|
|
64
|
+
" User <user>",
|
|
65
|
+
"",
|
|
66
|
+
"# devcontainer 内の tmux セッションへ直接入る接続用",
|
|
67
|
+
"Host <host>-tmux",
|
|
68
|
+
" HostName <host>",
|
|
69
|
+
" User <user>",
|
|
70
|
+
" RequestTTY force",
|
|
71
|
+
" RemoteCommand ~/bin/specdojo-tmux.sh",
|
|
72
|
+
];
|
|
73
|
+
if (ports.length > 0) {
|
|
74
|
+
for (const port of ports) {
|
|
75
|
+
lines.push(` LocalForward ${port} 127.0.0.1:${port}`);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
else {
|
|
79
|
+
lines.push(" # devcontainer.json の公開ポート(appPort / forwardPorts)に合わせて LocalForward を追加してください。", " # 例: LocalForward 5173 127.0.0.1:5173");
|
|
80
|
+
}
|
|
81
|
+
lines.push("");
|
|
82
|
+
return lines.join("\n");
|
|
83
|
+
}
|
|
9
84
|
export async function runDevcontainerScaffold(opts) {
|
|
10
|
-
const { packageRoot, repoRoot, providers, editors, ollama, cron, tmux, force, dryRun } = opts;
|
|
85
|
+
const { packageRoot, repoRoot, workspaceName: workspaceNameOverride, providers, editors, ollama, cron, tmux, force, dryRun, } = opts;
|
|
11
86
|
const devcontainerDir = path.join(repoRoot, ".devcontainer");
|
|
87
|
+
const workspaceName = resolveWorkspaceName(repoRoot, workspaceNameOverride);
|
|
12
88
|
if (existsSync(devcontainerDir) && !force) {
|
|
13
89
|
if (dryRun) {
|
|
14
90
|
process.stdout.write(`[dry-run] skipped: .devcontainer/ already exists\n`);
|
|
@@ -26,6 +102,9 @@ export async function runDevcontainerScaffold(opts) {
|
|
|
26
102
|
const devcontainerJsonPath = path.join(templateDir, "devcontainer.json");
|
|
27
103
|
const baseJsonStr = await readFile(devcontainerJsonPath, "utf8");
|
|
28
104
|
const devcontainer = JSON.parse(baseJsonStr);
|
|
105
|
+
const workspaceRoot = `/workspaces/${workspaceName}`;
|
|
106
|
+
devcontainer.workspaceMount = `source=\${localWorkspaceFolder}/..,target=${workspaceRoot},type=bind,consistency=cached`;
|
|
107
|
+
devcontainer.workspaceFolder = `${workspaceRoot}/\${localWorkspaceFolderBasename}`;
|
|
29
108
|
const volumePrefix = repositoryVolumePrefix(repoRoot);
|
|
30
109
|
const volumeName = (name) => `${volumePrefix}-specdojo-${name}`;
|
|
31
110
|
devcontainer.mounts = devcontainer.mounts.map((mount) => mount.replace(/^source=specdojo-/, `source=${volumePrefix}-specdojo-`));
|
|
@@ -139,12 +218,18 @@ fi`);
|
|
|
139
218
|
if (extraScripts.length > 0) {
|
|
140
219
|
postCreateScript = postCreateScript.replace("npm install", extraScripts.join("\n\n") + "\n\nnpm install");
|
|
141
220
|
}
|
|
221
|
+
const specdojoTmuxTemplatePath = path.join(templateDir, "remote-host", "specdojo-tmux.sh.sample");
|
|
222
|
+
const specdojoTmuxScript = await readFile(specdojoTmuxTemplatePath, "utf8");
|
|
223
|
+
const publishedPorts = extractPublishedPorts(devcontainer);
|
|
224
|
+
const sshConfigScript = generateSshConfigSample(publishedPorts);
|
|
142
225
|
if (dryRun) {
|
|
143
226
|
process.stdout.write(`[dry-run] would write: .devcontainer/devcontainer.json\n`);
|
|
144
227
|
process.stdout.write(`[dry-run] would write: .devcontainer/post-create.sh\n`);
|
|
145
228
|
if (emacsInitTemplate !== undefined) {
|
|
146
229
|
process.stdout.write(`[dry-run] would write: .devcontainer/emacs/init.el\n`);
|
|
147
230
|
}
|
|
231
|
+
process.stdout.write(`[dry-run] would write: .devcontainer/remote-host/specdojo-tmux.sh.sample\n`);
|
|
232
|
+
process.stdout.write(`[dry-run] would write: .devcontainer/remote-host/ssh-config.sample\n`);
|
|
148
233
|
return;
|
|
149
234
|
}
|
|
150
235
|
await mkdir(devcontainerDir, { recursive: true });
|
|
@@ -154,12 +239,19 @@ fi`);
|
|
|
154
239
|
await mkdir(path.join(devcontainerDir, "emacs"), { recursive: true });
|
|
155
240
|
await writeFile(path.join(devcontainerDir, "emacs", "init.el"), emacsInitTemplate, "utf8");
|
|
156
241
|
}
|
|
242
|
+
const remoteHostDir = path.join(devcontainerDir, "remote-host");
|
|
243
|
+
await mkdir(remoteHostDir, { recursive: true });
|
|
244
|
+
await writeFile(path.join(remoteHostDir, "specdojo-tmux.sh.sample"), specdojoTmuxScript, "utf8");
|
|
245
|
+
await writeFile(path.join(remoteHostDir, "ssh-config.sample"), sshConfigScript, "utf8");
|
|
157
246
|
process.stdout.write(`Written: .devcontainer/devcontainer.json\n`);
|
|
158
247
|
process.stdout.write(`Written: .devcontainer/post-create.sh\n`);
|
|
159
248
|
if (emacsInitTemplate !== undefined) {
|
|
160
249
|
process.stdout.write(`Written: .devcontainer/emacs/init.el\n`);
|
|
161
250
|
}
|
|
251
|
+
process.stdout.write(`Written: .devcontainer/remote-host/specdojo-tmux.sh.sample\n`);
|
|
252
|
+
process.stdout.write(`Written: .devcontainer/remote-host/ssh-config.sample\n`);
|
|
162
253
|
process.stdout.write("Next steps:\n" +
|
|
163
254
|
" 1. Commit the scaffolded files.\n" +
|
|
164
|
-
" 2. Open this directory in a Dev Container (VS Code or compatible editor).\n"
|
|
255
|
+
" 2. Open this directory in a Dev Container (VS Code or compatible editor).\n" +
|
|
256
|
+
" 3. Remote host: copy .devcontainer/remote-host/specdojo-tmux.sh.sample to the host (e.g. ~/bin/) and merge ssh-config.sample into ~/.ssh/config on your client.\n");
|
|
165
257
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { dirname, join, relative, resolve } from "node:path";
|
|
3
|
-
import { load } from "
|
|
3
|
+
import { load } from "../shared/yaml.js";
|
|
4
4
|
import { readSpecdojoNamespace } from "./frontmatter-namespace.js";
|
|
5
5
|
import { specdojoDirectoryPaths, specdojoReferencePath, } from "./template-resolution.js";
|
|
6
6
|
const SKIP_DIRS = new Set(["node_modules", "dist", ".vitepress", "out"]);
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
//
|
|
5
5
|
// 対象は Markdown frontmatter のみ。独立 YAML データファイル(dct-*.yaml / pm-*.yaml /
|
|
6
6
|
// sch-*.yaml など)は名前空間化しないため、本モジュールは使わない。
|
|
7
|
-
import { load } from "
|
|
7
|
+
import { load } from "../shared/yaml.js";
|
|
8
8
|
const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
|
|
9
9
|
function specdojoFromBlock(block) {
|
|
10
10
|
let parsed;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { existsSync, readFileSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { resolve } from "node:path";
|
|
3
|
-
import { loadEnv, specdojoRootDir } from "
|
|
3
|
+
import { loadEnv, specdojoRootDir } from "../shared/specdojo-config.js";
|
|
4
4
|
import { assertControlGeneratedIndexes, buildDocIndex, lookupDocIndex, replaceDocIndexRefs, } from "./doc-index.js";
|
|
5
5
|
function printCommandError(error) {
|
|
6
6
|
const message = error instanceof Error ? error.message : String(error);
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export * from "../shared/template-resolution.js";
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { readdirSync, readFileSync } from "node:fs";
|
|
2
2
|
import path from "node:path";
|
|
3
3
|
import { fileURLToPath } from "node:url";
|
|
4
|
-
import { load } from "
|
|
4
|
+
import { load } from "../shared/yaml.js";
|
|
5
5
|
// PJR-H220 / PJR-VJP8: 観点の document_kinds は rulebook ID の列挙で宣言する。rulebook を
|
|
6
6
|
// 追加したときに観点ごとの扱いの判断が漏れないよう、include / exclude / confirmed_default の
|
|
7
7
|
// どれにも載っていない rulebook を一覧にする。confirmed_default は判断の記録であり、適用判定
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { resolve } from "node:path";
|
|
2
|
-
import { loadEnv, specdojoRootDir } from "
|
|
2
|
+
import { loadEnv, specdojoRootDir } from "../shared/specdojo-config.js";
|
|
3
3
|
import { buildYamlPages } from "./yaml-pages.js";
|
|
4
4
|
function printCommandError(error) {
|
|
5
5
|
const message = error instanceof Error ? error.message : String(error);
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { dirname, join, posix } from "node:path";
|
|
3
|
-
import { dump, load } from "
|
|
3
|
+
import { dump, load } from "../shared/yaml.js";
|
|
4
4
|
import { collectDocIndexEntries } from "./doc-index.js";
|
|
5
|
-
import { isDctTemplateCatalog, renderCatalogTemplateBody } from "
|
|
5
|
+
import { isDctTemplateCatalog, renderCatalogTemplateBody } from "../shared/catalog-render.js";
|
|
6
6
|
// YAML は VitePress のページにならないため、doc-index に載っている YAML ごとに
|
|
7
7
|
// 同階層の generated/<name>.md へ表示用ページ(本文を yaml コードブロックで埋め込んだ
|
|
8
8
|
// Markdown)を生成する。wikilink・frontmatter リンクはこのページへ解決される。
|