specdojo 0.3.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (241) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.md +77 -18
  3. package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
  4. package/dist/catalog/build-render.js +32 -0
  5. package/dist/{catalog-build.js → catalog/build.js} +9 -9
  6. package/dist/{catalog.js → catalog/catalog.js} +10 -10
  7. package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
  8. package/dist/catalog/paths.js +1 -0
  9. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
  10. package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
  11. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
  12. package/dist/{agent.js → commands/agent.js} +11 -11
  13. package/dist/{build-command.js → commands/build.js} +2 -2
  14. package/dist/{init-command.js → commands/init.js} +98 -32
  15. package/dist/{orchestrator.js → commands/orchestrator.js} +2 -2
  16. package/dist/{watch.js → commands/watch.js} +3 -3
  17. package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
  18. package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
  19. package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
  20. package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
  21. package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
  22. package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
  23. package/dist/{timeline.js → dashboard/timeline.js} +1 -1
  24. package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
  25. package/dist/{deliverable-trash.js → deliverable/trash.js} +5 -5
  26. package/dist/{devcontainer-command.js → devcontainer/command.js} +5 -3
  27. package/dist/{devcontainer-scaffold.js → devcontainer/scaffold.js} +94 -2
  28. package/dist/{doc-index.js → docs/doc-index.js} +1 -1
  29. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
  30. package/dist/{index-command.js → docs/index-command.js} +1 -1
  31. package/dist/docs/template-resolution.js +1 -0
  32. package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +1 -1
  33. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  34. package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
  35. package/dist/{exec-agent-config.js → exec/agent-config.js} +33 -4
  36. package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
  37. package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
  38. package/dist/{exec-commands.js → exec/commands.js} +22 -18
  39. package/dist/{exec-core.js → exec/core.js} +11 -11
  40. package/dist/{exec-events.js → exec/events.js} +2 -2
  41. package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
  42. package/dist/exec/exec.js +2 -0
  43. package/dist/exec/format.js +1 -0
  44. package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
  45. package/dist/{exec-limit.js → exec/limit.js} +93 -12
  46. package/dist/{exec-parent-validation.js → exec/parent-validation.js} +4 -4
  47. package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +16 -2
  48. package/dist/{exec-plans-core.js → exec/plans-core.js} +68 -114
  49. package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
  50. package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
  51. package/dist/{exec-plans.js → exec/plans.js} +3 -3
  52. package/dist/{exec-project.js → exec/project.js} +1 -1
  53. package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
  54. package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
  55. package/dist/{exec-register.js → exec/register.js} +92 -9
  56. package/dist/{exec-repo-integration-git.js → exec/repo-integration-git.js} +2 -2
  57. package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
  58. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +13 -10
  59. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  60. package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
  61. package/dist/{exec-reporter.js → exec/reporter.js} +29 -12
  62. package/dist/{exec-results.js → exec/results.js} +256 -22
  63. package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +32 -12
  64. package/dist/{exec-run-agent.js → exec/run/agent.js} +79 -27
  65. package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
  66. package/dist/{exec-run-job.js → exec/run/job.js} +64 -35
  67. package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
  68. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  69. package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
  70. package/dist/{exec-run-register-command.js → exec/run/register-command.js} +18 -10
  71. package/dist/{exec-run-register-core.js → exec/run/register-core.js} +46 -21
  72. package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +20 -16
  73. package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +22 -17
  74. package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
  75. package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +54 -23
  76. package/dist/{exec-run.js → exec/run/run.js} +11 -11
  77. package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
  78. package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
  79. package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
  80. package/dist/{exec-run-shared.js → exec/run/shared.js} +61 -11
  81. package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
  82. package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
  83. package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
  84. package/dist/exec/schedule/gantt-chart.js +2 -0
  85. package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
  86. package/dist/exec/schedule/index.js +1 -0
  87. package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
  88. package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
  89. package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
  90. package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
  91. package/dist/exec/shared.js +63 -0
  92. package/dist/exec/slot-lock.js +1 -0
  93. package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
  94. package/dist/{exec-task-repos.js → exec/task-repos.js} +2 -2
  95. package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
  96. package/dist/{exec-trial-commands.js → exec/trial-commands.js} +20 -22
  97. package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
  98. package/dist/{exec-trial.js → exec/trial.js} +2 -2
  99. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  100. package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
  101. package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
  102. package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
  103. package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
  104. package/dist/exec/worktree.js +305 -0
  105. package/dist/{grade-apply.js → grade/apply.js} +9 -9
  106. package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
  107. package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
  108. package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
  109. package/dist/{grade-core.js → grade/core.js} +3 -3
  110. package/dist/grade/grade.js +19 -0
  111. package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
  112. package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
  113. package/dist/{grade-plan.js → grade/plan.js} +5 -5
  114. package/dist/{grade-result.js → grade/result.js} +5 -94
  115. package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
  116. package/dist/{grade-targets.js → grade/targets.js} +11 -8
  117. package/dist/{job-definition.js → job/definition.js} +25 -6
  118. package/dist/{job.js → job/job.js} +12 -11
  119. package/dist/{kata-command.js → kata/command.js} +3 -3
  120. package/dist/{kata.js → kata/kata.js} +5 -5
  121. package/dist/register/approach.js +134 -0
  122. package/dist/{register-core.js → register/core.js} +13 -7
  123. package/dist/{register-create-commands.js → register/create-commands.js} +115 -8
  124. package/dist/{register-date.js → register/date.js} +1 -1
  125. package/dist/register/derivation.js +163 -0
  126. package/dist/{register-event-merge.js → register/event-merge.js} +32 -3
  127. package/dist/{register-events.js → register/events.js} +9 -3
  128. package/dist/{register-history.js → register/history.js} +7 -6
  129. package/dist/{register-item.js → register/item.js} +23 -5
  130. package/dist/register/lifecycle-lock.js +5 -0
  131. package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
  132. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  133. package/dist/{register-migration.js → register/migration.js} +4 -4
  134. package/dist/{register.js → register/register.js} +32 -27
  135. package/dist/{register-renumber.js → register/renumber.js} +38 -11
  136. package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
  137. package/dist/{register-update.js → register/update.js} +5 -5
  138. package/dist/{register-views.js → register/views.js} +47 -7
  139. package/dist/{review-grade.js → review/grade.js} +2 -2
  140. package/dist/{review-plan.js → review/plan.js} +3 -3
  141. package/dist/{routine-definition.js → routine/definition.js} +2 -2
  142. package/dist/{routine.js → routine/routine.js} +49 -22
  143. package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
  144. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  145. package/dist/{schedule.js → schedule/schedule.js} +6 -6
  146. package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
  147. package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
  148. package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
  149. package/dist/shared/agent-types.js +23 -0
  150. package/dist/shared/artifact-path.js +9 -0
  151. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  152. package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
  153. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  154. package/dist/shared/fs.js +30 -0
  155. package/dist/{exec-worktree.js → shared/git.js} +83 -241
  156. package/dist/shared/grade-result.js +94 -0
  157. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  158. package/dist/shared/plan-templates.js +114 -0
  159. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +3 -1
  160. package/dist/shared/random.js +4 -0
  161. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  162. package/dist/shared/schedule-paths.js +9 -0
  163. package/dist/{specdojo-config.js → shared/specdojo-config.js} +93 -5
  164. package/dist/{exec-shared.js → shared/text.js} +0 -134
  165. package/dist/shared/time.js +28 -0
  166. package/dist/specdojo.js +22 -22
  167. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +29 -17
  168. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  169. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -2
  170. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  171. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  172. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -16
  173. package/docs/ja/specdojo/guides/exec-operation-guide.md +145 -12
  174. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  175. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +31 -0
  176. package/docs/ja/specdojo/guides/quick-start-guide.md +81 -16
  177. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -1
  178. package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -1
  179. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  180. package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
  181. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  182. package/docs/ja/specdojo/references/command-reference.md +52 -28
  183. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +17 -11
  184. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  185. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  186. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  187. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  188. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  189. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +20 -0
  190. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +23 -0
  191. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  192. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  193. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +26 -0
  194. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  195. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +70 -7
  196. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  197. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -1
  198. package/package.json +1 -1
  199. package/templates/antigravity/README.md +5 -1
  200. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  201. package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
  202. package/templates/claude/README.md +27 -3
  203. package/templates/claude/agents/claude-executor.md +0 -1
  204. package/templates/claude/agents/claude-reporter.md +2 -1
  205. package/templates/claude/agents/claude-review-executor.md +0 -1
  206. package/templates/codex/README.md +23 -4
  207. package/templates/devcontainer/devcontainer.json +2 -2
  208. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +69 -0
  209. package/templates/devcontainer/remote-host/ssh-config.sample +16 -0
  210. package/templates/init-agent-members.yaml +75 -25
  211. package/templates/init-exec-defaults.yaml +24 -8
  212. package/templates/opencode/README.md +17 -3
  213. package/templates/opencode/agents/opencode-executor.md +0 -1
  214. package/templates/opencode/agents/opencode-reporter.md +2 -1
  215. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  216. package/dist/exec-schedule-gantt-chart.js +0 -2
  217. package/dist/exec.js +0 -2
  218. package/dist/grade.js +0 -19
  219. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  220. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  221. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  222. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  223. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  224. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  225. /package/dist/{exec-types.js → exec/types.js} +0 -0
  226. /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
  227. /package/dist/{register-command-types.js → register/command-types.js} +0 -0
  228. /package/dist/{review-types.js → review/types.js} +0 -0
  229. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  230. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  231. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  232. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  233. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  234. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  235. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  236. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  237. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  238. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  239. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  240. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
  241. /package/dist/{yaml.js → shared/yaml.js} +0 -0
