specdojo 0.2.1 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (242) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +298 -0
  3. package/README.md +92 -42
  4. package/dist/agent-response.js +20 -0
  5. package/dist/agent.js +4 -4
  6. package/dist/build-command.js +28 -8
  7. package/dist/catalog-build-references.js +144 -0
  8. package/dist/catalog-build-render.js +144 -0
  9. package/dist/catalog-build.js +13 -290
  10. package/dist/catalog-generate.js +6 -9
  11. package/dist/catalog-plan-generate.js +2 -2
  12. package/dist/catalog-plan.js +6 -6
  13. package/dist/catalog-scaffold.js +4 -4
  14. package/dist/catalog.js +2 -2
  15. package/dist/dashboard-exec-records.js +105 -0
  16. package/dist/dashboard-routines.js +255 -0
  17. package/dist/dashboard-shared.js +14 -0
  18. package/dist/dashboard-timeline.js +175 -0
  19. package/dist/dashboard.js +31 -444
  20. package/dist/deliverable-trash.js +3 -3
  21. package/dist/devcontainer-command.js +43 -0
  22. package/dist/devcontainer-scaffold.js +165 -0
  23. package/dist/doc-index.js +3 -3
  24. package/dist/exec-agent-config.js +107 -9
  25. package/dist/exec-agent-git-state.js +18 -0
  26. package/dist/exec-agent-protected-config.js +46 -8
  27. package/dist/exec-commands.js +557 -0
  28. package/dist/exec-core.js +457 -0
  29. package/dist/exec-evidence.js +254 -11
  30. package/dist/exec-handoff.js +336 -0
  31. package/dist/exec-parent-validation.js +317 -43
  32. package/dist/exec-pipeline-state.js +74 -9
  33. package/dist/exec-plans-core.js +693 -0
  34. package/dist/exec-plans-generation.js +206 -0
  35. package/dist/exec-plans-storage.js +131 -0
  36. package/dist/exec-plans.js +3 -1016
  37. package/dist/exec-protection-handoff.js +43 -2
  38. package/dist/exec-provider-scaffold.js +247 -15
  39. package/dist/exec-register-resume.js +65 -19
  40. package/dist/exec-register.js +9 -3
  41. package/dist/exec-repo-integration-git.js +23 -0
  42. package/dist/exec-repo-integration-sync.js +264 -0
  43. package/dist/exec-repo-integration.js +534 -0
  44. package/dist/exec-repo-trace.js +182 -0
  45. package/dist/exec-reporter-output.js +206 -0
  46. package/dist/exec-reporter.js +525 -248
  47. package/dist/exec-results.js +103 -71
  48. package/dist/exec-run-agent-pipeline.js +256 -0
  49. package/dist/exec-run-agent.js +531 -0
  50. package/dist/exec-run-in-place.js +541 -0
  51. package/dist/exec-run-job.js +717 -0
  52. package/dist/exec-run-lifecycle-commands.js +522 -0
  53. package/dist/exec-run-lock.js +110 -107
  54. package/dist/exec-run-mode-shared.js +140 -0
  55. package/dist/exec-run-register-command.js +244 -0
  56. package/dist/exec-run-register-core.js +386 -0
  57. package/dist/exec-run-register-mode.js +206 -0
  58. package/dist/exec-run-register-resume.js +393 -0
  59. package/dist/exec-run-register-state.js +322 -0
  60. package/dist/exec-run-register-worktree.js +509 -0
  61. package/dist/exec-run-schedule-mode.js +294 -0
  62. package/dist/exec-run-schedule-prepare.js +353 -0
  63. package/dist/exec-run-schedule-task.js +572 -0
  64. package/dist/exec-run-shared.js +399 -0
  65. package/dist/exec-run.js +11 -4953
  66. package/dist/exec-shared.js +9 -2
  67. package/dist/exec-slot-lock.js +242 -0
  68. package/dist/exec-task-repos.js +415 -0
  69. package/dist/exec-trial-commands.js +558 -0
  70. package/dist/exec-trial-core.js +371 -0
  71. package/dist/exec-trial.js +2 -895
  72. package/dist/exec-worktree-command.js +87 -43
  73. package/dist/exec-worktree-ops-commit.js +707 -0
  74. package/dist/exec-worktree-ops-lifecycle.js +292 -0
  75. package/dist/exec-worktree-ops-merge.js +303 -0
  76. package/dist/exec-worktree-ops.js +3 -847
  77. package/dist/exec-worktree.js +146 -31
  78. package/dist/exec.js +2 -999
  79. package/dist/frontmatter-namespace.js +2 -2
  80. package/dist/grade-apply.js +734 -0
  81. package/dist/grade-command-apply.js +250 -0
  82. package/dist/grade-command-inspect.js +138 -0
  83. package/dist/grade-command-plan.js +101 -0
  84. package/dist/grade-command-shared.js +68 -0
  85. package/dist/grade-core.js +307 -0
  86. package/dist/grade-markdown.js +274 -0
  87. package/dist/grade-pipeline-state.js +184 -0
  88. package/dist/grade-plan.js +507 -0
  89. package/dist/grade-result.js +133 -5
  90. package/dist/grade-target-discovery.js +265 -0
  91. package/dist/grade-targets.js +432 -0
  92. package/dist/grade.js +14 -2451
  93. package/dist/init-command.js +443 -0
  94. package/dist/job-definition.js +670 -0
  95. package/dist/job.js +64 -578
  96. package/dist/kata-command.js +2 -2
  97. package/dist/orchestrator.js +213 -0
  98. package/dist/register-command-types.js +1 -0
  99. package/dist/register-core.js +363 -0
  100. package/dist/register-create-commands.js +245 -0
  101. package/dist/register-event-merge.js +169 -0
  102. package/dist/register-events.js +4 -4
  103. package/dist/register-item.js +13 -7
  104. package/dist/register-maintenance-commands.js +187 -0
  105. package/dist/register-migration.js +268 -0
  106. package/dist/register-renumber.js +314 -0
  107. package/dist/register-transition-commands.js +248 -0
  108. package/dist/register-update.js +230 -0
  109. package/dist/register-views.js +256 -0
  110. package/dist/register.js +175 -1975
  111. package/dist/review-grade.js +252 -0
  112. package/dist/review-plan.js +114 -4
  113. package/dist/review-types.js +40 -1
  114. package/dist/routine-definition.js +401 -0
  115. package/dist/routine.js +73 -402
  116. package/dist/schedule-approach.js +2 -2
  117. package/dist/schedule-build.js +2 -2
  118. package/dist/schedule-strategy-generate-document.js +273 -0
  119. package/dist/schedule-strategy-generate-scope.js +199 -0
  120. package/dist/schedule-strategy-generate.js +9 -473
  121. package/dist/schedule.js +19 -6
  122. package/dist/specdojo-config.js +465 -20
  123. package/dist/specdojo-gitignore.js +135 -0
  124. package/dist/specdojo.js +6 -0
  125. package/dist/viewpoint-document-kinds-check.js +128 -0
  126. package/dist/yaml-pages.js +4 -4
  127. package/dist/yaml.js +28 -0
  128. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  129. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  130. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  131. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  132. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  133. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  134. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  135. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  136. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  137. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  138. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  139. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  140. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  141. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  142. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  143. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  144. package/docs/ja/specdojo/guides/exec-config-guide.md +93 -49
  145. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  146. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  147. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  148. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +45 -22
  149. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  150. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  151. package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
  152. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  153. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  154. package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
  155. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  156. package/docs/ja/specdojo/guides/routine-operation-guide.md +75 -10
  157. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  158. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  159. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  160. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  161. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  162. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  163. package/docs/ja/specdojo/index.md +2 -2
  164. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  165. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  166. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  167. package/docs/ja/specdojo/references/command-reference.md +335 -92
  168. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  169. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  170. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  171. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  172. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  173. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  174. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  175. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  176. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  177. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  178. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  179. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  180. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  181. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  182. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  183. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  184. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  185. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  186. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  187. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  188. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  189. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  190. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  191. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  192. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  193. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  194. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  195. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  196. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  197. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  198. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  199. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  200. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  201. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  202. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  203. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  204. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  205. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  206. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  207. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  208. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  209. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  210. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  211. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  212. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  213. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  214. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  215. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  216. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  217. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  218. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  219. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  220. package/package.json +17 -12
  221. package/templates/antigravity/README.md +29 -4
  222. package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
  223. package/templates/antigravity/exec-defaults-snippet.yaml +10 -7
  224. package/templates/antigravity/orchestrator.md +18 -7
  225. package/templates/antigravity/settings.global.json +55 -0
  226. package/templates/claude/agents/claude-executor.md +14 -0
  227. package/templates/claude/agents/claude-reporter.md +16 -0
  228. package/templates/claude/agents/specdojo-orchestrator.md +18 -7
  229. package/templates/claude/settings.edit.json +27 -1
  230. package/templates/codex/README.md +5 -4
  231. package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
  232. package/templates/codex/orchestrator.md +18 -7
  233. package/templates/copilot/README.md +7 -5
  234. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  235. package/templates/devcontainer/devcontainer.json +27 -0
  236. package/templates/devcontainer/emacs/init.el +88 -0
  237. package/templates/devcontainer/post-create.sh +62 -0
  238. package/templates/init-agent-members.yaml +200 -0
  239. package/templates/init-exec-defaults.yaml +74 -0
  240. package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
  241. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  242. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
