specdojo 0.6.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 (60) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/README.md +2 -2
  3. package/dist/commands/agent.js +33 -0
  4. package/dist/commands/init.js +1 -0
  5. package/dist/commands/orchestrator.js +10 -1
  6. package/dist/devcontainer/command.js +18 -0
  7. package/dist/devcontainer/host-script.js +21 -0
  8. package/dist/devcontainer/scaffold.js +4 -3
  9. package/dist/exec/antigravity-session.js +154 -0
  10. package/dist/exec/parent-validation.js +7 -0
  11. package/dist/exec/plan-markdownlint.js +89 -0
  12. package/dist/exec/plans-generation.js +6 -2
  13. package/dist/exec/register-resume.js +28 -0
  14. package/dist/exec/run/lifecycle-commands.js +85 -16
  15. package/dist/exec/run/register-command.js +6 -0
  16. package/dist/exec/run/schedule-mode.js +22 -2
  17. package/dist/exec/run/schedule-prepare.js +42 -1
  18. package/dist/exec/run/schedule-task.js +3 -0
  19. package/dist/exec/worktree-ops-commit.js +1 -13
  20. package/dist/exec/worktree-ops-lifecycle.js +40 -36
  21. package/dist/register/register.js +31 -23
  22. package/dist/shared/git.js +7 -0
  23. package/dist/shared/provider-scaffold.js +2 -0
  24. package/dist/shared/specdojo-gitignore.js +1 -0
  25. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  26. package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
  27. package/docs/ja/specdojo/guides/exec-config-guide.md +14 -12
  28. package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -8
  29. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  30. package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
  31. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
  32. package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
  33. package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
  34. package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
  35. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  36. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
  37. package/docs/ja/specdojo/references/command-reference.md +69 -37
  38. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  39. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  40. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  41. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  42. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
  43. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  44. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
  45. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  46. package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
  47. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
  48. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  49. package/package.json +5 -2
  50. package/templates/antigravity/README.md +19 -46
  51. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  52. package/templates/antigravity/settings.edit.json +73 -0
  53. package/templates/antigravity/settings.orchestrator.json +15 -0
  54. package/templates/antigravity/settings.report.json +7 -0
  55. package/templates/antigravity/settings.review.json +7 -0
  56. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  57. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  58. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  59. package/templates/init-agent-members.yaml +1 -0
  60. package/templates/init-exec-defaults.yaml +1 -1
