specdojo 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (531) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +82 -38
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +980 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +45 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +15 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +55 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +473 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  141. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  142. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  143. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  144. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  145. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  146. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  147. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  148. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  149. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  150. package/docs/ja/specdojo/index.md +33 -0
  151. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  152. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  153. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  154. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  155. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  156. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  157. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  158. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  159. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  160. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  161. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  162. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  163. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  164. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  165. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  166. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  167. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  168. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  169. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  170. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  171. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  172. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  173. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  174. package/docs/ja/specdojo/references/command-reference.md +718 -0
  175. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  176. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  177. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  178. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  179. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  180. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  181. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  182. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  183. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  184. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  185. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  186. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  187. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  188. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  192. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  193. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  194. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  196. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  197. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  198. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  200. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  201. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  203. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  204. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  205. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  206. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  208. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  209. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  210. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  211. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  212. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  217. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  218. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  219. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  220. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  223. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  224. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  225. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  226. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  227. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  236. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  237. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  238. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  239. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  240. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  241. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  242. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  243. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  244. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  245. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  246. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  247. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  248. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  249. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  250. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  251. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  252. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  253. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  254. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  255. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  256. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  257. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  258. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  259. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  260. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  261. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  262. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  264. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  265. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  266. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  267. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  269. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  270. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  272. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  276. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  277. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  279. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  281. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  282. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  283. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  284. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  285. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  286. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  287. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  288. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  289. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  290. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  294. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  295. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  296. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  297. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  298. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  299. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  305. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  306. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  307. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  308. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  309. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  310. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  311. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  312. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  314. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  315. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  316. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  317. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  318. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  319. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  320. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  321. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  325. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  328. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  329. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  340. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  341. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  342. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  343. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  344. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  345. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  346. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  347. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  348. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  349. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  350. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  351. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  352. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  353. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  354. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  355. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  356. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  357. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  358. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  359. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  360. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  361. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  362. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  363. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  364. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  365. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  366. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  367. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  368. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  369. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  370. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  371. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  372. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  373. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  374. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  375. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  381. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  382. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  387. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  388. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  392. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  393. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  394. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  396. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  397. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  398. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  399. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  400. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  401. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  402. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  403. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  404. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  405. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  406. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  407. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  408. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  409. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  410. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  411. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  412. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  413. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  414. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  415. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  418. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  419. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  425. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  426. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  427. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  428. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  429. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  430. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  431. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  432. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  433. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  434. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  435. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  436. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  437. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  438. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  439. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  440. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  441. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  442. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  443. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  444. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  445. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  446. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  447. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  448. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  449. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  453. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  454. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  455. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  457. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  458. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  459. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  460. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  461. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  462. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  463. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  464. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  465. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  467. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  468. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  469. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  470. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  471. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  472. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  473. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  474. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  475. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  476. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  477. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  478. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  479. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  480. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  481. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  482. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  483. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  484. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  485. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  486. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  487. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  488. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  489. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  490. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  491. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  492. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  493. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  494. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  495. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  496. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  497. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  498. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  499. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  500. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  501. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  502. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  503. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  504. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  505. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  506. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  507. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  508. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  509. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  510. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  511. package/package.json +120 -24
  512. package/templates/claude/README.md +46 -0
  513. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  514. package/templates/claude/agents/claude-review-executor.md +14 -0
  515. package/templates/claude/settings.edit.json +6 -0
  516. package/templates/claude/settings.report.json +6 -0
  517. package/templates/claude/settings.review.json +7 -0
  518. package/templates/codex/README.md +61 -0
  519. package/templates/codex/agents/codex-executor.toml +12 -0
  520. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  521. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  522. package/templates/codex/agents/codex-review-executor.toml +10 -0
  523. package/templates/copilot/README.md +41 -0
  524. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  525. package/templates/copilot/pm-members-snippet.yaml +44 -0
  526. package/templates/opencode/README.md +41 -0
  527. package/templates/opencode/agents/opencode-executor.md +59 -0
  528. package/templates/opencode/agents/opencode-reporter.md +26 -0
  529. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  530. package/dist/exec-schedule-timeline-render.js +0 -201
  531. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,455 @@