package/CHANGELOG.md CHANGED
@@ -2,6 +2,53 @@
2
2
 
3
3
  SpecDojo の利用者に影響する変更を記録します。
4
4
 
5
+ ## [0.4.0] - 2026-10-18
6
+
7
+ 同梱パッケージは `@specdojo/docs-lint` 0.2.1 を同時に公開します。docs-lint は 0.2.0 以降の変更(js-yaml の 5.4.3 への更新。引用符なしの日付と merge key は 4 系と同じ規則で読み込みます。PJR-RCVS)を含みます。`@specdojo/docs-site` は、この版では公開しません。
8
+
9
+ ### 追加機能
10
+
11
+ - devcontainer の scaffold(`specdojo init --devcontainer` を含む)で、常時稼働ホスト接続用のサンプルスクリプト(`specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`ssh-config.sample`)を `.devcontainer/remote-host/` に生成するようにしました。`devcontainer.json` に設定された公開ポート(`appPort`・`forwardPorts`)に応じた `LocalForward` も含め、scaffold 完了時に置き場所とコピー先を案内します。`init --devcontainer` ではスクリプトの前提となるコンテナ内 tmux も自動で有効化します(PJR-CCXN)。
12
+ - agent 名簿の alias を `--by`・`--executor-by`・`--reporter-by`・fallback の指定、Schedule / Job / routine の指名で実体へ解決し、実体の `model` を provider の `command_template` の `{model}` へ渡すようにしました。event と result の actor には実体名を記録します(PJR-YK1C)。
13
+ - 登録項目の起票元を個票 Frontmatter の `derived_from` に記録できるようにし、`register add` / `update` の繰り返し指定可能な `--from`、元項目から派生先を辿る生成ビュー、`register history` の変更履歴に対応しました。decision から起票した todo の追跡にも同じ関係を使えます(PJR-7WME)。
14
+ - 指名した agent が rate limit になったとき、`--on-rate-limit wait|fallback|stop` と executor / reporter 別の fallback 指定で、同じ agent の再開待ちまたは代替 agent への切替を選べるようにしました。`exec-defaults.yaml` の `rate_limit_policy.pinned` でも既定を設定でき、従来互換の既定は `stop` です(PJR-BHMH)。
15
+ - `register add` / `update` に `--approach` と繰り返し指定できる `--target` を追加しました。個票で進め方と対象文書を宣言でき、成果物はカタログ、kata は文書索引で解決します。解決できない対象、成果物と kata の種別違い、`approach` と複数対象の組み合わせは書き込み前に拒否します(PJR-ZJXQ)。
16
+ - `exec run --register` は、個票に `approach` があれば、schedule のタスクと同じ plan の作り方(approach のテンプレート、kata の参照、DCT の `done_criteria`)を使うようにしました。個票の完了条件は追加の条件として plan に載り、owner には個票の `owner` を使います(PJR-H06F)。
17
+ - agent 名簿(`agent-members.yaml`)に、実体の `model`・`effort` と、実体を指す別名(`aliases`・`alias_of`)を書けるようにしました。別名の循環、存在しない実体や無効な実体を指す別名は、名簿の読み込み時にファイルと名前を示してエラーにします。今の 1 段の名簿もそのまま使えます(PJR-EANK)。
18
+ - Job Run で、Job 定義の `partial_exit_code` に一致する終了を部分成功(`partial`)として記録し、review の判定が `complete-with-findings` なら評価できた分を統合するようにしました。grade の Job は、一部の文書の評価が失敗したときに 2 で終わります。全件の失敗・上限・中断は従来どおり `waiting` で止まります。`routine list` にも `partial` が表示されます(PJR-VGNG)。
19
+
20
+ ### 変更
21
+
22
+ - 対話式の `specdojo init` から成果物カタログの質問を除き、`--catalog <size>` を明示した場合にだけ作成するように変更しました。導入直後の混乱を防ぎ、成果物が定まってから `catalog scaffold` で追加できるようにします。初期化の最後の案内でも `catalog scaffold` と `catalog_path` の設定手順を示します(PJR-G5AB)。
23
+ - approach のない実行(register の todo・issue など)の result で、第 4 章の見出しを「4. 進め方」にし、記入の指示をどう進めたか・根拠にした文書や規約に改めました。approach のある実行(schedule のタスク、approach を持つ個票)は「4. 進め方と実践の型の適用」のままです(PJR-S9QF)。
24
+ - `specdojo init --exec` と `config scaffold` が配布する agent の名簿と定義を、実体と別名の 2 段構成に改めました。実体は model の系統と役割で名付け(`sonnet-executor`・`terra-executor`・`gemma-executor`・`flash-executor` など)、`model` を持ちます。従来の名前(`claude-executor`・`codex-executor`・`opencode-executor`・`agy-executor` など)は `aliases` の別名として残し、init は選んだ provider の別名だけを書きます。claude と opencode の agent の定義は役割ごとの 1 ファイルにまとめて `model` を外し、`command_template` は `--agent {agent} --model {model}` と `command_params.by_mode` で組み立てます(`claude-expert-review-executor.md` は配布しません)。codex と antigravity の `command_params` からも `model` を外しました(PJR-8TGQ)。
25
+ - 既存の 1 段の名簿と `--agent {nickname}` の `command_template` は変更しなくても動きます。init は既存の名簿を上書きせず、scaffold も `--force` なしでは既存の定義を上書きしません。`--force` で役割ごとの定義に置き換える場合は、exec 設定ガイドの「agent の名簿の 2 段構成と移行」の手順(実体の名前と `model` を加える、従来の名前を `aliases` へ移す、`command_params` の `model` を外す、`command_template` を改める、`--dry-run` で確かめる)で 2 段へ移してください(PJR-8TGQ)。
26
+ - exec の plan で、共通の規約(記法・成果物規約)の全文を本文に差し込むのをやめ、守らないと失敗に直結する要点だけを残すようにしました。詳細は plan に記したパス(npm で導入した場合は `node_modules/specdojo/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md`)を作業前に読むよう指示します。要点は同じファイルの `plan-essentials` マーカーの間から取り出します。既存の plan は書き換えません(PJR-2219)。要点には検査の扱い(`package.json` と hook の設定を読んで適用条件から実行する検査を決める、当てはまらない検査は `not_applicable` と理由を報告する、`not_run` は実行できたのに実行しなかった検査だけに使う)も含めます。npm script も Markdown の lint もない新しいリポジトリで、executor が詳細を読まずに `not_run` と報告し、最初の実行が止まる問題を防ぎます(PJR-Z104)。
27
+
28
+ ### 不具合修正
29
+
30
+ - `devcontainer scaffold` が親ディレクトリを常に `/workspaces/specdojo-workspace` としていた問題を修正し、ホスト側の親名を反映するようにしました。`--workspace-name` で明示的に固定でき、`specdojo init --devcontainer` からも指定できます。既に生成済みの `.devcontainer/` は、`--force` で作り直すまで従来のままです(PJR-8GQ4)。
31
+ - 対話式の `specdojo init` で provider などの入力を誤ると、最初から入力し直しになっていた問題を修正しました。答えを質問ごとに確かめ、誤りがあればその質問だけを聞き直します。非対話(`--yes` や引数での指定)では、従来どおり誤りの理由を出して終えます。Claude Code を選んだときの最後の案内も、`npm run orch:opus` に揃えました(PJR-B3XQ)。
32
+ - exec の worktree を作るときに、git が一時的なエラー(dubious ownership など)を返しても実際には作成できていた場合、再試行が「branch がすでにある」で失敗していた問題を修正しました。再試行の前に目的の状態を確かめます(PJR-DT3Q)。
33
+ - exec の checkpoint の確認で git が失敗したときに、原因が記録されなかった問題を修正しました。終了コードと stderr を失敗のログとエラーのメッセージに含めます(PJR-CY80)。
34
+ - exec の result で、reporter が変更ファイルごとの説明を返さなかった場合に、定型文(「reporter の説明がないため、変更差分を参照。」)の代わりに Git の変更情報(追加・変更・削除・名前の変更、行数)を記録するようにしました。変更ファイルが 50 件を超える場合は、ディレクトリごとに集約して記録します(PJR-8TS6)。
35
+ - `register build` が生成する一覧(`pjr-index.md` と派生ビュー)で、個票のタイトル・説明・結論などのセルに含まれるパイプ文字(`|`)と改行をエスケープするようにしました。セル内のパイプ文字で表の列がずれ、markdownlint(MD056)で失敗する問題を解消します(PJR-FXPH)。
36
+ - register の plan テンプレート(`xep-register-template`・`xep-register-investigate-template`)の対象項目からサイズが大きくパスも古かった登録簿一覧(`pjr-index.md`)を外し、進め方の最初を個票のみを読む指示に改めました。文脈長の小さい agent が一覧を読んで文脈を消費し停止する問題を防ぎます(PJR-SJ0G)。
37
+ - `routine run` の実行中に、`routine list` などが前回の結果と理由をそのまま表示していた問題を修正しました。開始時に `last_result` を `running` にし、終了時に今回の結果で上書きします(PJR-2CQR)。
38
+ - `exec run --on-rate-limit wait` で、codex の usage limit(`try again at 11:17 PM`)の解除まで待たずに止まっていた問題を修正しました。agent の出力の全体(codex が表示した設定ファイルなどの内容を含む)から最初に見つかった時刻を使っていたため、設定ファイルの例の `resets 4:10am (UTC)` を解除の時刻と読んでいました。解除の時刻は出力の末尾の行から読みます。agy の `Resets in 4h36m50s` のような相対の形も読みます。待機を飛ばすときのログは、解除の時刻を読めない場合(元の出力の行を表示)、過ぎている場合、上限を超える場合で分けました(PJR-NJ6J)。
39
+
40
+ - `npm init` が `package.json` に入れる仮の `test` script(`echo "Error: no test specified" && exit 1`)があるリポジトリで、executor が `npm test` を `not_applicable` と報告しても runner が退け、最初の実行が `waiting` で止まっていた問題を修正しました。仮の `test` script(引用符や空白だけが違う変種を含む)は script がないものとみなし、共通の規約の検査の表にも同じ扱いを書きました。本物の test script がある場合は従来どおり退けます。`specdojo init` は利用者の `package.json` を書き換えません(PJR-6EF8)。
41
+
42
+ ### 文書
43
+
44
+ - README の始め方を、ランディングページ(<https://specdojo.org/>)と同じ `npx specdojo init` の手順と `<アプリ>-workspace/<アプリ>-specdojo` の構成に揃え、specdojo.org へのリンクを加えました(PJR-Y79W)。
45
+ - exec 運用ガイドに、登録簿(register)の todo から approach を使って成果物や kata(実践の型)を作成・修正する手順を追加しました。個票での approach と target の指定方法、kata 保守の approach の選び方、plan 生成内容、組み合わせ検証、および `exec run --deliverable` との違いと推奨経路を記載しました(PJR-4Z6N)。
46
+ - オーケストレーター運用ガイドに、Claude Code などの plan モードの plan と register の使い分けと、plan の下書きを decision と todo へ書き写す流れを加えました(PJR-YFBW)。
47
+
48
+ ### 内部の変更
49
+
50
+ - `src/` を機能ごとのサブディレクトリ(`exec/`・`register/`・`grade/`・`shared/` など)へ分け、機能の間の依存の向きを ESLint で検査するようにしました。CLI の動作と出力は変わりません(PJR-V23P・PJR-X8Y9 ほか)。
51
+
5
52
  ## [0.3.1] - 2026-10-16
6
53
 
7
54
  同梱パッケージの `@specdojo/docs-lint` と `@specdojo/docs-site` は、この版では公開しません(docs-lint の js-yaml の更新は次の docs-lint の版で公開します)。
package/README.md CHANGED
@@ -40,7 +40,7 @@ SpecDojo は、仕様道(Spec-Dō)の道場です。
40
40
 
41
41
  v0.3.0 の `grade` は試験的な機能です。npm package では `grade list` / `plan` / `apply` / `validate` / `result` などの部品を利用できますが、これらを通しで実行する SpecDojo 本体リポジトリの開発用スクリプト `tools/grade/run-per-document.sh` は package に含まれません。成果物を評価するには、project の `catalog_path` も設定してください。1 文書を部品で評価する手順は [CLI コマンドリファレンス](docs/ja/specdojo/references/command-reference.md#81-npm-package-で-1-文書を評価する)を参照してください。
42
42
 
43
- 日本語ドキュメントは [SpecDojo ドキュメントサイト](https://specdojo.github.io/specdojo/ja/) で公開しています。
43
+ [specdojo.org](https://specdojo.org/) では、SpecDojo の考え方と始め方を紹介しています。日本語の詳細文書は [SpecDojo ドキュメントサイト](https://specdojo.github.io/specdojo/ja/) で公開しています。
44
44
 
45
45
  ## この README の役割
46
46
 
@@ -55,6 +55,8 @@ v0.3.0 の `grade` は試験的な機能です。npm package では `grade list`
55
55
 
56
56
  ### npm で導入する
57
57
 
58
+ Node.js 22.13 以上と Git を用意します。オーケストレーターに Claude Code を使う場合は、Claude Code も導入してログインしておきます。ほかの provider も選べます。
59
+
58
60
  既定では、SpecDojo の記録をプロダクトの Git 履歴に混ぜないため、次の **別リポジトリ構成**で始めます。
59
61
 
60
62
  - **プロダクトリポジトリ** `app1/`: ソースコードと、仕様・設計などのプロダクトドキュメントを置きます。
@@ -68,32 +70,35 @@ app1-workspace/
68
70
  └── app1-specdojo-worktrees/ # タスクごとの作業場所
69
71
  ```
70
72
 
71
- `app1-workspace/` 直下で次を実行します。
73
+ 既に開発している `app1/` と並べてプロジェクトリポジトリを作り、SpecDojo を導入します。
72
74
 
73
75
  ```sh
74
- mkdir app1-specdojo
75
- git -C app1-specdojo init
76
- cd app1-specdojo
76
+ mkdir app1-workspace
77
+ mkdir app1-workspace/app1-specdojo
78
+ git -C app1-workspace/app1-specdojo init
79
+ cd app1-workspace/app1-specdojo
77
80
  npm init -y
78
- npm install --save-dev specdojo @specdojo/docs-lint
79
- npx specdojo config init
81
+ npm install --save-dev specdojo
82
+ npx specdojo init
80
83
  ```
81
84
 
82
85
  SpecDojo は開発時に使う文書・実行管理ツールなので、`--save-dev` で導入します。kata は、成果物を書くための規則・手順・テンプレート・サンプルの総称です。kata もインストールした package から参照されるため、`package-lock.json` によって SpecDojo と同じ版へ固定されます。
83
86
 
84
- `config init` は、登録簿を使い始めるための最小設定を `.specdojo/specdojo.config.json` に作成します。worktree の既定先はリポジトリのディレクトリ名から `../<リポジトリ名>-worktrees` として作られます。設定を変える方法は、後述の「設定を変えたいとき」を参照してください。
87
+ `specdojo init` の質問に答えると、`prj-0001` の設定、登録簿、人と AI の名簿、AI に実行させる設定、オーケストレーターを起動する npm script がまとめて作られます。Claude Code で AI に作業を任せる例では、provider に `claude`、exec の質問に「はい」を選びます。既存ファイルは上書きせず、作成内容は `--dry-run` で先に確認できます。
85
88
 
86
- あわせて、`npm install` で作られる `node_modules/` と SpecDojo の生成物(`docs/**/generated/*`、`.specdojo/doc-index.json` など)を git の管理から外す行を `.gitignore` に用意します。`.gitignore` が無ければ作成し、既にあれば足りない行だけを末尾へ追記します。`node_modules`、`/node_modules` など同じ意味の行が既にあれば `node_modules/` は追記しません。生成物を管理外にしておくと、登録簿の項目を並行実行したときに生成物どうしが衝突しません。追記する行は `npx specdojo config init --dry-run` で事前に確認できます。すでに `node_modules/` や生成物を git で管理している場合は、表示される案内に従って `git rm -r --cached` で管理から外し、コミットします。
89
+ あわせて、`node_modules/` と SpecDojo の生成物(`docs/**/generated/*`、`.specdojo/doc-index.json` など)を Git の管理から外す行が `.gitignore` に用意されます。すでに `node_modules/` や生成物を Git で管理している場合は、表示される案内に従って管理から外し、コミットします。
87
90
 
88
- ### オーケストレーターを配置する
91
+ `@specdojo/docs-lint` は必須ではありません。SpecDojo 文書向けの検査を使う場合だけ、[ドキュメント編集ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/docs-editing-guide.html)に従って追加します。
89
92
 
90
- SpecDojo は、会話を CLI 操作へ変換する対話型オーケストレーターを同梱しています。利用する AI ツール(provider)の設定を配置します。次は Claude Code を使う例です。
93
+ ### オーケストレーターを起動する
94
+
95
+ SpecDojo は、会話を CLI 操作へ変換する対話型オーケストレーターを同梱しています。`init` で Claude Code を選んだ場合は、追加された npm script で起動します。
91
96
 
92
97
  ```sh
93
- npx specdojo config scaffold --provider claude
98
+ npm run orch:opus
94
99
  ```
95
100
 
96
- このコマンドを実行すると、オーケストレーターの定義ファイルが配置され、`package.json` へ起動用のスクリプトが追加されます(`package.json` が存在する場合)。追加されたスクリプトで起動します。
101
+ `orch:sonnet` も追加されます。これらの script は `specdojo orchestrator launch --provider claude` を経由して Claude Code を起動します。provider ごとの詳しい設定は [オーケストレーター運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/orchestrator-operation-guide.html) を参照してください。
97
102
 
98
103
  | provider | 配置先 | 起動(`package.json` がある場合) |
99
104
  | ------------- | ------------------------------------------- | --------------------------------- |
@@ -102,7 +107,7 @@ npx specdojo config scaffold --provider claude
102
107
  | `codex` | `.specdojo/codex/orchestrator.md` | `npm run orch:codex` |
103
108
  | `antigravity` | `.specdojo/antigravity/orchestrator.md` | `npm run orch:agy` |
104
109
 
105
- 配置されるファイルのモデル名は、手元で使えるモデルに合わせて編集してください。provider ごとの詳しい設定は [オーケストレーター運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/orchestrator-operation-guide.html) を参照してください。
110
+ 各設定を個別に管理したい場合は、後述の「設定を個別に行う場合」にある `config init` と `config scaffold` を使います。
106
111
 
107
112
  Antigravity CLI を無人実行する場合は、利用者のグローバル設定へ permission rule を追加します。この設定はすべてのリポジトリに効くため、必ず先に差分を確認してから適用してください。通常の scaffold はグローバル設定へ触れません。
108
113
 
@@ -149,10 +154,9 @@ kata の rulebook を確認したい
149
154
 
150
155
  ### CLI を直接使う
151
156
 
152
- オーケストレーターを使わずに操作することもできます。最初の登録簿と、実施する作業を表す `todo` を作り、一覧を生成します。
157
+ オーケストレーターを使わずに操作することもできます。`init` が作成した登録簿へ、実施する作業を表す `todo` を起票し、一覧を生成します。
153
158
 
154
159
  ```sh
155
- npx specdojo register scaffold --project prj-0001
156
160
  npx specdojo register add \
157
161
  --project prj-0001 \
158
162
  --type todo \
@@ -160,6 +164,54 @@ npx specdojo register add \
160
164
  npx specdojo register build --project prj-0001
161
165
  ```
162
166
 
167
+ ### プロダクトリポジトリをつないで実行する
168
+
169
+ AI にプロダクトを変更させる前に、`.specdojo/specdojo.config.json` の `projects.prj-0001` へ、同じ workspace にあるプロダクトリポジトリを追加します。
170
+
171
+ ```json
172
+ "repos": [
173
+ {
174
+ "name": "app1",
175
+ "path": "../app1",
176
+ "integration_branch": "main"
177
+ }
178
+ ]
179
+ ```
180
+
181
+ 個票へ完了条件を書き、Claude Code の executor と reporter を指定して実行します。
182
+
183
+ ```sh
184
+ npx specdojo exec run \
185
+ --project prj-0001 \
186
+ --register PJR-XXXX \
187
+ --worktree \
188
+ --executor-by claude-executor \
189
+ --reporter-by claude-reporter
190
+ ```
191
+
192
+ 完了後は両方のリポジトリの commit とプロダクトの動作を確認します。
193
+
194
+ ```sh
195
+ git -C ../app1 log --oneline -1
196
+ git log --oneline -1
197
+ npm --prefix ../app1 run dev
198
+ ```
199
+
200
+ 人が result と成果物を確認し、気づいた改善を次の `todo` や `issue` として残してから、元の登録項目を close します。
201
+
202
+ ```sh
203
+ npx specdojo register add \
204
+ --project prj-0001 \
205
+ --type todo \
206
+ --title "次の改善" \
207
+ --commit
208
+ npx specdojo register close \
209
+ --project prj-0001 \
210
+ --id PJR-XXXX \
211
+ --conclusion "完了条件を満たした" \
212
+ --commit
213
+ ```
214
+
163
215
  `exec run` と並行して記帳し、その変更だけを commit まで完了させる場合は、`register add` / `update` / `renumber` または状態遷移コマンドへ `--commit` を付けます。同じ project の `register lifecycle` 枠が空くまで待ち、ほかの未 commit 変更を含めずに記帳・一覧再生成・commit を行います。対象の個票や event に既存差分がある場合は、混在を避けるため記帳前に停止します。
164
216
 
165
217
  ここまでの手順は、利用側へ kata をコピーせずに実行できます。生成された `todo` の個票が編集対象、
@@ -188,9 +240,16 @@ AI による実行は数分から数十分かかり、定期処理として登
188
240
  実行を続けたい場合は、常時稼働するホストへリモート接続する構成例を
189
241
  [常時稼働ホスト運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/remote-host-development-guide.html) に示しています。
190
242
 
191
- ### 設定を変えたいとき
243
+ ### 設定を個別に行う場合
244
+
245
+ 対話式の `init` を使わず、各設定を個別に管理したい場合は、`config init` と provider の `config scaffold` を順に実行します。
246
+
247
+ ```sh
248
+ npx specdojo config init
249
+ npx specdojo config scaffold --provider claude
250
+ ```
192
251
 
193
- `config init` が作る設定は、`prj-0001` の登録簿から始める例です。別のプロジェクト ID や配置を使う場合は、`.specdojo/specdojo.config.json` を変更します。
252
+ `config init` が作る設定は、`prj-0001` の登録簿から始める最小構成です。別のプロジェクト ID や配置を使う場合は、`.specdojo/specdojo.config.json` を変更します。
194
253
 
195
254
  - `current_project`: `--project` を省略したときに使うプロジェクトです。
196
255
  - `projects`: このプロジェクトリポジトリで扱うプロジェクトを定義します。複数登録できます。
@@ -1,9 +1,9 @@
1
1
  import { existsSync, readdirSync, readFileSync } from "node:fs";
2
2
  import { join } from "node:path";
3
- import { load } from "./yaml.js";
4
- import { resolveBasePath, resolveDeliverablePath } from "./catalog-paths.js";
5
- import { isDctCatalogFileName } from "./catalog-types.js";
6
- import { readSpecdojoNamespace } from "./frontmatter-namespace.js";
3
+ import { load } from "../shared/yaml.js";
4
+ import { resolveBasePath, resolveDeliverablePath } from "./paths.js";
5
+ import { isDctCatalogFileName } from "./types.js";
6
+ import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
7
7
  // Walk all deliverables, resolving each one's document path using the
8
8
  // leading-slash base_path convention (same rules as renderSections / dct build).
9
9
  export function collectResolvedDeliverables(sections, parentBase, out) {
@@ -0,0 +1,32 @@
1
+ import { resolveBasePath } from "./paths.js";
2
+ import { buildSpecdojoFrontmatter } from "../docs/frontmatter-namespace.js";
3
+ import { isRecord, isDctTemplateCatalog, renderCatalogTemplateBody, renderSections, } from "../shared/catalog-render.js";
4
+ export { isRecord, isDctTemplateCatalog, renderCatalogTemplateBody };
5
+ function buildFrontmatter(doc) {
6
+ const inner = [];
7
+ inner.push(`id: ${doc.id}`);
8
+ inner.push(`type: ${doc.type}`);
9
+ inner.push(`status: ${doc.status}`);
10
+ if (doc.part_of && doc.part_of.length > 0) {
11
+ inner.push("part_of:");
12
+ for (const p of doc.part_of) {
13
+ const val = p.includes(":") ? `'${p}'` : p;
14
+ inner.push(` - ${val}`);
15
+ }
16
+ }
17
+ inner.push("rulebook: specdojo:dct-rulebook");
18
+ return buildSpecdojoFrontmatter(inner).split("\n");
19
+ }
20
+ export function buildMarkdown(doc) {
21
+ const lines = [];
22
+ lines.push(...buildFrontmatter(doc));
23
+ lines.push("");
24
+ lines.push(`# 成果物カタログ: ${doc.domain}`);
25
+ lines.push("");
26
+ lines.push(`- project-id: \`${doc.project_id}\``);
27
+ lines.push(`- ドメイン: \`${doc.domain}\``);
28
+ const topBase = resolveBasePath("", doc.base_path);
29
+ lines.push(...renderSections(doc.groups, topBase, 1, []));
30
+ lines.push("");
31
+ return lines.join("\n");
32
+ }
@@ -1,14 +1,14 @@
1
1
  import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
2
2
  import { join } from "node:path";
3
- import { load } from "./yaml.js";
4
- import { isDctCatalogFileName } from "./catalog-types.js";
5
- import { declaredIncludes, declaredKata } from "./kata.js";
6
- import { readSpecdojoNamespace } from "./frontmatter-namespace.js";
7
- import { flattenTemplateFrontmatter } from "./template-frontmatter.js";
8
- import { specdojoRootDir } from "./specdojo-config.js";
9
- import { buildMarkdown, isRecord, isDctTemplateCatalog, renderCatalogTemplateBody, } from "./catalog-build-render.js";
10
- import { collectResolvedDeliverables, validateBasedOn } from "./catalog-build-references.js";
11
- import { resolveSpecdojoPath, resolveSpecdojoPathIfExists, specdojoDirectoryPaths, specdojoResourceCandidates, } from "./template-resolution.js";
3
+ import { load } from "../shared/yaml.js";
4
+ import { isDctCatalogFileName } from "./types.js";
5
+ import { declaredIncludes, declaredKata } from "../kata/kata.js";
6
+ import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
7
+ import { flattenTemplateFrontmatter } from "../docs/template-frontmatter.js";
8
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
9
+ import { buildMarkdown, isRecord, isDctTemplateCatalog, renderCatalogTemplateBody, } from "./build-render.js";
10
+ import { collectResolvedDeliverables, validateBasedOn } from "./build-references.js";
11
+ import { resolveSpecdojoPath, resolveSpecdojoPathIfExists, specdojoDirectoryPaths, specdojoResourceCandidates, } from "../docs/template-resolution.js";
12
12
  const CATALOG_RULEBOOK_ID_PATTERN = /^(?:[a-z][a-z0-9-]*:)?[a-z0-9][a-z0-9-]*-rulebook$/;
13
13
  const CATALOG_KATA_DIRS = {
14
14
  rulebook: "rulebooks",
@@ -1,16 +1,16 @@
1
1
  import { join, relative, resolve } from "node:path";
2
2
  import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
3
3
  import { dirname } from "node:path";
4
- import { load } from "./yaml.js";
5
- import { getProjectCatalogPath, loadConfig, loadEnv, SPECDOJO_CONFIG_REFERENCE_URL, specdojoRootDir, } from "./specdojo-config.js";
6
- import { buildCatalog, collectCatalogLocalIds, loadDctIndex, validateBasedOn, validateCatalogDomains, validateCatalogIndex, validateCatalogLocalIds, validateDctDoc, validateRulebookKata, } from "./catalog-build.js";
7
- import { collectDocIndexEntries } from "./doc-index.js";
8
- import { deriveProjectId, runScaffold } from "./catalog-scaffold.js";
9
- import { isDctCatalogFileName } from "./catalog-types.js";
10
- import { buildPlanSkeleton, DCT_PLAN_SCHEMA_PATH, domainFromPlanFileName, listPlanFiles, loadPlan, loadTemplateForDomain, planFileName, resolvePlanInputs, resolvePlanPath, resolvePlansDir, validateDctPlan, validatePlanSchema, writePlan, } from "./catalog-plan.js";
11
- import { renderPlanPrompt } from "./catalog-plan-prompt.js";
12
- import { generateCatalogsFromPlan, writeGeneratedCatalogs } from "./catalog-plan-generate.js";
13
- import { resolveSpecdojoReferencePathIfExists, resolveSpecdojoTemplatesDir, } from "./template-resolution.js";
4
+ import { load } from "../shared/yaml.js";
5
+ import { getProjectCatalogPath, loadConfig, loadEnv, SPECDOJO_CONFIG_REFERENCE_URL, specdojoRootDir, } from "../shared/specdojo-config.js";
6
+ import { buildCatalog, collectCatalogLocalIds, loadDctIndex, validateBasedOn, validateCatalogDomains, validateCatalogIndex, validateCatalogLocalIds, validateDctDoc, validateRulebookKata, } from "./build.js";
7
+ import { collectDocIndexEntries } from "../docs/doc-index.js";
8
+ import { deriveProjectId, runScaffold } from "./scaffold.js";
9
+ import { isDctCatalogFileName } from "./types.js";
10
+ import { buildPlanSkeleton, DCT_PLAN_SCHEMA_PATH, domainFromPlanFileName, listPlanFiles, loadPlan, loadTemplateForDomain, planFileName, resolvePlanInputs, resolvePlanPath, resolvePlansDir, validateDctPlan, validatePlanSchema, writePlan, } from "./plan.js";
11
+ import { renderPlanPrompt } from "./plan-prompt.js";
12
+ import { generateCatalogsFromPlan, writeGeneratedCatalogs } from "./plan-generate.js";
13
+ import { resolveSpecdojoReferencePathIfExists, resolveSpecdojoTemplatesDir, } from "../docs/template-resolution.js";
14
14
  function readSizeFromDeclaration(catalogPath) {
15
15
  const size = loadDctIndex(catalogPath)?.size;
16
16
  return size === "small" || size === "medium" || size === "large" ? size : null;
@@ -1,13 +1,13 @@
1
1
  import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
2
2
  import { dirname, join } from "node:path";
3
- import { dump, load } from "./yaml.js";
4
- import { collectResolvedDeliverables } from "./catalog-build.js";
5
- import { resolveBasePath } from "./catalog-paths.js";
6
- import { buildSpecdojoFrontmatter, readSpecdojoNamespace } from "./frontmatter-namespace.js";
7
- import { practiceLocalId } from "./practice-id.js";
8
- import { flattenTemplateFrontmatter } from "./template-frontmatter.js";
9
- import { isDctCatalogFileName } from "./catalog-types.js";
10
- import { resolveSpecdojoPathIfExists, } from "./template-resolution.js";
3
+ import { dump, load } from "../shared/yaml.js";
4
+ import { collectResolvedDeliverables } from "./build.js";
5
+ import { resolveBasePath } from "./paths.js";
6
+ import { buildSpecdojoFrontmatter, readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
7
+ import { practiceLocalId } from "../shared/practice-id.js";
8
+ import { flattenTemplateFrontmatter } from "../docs/template-frontmatter.js";
9
+ import { isDctCatalogFileName } from "./types.js";
10
+ import { resolveSpecdojoPathIfExists, } from "../docs/template-resolution.js";
11
11
  const PROJECT_ID_PLACEHOLDER = "_PROJECT_ID_";
12
12
  const LOCAL_ID_PLACEHOLDER = "_LOCAL_ID_";
13
13
  const DELIVERABLE_NAME_PLACEHOLDER = "_DELIVERABLE_NAME_";
@@ -0,0 +1 @@
1
+ export { resolveBasePath, resolveDeliverablePath, isTrashedPath } from "../shared/catalog-paths.js";
@@ -6,10 +6,10 @@
6
6
  // implementation exists.
7
7
  import { existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
8
8
  import { join } from "node:path";
9
- import { load } from "./yaml.js";
10
- import { collectCatalogLocalIds, validateDctDoc } from "./catalog-build.js";
11
- import { collectTemplateEntries, diffPlanText, loadTemplatesForDomain, validateDctPlan, } from "./catalog-plan.js";
12
- import { catalogFileNameFromTemplate, dumpDctDoc, scaffoldDoc, } from "./catalog-scaffold.js";
9
+ import { load } from "../shared/yaml.js";
10
+ import { collectCatalogLocalIds, validateDctDoc } from "./build.js";
11
+ import { collectTemplateEntries, diffPlanText, loadTemplatesForDomain, validateDctPlan, } from "./plan.js";
12
+ import { catalogFileNameFromTemplate, dumpDctDoc, scaffoldDoc, } from "./scaffold.js";
13
13
  function newOverlay() {
14
14
  return {
15
15
  instances: new Map(),
@@ -6,11 +6,11 @@
6
6
  // base_path, done_criteria) stays in the DCT template and is never copied into a plan.
7
7
  import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
8
8
  import { basename, join, resolve } from "node:path";
9
- import { dump, load } from "./yaml.js";
10
- import { resolveSpecdojoPath, specdojoDirectoryPaths } from "./template-resolution.js";
9
+ import { dump, load } from "../shared/yaml.js";
10
+ import { resolveSpecdojoPath, specdojoDirectoryPaths } from "../docs/template-resolution.js";
11
11
  import Ajv2020Module from "ajv/dist/2020.js";
12
- import { collectResolvedDeliverables, loadCatalogDocs } from "./catalog-build.js";
13
- import { isTrashedPath, resolveBasePath } from "./catalog-paths.js";
12
+ import { collectResolvedDeliverables, loadCatalogDocs } from "./build.js";
13
+ import { isTrashedPath, resolveBasePath } from "./paths.js";
14
14
  export const DCT_PLAN_SCHEMA_VERSION = 1;
15
15
  export const DCT_PLAN_SCHEMA_PATH = "docs/specdojo/schemas/v1/dct-plan.schema.yaml";
16
16
  const PLACEHOLDER_RE = /_([A-Z][A-Z0-9_]*)_/g;
@@ -1,8 +1,8 @@
1
1
  import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
2
2
  import { join } from "node:path";
3
- import { dump, load } from "./yaml.js";
4
- import { practiceLocalId } from "./practice-id.js";
5
- import { specdojoDirectoryPaths } from "./template-resolution.js";
3
+ import { dump, load } from "../shared/yaml.js";
4
+ import { practiceLocalId } from "../shared/practice-id.js";
5
+ import { specdojoDirectoryPaths, } from "../docs/template-resolution.js";
6
6
  const PLACEHOLDER_RE = /_([A-Z][A-Z0-9_]*)_/g;
7
7
  // js-yaml serializes all non-empty arrays in block style.
8
8
  // Restore flow style for the `roles` field to match template formatting.
@@ -1,24 +1,24 @@
1
1
  import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
2
2
  import { dirname, resolve } from "node:path";
3
- import { defaultExecDefaultsPath, loadExecDefaultsConfig, resolveMemberCommand, resolveRateLimitDetection, resolveRateLimitPolicy, } from "./exec-agent-config.js";
4
- import { resolveProjectPaths } from "./exec-project.js";
5
- import { executeAgent, loadRosterForExecutionPath } from "./exec-run.js";
6
- import { gitEnvironment } from "./git-environment.js";
7
- import { specdojoRootDir } from "./specdojo-config.js";
3
+ import { defaultExecDefaultsPath, loadExecDefaultsConfig, resolveMemberCommand, resolveRateLimitDetection, resolveRateLimitPolicy, } from "../exec/agent-config.js";
4
+ import { resolveProjectPaths } from "../exec/project.js";
5
+ import { executeAgent, loadRosterForExecutionPath } from "../exec/run/run.js";
6
+ import { gitEnvironment } from "../shared/git-environment.js";
7
+ import { resolveAgentMember as resolveRosterAgentMember, specdojoRootDir, } from "../shared/specdojo-config.js";
8
8
  // Rate limit は通常失敗と異なり、呼び出し側が処理済みにせず中断・再開する必要がある。
9
9
  // shell script が出力文字列を解析せず分岐できるよう、一時失敗を表す専用コードにする。
10
10
  export const AGENT_RUN_RATE_LIMIT_EXIT_CODE = 75;
11
11
  export function resolveAgentMember(roster, nickname) {
12
- const members = roster?.members.filter((candidate) => {
12
+ const directMembers = roster?.members.filter((candidate) => {
13
13
  return candidate.type === "agent" && candidate.nickname === nickname;
14
14
  });
15
- if (!members || members.length === 0) {
16
- return { error: `--by agent nickname not found in agent-members.yaml: ${nickname}` };
17
- }
18
- if (members.length !== 1) {
15
+ if (directMembers && directMembers.length > 1) {
19
16
  return { error: `--by agent nickname is not unique in agent-members.yaml: ${nickname}` };
20
17
  }
21
- const [member] = members;
18
+ const member = resolveRosterAgentMember(roster, nickname);
19
+ if (!member) {
20
+ return { error: `--by agent nickname not found in agent-members.yaml: ${nickname}` };
21
+ }
22
22
  if (member.disabled) {
23
23
  return { error: `--by agent is disabled in agent-members.yaml: ${nickname}` };
24
24
  }
@@ -1,6 +1,6 @@
1
1
  import { spawnSync } from "node:child_process";
2
- import { loadConfig, loadEnv, specdojoRootDir } from "./specdojo-config.js";
3
- import { selfRunArgs } from "./spawn-self.js";
2
+ import { loadConfig, loadEnv, specdojoRootDir } from "../shared/specdojo-config.js";
3
+ import { selfRunArgs } from "../shared/spawn-self.js";
4
4
  const VALID_SCOPES = [
5
5
  "exec",
6
6
  "catalog",