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,136 @@
1
+ import { gitResult } from "./exec-worktree.js";
2
+ function commandSnapshot(repoRoot, args) {
3
+ const result = gitResult(repoRoot, args);
4
+ const stdout = typeof result.stdout === "string" ? result.stdout : "";
5
+ const stderr = typeof result.stderr === "string" ? result.stderr.trim() : "";
6
+ return JSON.stringify({ status: result.status, stdout, stderr });
7
+ }
8
+ function isRunnerOwnedLocalConfigEntry(entry) {
9
+ const separator = entry.indexOf("\n");
10
+ const key = (separator === -1 ? entry : entry.slice(0, separator)).toLowerCase();
11
+ // VS Code records the merge base after it discovers a branch created for an exec worktree.
12
+ // The write can land while the agent is running, but it describes runner-created branch
13
+ // metadata and neither changes repository behavior nor belongs to the agent worktree.
14
+ return /^branch\..+\.vscode-merge-base$/.test(key);
15
+ }
16
+ function localConfigSnapshot(repoRoot) {
17
+ const result = gitResult(repoRoot, ["config", "--local", "--null", "--list"]);
18
+ const stdout = typeof result.stdout === "string" ? result.stdout : "";
19
+ const stderr = typeof result.stderr === "string" ? result.stderr.trim() : "";
20
+ if (result.status !== 0)
21
+ return JSON.stringify({ status: result.status, stdout, stderr });
22
+ // Drop only runner-owned metadata. Preserve order and duplicates because duplicate scalar
23
+ // settings can be order-sensitive, and changing them must remain detectable.
24
+ const entries = stdout
25
+ .split("\0")
26
+ .filter((entry) => entry !== "" && !isRunnerOwnedLocalConfigEntry(entry));
27
+ return JSON.stringify({ status: result.status, entries });
28
+ }
29
+ // Agent は成果物だけを編集し、commit と Git 設定変更は親 runner が管理する。
30
+ // agent の cwd で解決した linked worktree の HEAD と、runner 所有メタデータを除く
31
+ // 共有 local config を agent 起動前後で比較し、provider の権限設定をすり抜けた
32
+ // Git 操作も merge や親検証より前に検知する。
33
+ export function captureAgentGitStateSnapshot(repoRoot) {
34
+ return {
35
+ head: [
36
+ commandSnapshot(repoRoot, ["rev-parse", "--verify", "HEAD"]),
37
+ commandSnapshot(repoRoot, ["symbolic-ref", "-q", "HEAD"]),
38
+ ].join("\n"),
39
+ localConfig: localConfigSnapshot(repoRoot),
40
+ };
41
+ }
42
+ export function changedAgentGitStateFields(repoRoot, before) {
43
+ const after = captureAgentGitStateSnapshot(repoRoot);
44
+ const changed = [];
45
+ if (before.head !== after.head)
46
+ changed.push("HEAD");
47
+ if (before.localConfig !== after.localConfig)
48
+ changed.push("local-config");
49
+ return changed;
50
+ }
51
+ function commandStdout(snapshot) {
52
+ try {
53
+ const parsed = JSON.parse(snapshot);
54
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
55
+ const stdout = parsed.stdout;
56
+ if (typeof stdout === "string")
57
+ return stdout.trim();
58
+ }
59
+ }
60
+ catch {
61
+ // 解析できないスナップショットは「値なし」として扱い、申し送りの記録自体は続ける。
62
+ }
63
+ return "";
64
+ }
65
+ function describeHead(snapshot) {
66
+ const [revParse = "", symbolicRef = ""] = snapshot.split("\n");
67
+ const commit = commandStdout(revParse) || "(none)";
68
+ const ref = commandStdout(symbolicRef) || "(detached)";
69
+ return `${ref} @ ${commit}`;
70
+ }
71
+ function localConfigEntries(snapshot) {
72
+ try {
73
+ const parsed = JSON.parse(snapshot);
74
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
75
+ const entries = parsed.entries;
76
+ if (Array.isArray(entries)) {
77
+ return entries.filter((entry) => typeof entry === "string");
78
+ }
79
+ }
80
+ }
81
+ catch {
82
+ // 同上。キー差分を出せない場合は、フィールド名だけの記録に留める。
83
+ }
84
+ return [];
85
+ }
86
+ function localConfigKeys(entries) {
87
+ return entries.map((entry) => {
88
+ const separator = entry.indexOf("\n");
89
+ return separator === -1 ? entry : entry.slice(0, separator);
90
+ });
91
+ }
92
+ function describeKeyDifference(before, after) {
93
+ const removed = [...before];
94
+ const added = [];
95
+ for (const key of after) {
96
+ const index = removed.indexOf(key);
97
+ if (index === -1)
98
+ added.push(key);
99
+ else
100
+ removed.splice(index, 1);
101
+ }
102
+ const lines = [];
103
+ if (added.length > 0)
104
+ lines.push(`+ ${[...new Set(added)].sort().join(", ")}`);
105
+ if (removed.length > 0)
106
+ lines.push(`- ${[...new Set(removed)].sort().join(", ")}`);
107
+ return lines;
108
+ }
109
+ // block した Git 状態変更を、人が判断できる形へ要約する。local config は値に資格情報を
110
+ // 含みうるためキー名だけを出力し、値は適用者が repository 側で確認する前提にする。
111
+ export function describeAgentGitStateChanges(repoRoot, before, fields) {
112
+ const after = captureAgentGitStateSnapshot(repoRoot);
113
+ const sections = [];
114
+ if (fields.includes("HEAD")) {
115
+ sections.push([
116
+ "HEAD:",
117
+ ` before: ${describeHead(before.head)}`,
118
+ ` after: ${describeHead(after.head)}`,
119
+ ].join("\n"));
120
+ }
121
+ if (fields.includes("local-config")) {
122
+ const difference = describeKeyDifference(localConfigKeys(localConfigEntries(before.localConfig)), localConfigKeys(localConfigEntries(after.localConfig)));
123
+ sections.push([
124
+ "local-config(値は資格情報を含みうるため出力しない。キー名のみ):",
125
+ ...(difference.length > 0
126
+ ? difference.map((line) => ` ${line}`)
127
+ : [" キー構成は同じで値だけが変わりました。"]),
128
+ ].join("\n"));
129
+ }
130
+ return sections.join("\n");
131
+ }
132
+ export function agentGitStateViolation(fields) {
133
+ return ("agent-git-state-write: Git state changes detected; " +
134
+ `fields=${fields.join(", ")}; ` +
135
+ "agent must leave commits and repository configuration changes to the parent runner");
136
+ }
@@ -0,0 +1,276 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { createHash } from "node:crypto";
3
+ import { existsSync, lstatSync, readdirSync, readFileSync, readlinkSync } from "node:fs";
4
+ import { join, relative, sep } from "node:path";
5
+ import { gitEnvironment, gitResult } from "./exec-worktree.js";
6
+ // PJR-3S8Q で agent の書き込み対象外とした、親 runner / hook / CI の実行内容を
7
+ // 変えられる設定パス。provider 設定から注入できない固定定義として CLI 側に持つ。
8
+ const PROTECTED_DIRECTORY_PREFIXES = [
9
+ "node_modules/",
10
+ ".specdojo/",
11
+ ".agents/rules/",
12
+ ".agents/skills/",
13
+ ".claude/",
14
+ ".codex/",
15
+ ".opencode/",
16
+ ".github/agents/",
17
+ ".github/workflows/",
18
+ ".gitlab/ci/",
19
+ ".circleci/",
20
+ ".azure-pipelines/",
21
+ ".jenkins/",
22
+ ];
23
+ const PROTECTED_EXACT_PATHS = new Set([
24
+ "package.json",
25
+ "AGENTS.md",
26
+ "CLAUDE.md",
27
+ "GEMINI.md",
28
+ "lefthook.yml",
29
+ ".lefthook.yml",
30
+ ".gitlab-ci.yml",
31
+ ".gitlab-ci.yaml",
32
+ "azure-pipelines.yml",
33
+ "azure-pipelines.yaml",
34
+ "Jenkinsfile",
35
+ ]);
36
+ const SNAPSHOT_DIRECTORY_ROOTS = [
37
+ "node_modules/specdojo",
38
+ ".specdojo",
39
+ ".agents/rules",
40
+ ".agents/skills",
41
+ ".claude",
42
+ ".codex",
43
+ ".opencode",
44
+ ".github/agents",
45
+ ".github/workflows",
46
+ ".gitlab/ci",
47
+ ".circleci",
48
+ ".azure-pipelines",
49
+ ".jenkins",
50
+ ];
51
+ // 保護対象ディレクトリの配下にあるが、設定ではなく再生成可能な既知の生成物。
52
+ // 任意の gitignore 対象を除外すると、agent が .gitignore と新規設定を同時に作ることで
53
+ // ガードをすり抜けられるため、生成物として用途が確定しているパスだけを列挙する。
54
+ // `.opencode/` の 4 件は opencode が起動時に作る実行時生成物で、親 runner / hook / CI の
55
+ // 実行内容を変えない。指示ファイル(`.opencode/AGENTS.md`、`.opencode/agents/**`)は
56
+ // ここに含めず、保護対象のままにする。
57
+ const GENERATED_PATHS = new Set([
58
+ ".specdojo/doc-index.json",
59
+ ".opencode/.gitignore",
60
+ ".opencode/package.json",
61
+ ".opencode/package-lock.json",
62
+ ".opencode/bun.lock",
63
+ ".claude/settings.local.json",
64
+ ]);
65
+ // provider が agent 実行時に作る作業ディレクトリ。配下のファイル数が多く個別に列挙できないため
66
+ // prefix で判定する。GENERATED_PATHS と同じく、ignore 済みであることを併せて条件にする。
67
+ const GENERATED_DIRECTORY_PREFIXES = [".opencode/node_modules/", ".claude/worktrees/"];
68
+ function isGeneratedCandidate(path) {
69
+ if (GENERATED_PATHS.has(path))
70
+ return true;
71
+ return GENERATED_DIRECTORY_PREFIXES.some((prefix) => path.startsWith(prefix));
72
+ }
73
+ // `.specdojo/doc-index.json` のように、保護対象ディレクトリの下にある gitignore 済みの生成物を
74
+ // 除外する。agent は共通規約に従って `index build` などの再生成コマンドを実行するため、生成物まで
75
+ // 保護対象に含めると、規約どおりの検証を行っただけで違反として扱われてしまう。
76
+ //
77
+ // 判定は「追跡されていない」ではなく「ignore されている」で行う。未追跡のファイルをすべて除外すると、
78
+ // agent が新しい設定ファイル(例: `.specdojo/claude/settings.<mode>.json`)を作って保護をすり抜け
79
+ // られるため、ignore 済みの生成物だけを対象から外す。
80
+ //
81
+ // git が使えない、または想定外の終了コードで失敗した場合は除外せず、全候補を保護対象のままにする。
82
+ function ignoredGeneratedPaths(repoRoot, candidates) {
83
+ const generatedCandidates = candidates
84
+ .map((path) => normalizeRepoPath(path))
85
+ .filter(isGeneratedCandidate);
86
+ if (generatedCandidates.length === 0)
87
+ return new Set();
88
+ const result = spawnSync("git", ["check-ignore", "--no-index", "-z", "--stdin"], {
89
+ cwd: repoRoot,
90
+ env: gitEnvironment(),
91
+ input: `${generatedCandidates.join("\0")}\0`,
92
+ encoding: "utf8",
93
+ });
94
+ // 0: 1件以上が ignore 対象、1: 該当なし。それ以外は判定不能として除外しない。
95
+ if (result.error || (result.status !== 0 && result.status !== 1))
96
+ return new Set();
97
+ return new Set((result.stdout ?? "")
98
+ .split("\0")
99
+ .filter((path) => path !== "")
100
+ .map((path) => normalizeRepoPath(path)));
101
+ }
102
+ function normalizeRepoPath(path) {
103
+ return path.replaceAll("\\", "/").replace(/^\.\//, "");
104
+ }
105
+ export function isAgentProtectedConfigPath(path) {
106
+ const normalized = normalizeRepoPath(path);
107
+ if (PROTECTED_EXACT_PATHS.has(normalized))
108
+ return true;
109
+ if (PROTECTED_DIRECTORY_PREFIXES.some((prefix) => normalized.startsWith(prefix)))
110
+ return true;
111
+ return /^(?:commitlint\.config\.[^/]+|\.commitlintrc(?:\.[^/]+)?)$/.test(normalized);
112
+ }
113
+ // snapshot と統合直前の再検査で同じ保護境界を使う。isAgentProtectedConfigPath は
114
+ // path だけで設定候補を分類し、この関数が repository の ignore 規則と既知の生成物定義を
115
+ // 組み合わせて、実際に block すべきパスを返す。
116
+ export function agentProtectedConfigPaths(repoRoot, candidates) {
117
+ const protectedPaths = [
118
+ ...new Set(candidates.map((path) => normalizeRepoPath(path)).filter(isAgentProtectedConfigPath)),
119
+ ];
120
+ const ignoredGenerated = ignoredGeneratedPaths(repoRoot, protectedPaths);
121
+ return protectedPaths
122
+ .filter((path) => !ignoredGenerated.has(path))
123
+ .sort((a, b) => a.localeCompare(b));
124
+ }
125
+ function fingerprint(path) {
126
+ const stat = lstatSync(path);
127
+ if (stat.isSymbolicLink())
128
+ return `link:${readlinkSync(path)}`;
129
+ if (!stat.isFile())
130
+ return `other:${stat.mode}:${stat.size}`;
131
+ return `file:${createHash("sha256").update(readFileSync(path)).digest("hex")}`;
132
+ }
133
+ function addTreeFiles(repoRoot, rootPath, out) {
134
+ if (!existsSync(rootPath))
135
+ return;
136
+ const stat = lstatSync(rootPath);
137
+ if (!stat.isDirectory()) {
138
+ const relPath = normalizeRepoPath(relative(repoRoot, rootPath).split(sep).join("/"));
139
+ if (isAgentProtectedConfigPath(relPath))
140
+ out.set(relPath, fingerprint(rootPath));
141
+ return;
142
+ }
143
+ for (const entry of readdirSync(rootPath, { withFileTypes: true })) {
144
+ const entryPath = join(rootPath, entry.name);
145
+ if (entry.isDirectory()) {
146
+ // `.opencode/node_modules` のような実行時生成ディレクトリは数百〜数千ファイルになる。
147
+ // 走査して fingerprint を取っても結果は除外されるため、入口で辿らない。
148
+ const relDir = normalizeRepoPath(relative(repoRoot, entryPath).split(sep).join("/"));
149
+ if (GENERATED_DIRECTORY_PREFIXES.some((prefix) => `${relDir}/` === prefix))
150
+ continue;
151
+ addTreeFiles(repoRoot, entryPath, out);
152
+ continue;
153
+ }
154
+ const relPath = normalizeRepoPath(relative(repoRoot, entryPath).split(sep).join("/"));
155
+ if (isAgentProtectedConfigPath(relPath))
156
+ out.set(relPath, fingerprint(entryPath));
157
+ }
158
+ }
159
+ // in-place 実行では人間が先に行った未 commit 変更を妨げないよう、agent 起動直前の
160
+ // ファイル内容を保存し、終了後に内容が変わった保護対象だけを agent 由来と判定する。
161
+ export function captureAgentProtectedConfigSnapshot(repoRoot) {
162
+ const snapshot = new Map();
163
+ for (const entry of readdirSync(repoRoot, { withFileTypes: true })) {
164
+ if (entry.isDirectory())
165
+ continue;
166
+ if (!isAgentProtectedConfigPath(entry.name))
167
+ continue;
168
+ snapshot.set(entry.name, fingerprint(join(repoRoot, entry.name)));
169
+ }
170
+ for (const relRoot of SNAPSHOT_DIRECTORY_ROOTS) {
171
+ addTreeFiles(repoRoot, join(repoRoot, relRoot), snapshot);
172
+ }
173
+ const protectedPaths = new Set(agentProtectedConfigPaths(repoRoot, [...snapshot.keys()]));
174
+ for (const path of snapshot.keys()) {
175
+ if (!protectedPaths.has(path))
176
+ snapshot.delete(path);
177
+ }
178
+ return snapshot;
179
+ }
180
+ export function changedAgentProtectedConfigPaths(repoRoot, before) {
181
+ const after = captureAgentProtectedConfigSnapshot(repoRoot);
182
+ const allPaths = new Set([...before.keys(), ...after.keys()]);
183
+ return [...allPaths]
184
+ .filter((path) => before.get(path) !== after.get(path))
185
+ .sort((a, b) => a.localeCompare(b));
186
+ }
187
+ function gitFailure(result) {
188
+ const detail = result.error?.message || (typeof result.stderr === "string" ? result.stderr : "");
189
+ const normalized = detail.trim().replace(/\s+/g, " ");
190
+ if (normalized)
191
+ return normalized.slice(0, 500);
192
+ return `git exited with status ${result.status ?? "unknown"}`;
193
+ }
194
+ function gitDiffText(repoRoot, args) {
195
+ const result = gitResult(repoRoot, [...args]);
196
+ if (result.error || (result.status !== 0 && result.status !== 1)) {
197
+ return { text: "", failure: gitFailure(result) };
198
+ }
199
+ return { text: typeof result.stdout === "string" ? result.stdout : "" };
200
+ }
201
+ function untrackedProtectedPaths(repoRoot, paths) {
202
+ const result = gitResult(repoRoot, ["status", "--porcelain", "-z", "--", ...paths]);
203
+ if (result.error || result.status !== 0) {
204
+ return { paths: new Set(), failure: gitFailure(result) };
205
+ }
206
+ const stdout = typeof result.stdout === "string" ? result.stdout : "";
207
+ const untracked = new Set();
208
+ for (const entry of stdout.split("\0")) {
209
+ if (!entry.startsWith("?? "))
210
+ continue;
211
+ untracked.add(normalizeRepoPath(entry.slice(3)));
212
+ }
213
+ return { paths: untracked };
214
+ }
215
+ // 未追跡の新規ファイルは git diff の対象にならないため、適用者が内容を判断できるよう
216
+ // 現在の内容を追加行として組み立てる。git command 自体の失敗時にはこの処理へフォールバックしない。
217
+ function addedFileDiff(repoRoot, path, note) {
218
+ const absolutePath = join(repoRoot, path);
219
+ if (!existsSync(absolutePath))
220
+ return "";
221
+ let content;
222
+ try {
223
+ content = readFileSync(absolutePath, "utf8");
224
+ }
225
+ catch {
226
+ return "";
227
+ }
228
+ const header = `# ${path}: ${note}\n--- /dev/null\n+++ b/${path}`;
229
+ if (content.includes("\0"))
230
+ return `${header}\n# binary content omitted`;
231
+ const lines = content.split("\n");
232
+ if (lines.at(-1) === "")
233
+ lines.pop();
234
+ return [header, ...lines.map((line) => `+${line}`)].join("\n");
235
+ }
236
+ // 対象パスごとの提案差分を1つのテキストにまとめる。差分を取得できないパスは、
237
+ // 取得できなかったことが分かる注記を残し、他パスの差分は落とさない。
238
+ export function describeAgentProtectedConfigChanges(repoRoot, paths) {
239
+ if (paths.length === 0)
240
+ return "";
241
+ const untracked = untrackedProtectedPaths(repoRoot, paths);
242
+ const sections = [];
243
+ for (const path of paths) {
244
+ if (untracked.failure) {
245
+ sections.push(`# ${path}: 差分を取得できませんでした(git status: ${untracked.failure})`);
246
+ continue;
247
+ }
248
+ if (untracked.paths.has(path)) {
249
+ const added = addedFileDiff(repoRoot, path, "新規ファイル(未追跡)の内容");
250
+ sections.push(added.trim() === ""
251
+ ? `# ${path}: 未追跡ファイルの内容を読み取れませんでした`
252
+ : added.trimEnd());
253
+ continue;
254
+ }
255
+ const againstHead = gitDiffText(repoRoot, ["diff", "HEAD", "--unified=3", "--", path]);
256
+ if (againstHead.text.trim() !== "") {
257
+ sections.push(againstHead.text.trimEnd());
258
+ continue;
259
+ }
260
+ const workingTree = gitDiffText(repoRoot, ["diff", "--unified=3", "--", path]);
261
+ if (workingTree.text.trim() !== "") {
262
+ sections.push(workingTree.text.trimEnd());
263
+ continue;
264
+ }
265
+ const failures = [againstHead.failure, workingTree.failure].filter(Boolean);
266
+ sections.push(failures.length > 0
267
+ ? `# ${path}: 差分を取得できませんでした(git diff: ${[...new Set(failures)].join(" / ")})`
268
+ : `# ${path}: git diff の出力が空でした(HEAD に反映済み、削除、またはバイナリの可能性があります)`);
269
+ }
270
+ return sections.join("\n");
271
+ }
272
+ export function agentProtectedConfigViolation(paths) {
273
+ return ("agent-config-write: protected configuration changes detected; " +
274
+ `paths=${paths.join(", ")}; ` +
275
+ "agent must record the required change in the result handoff for human or orchestrator application");
276
+ }