specdojo 0.5.0 → 0.7.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 (137) hide show
  1. package/.github/agents/specdojo-orchestrator.md +2 -0
  2. package/CHANGELOG.md +100 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/generate.js +144 -13
  5. package/dist/commands/agent.js +33 -0
  6. package/dist/commands/init.js +2 -0
  7. package/dist/commands/orchestrator.js +10 -1
  8. package/dist/deliverable/deliverable.js +77 -4
  9. package/dist/devcontainer/command.js +18 -0
  10. package/dist/devcontainer/host-script.js +21 -0
  11. package/dist/devcontainer/scaffold.js +4 -3
  12. package/dist/exec/antigravity-session.js +154 -0
  13. package/dist/exec/core.js +1 -0
  14. package/dist/exec/parent-validation.js +14 -0
  15. package/dist/exec/plan-markdownlint.js +89 -0
  16. package/dist/exec/plans-core.js +46 -1
  17. package/dist/exec/plans-generation.js +45 -5
  18. package/dist/exec/plans-planning.js +1 -1
  19. package/dist/exec/plans-storage.js +1 -0
  20. package/dist/exec/product-branch-records.js +105 -0
  21. package/dist/exec/product-branches.js +52 -0
  22. package/dist/exec/register-product-message.js +50 -0
  23. package/dist/exec/register-resume.js +28 -0
  24. package/dist/exec/register.js +6 -0
  25. package/dist/exec/repo-integration-sync.js +4 -2
  26. package/dist/exec/repo-integration.js +41 -4
  27. package/dist/exec/repo-trace.js +2 -0
  28. package/dist/exec/results.js +9 -5
  29. package/dist/exec/run/lifecycle-commands.js +85 -16
  30. package/dist/exec/run/register-command.js +22 -0
  31. package/dist/exec/run/register-resume.js +11 -1
  32. package/dist/exec/run/register-worktree.js +29 -8
  33. package/dist/exec/run/schedule-mode.js +22 -2
  34. package/dist/exec/run/schedule-prepare.js +49 -4
  35. package/dist/exec/run/schedule-task.js +3 -0
  36. package/dist/exec/strategy.js +2 -1
  37. package/dist/exec/task-repos.js +78 -16
  38. package/dist/exec/worktree-command.js +2 -2
  39. package/dist/exec/worktree-ops-commit.js +1 -13
  40. package/dist/exec/worktree-ops-lifecycle.js +40 -36
  41. package/dist/exec/worktree.js +3 -3
  42. package/dist/register/core.js +5 -0
  43. package/dist/register/create-commands.js +54 -2
  44. package/dist/register/deliverable-target.js +24 -17
  45. package/dist/register/event-merge.js +4 -0
  46. package/dist/register/events.js +6 -0
  47. package/dist/register/external-project.js +2 -0
  48. package/dist/register/input.js +168 -0
  49. package/dist/register/item.js +61 -0
  50. package/dist/register/register.js +33 -25
  51. package/dist/register/renumber.js +4 -0
  52. package/dist/register/update.js +6 -0
  53. package/dist/schedule/approach.js +9 -0
  54. package/dist/schedule/strategy-profiles.js +22 -2
  55. package/dist/shared/agent-types.js +4 -1
  56. package/dist/shared/branch-template.js +26 -0
  57. package/dist/shared/commit-message-template.js +38 -0
  58. package/dist/shared/commit-types.js +15 -0
  59. package/dist/shared/git.js +7 -0
  60. package/dist/shared/provider-scaffold.js +2 -0
  61. package/dist/shared/specdojo-config.js +35 -4
  62. package/dist/shared/specdojo-gitignore.js +1 -0
  63. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  64. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  65. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  66. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  67. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  68. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  69. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  70. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  71. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  72. package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
  73. package/docs/ja/specdojo/guides/exec-config-guide.md +16 -12
  74. package/docs/ja/specdojo/guides/exec-operation-guide.md +116 -10
  75. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  76. package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
  77. package/docs/ja/specdojo/guides/register-operation-guide.md +16 -1
  78. package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
  79. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  80. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  81. package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
  82. package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
  83. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  84. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
  85. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  86. package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
  87. package/docs/ja/specdojo/references/command-reference.md +111 -46
  88. package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
  89. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  90. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  91. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  92. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  93. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
  94. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +8 -0
  95. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
  96. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
  97. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  98. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
  99. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  100. package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
  101. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  102. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  103. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  104. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  105. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
  106. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  107. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  108. package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
  109. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  110. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  111. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  112. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  113. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  114. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  115. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  116. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +2 -0
  117. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  118. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
  119. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  120. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +41 -2
  121. package/package.json +6 -2
  122. package/templates/antigravity/README.md +19 -46
  123. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  124. package/templates/antigravity/orchestrator.md +2 -0
  125. package/templates/antigravity/settings.edit.json +73 -0
  126. package/templates/antigravity/settings.orchestrator.json +15 -0
  127. package/templates/antigravity/settings.report.json +7 -0
  128. package/templates/antigravity/settings.review.json +7 -0
  129. package/templates/claude/agents/specdojo-orchestrator.md +2 -0
  130. package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
  131. package/templates/codex/orchestrator.md +2 -0
  132. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  133. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -90
  134. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  135. package/templates/init-agent-members.yaml +1 -0
  136. package/templates/init-exec-defaults.yaml +1 -1
  137. package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
@@ -106,6 +106,8 @@ type は次のように使い分ける。
106
106
 
107
107
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
108
108
 