@@ -0,0 +1,217 @@
1
+ #!/usr/bin/env bash
2
+ #
3
+ # devcontainer-tmux.sh
4
+ #
5
+ # SpecDojo が配布する、ホストから devcontainer 内の tmux セッションへ入るためのスクリプト本体です。
6
+ # workspace の .specdojo/host/devcontainer-tmux.sh へ書き出され、ホスト側のラッパーから呼ばれます。
7
+ #
8
+ # 対応 OS:
9
+ # - macOS
10
+ # - Linux
11
+ # - Windows WSL2
12
+ #
13
+ set -euo pipefail
14
+
15
+ if [ $# -lt 1 ] || [ -z "${1:-}" ]; then
16
+ echo "Usage: $0 <workspace-path>" >&2
17
+ exit 1
18
+ fi
19
+
20
+ workspace_dir_input="$1"
21
+ if [ ! -d "$workspace_dir_input" ]; then
22
+ echo "Workspace directory not found: $workspace_dir_input" >&2
23
+ exit 1
24
+ fi
25
+
26
+ workspace_dir="$(cd "$workspace_dir_input" && pwd -P)"
27
+
28
+ devcontainer_json="$workspace_dir/.devcontainer/devcontainer.json"
29
+ if [ ! -f "$devcontainer_json" ]; then
30
+ if [ -f "$workspace_dir/.devcontainer.json" ]; then
31
+ devcontainer_json="$workspace_dir/.devcontainer.json"
32
+ else
33
+ echo "devcontainer.json was not found in $workspace_dir" >&2
34
+ exit 1
35
+ fi
36
+ fi
37
+
38
+ remote_user="$(sed -E -e 's,//.*$,,' -e 's,/\*.*\*/,,' "$devcontainer_json" | grep -E '"remoteUser"[[:space:]]*:' | head -n 1 | sed -E 's/.*"remoteUser"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/' || true)"
39
+
40
+ if [ -z "$remote_user" ]; then
41
+ echo "remoteUser is not defined in $devcontainer_json" >&2
42
+ exit 1
43
+ fi
44
+
45
+ # docker の探索は最初の呼び出しより前に行う。SSH の PATH だけには依存しない。
46
+ docker_dir=""
47
+ docker_search_path="$PATH"
48
+ docker_login_shell="${SHELL:-/bin/bash}"
49
+ docker_candidates=(
50
+ /usr/local/bin
51
+ /opt/homebrew/bin
52
+ "${HOME:-}/.docker/bin"
53
+ /Applications/Docker.app/Contents/Resources/bin
54
+ /snap/bin
55
+ /usr/bin
56
+ )
57
+
58
+ select_docker() {
59
+ local candidate="$1" candidate_dir
60
+ # command -v が返す alias や関数の説明は受け付けない。
61
+ case "$candidate" in
62
+ */docker) ;;
63
+ *) return 1 ;;
64
+ esac
65
+ [ -f "$candidate" ] && [ -x "$candidate" ] || return 1
66
+ candidate_dir="${candidate%/*}"
67
+ candidate_dir="$(cd "${candidate_dir:-/}" && pwd -P)" || return 1
68
+ docker_dir="$candidate_dir"
69
+ }
70
+
71
+ docker_hint() {
72
+ local failure="$1" host_os kernel
73
+ host_os="$(uname -s 2>/dev/null || true)"
74
+ kernel="$(uname -r 2>/dev/null || true)"
75
+ case "$host_os" in
76
+ Darwin)
77
+ if [ "$failure" = missing ]; then
78
+ echo "macOS: Install Docker Desktop." >&2
79
+ else
80
+ echo "macOS: Start Docker Desktop and check the Docker context." >&2
81
+ fi
82
+ ;;
83
+ Linux)
84
+ if printf '%s\n' "$kernel" | grep -qi microsoft || grep -qi microsoft /proc/version 2>/dev/null; then
85
+ echo "WSL2: Start Docker Desktop and enable WSL integration for this distribution." >&2
86
+ elif [ "$failure" = missing ]; then
87
+ echo "Linux: Install Docker Engine." >&2
88
+ else
89
+ echo "Linux: Start the docker service and check membership in the docker group (then log in again)." >&2
90
+ fi
91
+ ;;
92
+ *) echo "Install and start Docker, and check the Docker context and access permissions." >&2 ;;
93
+ esac
94
+ }
95
+
96
+ if [ -n "${SPECDOJO_DOCKER_BIN:-}" ]; then
97
+ # 明示指定はディレクトリ。誤指定を別の Docker で隠さず、下で診断する。
98
+ select_docker "$SPECDOJO_DOCKER_BIN/docker" || true
99
+ else
100
+ if ! select_docker "$(command -v docker || true)"; then
101
+ # 起動時のメッセージを無視し、問い合わせの印が付いた実行ファイルだけを採る。
102
+ # shellcheck disable=SC2016
103
+ login_output="$("$docker_login_shell" -lc 'printf "\n__SPECDOJO_DOCKER__"; command -v docker' 2>/dev/null)" || login_output=""
104
+ while IFS= read -r line; do
105
+ case "$line" in
106
+ __SPECDOJO_DOCKER__*)
107
+ if select_docker "${line#__SPECDOJO_DOCKER__}"; then
108
+ break
109
+ fi
110
+ ;;
111
+ esac
112
+ done <<< "$login_output"
113
+ if [ -z "$docker_dir" ]; then
114
+ for candidate_dir in "${docker_candidates[@]}"; do
115
+ if select_docker "$candidate_dir/docker"; then
116
+ break
117
+ fi
118
+ done
119
+ fi
120
+ fi
121
+ fi
122
+
123
+ if [ -z "$docker_dir" ]; then
124
+ echo "Docker executable not found." >&2
125
+ if [ -n "${SPECDOJO_DOCKER_BIN:-}" ]; then
126
+ echo "Searched SPECDOJO_DOCKER_BIN: $SPECDOJO_DOCKER_BIN/docker (must be an executable file)." >&2
127
+ else
128
+ echo "Searched PATH: $docker_search_path" >&2
129
+ echo "Queried login shell: $docker_login_shell -lc 'command -v docker'" >&2
130
+ printf 'Searched directory: %s\n' "${docker_candidates[@]}" >&2
131
+ fi
132
+ docker_hint missing
133
+ exit 1
134
+ fi
135
+
136
+ export PATH="$docker_dir:$PATH"
137
+ if ! docker info >/dev/null 2>&1; then
138
+ echo "Docker is not usable: $docker_dir/docker (docker info failed)." >&2
139
+ docker_hint unavailable
140
+ exit 1
141
+ fi
142
+
143
+ # 1. 動いているコンテナを探す
144
+ container_id="$(docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
145
+
146
+ # 2. 止まっているコンテナがあれば docker start で起こす
147
+ if [ -z "$container_id" ]; then
148
+ stopped_id="$(docker ps -a -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
149
+ if [ -n "$stopped_id" ]; then
150
+ docker start "$stopped_id" >/dev/null
151
+ container_id="$stopped_id"
152
+ fi
153
+ fi
154
+
155
+ # 3. コンテナが無いときだけ devcontainer up を動かす
156
+ if [ -z "$container_id" ]; then
157
+ echo "Starting devcontainer for $workspace_dir..." >&2
158
+ if [ -n "${SPECDOJO_NODE_BIN:-}" ]; then
159
+ PATH="$docker_dir:$SPECDOJO_NODE_BIN:$PATH" devcontainer up --workspace-folder "$workspace_dir" >&2
160
+ else
161
+ # shellcheck disable=SC2016
162
+ "${SHELL:-/bin/bash}" -lic 'export PATH="$1:$PATH"; exec devcontainer up --workspace-folder "$2"' devcontainer-launcher "$docker_dir" "$workspace_dir" >&2
163
+ fi
164
+ container_id="$(docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
165
+ fi
166
+
167
+ if [ -z "$container_id" ]; then
168
+ echo "Failed to start or find devcontainer for $workspace_dir" >&2
169
+ exit 1
170
+ fi
171
+
172
+ # 4. コンテナ内の作業ディレクトリをマウント情報から求める
173
+ mounts_info="$(docker inspect --format '{{range .Mounts}}{{printf "%s\t%s\t%s\n" .Type .Source .Destination}}{{end}}' "$container_id")"
174
+ best_match_src=""
175
+ best_match_dst=""
176
+
177
+ while IFS=$'\t' read -r m_type m_src m_dst; do
178
+ [ "$m_type" != "bind" ] && continue
179
+ [ -z "$m_src" ] && continue
180
+
181
+ norm_src="$m_src"
182
+ if [ -d "$m_src" ]; then
183
+ norm_src="$(cd "$m_src" && pwd -P)"
184
+ fi
185
+
186
+ if [ "$workspace_dir" = "$norm_src" ]; then
187
+ best_match_src="$norm_src"
188
+ best_match_dst="$m_dst"
189
+ break
190
+ elif [ "${workspace_dir#"$norm_src"/}" != "$workspace_dir" ]; then
191
+ if [ ${#norm_src} -gt ${#best_match_src} ]; then
192
+ best_match_src="$norm_src"
193
+ best_match_dst="$m_dst"
194
+ fi
195
+ fi
196
+ done <<< "$mounts_info"
197
+
198
+ if [ -z "$best_match_src" ]; then
199
+ echo "Could not determine container workspace directory from mounts for: $workspace_dir" >&2
200
+ exit 1
201
+ fi
202
+
203
+ if [ "$workspace_dir" = "$best_match_src" ]; then
204
+ container_workspace_dir="$best_match_dst"
205
+ else
206
+ rel_path="${workspace_dir#"$best_match_src"/}"
207
+ container_workspace_dir="${best_match_dst%/}/$rel_path"
208
+ fi
209
+
210
+ if ! docker exec "$container_id" test -d "$container_workspace_dir"; then
211
+ echo "Workspace directory '$container_workspace_dir' does not exist in container '$container_id'." >&2
212
+ exit 1
213
+ fi
214
+
215
+ # 5. tmux セッションへ入る
216
+ session_name="${SPECDOJO_TMUX_SESSION:-specdojo}"
217
+ exec docker exec -it --detach-keys="ctrl-]" -u "$remote_user" -w "$container_workspace_dir" "$container_id" tmux new-session -A -s "$session_name"
@@ -5,104 +5,16 @@
5
5
  # 常時稼働ホスト上で devcontainer 内の tmux セッションへ入るためのスクリプトです。
6
6
  # ホスト側の ~/bin/specdojo-tmux.sh などへコピーし、実行権限(chmod +x)を付与して使用してください。
7
7
  #
8
- # 前提ツール:
9
- # - Docker (Docker Desktop または Docker Engine): コンテナの実行環境
10
- # - Dev Container CLI (@devcontainers/cli): コンテナの起動に使用 (npm install -g @devcontainers/cli)
11
- # - tmux: コンテナ内にインストールされている必要があります
12
- #
13
- # 起動コマンド:
14
- # - コンテナ起動: devcontainer up --workspace-folder "$workspace_dir"
15
- # - セッション接続: docker exec -it ... tmux new-session -A -s <名前>
16
- #
17
- # コンテナの特定(ラベルの一致):
18
- # - スクリプトはラベル devcontainer.local_folder が workspace_dir と一致する
19
- # コンテナを探して接続します。
20
- # - ラベルが workspace_dir と一致しないと、devcontainer up が別の新しいコンテナを作ります。
21
- # - 既存コンテナのラベルは次のコマンドで確認できます:
22
- # docker inspect <id> --format '{{index .Config.Labels "devcontainer.local_folder"}}'
8
+ # 実際の処理本体は各 workspace の .specdojo/host/devcontainer-tmux.sh が行います。
9
+ # 本体のスクリプトは `npx specdojo devcontainer host-script` で書き出せます。
23
10
  #
24
- # 利用者(ユーザー)の変更:
25
- # - devcontainer.json の remoteUser(既定は node)に合わせて -u でコンテナに入ります。
26
- # - remoteUser を変更した場合は、下記 container_user の値を変更してください。
27
- #
28
- # PATH の設定(SSH 経由での実行):
29
- # - ssh の RemoteCommand は非対話シェルで動くため、Mac の通常端末で読み込まれる
30
- # ~/.zshrc などの PATH の設定が反映されません。
31
- # - ホスト側の通常端末で node と devcontainer の配置場所を確認し、必要に応じて
32
- # 下記 node_bin_dir を設定してください:
33
- # dirname "$(command -v devcontainer)"
34
- # - Homebrew の例: node_bin_dir="/opt/homebrew/bin"
35
- # - nvm の例: node_bin_dir="$HOME/.nvm/versions/node/v22.0.0/bin"
36
- # - mise の例: node_bin_dir="$HOME/.local/share/mise/installs/node/24/bin"
37
- # - node と Dev Container CLI は同じ node_bin_dir にあることを前提とします。
11
+ # 前提ツール:
12
+ # - Docker (Docker Desktop または Docker Engine)
13
+ # - Dev Container CLI (@devcontainers/cli): コンテナ未作成時のみ起動に使用
38
14
  #
39
15
  set -euo pipefail
40
16
 
41
- # コンテナ内とホスト側の作業ディレクトリ(実際の環境に合わせて設定してください)
42
- container_workspace_dir="/workspaces/<workspace-name>/<repo-name>"
43
- workspace_dir="${HOME}/<path-to-workspace>/<repo-name>"
44
-
45
- # コンテナ内の実行ユーザー(devcontainer.json の remoteUser に合わせます。既定は node です)
46
- # remoteUser を変更した場合は、この値を変更してください。
47
- container_user="node"
48
-
49
- # セッション名(必要に応じて変更してください)
50
- session_name="specdojo"
51
-
52
- # Mac や Linux の通常端末で確認した実際のディレクトリへ置き換えてください。
53
- # Homebrew の例: node_bin_dir="/opt/homebrew/bin"
54
- # nvm の例: node_bin_dir="$HOME/.nvm/versions/node/v22.0.0/bin"
55
- # mise の例: node_bin_dir="$HOME/.local/share/mise/installs/node/24/bin"
56
- # node と Dev Container CLI は同じ node_bin_dir にあることを前提とします。
57
- node_bin_dir="/absolute/path/to/node/bin"
58
- export PATH="$node_bin_dir:/opt/homebrew/bin:/usr/local/bin:$PATH"
59
-
60
- find_container() {
61
- docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1
62
- }
63
-
64
- if [ ! -f "$workspace_dir/.devcontainer/devcontainer.json" ]; then
65
- echo "devcontainer.json was not found: $workspace_dir" >&2
66
- echo "Set workspace_dir to the repository path on the host." >&2
67
- exit 1
68
- fi
69
-
70
- if ! command -v devcontainer >/dev/null 2>&1; then
71
- echo "Dev Container CLI is not installed or not in PATH." >&2
72
- echo "Current PATH: $PATH" >&2
73
- echo "Check the location on the host terminal with: dirname \"\$(command -v devcontainer)\"" >&2
74
- echo "Install it with: npm install -g @devcontainers/cli" >&2
75
- exit 1
76
- fi
77
-
78
- if ! command -v docker >/dev/null 2>&1; then
79
- echo "Docker command was not found in PATH." >&2
80
- echo "Current PATH: $PATH" >&2
81
- echo "Check the location on the host terminal with: dirname \"\$(command -v docker)\"" >&2
82
- exit 1
83
- fi
84
-
85
- if ! docker info >/dev/null 2>&1; then
86
- echo "Docker is not running on the host." >&2
87
- exit 1
88
- fi
89
-
90
- container_name="$(find_container)"
91
-
92
- if [ -z "$container_name" ]; then
93
- echo "Starting devcontainer..." >&2
94
- devcontainer up --workspace-folder "$workspace_dir" >&2
95
- container_name="$(find_container)"
96
- fi
97
-
98
- if [ -z "$container_name" ]; then
99
- echo "The devcontainer did not start." >&2
100
- exit 1
101
- fi
102
-
103
- if ! docker exec "$container_name" test -d "$container_workspace_dir"; then
104
- echo "Workspace directory '$container_workspace_dir' was not found in container '$container_name'." >&2
105
- exit 1
106
- fi
17
+ # ホスト上のワークスペースのパス(実際の配置場所に合わせて書き換えてください)
18
+ workspace_dir="${1:-$HOME/<path-to-workspace>/<repo-name>}"
107
19
 
108
- exec docker exec -it --detach-keys="ctrl-]" -u "$container_user" -w "$container_workspace_dir" "$container_name" tmux new-session -A -s "$session_name"
20
+ exec bash "$workspace_dir/.specdojo/host/devcontainer-tmux.sh" "$workspace_dir"
@@ -8,8 +8,10 @@ Host <host>
8
8
 
9
9
  # devcontainer 内の tmux セッションへ直接入る接続用
10
10
  # RemoteCommand は非対話シェルで動くため、接続先端末の ~/.zshrc などの PATH 設定は読み込まれません。
11
+ # 通常の接続(コンテナ稼働中または停止中)では Node.js は不要です(docker のみ使用)。
12
+ # コンテナ未作成時のみ Dev Container CLI が自動起動されます。
11
13
  # 接続元から「ssh <host> 'command -v devcontainer'」を実行して Dev Container CLI が見つかるか確認できます。
12
- # 見つからない場合は、ホスト側の ~/bin/specdojo-tmux.sh の node_bin_dir を設定してください。
14
+ # 見つからない場合は、ホストの環境変数 SPECDOJO_NODE_BIN を設定するか、ログインシェルの PATH を確認してください。
13
15
  Host <host>-tmux
14
16
  HostName <host>
15
17
  User <user>
@@ -282,6 +282,7 @@ members:
282
282
  type: agent
283
283
  provider: antigravity
284
284
  model: gemini-3.8-flash-high
285
+ mode: report
285
286
  stage_role: reporter
286
287
  capabilities: []
287
288
  proficiency: normal
@@ -92,7 +92,7 @@ providers:
92
92
  # 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
93
93
  # expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
94
94
  # model の ID は実体の member の model に書く(PJR-ZM1K)。
95
- command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
95
+ command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
96
96
  rate_limit_detection:
97
97
  stderr_patterns: [rate limit, "429", quota, RESOURCE_EXHAUSTED]
98
98
  copilot: