specdojo 0.5.0 → 0.6.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.
- package/.github/agents/specdojo-orchestrator.md +2 -0
- package/CHANGELOG.md +60 -0
- package/dist/catalog/generate.js +144 -13
- package/dist/commands/init.js +1 -0
- package/dist/deliverable/deliverable.js +77 -4
- package/dist/exec/core.js +1 -0
- package/dist/exec/parent-validation.js +7 -0
- package/dist/exec/plans-core.js +46 -1
- package/dist/exec/plans-generation.js +39 -3
- package/dist/exec/plans-planning.js +1 -1
- package/dist/exec/plans-storage.js +1 -0
- package/dist/exec/product-branch-records.js +105 -0
- package/dist/exec/product-branches.js +52 -0
- package/dist/exec/register-product-message.js +50 -0
- package/dist/exec/register.js +6 -0
- package/dist/exec/repo-integration-sync.js +4 -2
- package/dist/exec/repo-integration.js +41 -4
- package/dist/exec/repo-trace.js +2 -0
- package/dist/exec/results.js +9 -5
- package/dist/exec/run/register-command.js +16 -0
- package/dist/exec/run/register-resume.js +11 -1
- package/dist/exec/run/register-worktree.js +29 -8
- package/dist/exec/run/schedule-prepare.js +7 -3
- package/dist/exec/strategy.js +2 -1
- package/dist/exec/task-repos.js +78 -16
- package/dist/exec/worktree-command.js +2 -2
- package/dist/exec/worktree.js +3 -3
- package/dist/register/core.js +5 -0
- package/dist/register/create-commands.js +54 -2
- package/dist/register/deliverable-target.js +24 -17
- package/dist/register/event-merge.js +4 -0
- package/dist/register/events.js +6 -0
- package/dist/register/external-project.js +2 -0
- package/dist/register/input.js +168 -0
- package/dist/register/item.js +61 -0
- package/dist/register/register.js +2 -2
- package/dist/register/renumber.js +4 -0
- package/dist/register/update.js +6 -0
- package/dist/schedule/approach.js +9 -0
- package/dist/schedule/strategy-profiles.js +22 -2
- package/dist/shared/agent-types.js +4 -1
- package/dist/shared/branch-template.js +26 -0
- package/dist/shared/commit-message-template.js +38 -0
- package/dist/shared/commit-types.js +15 -0
- package/dist/shared/specdojo-config.js +35 -4
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
- package/docs/ja/specdojo/guides/exec-config-guide.md +3 -1
- package/docs/ja/specdojo/guides/exec-operation-guide.md +96 -2
- package/docs/ja/specdojo/guides/register-operation-guide.md +14 -1
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +1 -1
- package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
- package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
- package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
- package/docs/ja/specdojo/references/command-reference.md +44 -11
- package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +8 -0
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
- package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
- package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
- package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +40 -2
- package/package.json +3 -2
- package/templates/antigravity/orchestrator.md +2 -0
- package/templates/claude/agents/specdojo-orchestrator.md +2 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
- package/templates/codex/orchestrator.md +2 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +14 -8
- package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
|
@@ -50,6 +50,7 @@ $defs:
|
|
|
50
50
|
lint-ts,
|
|
51
51
|
lint-fm,
|
|
52
52
|
lint-md,
|
|
53
|
+
lint-mermaid,
|
|
53
54
|
build,
|
|
54
55
|
format-check,
|
|
55
56
|
]
|
|
@@ -99,6 +100,10 @@ $defs:
|
|
|
99
100
|
type: array
|
|
100
101
|
items:
|
|
101
102
|
$ref: "#/$defs/NonEmptyString"
|
|
103
|
+
commit_types:
|
|
104
|
+
description: >-
|
|
105
|
+
Mapping from register item types to Conventional Commits types for this project.
|
|
106
|
+
$ref: "#/$defs/CommitTypeMap"
|
|
102
107
|
repos:
|
|
103
108
|
description: >-
|
|
104
109
|
Product repositories that tasks of this project may change. The project repository is
|
|
@@ -148,10 +153,19 @@ $defs:
|
|
|
148
153
|
integration_branch:
|
|
149
154
|
description: Branch exec integrates into. Omit to use the repository's current branch.
|
|
150
155
|
$ref: "#/$defs/NonEmptyString"
|
|
156
|
+
branch_template:
|
|
157
|
+
description: Product work branch template; must contain id or topic. Expanded values must be valid Git branch names.
|
|
158
|
+
type: string
|
|
159
|
+
default: "exec/{project}-{id}"
|
|
160
|
+
allOf:
|
|
161
|
+
- pattern: '\{(?:id|topic)\}'
|
|
162
|
+
- pattern: '^(?:[^{}\u0000]|\{(?:id|project|topic|type|scope|title)\})*$'
|
|
163
|
+
- not:
|
|
164
|
+
pattern: '[\s\u0000-\u001f\u007f~^:?*\[\\]|\.\.|@\{|^[-/]|/$|//|\.$|(^|/)\.|\.lock(/|$)'
|
|
151
165
|
integration_strategy:
|
|
152
|
-
description: Local merge commit (default), or retain the
|
|
166
|
+
description: Local merge commit (default), fast-forward only, or retain the branch for product-side PR review.
|
|
153
167
|
type: string
|
|
154
|
-
enum: [merge, branch-only]
|
|
168
|
+
enum: [merge, branch-only, ff]
|
|
155
169
|
default: merge
|
|
156
170
|
setup:
|
|
157
171
|
description: Whether exec installs dependencies and builds in the repository worktree.
|
|
@@ -162,6 +176,23 @@ $defs:
|
|
|
162
176
|
type: boolean
|
|
163
177
|
build:
|
|
164
178
|
type: boolean
|
|
179
|
+
commit_types:
|
|
180
|
+
description: >-
|
|
181
|
+
Mapping from register item types to Conventional Commits types for this repository.
|
|
182
|
+
$ref: "#/$defs/CommitTypeMap"
|
|
183
|
+
commit_subject_template:
|
|
184
|
+
description: >-
|
|
185
|
+
Product commit subject. Omit to retain exec(register <ID>): <title>.
|
|
186
|
+
$ref: "#/$defs/CommitMessageTemplate"
|
|
187
|
+
merge_message_template:
|
|
188
|
+
description: >-
|
|
189
|
+
Product merge message. Omit to retain exec(register <ID>): <title>. Refs is always appended.
|
|
190
|
+
$ref: "#/$defs/CommitMessageTemplate"
|
|
191
|
+
CommitMessageTemplate:
|
|
192
|
+
type: string
|
|
193
|
+
allOf:
|
|
194
|
+
- pattern: '\S'
|
|
195
|
+
- pattern: '^(?:[^{}\u0000]|\{(?:id|project|topic|type|scope|title|branch|target)\})*$'
|
|
165
196
|
Run:
|
|
166
197
|
type: object
|
|
167
198
|
properties:
|
|
@@ -195,3 +226,10 @@ $defs:
|
|
|
195
226
|
type: string
|
|
196
227
|
register_date_timezone:
|
|
197
228
|
type: string
|
|
229
|
+
CommitTypeMap:
|
|
230
|
+
type: object
|
|
231
|
+
description: >-
|
|
232
|
+
Mapping from register item type (e.g., todo, issue) to Conventional Commits type (e.g., feat, fix).
|
|
233
|
+
additionalProperties:
|
|
234
|
+
type: string
|
|
235
|
+
enum: [feat, fix, docs, refactor, test, chore, perf, build, ci, style, revert]
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specdojo",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "naoji3x",
|
|
@@ -93,6 +93,7 @@
|
|
|
93
93
|
"docs:rebuild:mermaid": "rm -f .vitepress/mermaid/*.svg && npm run docs:build:mermaid",
|
|
94
94
|
"docs:build": "npm run docs:generate && npm --prefix packages/docs-site run docs:build",
|
|
95
95
|
"lint:fm": "node packages/docs-lint/bin/specdojo-docs-lint.js remark \"docs/**/*.{md,mdx}\" --quiet --frail",
|
|
96
|
+
"lint:mermaid": "node tools/lint-mermaid.mjs",
|
|
96
97
|
"validate:schema:job-run": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/job-run.schema.yaml --data \"docs/ja/**/execution/jobs/runs/*.json\" --allow-empty",
|
|
97
98
|
"validate:schema:grade-pipeline": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml --data \"docs/ja/**/execution/grade/pipeline/*.json\" --allow-empty",
|
|
98
99
|
"validate:schema:file": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema",
|
|
@@ -101,7 +102,7 @@
|
|
|
101
102
|
"validate:schema:glossary": "node packages/docs-lint/bin/specdojo-docs-lint.js glossary-references",
|
|
102
103
|
"validate:catalog": "tsx src/specdojo.ts catalog validate",
|
|
103
104
|
"validate:history-links": "node packages/docs-lint/bin/specdojo-docs-lint.js history-links",
|
|
104
|
-
"check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
|
|
105
|
+
"check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run lint:mermaid && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
|
|
105
106
|
"check:src-imports": "node tools/check-src-imports-in-dependencies.mjs",
|
|
106
107
|
"dc:ps": "docker ps --format \"table {{.Names}}\\t{{.Image}}\\t{{.Status}}\"",
|
|
107
108
|
"dc:name": "bash -lc 'docker ps --format \"{{.Names}}\\t{{.Image}}\" | awk \"\\$2 ~ /^vsc-specdojo/ {print \\$1; exit}\"'",
|
|
@@ -98,6 +98,8 @@ type は次のように使い分ける。
|
|
|
98
98
|
|
|
99
99
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
100
100
|
|
|
101
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
102
|
+
|
|
101
103
|
```bash
|
|
102
104
|
npx specdojo register add --project <project-id> \
|
|
103
105
|
--type todo --title "<title>" --description "<description>" \
|
|
@@ -105,6 +105,8 @@ type は次のように使い分ける。
|
|
|
105
105
|
|
|
106
106
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
107
107
|
|
|
108
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
109
|
+
|
|
108
110
|
```bash
|
|
109
111
|
npx specdojo register add --project <project-id> \
|
|
110
112
|
--type todo --title "<title>" --description "<description>" \
|
|
@@ -105,6 +105,8 @@ type は次のように使い分ける。
|
|
|
105
105
|
|
|
106
106
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
107
107
|
|
|
108
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
109
|
+
|
|
108
110
|
```bash
|
|
109
111
|
npx specdojo register add --project <project-id> \
|
|
110
112
|
--type todo --title "<title>" --description "<description>" \
|
|
@@ -98,6 +98,8 @@ type は次のように使い分ける。
|
|
|
98
98
|
|
|
99
99
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
100
100
|
|
|
101
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
102
|
+
|
|
101
103
|
```bash
|
|
102
104
|
npx specdojo register add --project <project-id> \
|
|
103
105
|
--type todo --title "<title>" --description "<description>" \
|
|
@@ -14,6 +14,13 @@
|
|
|
14
14
|
# - コンテナ起動: devcontainer up --workspace-folder "$workspace_dir"
|
|
15
15
|
# - セッション接続: docker exec -it ... tmux new-session -A -s <名前>
|
|
16
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"}}'
|
|
23
|
+
#
|
|
17
24
|
# 利用者(ユーザー)の変更:
|
|
18
25
|
# - devcontainer.json の remoteUser(既定は node)に合わせて -u でコンテナに入ります。
|
|
19
26
|
# - remoteUser を変更した場合は、下記 container_user の値を変更してください。
|
|
@@ -51,13 +58,7 @@ node_bin_dir="/absolute/path/to/node/bin"
|
|
|
51
58
|
export PATH="$node_bin_dir:/opt/homebrew/bin:/usr/local/bin:$PATH"
|
|
52
59
|
|
|
53
60
|
find_container() {
|
|
54
|
-
|
|
55
|
-
id="$(docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
|
|
56
|
-
if [ -n "$id" ]; then
|
|
57
|
-
echo "$id"
|
|
58
|
-
return
|
|
59
|
-
fi
|
|
60
|
-
docker ps --format '{{.Names}}\t{{.Image}}' | awk '$2 ~ /^vsc-/ {print $1; exit}'
|
|
61
|
+
docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1
|
|
61
62
|
}
|
|
62
63
|
|
|
63
64
|
if [ ! -f "$workspace_dir/.devcontainer/devcontainer.json" ]; then
|
|
@@ -90,7 +91,7 @@ container_name="$(find_container)"
|
|
|
90
91
|
|
|
91
92
|
if [ -z "$container_name" ]; then
|
|
92
93
|
echo "Starting devcontainer..." >&2
|
|
93
|
-
devcontainer up --workspace-folder "$workspace_dir"
|
|
94
|
+
devcontainer up --workspace-folder "$workspace_dir" >&2
|
|
94
95
|
container_name="$(find_container)"
|
|
95
96
|
fi
|
|
96
97
|
|
|
@@ -99,4 +100,9 @@ if [ -z "$container_name" ]; then
|
|
|
99
100
|
exit 1
|
|
100
101
|
fi
|
|
101
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
|
|
107
|
+
|
|
102
108
|
exec docker exec -it --detach-keys="ctrl-]" -u "$container_user" -w "$container_workspace_dir" "$container_name" tmux new-session -A -s "$session_name"
|
|
@@ -199,6 +199,8 @@ type は次のように使い分ける。
|
|
|
199
199
|
|
|
200
200
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
201
201
|
|
|
202
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
203
|
+
|
|
202
204
|
```bash
|
|
203
205
|
npx specdojo register add --project <project-id> \
|
|
204
206
|
--type todo --title "<title>" --description "<description>" \
|