109
+ 対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
110
+
109
111
  ```bash
110
112
  npx specdojo register add --project <project-id> \
111
113
  --type todo --title "<title>" --description "<description>" \
package/CHANGELOG.md CHANGED
@@ -2,6 +2,106 @@
2
2
 
3
3
  SpecDojo の利用者に影響する変更を記録します。
4
4
 
5
+ ## [Unreleased]
6
+
7
+ ## [0.7.0] - 2026-11-03
8
+
9
+ 同梱パッケージは `@specdojo/docs-site` 0.4.0 を同時に公開します。docs-site 0.4.0 は、D2 コードブロックの SVG 生成と配信(`specdojo-docs-site d2`、PJR-6NEM)と、サイドメニューへの Kata(rulebook・recipe・sample・template)の掲載(PJR-PQG3)を含みます。`@specdojo/docs-lint` は変更がないため 0.4.0 のままです。
10
+
11
+ この版に破壊的変更はありません。
12
+
13
+ ### 追加機能
14
+
15
+ - `exec run --auto --track <track>` を追加しました。`--parallel`・`--loop`・`--dry-run` と併用でき、失敗後や次の枠の補充でも指定した track だけから選びます。存在しない track は claim 前にエラーで停止し、省略時は全 track から選ぶ従来の動作を維持します(PJR-561Q)。
16
+
17
+ - Antigravity 向けの対話型オーケストレーター起動スクリプトとして `orch:argon`(`gemini-4-argon-medium`)と `orch:argon:work`(worktree `argon-work`)を追加しました。`specdojo init` と `config scaffold` が Antigravity 選択時に配布します。既存の `orch:flash`・`orch:flash:work`(`gemini-3.8-flash-high`)も維持されます(PJR-EWHQ)。
18
+
19
+ - schedule の `exec resume --task <task-id> --resume-from executor` を追加しました。executor が成功し reporter で止まった `blocked`/中断した `doing` の pipeline を、既存 worktree と変更、worktree で編集した plan を引き継いで executor から再実行できます(PJR-RKHR)。
20
+
21
+ - docs-site に D2 コードブロックの SVG 生成と配信、`specdojo-docs-site d2` を追加しました。D2 CLI v0.9.0 と既定 ELK を使い、構文検査 `node tools/lint-d2.mjs` と親検証 ID `lint-d2` を用意しました。Dev Container の CLI 導入は版と SHA-256 を固定します。`lint:d2`・`check`・commit hook・親検証設定および CI への組み込みは、保護された設定の承認後に反映します(PJR-6NEM)。
22
+
23
+ - `devcontainer host-script` コマンドを追加しました。常時稼働ホストから devcontainer 内の tmux セッションへ入るためのスクリプト本体(`devcontainer-tmux.sh`)を workspace の `.specdojo/host/` へ書き出します。ホスト側のスクリプト(`specdojo-tmux.sh`)は workspace のパスを渡して本体を呼び出す数行のみとなり、稼働中または停止中のコンテナへの接続ではホスト側に Node.js が不要になります。コンテナ未作成時のみ `devcontainer up` を動かし、`SPECDOJO_NODE_BIN` による PATH 上書きやログインシェル経由の起動に対応します。対応 OS は macOS、Linux、Windows の WSL2 です(PJR-Q8KP)。
24
+
25
+ ### 変更
26
+
27
+ - 概念データフロー図の Kata を見直しました。全体概要(`cdfd-overview`)の rulebook・recipe・sample・template は、目的を全体像として書き、プロセス領域の区分を代表ノードとする図(区分の位置をそろえる、線のない区分を置かない、調整役の指示の図を分ける、区分の間の実行要求の線を認める、業務の言葉の題)を定め、sample と template の図を D2 の縦の流れにしました(PJR-6QTK・PJR-BC45)。ユースケース別(`cdfd-uc`)の Kata は、「引き渡し」と「例外時の戻り先」の章をなくして渡す情報を図の線で表し、図から調整役を外し、イベントを 1 ノード 1 出来事の短い文にし、deprecated の文書を参照しないことを定め、sample と template の図を D2 の縦の流れにしました(PJR-PRYZ)。eject している場合は、差分を確かめて取り込んでください。
28
+
29
+ - docs-site のサイドメニューに、非推奨でない Kata(rulebook・recipe・sample・template)をすべて載せました。「サンプル」と「テンプレート」のメニューを新設し、載っていない Kata を検出するテストを追加しました(PJR-PQG3)。
30
+
31
+ - agy 1.4.12 のセッション別権限に対応する `agent launch --provider antigravity --role <edit|review|report>` と、対話型 orchestrator の専用設定を追加しました。scaffold は役割別プロファイルを配置し、宣言済みプロダクト worktree の編集許可と各リポジトリの保護ルールを一つの `--settings` JSON にまとめます。通常導入ではグローバル設定を書き換えません。既存の起動設定は配布スニペットへ移行し、設定マージ・許可/拒否の実機確認後に適用してください(PJR-B0B8)。
32
+
33
+ - `devcontainer scaffold` が生成する `specdojo-tmux.sh.sample` を、`.specdojo/host/devcontainer-tmux.sh` を呼び出す数行のラッパースクリプトへ置き換えました。あわせて `ssh-config.sample` の接続説明を新しい起動方式に合わせて更新しました(PJR-Q8KP)。
34
+
35
+ ### 不具合修正
36
+
37
+ - checkpoint の stage 後の検査失敗と、`register --commit` の commit・amend 失敗時に、処理対象だけを unstage するようにしました。作業ツリーの内容と無関係な staged 変更を保持し、register の初回 commit と amend は対象パスだけを記録します(PJR-W7YX)。
38
+
39
+ - schedule の phase の説明に含まれる Markdown の誤りを、checkpoint commit より前の plan 生成時に検出するようにしました。`exec plan --task` と `exec run --auto`(`--dry-run` を含む)が markdownlint の違反をタスク ID・plan のパス・行番号とともに報告し、既存 plan の上書き前に停止します。検査には利用リポジトリまたは SpecDojo 側の markdownlint が必要です(PJR-FVRZ)。
40
+
41
+ - SSH 経由の非対話シェルで `devcontainer-tmux.sh` が Docker を見つけられない問題を修正しました。`SPECDOJO_DOCKER_BIN`、現在の PATH、ログインシェル、代表的な配置先の順に探索し、見つかった場所を `devcontainer up` にも引き継ぎます。Docker が見つからない場合や `docker info` に失敗した場合は、macOS・WSL2・Linux に合った対処方法を表示して停止します(PJR-DWHZ)。
42
+
43
+ - ホストから devcontainer 内の tmux セッションへ入るスクリプト本体(`devcontainer-tmux.sh`)で、`docker inspect` のマウント情報のうち `bind` マウントのみを対象とし、ホスト側のディレクトリパスを正規化してからワークスペースパスと照合するように修正しました。Docker Desktop for Mac などでマウント元のパスが `<親>/<repo>/..` の形式で返る環境でもコンテナ内の作業ディレクトリを正しく特定できるようにします。あわせてマウントパスの前方一致判定における変数展開のクォート漏れ(SC2295)および未使用変数(SC2034)を修正し、サンプルのラッパースクリプト(`specdojo-tmux.sh.sample`)では本体スクリプトの実行権限の有無に関わらず起動できるよう `bash` 経由で呼び出すようにしました(PJR-NV5T)。
44
+
45
+ ## [0.6.0] - 2026-10-31
46
+
47
+ 同梱パッケージは `@specdojo/docs-lint` 0.4.0 を同時に公開します。docs-lint 0.4.0 は、成果物の文脈の目印 `_CONTEXT_:` の検出(`status: ready` の文書ではエラー、それ以外は情報。PJR-JRSY・PJR-D0GB)を含みます。`remark/md-content` を options なしで読み込むと失敗する問題の修正(PJR-5EN3)と、0.3.1(2026-10-29 公開)の rulebook 一覧のキャッシュ(PJR-SC8T)も含みます。`@specdojo/docs-site` は変更がないため 0.3.0 のままです。
48
+
49
+ ### 利用者から見て動きが変わる点
50
+
51
+ この版に破壊的変更はありません。ただし、次の 2 点は既存の使い方で結果が変わります。
52
+
53
+ - schedule の strategy の `guided-pass`(草案作成)の approach が、`fully-guided` から `draft` に変わりました。既存の schedule を作り直すと、草案の段の plan が `draft` の雛形で作られます(PJR-3MY5・PJR-E45K)。
54
+ - `fully-guided` は、既存成果物の磨き込み専用になりました。参照するのは宣言された文書(rulebook・recipe・sample、`based_on`、個票の `入力`、カタログの `brief` など)だけで、template から本文を新しく作ることはしません。文脈から下書きを作る場合は `draft` を使います(PJR-3MY5)。
55
+
56
+ ### 追加機能
57
+
58
+ - 本リポジトリの開発用に `node tools/lint-mermaid.mjs '<Markdown のパスまたは glob>'` を追加しました。docs-site と同じ Mermaid で、ブラウザを使わずに図の構文を検査し、エラーの文書・開始行・図の種類と未検査の件数を報告します。引数なしでは `docs/` 全体を検査します。本リポジトリでは `npm run lint:mermaid` として `npm run check` と commit 時の hook(変更した Markdown)に組み込みました(PJR-B5TY)。
59
+
60
+ - exec の親の検証に `lint-mermaid`(`npm run lint:mermaid`)を追加しました。`pipeline.parent_validations` に指定でき、利用するリポジトリに `lint:mermaid` script が必要です(PJR-B5TY)。
61
+
62
+ - プロダクトの作業ブランチ名を `repos[].branch_template` と `exec run --branch <repo>=<name>` で選べるようにしました。項目とブランチの対応を runner が記録し、再開・片付けに使います。別項目との名前の重なりは開始前に停止します。`integration_strategy: ff` は merge commit を作らず早送りだけで統合し、分岐した履歴では停止します。未設定時の名前と `merge`・`branch-only` の動作は従来どおりです(PJR-M1DH)。
63
+
64
+ - プロダクトリポジトリの `repos[].commit_subject_template` と `repos[].merge_message_template` で、register の exec が作る commit と merge commit の書式を選べるようにしました。8 種類の変数と空 scope の括弧除去に対応し、本文末尾の `Refs:` は常に付けます。未設定時の書式と SpecDojo の記帳は従来どおりです(PJR-Z7GX)。
65
+
66
+ - 個票に `commit_type` と `commit_scope` を追加し、`register add` / `update` に `--commit-type` と `--commit-scope` を追加しました。Conventional Commits の type・scope を個票ごとに指定でき、`update` では `-` で削除できます。未指定時は項目の type から既定の対応(`issue` は `fix`、`todo`・`change-request` は `feat` など)で解決し、`specdojo.config.json` の `projects.<project-id>.commit_types` や `repos[].commit_types` で対応を上書きできます(PJR-TC62)。
67
+
68
+ - `deliverable scaffold` に `--target <doc-id>` を追加しました。成果物を 1 つだけ指定して雛形を作成できます(`--dct` との併用は不可)。カタログにない成果物は `--target-path` と `--target-rulebook` を指定して作成できます。template のない rulebook でも最小構成の雛形を生成します(PJR-S23T)。
69
+
70
+ - 文脈を渡して成果物を作成する流れ(scaffold・文脈記入・`draft`・`fully-guided`・`finalize`)と、文脈の置き場所(成果物内の `_CONTEXT_:`、個票の `入力` / `--input`、カタログの `brief`)の使い分けを `exec-operation-guide` と `ryu-guide` にまとめました。あわせて `tsd-recipe` の「作成前に集める情報」に文脈の置き場所の対応を追加し、静的サイト向け TSD の技術選定を指示して作成する例を掲載しました(PJR-6A2B)。
71
+
72
+ - schedule に `draft` profile を追加しました。`strategy-planning` で `intent: draft-with-context` を宣言すると、雛形作成・文脈記入(human)→ draft → refine → review → finalize(human)を生成します。human は claim / complete で記録し、文脈記入用の result に雛形作成と `_CONTEXT_:` の案内を表示します(PJR-E45K)。
73
+
74
+ - `register add` / `update` に繰り返し指定できる `--input` を追加しました。対話で得た前提を個票の `入力` 節と event に記録し、register 経由の plan へ完了条件とは別に渡します。update は一覧置換、`--input -` は全削除です(PJR-6DD7)。
75
+
76
+ - 成果物内の文脈の目印 `_CONTEXT_:` を定めました。`draft` で反映した指示を result に記録し、`fully-guided` では未反映の指示を論点として残します。finalize の確認と文書 lint で残りを検出し、lint は `ready` で error、それ以外で warning とします(PJR-JRSY)。
77
+ - `draft` approach を追加しました。文脈で任された範囲を調べて下書きし、選定値を提案として示して出典と選定理由を記録します。register・schedule・plan で使えます(PJR-3MY5)。
78
+
79
+ - 成果物カタログ(dct)の成果物に `brief` を追加しました。成果物の外から継続して渡す前提(技術スタックや制約など)を記載でき、schedule の task の plan および register 経由の plan に「前提」として反映します。`brief` が無い場合は plan に載せません。複数成果物で共有する場合は YAML アンカーを利用できます(PJR-YKMA)。
80
+
81
+ ### 変更
82
+
83
+ - `schedule-design-guide`・`xer-human-draft-template`・`plans-planning.ts` に残っていた雛形作成の案内を、成果物を 1 つだけ作成する `deliverable scaffold --project <project-id> --target <doc-id>` の形にそろえました。これに伴い、カタログ全体の未作成成果物も生成される旨の注意事項を案内から削除しました(PJR-73KT)。
84
+
85
+ - strategy の `guided-pass`(草案作成)の approach を `fully-guided` から `draft` に変更しました。型がそろった未作成成果物を、文脈の記入がなくても template から下書きできます。調査・選定の委任がない範囲は保留し、後続の refine で `fully-guided` による磨き込みを行います。既存 strategy へは再生成時に反映されます(PJR-E45K)。
86
+
87
+ - `@specdojo/docs-lint` の `_CONTEXT_:` の検出において、`status: ready` 以外の文書では warning ではなく情報(info)として報告するように変更しました。下書き時に `_CONTEXT_:` を残したまま実行しても `--frail` 付きの `npm run lint:fm` が失敗せず、親の検証を妨げません。`status: ready` の文書では従来どおり error として失敗させます(PJR-D0GB)。
88
+
89
+ - 配布するオーケストレーターの指示に、対話で得た前提・制約・委任範囲を `--input` で個票の `入力` へ記録し、完了条件と分ける扱いを書き足しました(PJR-6DD7)。
90
+
91
+ - `fully-guided` を既存成果物の磨き込み専用に整理しました。参照は宣言された文書だけとし、対象成果物の `based_on`、個票の `入力`、カタログの `brief` を参照範囲に加えました。`入力`・`brief` の差し込み口は、値が無ければ「なし」と表示します(PJR-3MY5)。
92
+
93
+ ### 不具合修正
94
+
95
+ - `specdojo-tmux.sh.sample` の `find_container` で、ラベル `devcontainer.local_folder` が一致するコンテナが見つからない場合に `vsc-` で始まる別のコンテナへ誤って接続していた問題を修正しました。ラベルの一致するコンテナだけを検索対象とし、見つからない場合は `devcontainer up` を呼び出して起動するようにしました。あわせて `docker exec` の前にコンテナ内の作業ディレクトリの存在を確認し、存在しない場合は明示的なメッセージで停止するようにしました(PJR-P9ZC)。
96
+
97
+ - `decision`・`note`・`epic` など `入力` の章がない種類の個票へ `--input` を指定した際に、末尾に番号のない `## 入力` が追加されて章番号の連続性規約に違反していた問題を修正しました。最初の章の直後に `## 2. 入力` として挿入し、以降の章番号を 1 つずつ繰り下げます。既存の個票に番号のない `## 入力` がある場合も、同様に番号付きの章として適切な位置へ移動します(PJR-790T)。
98
+
99
+ - `deliverable scaffold` の一括生成と `--target` において、template のない rulebook の最小の雛形の `type` を rulebook の frontmatter で宣言された `deliverable_type` に合わせるように修正しました(未宣言時は従来どおり `project`)。これにより、template のない rulebook を指定して生成した雛形が docs-lint の `frontmatter-deliverable-type` で警告にならず、コミット時ガードを通過します(PJR-YKYK)。
100
+
101
+ - `@specdojo/docs-lint` の Markdown / YAML frontmatter 検証において、rulebook 一覧の生成をプロセス内でワークスペースごとに 1 回だけ行いキャッシュするように修正しました。remark のファイルごとのプラグイン読み込みで rulebook 一覧が毎回再生成されて `lint:fm` が著しく低速化していた問題を解消します。本修正は `@specdojo/docs-lint` 0.3.1 で公開済みです(PJR-SC8T)。
102
+
103
+ - `@specdojo/docs-lint` の `remark/md-content` を options なしで読み込んだ場合に `TypeError` で失敗する問題を修正しました。options が渡されないときは空の options として扱い、`schemas` は空、`workspaceRoot` は `process.cwd()` として動作します。これにより options なしでも `_CONTEXT_:` の検出が動作します(PJR-5EN3)。
104
+
5
105
  ## [0.5.0] - 2026-10-29