@@ -0,0 +1,187 @@
1
+ import { existsSync, writeFileSync } from "node:fs";
2
+ import { collectRegisterHistoryEvents, formatRegisterHistoryEvents } from "./register-history.js";
3
+ import { createGitTimestampResolver, planRegisterTimestampMigration, summarizeTimestampMigration, } from "./register-migrate-timestamps.js";
4
+ import { registerEventFilePath, validateRegisterEventDocs } from "./register-events.js";
5
+ import { validateRegisterItemDocs } from "./register-item.js";
6
+ import { specdojoRootDir } from "./specdojo-config.js";
7
+ export function registerMaintenanceCommands(reg, dependencies) {
8
+ const { addProjectOption, addRegisterCommitOptions, applyRegisterMigrationPlan, generateDerivedViewFiles, loadItemForUpdate, migrateEmbeddedRegisterEvents, migrateRegisterEventsFromGit, parseHistoryIds, planRegisterMigration, planRenumber, printCommandError, registerEventActor, renumberPjrItem, repoRelativePathspec, resolveRegisterPaths, runRegisterMutation, validBuildScopes, writeDerivedViews, } = dependencies;
9
+ // --- migrate ---
10
+ const migrateCmd = reg
11
+ .command("migrate")
12
+ .description("Migrate legacy register data (index rows, dates, and embedded register events)");
13
+ addProjectOption(migrateCmd);
14
+ migrateCmd.option("--dry-run", "Validate and print the migration summary without writing", false);
15
+ migrateCmd.action((opts) => {
16
+ try {
17
+ const paths = resolveRegisterPaths(opts);
18
+ const plan = planRegisterMigration(paths);
19
+ const summary = `items=${plan.sourceCount}, create=${plan.createdCount}, update=${plan.updatedCount}, ` +
20
+ `unchanged=${plan.unchangedCount}`;
21
+ if (opts.dryRun) {
22
+ process.stdout.write(`Would migrate register items: ${summary}\n`);
23
+ if (plan.sourceIndexPath) {
24
+ process.stdout.write(`Would remove legacy index: ${plan.sourceIndexPath}\n`);
25
+ }
26
+ }
27
+ else {
28
+ applyRegisterMigrationPlan(plan);
29
+ process.stdout.write(`Migrated register items: ${summary}\n`);
30
+ if (plan.sourceIndexPath) {
31
+ process.stdout.write(`Removed legacy index: ${plan.sourceIndexPath}\n`);
32
+ }
33
+ }
34
+ const timestampPlan = planRegisterTimestampMigration({
35
+ projectRegisterPath: paths.projectRegisterPath,
36
+ timeZone: paths.registerDateTimeZone,
37
+ resolveGitTimestamps: createGitTimestampResolver(specdojoRootDir()),
38
+ });
39
+ const timestampSummary = summarizeTimestampMigration(timestampPlan);
40
+ if (opts.dryRun) {
41
+ const embeddedMigration = migrateEmbeddedRegisterEvents(paths, true);
42
+ const eventMigration = migrateRegisterEventsFromGit(paths, true);
43
+ const eventSummary = eventMigration.available
44
+ ? `items=${eventMigration.items}, events=${eventMigration.events}, skipped=${eventMigration.skipped}`
45
+ : "unavailable (Git history not found; legacy fallback remains active)";
46
+ process.stdout.write(`Would migrate register timestamps: ${timestampSummary}\n`);
47
+ process.stdout.write(`Would separate embedded register events: items=${embeddedMigration.items}, events=${embeddedMigration.events}\n`);
48
+ process.stdout.write(`Would migrate register events: ${eventSummary}\n`);
49
+ return;
50
+ }
51
+ for (const file of timestampPlan.files) {
52
+ writeFileSync(file.path, file.content, "utf8");
53
+ }
54
+ process.stdout.write(`Migrated register timestamps: ${timestampSummary}\n`);
55
+ const embeddedMigration = migrateEmbeddedRegisterEvents(paths, false);
56
+ process.stdout.write(`Separated embedded register events: items=${embeddedMigration.items}, events=${embeddedMigration.events}\n`);
57
+ const eventMigration = migrateRegisterEventsFromGit(paths, false);
58
+ const eventSummary = eventMigration.available
59
+ ? `items=${eventMigration.items}, events=${eventMigration.events}, skipped=${eventMigration.skipped}`
60
+ : "unavailable (Git history not found; legacy fallback remains active)";
61
+ process.stdout.write(`Migrated register events: ${eventSummary}\n`);
62
+ for (const view of writeDerivedViews(paths, "all")) {
63
+ process.stdout.write(`Generated: ${view.path}\n`);
64
+ }
65
+ }
66
+ catch (error) {
67
+ printCommandError(error);
68
+ }
69
+ });
70
+ // --- build ---
71
+ const buildCmd = reg
72
+ .command("build")
73
+ .description("Generate the register list and derived views from register item files");
74
+ addProjectOption(buildCmd);
75
+ buildCmd.option("--scope <scope>", "Generation scope: register | controls | all", "all");
76
+ buildCmd.option("--dry-run", "Print generated content without writing", false);
77
+ buildCmd.action((opts) => {
78
+ try {
79
+ const paths = resolveRegisterPaths(opts);
80
+ if (!existsSync(paths.projectRegisterPath)) {
81
+ throw new Error(`Project register directory not found: ${paths.projectRegisterPath}\n` +
82
+ `Run: specdojo register scaffold --project ${opts.project || paths.projectId}`);
83
+ }
84
+ const scope = opts.scope;
85
+ if (!validBuildScopes.includes(scope)) {
86
+ throw new Error(`Invalid scope: "${opts.scope}". Must be one of: ${validBuildScopes.join(", ")}`);
87
+ }
88
+ const validation = validateRegisterItemDocs(paths.projectRegisterPath);
89
+ const eventErrors = validateRegisterEventDocs(paths.projectRegisterPath, paths.registerDateTimeZone);
90
+ if (validation.errors.length > 0 || eventErrors.length > 0) {
91
+ throw new Error(`Invalid register item files:\n${[...validation.errors, ...eventErrors].join("\n")}`);
92
+ }
93
+ const views = generateDerivedViewFiles(paths, scope);
94
+ if (opts.dryRun) {
95
+ for (const view of views) {
96
+ process.stdout.write(`=== ${view.path} ===\n${view.content}\n\n`);
97
+ }
98
+ return;
99
+ }
100
+ for (const view of writeDerivedViews(paths, scope)) {
101
+ process.stdout.write(`Generated: ${view.path}\n`);
102
+ }
103
+ }
104
+ catch (error) {
105
+ printCommandError(error);
106
+ }
107
+ });
108
+ // --- history ---
109
+ const historyCmd = reg
110
+ .command("history")
111
+ .description("Show register item changes from append-only events and legacy Git history");
112
+ addProjectOption(historyCmd);
113
+ historyCmd.option("--since <date>", "Include commits on or after this date (YYYY-MM-DD)");
114
+ historyCmd.option("--until <date>", "Include commits on or before this date (YYYY-MM-DD)");
115
+ historyCmd.option("--id <id...>", "Limit output to these item IDs (PJR-XXXX; space/comma separated)");
116
+ historyCmd.option("--status-only", "Show only additions, removals, and status transitions", false);
117
+ historyCmd.option("--limit <count>", "Maximum number of commits to inspect");
118
+ historyCmd.option("--json", "Print events as JSON", false);
119
+ historyCmd.action((opts) => {
120
+ try {
121
+ const paths = resolveRegisterPaths(opts);
122
+ const ids = parseHistoryIds(opts.id);
123
+ const limit = opts.limit === undefined ? undefined : Number(opts.limit);
124
+ const events = collectRegisterHistoryEvents({
125
+ repoRoot: specdojoRootDir(),
126
+ registerPathspec: repoRelativePathspec(specdojoRootDir(), paths.projectRegisterPath),
127
+ since: opts.since?.trim() || undefined,
128
+ until: opts.until?.trim() || undefined,
129
+ limit,
130
+ ids,
131
+ statusOnly: Boolean(opts.statusOnly),
132
+ timeZone: paths.registerDateTimeZone,
133
+ });
134
+ if (opts.json) {
135
+ process.stdout.write(`${JSON.stringify(events, null, 2)}\n`);
136
+ return;
137
+ }
138
+ if (events.length === 0) {
139
+ process.stdout.write("No register item changes found for the given range.\n");
140
+ return;
141
+ }
142
+ process.stdout.write(`${formatRegisterHistoryEvents(events)}\n`);
143
+ const itemCount = new Set(events.map((event) => event.id)).size;
144
+ const gitCommitCount = new Set(events.filter((event) => event.source !== "event").map((event) => event.commit)).size;
145
+ const storedEventCount = events.filter((event) => event.source === "event").length;
146
+ process.stdout.write(`events=${events.length} items=${itemCount} stored=${storedEventCount} legacy_commits=${gitCommitCount}\n`);
147
+ }
148
+ catch (error) {
149
+ printCommandError(error);
150
+ }
151
+ });
152
+ // --- renumber ---
153
+ const renumberCmd = reg
154
+ .command("renumber")
155
+ .description("Resolve a random PJR-ID collision by moving one item to an unused ID");
156
+ addProjectOption(renumberCmd);
157
+ renumberCmd.requiredOption("--id <id>", "Current item ID (PJR-XXXX)");
158
+ renumberCmd.requiredOption("--to <id>", "Target unused ID (PJR-XXXX)");
159
+ renumberCmd.option("--by <actor>", "Actor recorded in the append-only register event");
160
+ renumberCmd.option("--reason <text>", "Reason recorded in the append-only register event");
161
+ renumberCmd.option("--dry-run", "Print planned changes without writing", false);
162
+ addRegisterCommitOptions(renumberCmd);
163
+ renumberCmd.action(async (opts) => {
164
+ await runRegisterMutation("renumber", opts, (context) => {
165
+ const { paths } = context;
166
+ const source = loadItemForUpdate(paths, opts.id);
167
+ const renumberPlan = planRenumber(paths, opts.id, opts.to);
168
+ context.assertCommitTargetsClean([
169
+ ...(renumberPlan.ticketRename
170
+ ? [renumberPlan.ticketRename.from, renumberPlan.ticketRename.to]
171
+ : []),
172
+ ...renumberPlan.writes.map((write) => write.path),
173
+ registerEventFilePath(paths.projectRegisterPath, opts.id),
174
+ registerEventFilePath(paths.projectRegisterPath, opts.to),
175
+ ]);
176
+ renumberPjrItem({
177
+ paths,
178
+ fromId: opts.id,
179
+ toId: opts.to,
180
+ dryRun: opts.dryRun,
181
+ actor: registerEventActor(opts),
182
+ reason: opts.reason,
183
+ });
184
+ return { id: opts.to, title: source.item.title };
185
+ });
186
+ });
187
+ }
@@ -0,0 +1,268 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { existsSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
3
+ import { basename, dirname, join } from "node:path";
4
+ import { buildRegisterItemContent, locateRegisterTable, parsePjrIndex, slugify, validateFields, } from "./register-core.js";
5
+ import { applyRegisterItemFields, loadRegisterItemDocs, prependRegisterItemDescription, readRegisterItemContent, registerItemFieldsFromItem, setRegisterItemTitle, } from "./register-item.js";
6
+ import { resolveSpecdojoTemplatePath } from "./template-resolution.js";
7
+ import { loadRegisterItems } from "./register-views.js";
8
+ const REGISTER_ITEM_VALUE_KEYS = [
9
+ "id",
10
+ "status",
11
+ "title",
12
+ "description",
13
+ "type",
14
+ "priority",
15
+ "owner",
16
+ "registeredAt",
17
+ "due",
18
+ "completedAt",
19
+ "conclusion",
20
+ ];
21
+ // pjr-index の表セルだけで必要だった pipe のエスケープを本文へ持ち込まない。
22
+ function tableCellToBody(value) {
23
+ return value.replace(/\\\|/g, "|");
24
+ }
25
+ function migrationTopic(title) {
26
+ return slugify(tableCellToBody(title)).slice(0, 64).replace(/-+$/g, "") || "item";
27
+ }
28
+ function assertMigratedItemMatches(source, content, filename) {
29
+ const migrated = readRegisterItemContent(content, filename)?.item;
30
+ if (!migrated) {
31
+ throw new Error(`Failed to read planned register item: ${filename}`);
32
+ }
33
+ const mismatches = REGISTER_ITEM_VALUE_KEYS.filter((key) => migrated[key] !== source[key]);
34
+ if (mismatches.length > 0) {
35
+ const detail = mismatches
36
+ .map((key) => `${key}: ${JSON.stringify(source[key])} -> ${JSON.stringify(migrated[key])}`)
37
+ .join(", ");
38
+ throw new Error(`Migration verification failed for ${source.id}: ${detail}`);
39
+ }
40
+ }
41
+ // 追跡対象の旧 pjr-index と、すでに frontmatter 正本へ移った個票を統合して移行計画を作る。
42
+ // この段階では書き込みを行わず、全件の変換結果が元の項目値と一致してから計画を返す。
43
+ export function planRegisterMigration(paths) {
44
+ const docs = loadRegisterItemDocs(paths.projectRegisterPath);
45
+ const duplicateDocIds = docs
46
+ .map((doc) => doc.id)
47
+ .filter((id, index, ids) => ids.indexOf(id) !== index);
48
+ if (duplicateDocIds.length > 0) {
49
+ throw new Error(`Duplicate register item ticket IDs: ${[...new Set(duplicateDocIds)].join(", ")}`);
50
+ }
51
+ if (!existsSync(paths.pjrIndexPath)) {
52
+ const notMigrated = docs.filter((doc) => !doc.hasRegisterFields);
53
+ if (notMigrated.length > 0) {
54
+ throw new Error(`Legacy pjr-index.md is missing, but ${notMigrated.length} ticket(s) have no register item fields: ` +
55
+ notMigrated.map((doc) => doc.id).join(", "));
56
+ }
57
+ return {
58
+ sourceCount: docs.length,
59
+ createdCount: 0,
60
+ updatedCount: 0,
61
+ unchangedCount: docs.length,
62
+ files: [],
63
+ };
64
+ }
65
+ const sourceIndexContent = readFileSync(paths.pjrIndexPath, "utf8");
66
+ const timeZone = paths.registerDateTimeZone;
67
+ // 旧構成の pjr-index.md が一覧テーブルを持たない参照案内だった場合もある。
68
+ // その案内ページは、旧一覧が存在しない場合と同じ no-op として扱う。
69
+ if (!locateRegisterTable(sourceIndexContent.split("\n"))) {
70
+ const notMigrated = docs.filter((doc) => !doc.hasRegisterFields);
71
+ if (notMigrated.length > 0) {
72
+ throw new Error(`Legacy pjr-index table is missing, but ${notMigrated.length} ticket(s) have no register item fields: ` +
73
+ notMigrated.map((doc) => doc.id).join(", "));
74
+ }
75
+ return {
76
+ sourceCount: docs.length,
77
+ createdCount: 0,
78
+ updatedCount: 0,
79
+ unchangedCount: docs.length,
80
+ files: [],
81
+ };
82
+ }
83
+ const indexItems = parsePjrIndex(sourceIndexContent, timeZone);
84
+ const duplicateIndexIds = indexItems
85
+ .map((item) => item.id)
86
+ .filter((id, index, ids) => ids.indexOf(id) !== index);
87
+ if (duplicateIndexIds.length > 0) {
88
+ throw new Error(`Duplicate pjr-index IDs: ${[...new Set(duplicateIndexIds)].join(", ")}`);
89
+ }
90
+ // loadRegisterItems は移行済み個票を優先し、未移行項目だけ旧一覧を読む。これにより、
91
+ // runner がすでに遷移させた item_status を古い一覧行で巻き戻さない。
92
+ const sources = loadRegisterItems(paths);
93
+ if (sources.length !== indexItems.length) {
94
+ throw new Error(`Register item count mismatch before migration: index=${indexItems.length}, resolved=${sources.length}`);
95
+ }
96
+ const docsById = new Map(docs.map((doc) => [doc.id, doc]));
97
+ const files = [];
98
+ let createdCount = 0;
99
+ let updatedCount = 0;
100
+ let unchangedCount = 0;
101
+ for (const source of sources) {
102
+ validateFields({
103
+ type: source.item.type,
104
+ priority: source.item.priority,
105
+ status: source.item.status,
106
+ registeredAt: source.item.registeredAt,
107
+ due: source.item.due,
108
+ completedAt: source.item.completedAt,
109
+ });
110
+ const existing = docsById.get(source.id);
111
+ let filename;
112
+ let path;
113
+ let originalContent;
114
+ let content;
115
+ if (existing) {
116
+ filename = existing.filename;
117
+ path = existing.path;
118
+ originalContent = readFileSync(path, "utf8");
119
+ content = originalContent;
120
+ if (source.source === "index") {
121
+ if (existing.item.title !== source.item.title) {
122
+ content = setRegisterItemTitle(content, tableCellToBody(source.item.title));
123
+ }
124
+ if (existing.item.description !== source.item.description) {
125
+ content = prependRegisterItemDescription(content, tableCellToBody(source.item.description));
126
+ }
127
+ content = applyRegisterItemFields(content, registerItemFieldsFromItem(source.item));
128
+ }
129
+ }
130
+ else {
131
+ const topic = migrationTopic(source.item.title);
132
+ filename = `pjr-${source.id.slice("PJR-".length).toLowerCase()}-${topic}.md`;
133
+ path = join(paths.projectRegisterPath, filename);
134
+ if (existsSync(path)) {
135
+ throw new Error(`Migration target already exists: ${path}`);
136
+ }
137
+ const templatePath = resolveSpecdojoTemplatePath(`pjr-${source.item.type}-template.md`);
138
+ content = buildRegisterItemContent({
139
+ projectId: paths.projectId,
140
+ displayId: source.item.id,
141
+ topic,
142
+ fields: {
143
+ type: source.item.type,
144
+ title: tableCellToBody(source.item.title),
145
+ description: tableCellToBody(source.item.description),
146
+ priority: source.item.priority,
147
+ status: source.item.status,
148
+ owner: source.item.owner,
149
+ registeredAt: source.item.registeredAt,
150
+ due: source.item.due,
151
+ completedAt: source.item.completedAt,
152
+ conclusion: source.item.conclusion,
153
+ },
154
+ templatePath,
155
+ });
156
+ // 旧一覧のセルでは問題にならなかった `_CAPITAL_CASE_` などを本文へ移すと、
157
+ // markdownlint が underscore emphasis と解釈する。表示値を変えずに規則だけ抑止する。
158
+ if (/_[A-Z][A-Z0-9_]*_/.test(`${source.item.title}\n${source.item.description}`)) {
159
+ content = content.replace(/^(---\r?\n[\s\S]*?\r?\n---\r?\n)/, "$1\n<!-- markdownlint-disable MD049 -->\n");
160
+ }
161
+ }
162
+ assertMigratedItemMatches(source.item, content, filename);
163
+ if (content === originalContent) {
164
+ unchangedCount++;
165
+ }
166
+ else {
167
+ files.push({ path, content, originalContent });
168
+ if (originalContent === undefined)
169
+ createdCount++;
170
+ else
171
+ updatedCount++;
172
+ }
173
+ }
174
+ return {
175
+ sourceCount: sources.length,
176
+ createdCount,
177
+ updatedCount,
178
+ unchangedCount,
179
+ files,
180
+ sourceIndexPath: paths.pjrIndexPath,
181
+ sourceIndexContent,
182
+ };
183
+ }
184
+ // 全出力を同一ディレクトリ内の一時ファイルへ書いてから切り替える。切り替え途中で失敗した
185
+ // 場合は既存ファイルと旧一覧を戻し、作成途中の個票を除去して部分適用を残さない。
186
+ export function applyRegisterMigrationPlan(plan) {
187
+ if (plan.files.length === 0 && !plan.sourceIndexPath)
188
+ return;
189
+ if (plan.sourceIndexPath) {
190
+ if (!existsSync(plan.sourceIndexPath)) {
191
+ throw new Error(`Migration source changed after planning: missing ${plan.sourceIndexPath}`);
192
+ }
193
+ if (readFileSync(plan.sourceIndexPath, "utf8") !== plan.sourceIndexContent) {
194
+ throw new Error(`Migration source changed after planning: ${plan.sourceIndexPath}`);
195
+ }
196
+ }
197
+ for (const file of plan.files) {
198
+ if (file.originalContent === undefined) {
199
+ if (existsSync(file.path)) {
200
+ throw new Error(`Migration target appeared after planning: ${file.path}`);
201
+ }
202
+ }
203
+ else if (!existsSync(file.path) || readFileSync(file.path, "utf8") !== file.originalContent) {
204
+ throw new Error(`Migration target changed after planning: ${file.path}`);
205
+ }
206
+ }
207
+ const transactionId = randomUUID();
208
+ const staged = [];
209
+ let indexBackupPath;
210
+ try {
211
+ for (const file of plan.files) {
212
+ const stagedPath = join(dirname(file.path), `.specdojo-migrate-${transactionId}-${basename(file.path)}`);
213
+ staged.push({ ...file, stagedPath });
214
+ writeFileSync(stagedPath, file.content, { encoding: "utf8", flag: "wx" });
215
+ }
216
+ for (const file of staged) {
217
+ if (file.originalContent !== undefined) {
218
+ file.backupPath = `${file.stagedPath}.backup`;
219
+ renameSync(file.path, file.backupPath);
220
+ }
221
+ renameSync(file.stagedPath, file.path);
222
+ }
223
+ if (plan.sourceIndexPath) {
224
+ indexBackupPath = join(dirname(plan.sourceIndexPath), `.specdojo-migrate-${transactionId}-${basename(plan.sourceIndexPath)}.backup`);
225
+ renameSync(plan.sourceIndexPath, indexBackupPath);
226
+ }
227
+ }
228
+ catch (error) {
229
+ if (indexBackupPath && existsSync(indexBackupPath) && plan.sourceIndexPath) {
230
+ if (existsSync(plan.sourceIndexPath))
231
+ unlinkSync(plan.sourceIndexPath);
232
+ renameSync(indexBackupPath, plan.sourceIndexPath);
233
+ }
234
+ for (const file of [...staged].reverse()) {
235
+ if (existsSync(file.stagedPath))
236
+ unlinkSync(file.stagedPath);
237
+ if (file.backupPath && existsSync(file.backupPath)) {
238
+ if (existsSync(file.path))
239
+ unlinkSync(file.path);
240
+ renameSync(file.backupPath, file.path);
241
+ }
242
+ else if (file.originalContent === undefined && existsSync(file.path)) {
243
+ unlinkSync(file.path);
244
+ }
245
+ }
246
+ throw error;
247
+ }
248
+ // バックアップ除去は切り替え完了後に行う。ここで一時ファイルの除去に失敗しても、
249
+ // 正本の切り替え自体は完了しているため migration を巻き戻さない。
250
+ for (const file of staged) {
251
+ if (file.backupPath && existsSync(file.backupPath)) {
252
+ try {
253
+ unlinkSync(file.backupPath);
254
+ }
255
+ catch {
256
+ // 正本は切り替え済み。一時バックアップは次回の手動清掃対象として残す。
257
+ }
258
+ }
259
+ }
260
+ if (indexBackupPath && existsSync(indexBackupPath)) {
261
+ try {
262
+ unlinkSync(indexBackupPath);
263
+ }
264
+ catch {
265
+ // 正本は切り替え済み。一時バックアップは次回の手動清掃対象として残す。
266
+ }
267
+ }
268
+ }