1
+ // 登録項目(PJR-XXXX)の正本は個票ファイル `pjr-XXXX-<topic>.md` の frontmatter である
2
+ // (register-item-frontmatter.schema.yaml)。本モジュールは個票の読み取り・派生値の導出・
3
+ // frontmatter の書き込みを担い、pjr-index の表は生成される一覧ビューとして扱う。
4
+ //
5
+ // 表示 ID・タイトル・説明は frontmatter に重複させず、`id` / H1 / 本文から導出する。
6
+ import { existsSync, readdirSync, readFileSync } from "node:fs";
7
+ import { join } from "node:path";
8
+ import yaml from "js-yaml";
9
+ import { inlineCodeAnglePlaceholders } from "./exec-shared.js";
10
+ import { registerDateFromTimestamp } from "./register-date.js";
11
+ export const VALID_STATUSES = [
12
+ "open",
13
+ "in-progress",
14
+ "waiting",
15
+ "review",
16
+ "decided",
17
+ "done",
18
+ "deferred",
19
+ "rejected",
20
+ ];
21
+ export const VALID_TYPES = [
22
+ "todo",
23
+ "question",
24
+ "risk",
25
+ "issue",
26
+ "change-request",
27
+ "decision",
28
+ "note",
29
+ ];
30
+ export const VALID_PRIORITIES = ["high", "medium", "low"];
31
+ export const TERMINAL_STATUSES_SET = new Set(["done", "decided", "rejected", "deferred"]);
32
+ // PJR-ID の乱数部分に使う 32 文字セット。曖昧文字(`I` / `L` / `O` / `U`)を除いた
33
+ // 英大文字(単一ケース)と数字で構成し、目視・手入力時の誤読を避ける。
34
+ export const PJR_ID_ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
35
+ // PJR-ID の書式。旧来の数字4桁(例: `PJR-0163`)も 0-9 が集合に含まれるため引き続き一致する。
36
+ export const PJR_ID_RE = /^PJR-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}$/;
37
+ // 個票ファイル名 `pjr-XXXX-<topic>.md`。ID 部分は PJR-ID の 32 文字セットの小文字表記。
38
+ const TICKET_FILENAME_RE = /^pjr-([0-9abcdefghjkmnpqrstvwxyz]{4})-[a-z0-9-]+\.md$/;
39
+ // 表示用プレースホルダ。値未定は frontmatter のキー省略で表し、一覧に出す時だけ補う。
40
+ export const CELL_NONE = "-";
41
+ export const CELL_TODO = "_TODO_";
42
+ // optional field を明示的に削除する内部値。`due_on: null` は「期限なし」を表すため、
43
+ // キー削除と YAML null を区別する必要がある。
44
+ export const REMOVE_REGISTER_ITEM_FIELD = Symbol("remove-register-item-field");
45
+ // 日時へ移行する前の個票が持っていた日付フィールド。移行処理だけが読み書きする。
46
+ export const LEGACY_REGISTERED_KEY = "registered_on";
47
+ export const LEGACY_COMPLETED_KEY = "completed_on";
48
+ const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
49
+ // frontmatter の specdojo 名前空間で使うキー順。書き戻しのたびに同じ並びへ整えて、
50
+ // 生成物としての差分を安定させる。表に無いキーは末尾へ元の順序で残す。
51
+ const SPECDOJO_KEY_ORDER = [
52
+ "id",
53
+ "type",
54
+ "status",
55
+ "rulebook",
56
+ "part_of",
57
+ "based_on",
58
+ "item_type",
59
+ "item_status",
60
+ "priority",
61
+ "owner",
62
+ "registered_at",
63
+ "due_on",
64
+ "completed_at",
65
+ "block_reason",
66
+ "conclusion",
67
+ ];
68
+ // ================================
69
+ // Derivation helpers
70
+ // ================================
71
+ function isRecord(value) {
72
+ return typeof value === "object" && value !== null && !Array.isArray(value);
73
+ }
74
+ function asString(value) {
75
+ return typeof value === "string" && value.trim() !== "" ? value.trim() : undefined;
76
+ }
77
+ // 一覧の行順は表示 ID の昇順に固定する。localeCompare は ICU の照合順(環境・ロケール差)に
78
+ // 依存するため、生成物の再現性を保つために code unit 比較で並べ替える。
79
+ export function compareRegisterItemIds(a, b) {
80
+ if (a === b)
81
+ return 0;
82
+ return a < b ? -1 : 1;
83
+ }
84
+ // 個票ファイル名から表示 ID(PJR-XXXX)を取り出す。命名規約に合わない名前は undefined。
85
+ export function displayIdFromTicketFilename(filename) {
86
+ const match = TICKET_FILENAME_RE.exec(filename);
87
+ return match ? `PJR-${match[1].toUpperCase()}` : undefined;
88
+ }
89
+ // 一覧の「個票」セル(`[pjr-xxxx-topic](./pjr-xxxx-topic.md)`)を組み立てる。
90
+ export function ticketRefCell(filename) {
91
+ return `[${filename.replace(/\.md$/, "")}](./${filename})`;
92
+ }
93
+ // 表セルへ埋め込むために1行化し、列区切りの `|` をエスケープする。
94
+ function toCell(text) {
95
+ return text.replace(/\r?\n/g, " ").replace(/\s+/g, " ").replace(/\|/g, "\\|").trim();
96
+ }
97
+ // H1(`# PJR-XXXX タイトル`)からタイトルを導出する。表示 ID の接頭辞は取り除く。
98
+ export function titleFromBody(body, id) {
99
+ const match = body.match(/^#\s+(.+)$/m);
100
+ if (!match)
101
+ return CELL_TODO;
102
+ const heading = match[1].trim();
103
+ const withoutId = heading.replace(new RegExp(`^${id}\\s+`, "i"), "").trim();
104
+ return toCell(withoutId || heading) || CELL_TODO;
105
+ }
106
+ // 本文から説明を導出する。最初の `##` 見出し(`## 1. 概要` など)直後の段落を採用し、
107
+ // 未記入プレースホルダ(`_TODO_` 始まり)はそのまま `_TODO_` として扱う。
108
+ export function descriptionFromBody(body) {
109
+ const lines = body.split(/\r?\n/);
110
+ let sectionIndex = lines.findIndex((line) => /^##\s/.test(line));
111
+ if (sectionIndex === -1) {
112
+ // 章が無い個票は H1 直後の段落を説明とみなす。
113
+ sectionIndex = lines.findIndex((line) => /^#\s/.test(line));
114
+ if (sectionIndex === -1)
115
+ return CELL_TODO;
116
+ }
117
+ const paragraph = [];
118
+ for (const line of lines.slice(sectionIndex + 1)) {
119
+ if (/^#{1,4}\s/.test(line))
120
+ break;
121
+ if (line.trim() === "") {
122
+ if (paragraph.length > 0)
123
+ break;
124
+ continue;
125
+ }
126
+ paragraph.push(line.trim());
127
+ }
128
+ if (paragraph.length === 0)
129
+ return CELL_TODO;
130
+ const text = toCell(paragraph.join(" "));
131
+ if (text.startsWith(CELL_TODO))
132
+ return CELL_TODO;
133
+ return text;
134
+ }
135
+ // ================================
136
+ // Reading
137
+ // ================================
138
+ // 個票の内容から一覧1行分の値と、登録項目フィールドの有無を導出する。
139
+ // ファイル名から ID を導出できない(命名規約外の)ファイルは undefined を返す。
140
+ export function readRegisterItemContent(content, filename) {
141
+ const id = displayIdFromTicketFilename(filename);
142
+ if (!id)
143
+ return undefined;
144
+ const match = content.match(FRONTMATTER_RE);
145
+ const body = match ? (match[2] ?? "") : content;
146
+ let fields = {};
147
+ if (match) {
148
+ let parsed;
149
+ try {
150
+ parsed = yaml.load(match[1]);
151
+ }
152
+ catch {
153
+ parsed = undefined;
154
+ }
155
+ if (isRecord(parsed) && isRecord(parsed.specdojo))
156
+ fields = parsed.specdojo;
157
+ }
158
+ const item = {
159
+ id,
160
+ status: asString(fields.item_status) ?? "open",
161
+ title: titleFromBody(body, id),
162
+ description: descriptionFromBody(body),
163
+ type: asString(fields.item_type) ?? CELL_TODO,
164
+ priority: asString(fields.priority) ?? "medium",
165
+ owner: asString(fields.owner) ?? CELL_TODO,
166
+ registeredAt: asString(fields.registered_at) ?? CELL_TODO,
167
+ due: fields.due_on === null
168
+ ? CELL_NONE
169
+ : (asString(fields.due_on) ??
170
+ (Object.prototype.hasOwnProperty.call(fields, "due_on") ? CELL_NONE : CELL_TODO)),
171
+ completedAt: asString(fields.completed_at) ?? CELL_NONE,
172
+ conclusion: asString(fields.conclusion) ?? CELL_NONE,
173
+ ticket: ticketRefCell(filename),
174
+ };
175
+ return {
176
+ id,
177
+ item,
178
+ hasRegisterFields: asString(fields.item_status) !== undefined,
179
+ blockReason: asString(fields.block_reason) ?? CELL_NONE,
180
+ };
181
+ }
182
+ // 個票の日時を、指定タイムゾーン上の暦日へ変換した表示値へ写す。
183
+ // プレースホルダ(`-` / `_TODO_`)はそのまま残す。
184
+ export function toDisplayItem(item, timeZone) {
185
+ const { registeredAt, completedAt, ...rest } = item;
186
+ return {
187
+ ...rest,
188
+ registered: isPlaceholderCell(registeredAt)
189
+ ? registeredAt
190
+ : registerDateFromTimestamp(registeredAt, timeZone),
191
+ completed: isPlaceholderCell(completedAt)
192
+ ? completedAt
193
+ : registerDateFromTimestamp(completedAt, timeZone),
194
+ };
195
+ }
196
+ // 登録簿ディレクトリ直下の個票ファイルを走査し、ID 昇順で返す。走査順(readdir の列挙順)は
197
+ // 結果に影響しない。一覧本体(pjr-index.md)と生成ビュー(generated/)は対象外。
198
+ export function loadRegisterItemDocs(projectRegisterPath) {
199
+ if (!existsSync(projectRegisterPath))
200
+ return [];
201
+ const docs = [];
202
+ for (const entry of readdirSync(projectRegisterPath, { withFileTypes: true })) {
203
+ if (!entry.isFile())
204
+ continue;
205
+ if (!displayIdFromTicketFilename(entry.name))
206
+ continue;
207
+ const path = join(projectRegisterPath, entry.name);
208
+ const parsed = readRegisterItemContent(readFileSync(path, "utf8"), entry.name);
209
+ if (!parsed)
210
+ continue;
211
+ docs.push({
212
+ id: parsed.id,
213
+ path,
214
+ filename: entry.name,
215
+ item: parsed.item,
216
+ hasRegisterFields: parsed.hasRegisterFields,
217
+ });
218
+ }
219
+ return docs.sort((a, b) => compareRegisterItemIds(a.id, b.id));
220
+ }
221
+ // 個票正本を横断して検証する。frontmatter の単票スキーマでは表現できない、表示 ID の一意性と
222
+ // ファイル名・frontmatter ID の対応をここで保証する。エディタでは .remarkrc.yaml の schema rule が
223
+ // 単票の enum / 必須項目を検証し、CI では register build がこの検証を実行する。
224
+ export function validateRegisterItemDocs(projectRegisterPath) {
225
+ if (!existsSync(projectRegisterPath))
226
+ return { errors: [] };
227
+ const errors = [];
228
+ const ids = new Map();
229
+ const entries = readdirSync(projectRegisterPath, { withFileTypes: true }).sort((a, b) => a.name === b.name ? 0 : a.name < b.name ? -1 : 1);
230
+ for (const entry of entries) {
231
+ if (!entry.isFile())
232
+ continue;
233
+ const displayId = displayIdFromTicketFilename(entry.name);
234
+ if (!displayId)
235
+ continue;
236
+ const filePath = join(projectRegisterPath, entry.name);
237
+ const content = readFileSync(filePath, "utf8");
238
+ const match = content.match(FRONTMATTER_RE);
239
+ let frontmatterId;
240
+ if (match) {
241
+ try {
242
+ const parsed = yaml.load(match[1]);
243
+ if (isRecord(parsed) && isRecord(parsed.specdojo)) {
244
+ frontmatterId = asString(parsed.specdojo.id);
245
+ }
246
+ }
247
+ catch {
248
+ // YAML の構文エラー自体は frontmatter schema が報告する。ここでは対応検証だけを担う。
249
+ }
250
+ }
251
+ const expectedLocalId = entry.name.replace(/\.md$/, "");
252
+ if (!frontmatterId) {
253
+ errors.push(`${entry.name}: missing frontmatter specdojo.id for ${displayId}`);
254
+ }
255
+ else if (!frontmatterId.endsWith(`:${expectedLocalId}`)) {
256
+ errors.push(`${entry.name}: ${displayId} must match frontmatter id "${frontmatterId}" (expected *:${expectedLocalId})`);
257
+ }
258
+ const previous = ids.get(displayId);
259
+ if (previous) {
260
+ errors.push(`${displayId}: duplicate register item ID in ${previous} and ${entry.name}`);
261
+ }
262
+ else {
263
+ ids.set(displayId, entry.name);
264
+ }
265
+ }
266
+ return { errors };
267
+ }
268
+ // ================================
269
+ // Writing
270
+ // ================================
271
+ // 表示用プレースホルダ(`-` / `_TODO_` / 空文字)は「値なし」を意味する。
272
+ export function isPlaceholderCell(value) {
273
+ const trimmed = value?.trim() ?? "";
274
+ return trimmed === "" || trimmed === CELL_NONE || trimmed === CELL_TODO;
275
+ }
276
+ // 登録項目1件分の値を frontmatter フィールドへ写す。表示プレースホルダはキー削除(null)にする。
277
+ export function registerItemFieldsFromItem(item) {
278
+ return {
279
+ item_type: item.type,
280
+ item_status: item.status,
281
+ priority: item.priority,
282
+ owner: isPlaceholderCell(item.owner) ? null : item.owner.trim(),
283
+ registered_at: isPlaceholderCell(item.registeredAt) ? null : item.registeredAt.trim(),
284
+ due_on: item.due.trim() === CELL_TODO
285
+ ? REMOVE_REGISTER_ITEM_FIELD
286
+ : item.due.trim() === CELL_NONE || item.due.trim() === ""
287
+ ? null
288
+ : item.due.trim(),
289
+ completed_at: isPlaceholderCell(item.completedAt) ? null : item.completedAt.trim(),
290
+ conclusion: isPlaceholderCell(item.conclusion)
291
+ ? null
292
+ : inlineCodeAnglePlaceholders(item.conclusion.trim()),
293
+ };
294
+ }
295
+ function orderSpecdojoKeys(fields) {
296
+ const ordered = {};
297
+ for (const key of SPECDOJO_KEY_ORDER) {
298
+ if (key in fields)
299
+ ordered[key] = fields[key];
300
+ }
301
+ for (const [key, value] of Object.entries(fields)) {
302
+ if (!(key in ordered))
303
+ ordered[key] = value;
304
+ }
305
+ return ordered;
306
+ }
307
+ // 個票 frontmatter の `specdojo:` 名前空間を読み書きする共通処理。
308
+ // mutate はキーの追加・更新・削除だけを行い、frontmatter 以外(本文)は書き換えない。
309
+ export function updateSpecdojoFields(content, mutate) {
310
+ const match = content.match(FRONTMATTER_RE);
311
+ if (!match) {
312
+ throw new Error("frontmatter not found in register item file");
313
+ }
314
+ const parsed = parseFrontmatterDocument(match[1]);
315
+ if (!isRecord(parsed.specdojo)) {
316
+ throw new Error("register item frontmatter has no specdojo namespace");
317
+ }
318
+ const fields = { ...parsed.specdojo };
319
+ mutate(fields);
320
+ const document = { ...parsed, specdojo: orderSpecdojoKeys(fields) };
321
+ const dumped = yaml.dump(document, { lineWidth: -1, noRefs: true, quotingType: '"' });
322
+ return `---\n${dumped}---\n${match[2] ?? ""}`;
323
+ }
324
+ // 個票 frontmatter の `specdojo:` 名前空間を、イベント検証などの読み取り用途へ返す。
325
+ // 呼び出し側が誤って元の文書を変更しないよう shallow copy にする。
326
+ export function readSpecdojoFields(content) {
327
+ const match = content.match(FRONTMATTER_RE);
328
+ if (!match) {
329
+ throw new Error("frontmatter not found in register item file");
330
+ }
331
+ const parsed = parseFrontmatterDocument(match[1]);
332
+ if (!isRecord(parsed.specdojo)) {
333
+ throw new Error("register item frontmatter has no specdojo namespace");
334
+ }
335
+ return { ...parsed.specdojo };
336
+ }
337
+ function parseFrontmatterDocument(frontmatter) {
338
+ let parsed;
339
+ try {
340
+ parsed = yaml.load(frontmatter);
341
+ }
342
+ catch (error) {
343
+ const detail = error instanceof Error ? error.message : String(error);
344
+ throw new Error(`Failed to parse register item frontmatter: ${detail}`);
345
+ }
346
+ if (!isRecord(parsed)) {
347
+ throw new Error("register item frontmatter must be a mapping");
348
+ }
349
+ return parsed;
350
+ }
351
+ // 個票 frontmatter の `specdojo:` 名前空間へ登録項目フィールドを反映する。
352
+ // 値 null のキーは削除する。frontmatter 以外(本文)は書き換えない。
353
+ export function applyRegisterItemFields(content, updates) {
354
+ return updateSpecdojoFields(content, (fields) => {
355
+ for (const [key, value] of Object.entries(updates)) {
356
+ if (value === undefined)
357
+ continue;
358
+ if (value === REMOVE_REGISTER_ITEM_FIELD || (value === null && key !== "due_on")) {
359
+ delete fields[key];
360
+ continue;
361
+ }
362
+ fields[key] = value;
363
+ }
364
+ });
365
+ }
366
+ // 日時移行前の個票が持つ `registered_on` / `completed_on` を読み出す。
367
+ // 移行済み(どちらのキーも無い)個票では両方 undefined を返す。
368
+ export function readRegisterItemLegacyDates(content) {
369
+ const match = content.match(FRONTMATTER_RE);
370
+ if (!match)
371
+ return {};
372
+ let parsed;
373
+ try {
374
+ parsed = yaml.load(match[1]);
375
+ }
376
+ catch {
377
+ return {};
378
+ }
379
+ if (!isRecord(parsed) || !isRecord(parsed.specdojo))
380
+ return {};
381
+ const fields = parsed.specdojo;
382
+ return {
383
+ registeredOn: asString(fields[LEGACY_REGISTERED_KEY]),
384
+ completedOn: asString(fields[LEGACY_COMPLETED_KEY]),
385
+ };
386
+ }
387
+ // 旧日付キーを取り除き、UTC の日時キーへ置き換える。移行処理だけが使う。
388
+ export function applyRegisterItemTimestamps(content, timestamps) {
389
+ return updateSpecdojoFields(content, (fields) => {
390
+ delete fields[LEGACY_REGISTERED_KEY];
391
+ delete fields[LEGACY_COMPLETED_KEY];
392
+ if (timestamps.registeredAt)
393
+ fields.registered_at = timestamps.registeredAt;
394
+ if (timestamps.completedAt)
395
+ fields.completed_at = timestamps.completedAt;
396
+ });
397
+ }
398
+ // H1 のタイトル部分(表示 ID の後ろ)を差し替える。ID 接頭辞は保持する。
399
+ export function setRegisterItemTitle(content, title) {
400
+ const heading = content.match(/^#\s+(.+)$/m);
401
+ if (!heading) {
402
+ throw new Error("H1 heading not found in register item file");
403
+ }
404
+ const idPrefix = heading[1].match(/^(PJR-[0-9A-Za-z]{4})\s+/);
405
+ const replacement = idPrefix ? `# ${idPrefix[1]} ${title}` : `# ${title}`;
406
+ return content.replace(/^#\s+.+$/m, () => replacement);
407
+ }
408
+ // 説明の導出元(最初の `##` 見出し直後の段落)を差し替える。段落が無い場合は見出し直後へ挿入する。
409
+ export function setRegisterItemDescription(content, description) {
410
+ const safeDescription = inlineCodeAnglePlaceholders(description);
411
+ const lines = content.split("\n");
412
+ const sectionIndex = lines.findIndex((line) => /^##\s/.test(line));
413
+ if (sectionIndex === -1) {
414
+ throw new Error("section heading (## ) not found in register item file");
415
+ }
416
+ let start = sectionIndex + 1;
417
+ while (start < lines.length && lines[start].trim() === "")
418
+ start++;
419
+ let end = start;
420
+ while (end < lines.length && lines[end].trim() !== "" && !/^#{1,4}\s/.test(lines[end]))
421
+ end++;
422
+ if (start >= lines.length || /^#{1,4}\s/.test(lines[start] ?? "")) {
423
+ lines.splice(sectionIndex + 1, 0, "", safeDescription);
424
+ return lines.join("\n");
425
+ }
426
+ lines.splice(start, end - start, safeDescription);
427
+ return lines.join("\n");
428
+ }
429
+ // 一覧に記録されていた要約を最初の章の先頭段落へ移し、既存段落はその後ろへ残す。
430
+ // 既存個票の詳細を失わず、本文から生成する一覧の「説明」を移行前と一致させるために使う。
431
+ export function prependRegisterItemDescription(content, description) {
432
+ const safeDescription = inlineCodeAnglePlaceholders(description);
433
+ const lines = content.split("\n");
434
+ const sectionIndex = lines.findIndex((line) => /^##\s/.test(line));
435
+ if (sectionIndex === -1) {
436
+ throw new Error("section heading (## ) not found in register item file");
437
+ }
438
+ let insertAt = sectionIndex + 1;
439
+ while (insertAt < lines.length && lines[insertAt].trim() === "")
440
+ insertAt++;
441
+ lines.splice(insertAt, 0, safeDescription, "");
442
+ return lines.join("\n");
443
+ }
444
+ // dry-run 表示用に、書き込む登録項目フィールドを1行ずつ整形する。
445
+ export function formatRegisterItemFields(updates) {
446
+ return Object.entries(updates)
447
+ .filter(([, value]) => value !== undefined)
448
+ .map(([key, value]) => {
449
+ if (value === REMOVE_REGISTER_ITEM_FIELD || (value === null && key !== "due_on")) {
450
+ return ` ${key}: (removed)`;
451
+ }
452
+ return ` ${key}: ${value === null ? "null" : value}`;
453
+ })
454
+ .join("\n");
455
+ }
@@ -0,0 +1,176 @@
1
+ // 個票の起票日・完了日(旧 `registered_on` / `completed_on`)を、UTC の日時
2
+ // (`registered_at` / `completed_at`)へ移す一度限りの移行処理。
3
+ //
4
+ // 時刻は次の優先順で決める。
5
+ // 1. Git 履歴から復元する。起票は個票ファイルを追加したコミット、完了は終端状態
6
+ // (done / decided / rejected)へ遷移したコミットの author 時刻を採る。
7
+ // 2. 復元した時刻の暦日(プロジェクトタイムゾーン)が旧日付と一致しない場合、または
8
+ // 履歴から復元できない場合は、旧日付にプロジェクトタイムゾーンの 21:00 を補う。
9
+ //
10
+ // 2 の一致判定を挟むのは、日付そのものが登録簿の記録として正であり、移行によって
11
+ // 一覧・派生ビューに出る暦日を変えないためである(個票ファイルの作成が起票より
12
+ // 後になっている項目では、追加コミットの時刻は起票時刻ではない)。
13
+ import { readdirSync, readFileSync } from "node:fs";
14
+ import { join, relative, sep } from "node:path";
15
+ import { applyRegisterItemTimestamps, displayIdFromTicketFilename, readRegisterItemContent, readRegisterItemLegacyDates, } from "./register-item.js";
16
+ import { normalizeRegisterTimestamp, REGISTER_FALLBACK_TIME_OF_DAY, registerDateFromTimestamp, timestampFromDateInTimeZone, } from "./register-date.js";
17
+ import { gitResult } from "./exec-worktree.js";
18
+ // git log の1行書式。コミットハッシュも ISO 日付も空白を含まないため、空白で分割できる。
19
+ const COMMIT_LOG_FORMAT = "--format=%H %aI";
20
+ // 完了日を記録する終端状態。deferred は終端だが完了日を持たないため含めない。
21
+ const CLOSED_STATUSES = new Set(["done", "decided", "rejected"]);
22
+ // ================================
23
+ // Git timestamps
24
+ // ================================
25
+ function gitLines(repoRoot, args) {
26
+ const result = gitResult(repoRoot, args);
27
+ if (result.status !== 0)
28
+ return [];
29
+ const stdout = typeof result.stdout === "string" ? result.stdout : "";
30
+ return stdout.split(/\r?\n/).filter((line) => line.trim() !== "");
31
+ }
32
+ // git のパス限定はリポジトリルート起点の POSIX 表記で渡す。
33
+ function repoRelativePath(repoRoot, target) {
34
+ const value = relative(repoRoot, target);
35
+ if (!value || value === ".." || value.startsWith(`..${sep}`))
36
+ return undefined;
37
+ return value.split(sep).join("/");
38
+ }
39
+ function toUtcTimestamp(authorDate) {
40
+ try {
41
+ return normalizeRegisterTimestamp(authorDate, "git author date");
42
+ }
43
+ catch {
44
+ return undefined;
45
+ }
46
+ }
47
+ function isClosedContent(content, filename) {
48
+ const parsed = readRegisterItemContent(content, filename);
49
+ return parsed ? CLOSED_STATUSES.has(parsed.item.status) : false;
50
+ }
51
+ // 作業ツリーの Git 履歴から、個票の追加時刻と終端状態への遷移時刻を取り出す。
52
+ // 履歴が読めない場合(未コミット・git 不在など)は該当項目を undefined のままにする。
53
+ export function createGitTimestampResolver(repoRoot) {
54
+ return ({ path, filename }) => {
55
+ const relativePath = repoRelativePath(repoRoot, path);
56
+ if (!relativePath)
57
+ return {};
58
+ const addedDates = gitLines(repoRoot, [
59
+ "log",
60
+ "--follow",
61
+ "--diff-filter=A",
62
+ "--format=%aI",
63
+ "--",
64
+ relativePath,
65
+ ]);
66
+ // git log は新しい順に出力するため、最初の追加コミットは末尾の行になる。
67
+ const addedAt = addedDates.length > 0 ? toUtcTimestamp(addedDates[addedDates.length - 1]) : undefined;
68
+ // 終端状態は最新側から遡り、終端が連続している最古のコミットを遷移時点とみなす。
69
+ // 大半の個票では close コミットが最新側にあるため、走査は数リビジョンで止まる。
70
+ const commits = gitLines(repoRoot, ["log", COMMIT_LOG_FORMAT, "--", relativePath]);
71
+ let closedAt;
72
+ for (const line of commits) {
73
+ const [commit, authorDate] = line.trim().split(" ");
74
+ if (!commit || !authorDate)
75
+ break;
76
+ const shown = gitResult(repoRoot, ["show", `${commit}:${relativePath}`]);
77
+ if (shown.status !== 0 || typeof shown.stdout !== "string")
78
+ break;
79
+ if (!isClosedContent(shown.stdout, filename))
80
+ break;
81
+ closedAt = toUtcTimestamp(authorDate) ?? closedAt;
82
+ }
83
+ return { addedAt, closedAt };
84
+ };
85
+ }
86
+ // ================================
87
+ // Planning
88
+ // ================================
89
+ // Git 履歴から復元した時刻が旧日付と同じ暦日を指す場合だけ採用し、それ以外は 21:00 を補う。
90
+ function resolveTimestamp(legacyDate, restoredAt, timeZone) {
91
+ if (restoredAt && registerDateFromTimestamp(restoredAt, timeZone) === legacyDate) {
92
+ return { timestamp: restoredAt, source: "git" };
93
+ }
94
+ return {
95
+ timestamp: timestampFromDateInTimeZone(legacyDate, timeZone, REGISTER_FALLBACK_TIME_OF_DAY),
96
+ source: "fallback",
97
+ };
98
+ }
99
+ // 登録簿ディレクトリを走査し、旧日付キーを持つ個票の書き換え内容を組み立てる。
100
+ // 書き込みは行わず、対象・決定した日時・その根拠を計画として返す。
101
+ export function planRegisterTimestampMigration(opts) {
102
+ const entries = [];
103
+ const files = [];
104
+ const filenames = readdirSync(opts.projectRegisterPath, { withFileTypes: true })
105
+ .filter((entry) => entry.isFile() && displayIdFromTicketFilename(entry.name) !== undefined)
106
+ .map((entry) => entry.name)
107
+ .sort((a, b) => (a === b ? 0 : a < b ? -1 : 1));
108
+ for (const filename of filenames) {
109
+ const id = displayIdFromTicketFilename(filename);
110
+ if (!id)
111
+ continue;
112
+ const path = join(opts.projectRegisterPath, filename);
113
+ const originalContent = readFileSync(path, "utf8");
114
+ const legacy = readRegisterItemLegacyDates(originalContent);
115
+ if (!legacy.registeredOn && !legacy.completedOn)
116
+ continue;
117
+ const gitTimestamps = opts.resolveGitTimestamps({ path, filename });
118
+ const entry = { id, path, filename };
119
+ if (legacy.registeredOn) {
120
+ const resolved = resolveTimestamp(legacy.registeredOn, gitTimestamps.addedAt, opts.timeZone);
121
+ entry.registeredAt = resolved.timestamp;
122
+ entry.registeredSource = resolved.source;
123
+ }
124
+ if (legacy.completedOn) {
125
+ const resolved = resolveTimestamp(legacy.completedOn, gitTimestamps.closedAt, opts.timeZone);
126
+ entry.completedAt = resolved.timestamp;
127
+ entry.completedSource = resolved.source;
128
+ }
129
+ const content = applyRegisterItemTimestamps(originalContent, {
130
+ registeredAt: entry.registeredAt,
131
+ completedAt: entry.completedAt,
132
+ });
133
+ assertDisplayDatesPreserved(entry, legacy, content, filename, opts.timeZone);
134
+ entries.push(entry);
135
+ if (content !== originalContent)
136
+ files.push({ path, content, originalContent });
137
+ }
138
+ return { targetCount: entries.length, entries, files };
139
+ }
140
+ // 移行によって一覧・派生ビューへ出る暦日が変わっていないことを、書き込み前に検証する。
141
+ function assertDisplayDatesPreserved(entry, legacy, content, filename, timeZone) {
142
+ const parsed = readRegisterItemContent(content, filename);
143
+ if (!parsed) {
144
+ throw new Error(`Failed to read migrated register item: ${filename}`);
145
+ }
146
+ const mismatches = [];
147
+ const check = (label, expected, actualAt) => {
148
+ if (expected === undefined)
149
+ return;
150
+ const actual = registerDateFromTimestamp(actualAt, timeZone);
151
+ if (actual !== expected)
152
+ mismatches.push(`${label}: ${expected} -> ${actual}`);
153
+ };
154
+ check("registered", legacy.registeredOn, parsed.item.registeredAt);
155
+ check("completed", legacy.completedOn, parsed.item.completedAt);
156
+ const missing = [];
157
+ if (entry.registeredAt && parsed.item.registeredAt !== entry.registeredAt) {
158
+ missing.push("registered_at");
159
+ }
160
+ if (entry.completedAt && parsed.item.completedAt !== entry.completedAt) {
161
+ missing.push("completed_at");
162
+ }
163
+ if (missing.length > 0) {
164
+ throw new Error(`Timestamp migration did not write ${missing.join(", ")} for ${entry.id}`);
165
+ }
166
+ if (mismatches.length > 0) {
167
+ throw new Error(`Timestamp migration would change displayed dates for ${entry.id}: ${mismatches.join(", ")}`);
168
+ }
169
+ }
170
+ // 移行結果を「復元できた件数 / 補完した件数」で要約する。対応結果へそのまま記録できる形にする。
171
+ export function summarizeTimestampMigration(plan) {
172
+ const count = (key, source) => plan.entries.filter((entry) => entry[key] === source).length;
173
+ return (`items=${plan.targetCount}, ` +
174
+ `registered(git=${count("registeredSource", "git")}, fallback=${count("registeredSource", "fallback")}), ` +
175
+ `completed(git=${count("completedSource", "git")}, fallback=${count("completedSource", "fallback")})`);
176
+ }