6
106
 
7
107
  同梱パッケージは `@specdojo/docs-lint` 0.3.0 と `@specdojo/docs-site` 0.3.0 を同時に公開します。docs-lint 0.3.0 は、rulebook の `deliverable_type` と成果物の `type` の照合、YAML 成果物の旧 type のエラー化(下記の破壊的変更の PJR-484B・PJR-0D0T)を含みます。下記の移行手順の検査には docs-lint 0.3.0 が必要です。docs-site 0.3.0 は、生成物の `.vitepress/` への集約(PJR-9ZN5)と、Mermaid の構文エラーで生成を止めない変更(PJR-N9JC)を含みます。
package/README.md CHANGED
@@ -6,7 +6,7 @@ SpecDojo は、Spec道(仕様道)の道場です。
6
6
  **記して、形にして、磨き続ける。**
7
7
 
8
8
  **記帳ひとつから始められます。** 設定 2 行で使い始め、必要になった分だけ広げられます。
9
- 迷いを question として起票し、decision で決め、仕様書に書き、後日 change-request で直すまでを 10 分で体験できます。kata(型)を事前に用意する必要はありません。手順は [Quick Start ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/quick-start-guide.html) 冒頭の「10分で体験する — 仕様の判断台帳」を参照してください。
9
+ 導入と Git flow の初期設定、register での起票と AI 実行、schedule・routine による運用までを対話で体験できます。手順は [Quick Start ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/quick-start-guide.html) を参照してください。
10
10
 
11
11
  | 道場の言葉 | SpecDojo の仕組み |
12
12
  | ---------- | ------------------------------------------------------------------------------------------------------- |
@@ -105,7 +105,7 @@ npm run orch:opus
105
105
  | `claude` | `.claude/agents/specdojo-orchestrator.md` | `npm run orch:opus` ほか |
106
106
  | `opencode` | `.opencode/agents/specdojo-orchestrator.md` | `npm run orch:opencode` |
107
107
  | `codex` | `.specdojo/codex/orchestrator.md` | `npm run orch:sol` ほか |
108
- | `antigravity` | `.specdojo/antigravity/orchestrator.md` | `npm run orch:flash` |
108
+ | `antigravity` | `.specdojo/antigravity/orchestrator.md` | `npm run orch:argon` ほか |
109
109
 
110
110
  各設定を個別に管理したい場合は、後述の「設定を個別に行う場合」にある `config init` と `config scaffold` を使います。
111
111
 
@@ -3,12 +3,14 @@ import { dirname, join } from "node:path";
3
3
  import { dump, load } from "../shared/yaml.js";
4
4
  import { collectResolvedDeliverables } from "./build.js";
5
5
  import { resolveBasePath } from "./paths.js";
6
- import { buildSpecdojoFrontmatter, readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
6
+ import { buildSpecdojoFrontmatter, parseSpecdojoDocument, readSpecdojoNamespace, } from "../docs/frontmatter-namespace.js";
7
7
  import { parsePracticeId, practiceLocalId } from "../shared/practice-id.js";
8
8
  import { resolveKataDocumentPathIfExists } from "../kata/kata.js";
9
9
  import { flattenTemplateFrontmatter } from "../docs/template-frontmatter.js";
10
10
  import { isDctCatalogFileName } from "./types.js";
11
11
  import { resolveSpecdojoPathIfExists, } from "../docs/template-resolution.js";
12
+ import { resolveDeliverableByDocId } from "./document-target.js";
13
+ import { validateDeliverableTargetPath } from "../register/deliverable-target.js";
12
14
  const PROJECT_ID_PLACEHOLDER = "_PROJECT_ID_";
13
15
  const LOCAL_ID_PLACEHOLDER = "_LOCAL_ID_";
14
16
  const DELIVERABLE_NAME_PLACEHOLDER = "_DELIVERABLE_NAME_";
@@ -62,10 +64,8 @@ function normalizeDctName(name) {
62
64
  .replace(/\.ya?ml$/i, "")
63
65
  .replace(/^dct-/, "");
64
66
  }
65
- // Resolve a deliverable template from the rulebook frontmatter declaration. The declaration is
66
- // the SSOT, so local_id naming conventions are deliberately not used as a fallback. This lets
67
- // every deliverable in one rulebook lineage share a single template.
68
- function findTemplate(templatesPath, rulebooksPath, repoRoot, rulebookId, ext, resourceRoots) {
67
+ // Resolve the path to a rulebook file. The declaration is the SSOT.
68
+ function resolveRulebookPath(rulebooksPath, repoRoot, rulebookId, resourceRoots) {
69
69
  if (!rulebookId ||
70
70
  rulebookId === "none" ||
71
71
  rulebookId === "not-needed" ||
@@ -83,11 +83,41 @@ function findTemplate(templatesPath, rulebooksPath, repoRoot, rulebookId, ext, r
83
83
  : resourceRoots
84
84
  ? resolveSpecdojoPathIfExists(`docs/ja/specdojo/rulebooks/${rulebookFileName}`, resourceRoots)
85
85
  : join(rulebooksPath, rulebookFileName);
86
+ if (!rulebookPath || !existsSync(rulebookPath))
87
+ return null;
88
+ return rulebookPath;
89
+ }
90
+ // Resolve a rulebook's declared deliverable_type from its frontmatter.
91
+ // Falls back to "project" if the rulebook is absent, unreadable, or omits deliverable_type.
92
+ function resolveDeliverableType(rulebooksPath, repoRoot, rulebookId, resourceRoots) {
93
+ const rulebookPath = resolveRulebookPath(rulebooksPath, repoRoot, rulebookId, resourceRoots);
94
+ if (!rulebookPath)
95
+ return "project";
96
+ try {
97
+ const meta = readSpecdojoNamespace(readFileSync(rulebookPath, "utf8"));
98
+ if (typeof meta.deliverable_type === "string" && meta.deliverable_type.trim().length > 0) {
99
+ return meta.deliverable_type.trim();
100
+ }
101
+ }
102
+ catch {
103
+ return "project";
104
+ }
105
+ return "project";
106
+ }
107
+ // Resolve a deliverable template from the rulebook frontmatter declaration. The declaration is
108
+ // the SSOT, so local_id naming conventions are deliberately not used as a fallback. This lets
109
+ // every deliverable in one rulebook lineage share a single template.
110
+ function findTemplate(templatesPath, rulebooksPath, repoRoot, rulebookId, ext, resourceRoots) {
111
+ const rulebookPath = resolveRulebookPath(rulebooksPath, repoRoot, rulebookId, resourceRoots);
86
112
  if (!rulebookPath)
87
113
  return null;
88
- if (!existsSync(rulebookPath))
114
+ let templateId;
115
+ try {
116
+ templateId = readSpecdojoNamespace(readFileSync(rulebookPath, "utf8")).template;
117
+ }
118
+ catch {
89
119
  return null;
90
- const templateId = readSpecdojoNamespace(readFileSync(rulebookPath, "utf8")).template;
120
+ }
91
121
  if (typeof templateId !== "string" ||
92
122
  templateId === "none" ||
93
123
  templateId === "not-needed" ||
@@ -112,10 +142,10 @@ function findTemplate(templatesPath, rulebooksPath, repoRoot, rulebookId, ext, r
112
142
  // Minimal Markdown scaffold built from catalog metadata when no template exists.
113
143
  // Fills the generated Frontmatter, an H1 from `name`, the catalog `overview`, and a
114
144
  // single `_TODO_` line so the author knows the body is unwritten.
115
- function fallbackMarkdown(item, projectId) {
145
+ function fallbackMarkdown(item, projectId, deliverableType = "project") {
116
146
  const inner = {
117
147
  id: `${projectId}:${item.local_id}`,
118
- type: "project",
148
+ type: deliverableType,
119
149
  status: "draft",
120
150
  };
121
151
  if (item.rulebook && item.rulebook !== "undecided") {
@@ -129,10 +159,10 @@ function fallbackMarkdown(item, projectId) {
129
159
  return `${frontmatter}\n\n# ${item.name}\n\n${item.overview}\n\n_TODO_: 本文を記述する\n`;
130
160
  }
131
161
  // Minimal YAML scaffold built from catalog metadata when no template exists.
132
- function fallbackYaml(item, projectId) {
162
+ function fallbackYaml(item, projectId, deliverableType = "project") {
133
163
  const doc = {
134
164
  id: `${projectId}:${item.local_id}`,
135
- type: "project",
165
+ type: deliverableType,
136
166
  status: "draft",
137
167
  };
138
168
  if (item.rulebook && item.rulebook !== "undecided") {
@@ -156,14 +186,19 @@ function expandYamlTemplate(templatePath, item, projectId) {
156
186
  function generateContent(item, resolvedPath, projectId, templatesPath, rulebooksPath, repoRoot, resourceRoots) {
157
187
  if (isYamlPath(resolvedPath)) {
158
188
  const template = findTemplate(templatesPath, rulebooksPath, repoRoot, item.rulebook, ".yaml", resourceRoots);
159
- return template ? expandYamlTemplate(template, item, projectId) : fallbackYaml(item, projectId);
189
+ if (template) {
190
+ return expandYamlTemplate(template, item, projectId);
191
+ }
192
+ const deliverableType = resolveDeliverableType(rulebooksPath, repoRoot, item.rulebook, resourceRoots);
193
+ return fallbackYaml(item, projectId, deliverableType);
160
194
  }
161
195
  const template = findTemplate(templatesPath, rulebooksPath, repoRoot, item.rulebook, ".md", resourceRoots);
162
196
  if (template) {
163
197
  const raw = readFileSync(template, "utf8");
164
198
  return replaceGeneratedPlaceholders(flattenTemplateFrontmatter(raw), item, projectId);
165
199
  }
166
- return fallbackMarkdown(item, projectId);
200
+ const deliverableType = resolveDeliverableType(rulebooksPath, repoRoot, item.rulebook, resourceRoots);
201
+ return fallbackMarkdown(item, projectId, deliverableType);
167
202
  }
168
203
  // Materialize the deliverable files a project's catalog points to. Only `kind: work`
169
204
  // items are generated; `control` deliverables have dedicated scaffolds (e.g. register
@@ -236,3 +271,99 @@ export function runGenerate(opts) {
236
271
  }
237
272
  return { written, skipped, errors };
238
273
  }
274
+ function ensureFrontmatterProperties(content, isYaml, expected) {
275
+ if (isYaml) {
276
+ const loaded = load(content);
277
+ const doc = loaded && typeof loaded === "object" && !Array.isArray(loaded) ? loaded : {};
278
+ doc.id = expected.id;
279
+ doc.status = expected.status;
280
+ if (expected.rulebook && expected.rulebook !== "undecided") {
281
+ doc.rulebook = expected.rulebook === "not-needed" ? "none" : expected.rulebook;
282
+ }
283
+ return dump(doc, { lineWidth: 120, noRefs: true });
284
+ }
285
+ const { data, body } = parseSpecdojoDocument(content);
286
+ data.id = expected.id;
287
+ data.status = expected.status;
288
+ if (expected.rulebook && expected.rulebook !== "undecided") {
289
+ data.rulebook = expected.rulebook === "not-needed" ? "none" : expected.rulebook;
290
+ }
291
+ const innerLines = dump(data, { lineWidth: 120, noRefs: true }).replace(/\n+$/, "").split("\n");
292
+ const fm = buildSpecdojoFrontmatter(innerLines);
293
+ return `${fm}\n\n${body.replace(/^\n+/, "")}`;
294
+ }
295
+ export function runGenerateTarget(opts) {
296
+ const { catalogPath, templatesPath, rulebooksPath, repoRoot, projectId, targetId, targetPath, targetRulebook, force, dryRun = false, resourceRoots, } = opts;
297
+ const written = [];
298
+ const skipped = [];
299
+ const errors = [];
300
+ const localId = targetId.includes(":") ? targetId.slice(targetId.indexOf(":") + 1) : targetId;
301
+ const canonicalDocId = targetId.includes(":") ? targetId : `${projectId}:${targetId}`;
302
+ let item;
303
+ let resolvedPath;
304
+ if (catalogPath && existsSync(catalogPath)) {
305
+ try {
306
+ const resolved = resolveDeliverableByDocId(catalogPath, projectId, targetId, repoRoot);
307
+ item = resolved.info.deliverable;
308
+ resolvedPath = resolved.info.resolvedPath;
309
+ }
310
+ catch (error) {
311
+ if (!(error instanceof Error) ||
312
+ !error.message.startsWith("catalog deliverable target not found")) {
313
+ errors.push(error instanceof Error ? error.message : String(error));
314
+ return { written, skipped, errors };
315
+ }
316
+ if (!targetPath || !targetRulebook) {
317
+ errors.push(error.message);
318
+ return { written, skipped, errors };
319
+ }
320
+ }
321
+ }
322
+ if (!item || !resolvedPath) {
323
+ if (!targetPath || !targetRulebook) {
324
+ errors.push(`Catalog-less deliverable ${targetId} requires both --target-path and --target-rulebook`);
325
+ return { written, skipped, errors };
326
+ }
327
+ try {
328
+ resolvedPath = validateDeliverableTargetPath(repoRoot, canonicalDocId, targetPath);
329
+ }
330
+ catch (err) {
331
+ errors.push(err instanceof Error ? err.message : String(err));
332
+ return { written, skipped, errors };
333
+ }
334
+ item = {
335
+ local_id: localId,
336
+ name: localId,
337
+ kind: "work",
338
+ overview: "",
339
+ path: resolvedPath,
340
+ rulebook: targetRulebook,
341
+ };
342
+ }
343
+ if (item.kind !== "work") {
344
+ errors.push(`Deliverable ${targetId} is kind '${item.kind}', only 'work' deliverables can be scaffolded`);
345
+ return { written, skipped, errors };
346
+ }
347
+ const outputPath = join(repoRoot, resolvedPath);
348
+ if (existsSync(outputPath) && !force) {
349
+ skipped.push(resolvedPath);
350
+ return { written, skipped, errors };
351
+ }
352
+ try {
353
+ let content = generateContent(item, resolvedPath, projectId, templatesPath, rulebooksPath, repoRoot, resourceRoots);
354
+ content = ensureFrontmatterProperties(content, isYamlPath(resolvedPath), {
355
+ id: canonicalDocId,
356
+ status: "draft",
357
+ rulebook: item.rulebook,
358
+ });
359
+ if (!dryRun) {
360
+ mkdirSync(dirname(outputPath), { recursive: true });
361
+ writeFileSync(outputPath, content, "utf8");
362
+ }
363
+ written.push(resolvedPath);
364
+ }
365
+ catch (err) {
366
+ errors.push(`${resolvedPath}: ${err instanceof Error ? err.message : String(err)}`);
367
+ }
368
+ return { written, skipped, errors };
369
+ }
@@ -1,7 +1,40 @@
1
+ import { antigravityRole, antigravitySessionArguments } from "../exec/antigravity-session.js";
2
+ import { productRootsFromEnvironment } from "../exec/task-repos.js";
3
+ import { runOrchestratorLaunch } from "./orchestrator.js";
1
4
  import { AGENT_RUN_RATE_LIMIT_EXIT_CODE, runAgentPlan, writeAgentOutput, } from "../exec/agent-plan.js";
2
5
  export { AGENT_RUN_RATE_LIMIT_EXIT_CODE, resolveAgentMember, resolveAgentCommand, readAgentPlan, writeAgentOutput, runAgentPlan, } from "../exec/agent-plan.js";
3
6
  export function registerAgentCommands(program) {
4
7
  const agent = program.command("agent").description("Run a plan with a specific agent");
8
+ agent
9
+ .command("launch")
10
+ .description("Launch agy with role-specific session permissions and runner-declared roots")
11
+ .requiredOption("--provider <name>", "Provider CLI (antigravity)")
12
+ .requiredOption("--role <role>", "Pipeline role (edit|review|report)")
13
+ .argument("[providerArgs...]", "agy arguments after --")
14
+ .action(async (providerArgs, options) => {
15
+ try {
16
+ if (options.provider !== "antigravity" || options.role === "orchestrator") {
17
+ throw new Error("agent launch requires antigravity and a pipeline role (edit|review|report)");
18
+ }
19
+ const cwd = process.cwd();
20
+ const args = antigravitySessionArguments({
21
+ role: antigravityRole(options.role),
22
+ cwd,
23
+ repoRoots: productRootsFromEnvironment(process.env).map((repo) => repo.path),
24
+ providerArgs,
25
+ });
26
+ process.exitCode = await runOrchestratorLaunch({
27
+ command: "agy",
28
+ args,
29
+ cwd,
30
+ env: { ...process.env },
31
+ });
32
+ }
33
+ catch (error) {
34
+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
35
+ process.exitCode = 1;
36
+ }
37
+ });
5
38
  agent
6
39
  .command("run")
7
40
  .description("Feed a plan to one agent and capture its stdout")
@@ -17,6 +17,8 @@ const PARENT_VALIDATION_SCRIPTS = {
17
17
  "lint-ts": "lint:ts",
18
18
  "lint-fm": "lint:fm",
19
19
  "lint-md": "lint:md",
20
+ "lint-mermaid": "lint:mermaid",
21
+ "lint-d2": "lint:d2",
20
22
  "test-integration": "test:integration",
21
23
  "validate-schema": "validate:schema",
22
24
  typecheck: "typecheck",
@@ -2,6 +2,7 @@ import { spawn } from "node:child_process";
2
2
  import { constants as osConstants } from "node:os";
3
3
  import { resolve } from "node:path";
4
4
  import { agentExtraRootArguments, resolveProductRepos } from "../exec/task-repos.js";
5
+ import { antigravitySessionArguments } from "../exec/antigravity-session.js";
5
6
  import { loadConfig, resolveExternalProjects, specdojoRootDir, } from "../shared/specdojo-config.js";
6
7
  import { registerNightOrchestratorCommand } from "./night-orchestrator.js";
7
8
  const ORCHESTRATOR_EXECUTABLES = {
@@ -108,7 +109,15 @@ function inlineOpenCodeConfig(current, agentName, repoRoots) {
108
109
  export function buildOrchestratorLaunch(options) {
109
110
  const env = { ...(options.env ?? process.env) };
110
111
  const args = [...options.providerArgs];
111
- if (options.provider === "opencode" && options.repoRoots.length > 0) {
112
+ if (options.provider === "antigravity") {
113
+ args.splice(0, args.length, ...antigravitySessionArguments({
114
+ role: "orchestrator",
115
+ cwd: options.cwd,
116
+ repoRoots: options.repoRoots,
117
+ providerArgs: args,
118
+ }));
119
+ }
120
+ else if (options.provider === "opencode" && options.repoRoots.length > 0) {
112
121
  env.OPENCODE_CONFIG_CONTENT = inlineOpenCodeConfig(env.OPENCODE_CONFIG_CONTENT, opencodeAgentName(args), options.repoRoots);
113
122
  }
114
123
  else {
@@ -1,9 +1,31 @@
1
1
  import { existsSync } from "node:fs";
2
2
  import { addProjectOption, printCommandError, resolveCatalogPath } from "../catalog/catalog.js";
3
- import { runGenerate } from "../catalog/generate.js";
4
- import { specdojoRootDir } from "../shared/specdojo-config.js";
3
+ import { runGenerate, runGenerateTarget } from "../catalog/generate.js";
4
+ import { deriveProjectId } from "../catalog/scaffold.js";
5
+ import { loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
5
6
  import { resolveSpecdojoPath } from "../docs/template-resolution.js";
6
7
  import { applyTrash, planTrash } from "./trash.js";
8
+ function resolveTargetProjectId(opts, catalogPath, targetId) {
9
+ if (opts.projectId?.trim())
10
+ return opts.projectId.trim();
11
+ if (opts.project?.trim())
12
+ return opts.project.trim();
13
+ if (process.env.SPECDOJO_PROJECT?.trim())
14
+ return process.env.SPECDOJO_PROJECT.trim();
15
+ if (catalogPath) {
16
+ const derived = deriveProjectId(catalogPath);
17
+ if (derived)
18
+ return derived;
19
+ }
20
+ const config = loadConfig().config;
21
+ if (config && Object.keys(config.projects).length > 0) {
22
+ return Object.keys(config.projects)[0];
23
+ }
24
+ if (targetId.includes(":")) {
25
+ return targetId.slice(0, targetId.indexOf(":"));
26
+ }
27
+ throw new Error("No project specified. Use --project <id> or --project-id <id>.");
28
+ }
7
29
  function collectCommaSeparated(value, previous) {
8
30
  return [
9
31
  ...previous,
@@ -23,11 +45,24 @@ export function registerDeliverableCommands(program) {
23
45
  addProjectOption(scaffold);
24
46
  scaffold.option("--project-id <projectId>", "Project ID to embed (e.g. prj-0001); derived from each dct-*.yaml if omitted");
25
47
  scaffold.option("--dct <name>", "Limit to specific dct-*.yaml (repeatable / comma-separated; with or without 'dct-' prefix and '.yaml')", collectCommaSeparated, []);
48
+ scaffold.option("--target <targetId>", "Scaffold only a single deliverable by document id");
49
+ scaffold.option("--target-path <targetPath>", "Repository-relative file path for catalog-less deliverable");
50
+ scaffold.option("--target-rulebook <targetRulebook>", "Rulebook document id for catalog-less deliverable");
26
51
  scaffold.option("--force", "Overwrite existing files", false);
27
52
  scaffold.option("--dry-run", "Print planned files without writing", false);
28
53
  scaffold.action((opts) => {
29
54
  try {
30
- const catalogPath = resolveCatalogPath(opts);
55
+ const dctList = opts.dct ?? [];
56
+ const hasDct = dctList.length > 0;
57
+ const target = typeof opts.target === "string" ? opts.target.trim() : "";
58
+ const targetPath = typeof opts.targetPath === "string" ? opts.targetPath.trim() : undefined;
59
+ const targetRulebook = typeof opts.targetRulebook === "string" ? opts.targetRulebook.trim() : undefined;
60
+ if (target && hasDct) {
61
+ throw new Error("Cannot specify both --target and --dct");
62
+ }
63
+ if (!target && (targetPath || targetRulebook)) {
64
+ throw new Error("--target-path and --target-rulebook require --target");
65
+ }
31
66
  const templatesPath = resolveSpecdojoPath("docs/ja/specdojo/templates");
32
67
  const rulebooksPath = resolveSpecdojoPath("docs/ja/specdojo/rulebooks");
33
68
  if (!existsSync(templatesPath)) {
@@ -36,6 +71,44 @@ export function registerDeliverableCommands(program) {
36
71
  if (!existsSync(rulebooksPath)) {
37
72
  throw new Error(`Rulebooks directory not found: ${rulebooksPath}`);
38
73
  }
74
+ if (target) {
75
+ const repoRoot = specdojoRootDir();
76
+ let catalogPath;
77
+ try {
78
+ catalogPath = resolveCatalogPath(opts);
79
+ }
80
+ catch (error) {
81
+ if (!targetPath || !targetRulebook) {
82
+ throw error;
83
+ }
84
+ }
85
+ const projectId = resolveTargetProjectId(opts, catalogPath, target);
86
+ const { written, skipped, errors } = runGenerateTarget({
87
+ catalogPath,
88
+ templatesPath,
89
+ rulebooksPath,
90
+ repoRoot,
91
+ projectId,
92
+ targetId: target,
93
+ targetPath,
94
+ targetRulebook,
95
+ force: !!opts.force,
96
+ dryRun: !!opts.dryRun,
97
+ resourceRoots: { repositoryRoot: repoRoot },
98
+ });
99
+ const createdLabel = opts.dryRun ? "Would create" : "Created";
100
+ for (const error of errors)
101
+ process.stdout.write(`ERROR: ${error}\n`);
102
+ for (const path of written)
103
+ process.stdout.write(`${createdLabel}: ${path}\n`);
104
+ for (const path of skipped) {
105
+ process.stdout.write(`Skipped (already exists; use --force to overwrite): ${path}\n`);
106
+ }
107
+ if (errors.length > 0)
108
+ process.exitCode = 1;
109
+ return;
110
+ }
111
+ const catalogPath = resolveCatalogPath(opts);
39
112
  const { written, skipped, errors } = runGenerate({
40
113
  catalogPath,
41
114
  templatesPath,
@@ -44,7 +117,7 @@ export function registerDeliverableCommands(program) {
44
117
  projectId: opts.projectId ?? null,
45
118
  force: !!opts.force,
46
119
  dryRun: !!opts.dryRun,
47
- dctNames: opts.dct ?? [],
120
+ dctNames: dctList,
48
121
  resourceRoots: { repositoryRoot: specdojoRootDir() },
49
122
  });
50
123
  const createdLabel = opts.dryRun ? "Would create" : "Created";
@@ -1,4 +1,5 @@
1
1
  import { runDevcontainerScaffold } from "./scaffold.js";
2
+ import { runDevcontainerHostScript } from "./host-script.js";
2
3
  import { specdojoPackageRootDir } from "../shared/package-paths.js";
3
4
  import { specdojoRootDir } from "../shared/specdojo-config.js";
4
5
  export function registerDevcontainerCommands(program) {
@@ -44,4 +45,21 @@ export function registerDevcontainerCommands(program) {
44
45
  process.exitCode = 1;
45
46
  }
46
47
  });
48
+ dc.command("host-script")
49
+ .description("Write the devcontainer tmux host script into .specdojo/host/")
50
+ .option("--dry-run", "Show planned files without writing", false)
51
+ .action(async (opts) => {
52
+ try {
53
+ await runDevcontainerHostScript({
54
+ packageRoot: specdojoPackageRootDir(),
55
+ repoRoot: specdojoRootDir(),
56
+ dryRun: !!opts.dryRun,
57
+ });
58
+ }
59
+ catch (error) {
60
+ const message = error instanceof Error ? error.message : String(error);
61
+ process.stderr.write(`${message}\n`);
62
+ process.exitCode = 1;
63
+ }
64
+ });
47
65
  }
@@ -0,0 +1,21 @@
1
+ import { existsSync } from "node:fs";
2
+ import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
3
+ import * as path from "node:path";
4
+ export async function runDevcontainerHostScript(opts) {
5
+ const { packageRoot, repoRoot, dryRun } = opts;
6
+ const templatePath = path.join(packageRoot, "templates", "devcontainer", "remote-host", "devcontainer-tmux.sh");
7
+ if (!existsSync(templatePath)) {
8
+ throw new Error(`Host script template not found: ${templatePath}`);
9
+ }
10
+ const hostScriptContent = await readFile(templatePath, "utf8");
11
+ const hostDir = path.join(repoRoot, ".specdojo", "host");
12
+ const destPath = path.join(hostDir, "devcontainer-tmux.sh");
13
+ if (dryRun) {
14
+ process.stdout.write(`[dry-run] would write: .specdojo/host/devcontainer-tmux.sh\n`);
15
+ return;
16
+ }
17
+ await mkdir(hostDir, { recursive: true });
18
+ await writeFile(destPath, hostScriptContent, "utf8");
19
+ await chmod(destPath, 0o755);
20
+ process.stdout.write(`Written: .specdojo/host/devcontainer-tmux.sh\n`);
21
+ }