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.
Files changed (93) hide show
  1. package/.github/agents/specdojo-orchestrator.md +2 -0
  2. package/CHANGELOG.md +60 -0
  3. package/dist/catalog/generate.js +144 -13
  4. package/dist/commands/init.js +1 -0
  5. package/dist/deliverable/deliverable.js +77 -4
  6. package/dist/exec/core.js +1 -0
  7. package/dist/exec/parent-validation.js +7 -0
  8. package/dist/exec/plans-core.js +46 -1
  9. package/dist/exec/plans-generation.js +39 -3
  10. package/dist/exec/plans-planning.js +1 -1
  11. package/dist/exec/plans-storage.js +1 -0
  12. package/dist/exec/product-branch-records.js +105 -0
  13. package/dist/exec/product-branches.js +52 -0
  14. package/dist/exec/register-product-message.js +50 -0
  15. package/dist/exec/register.js +6 -0
  16. package/dist/exec/repo-integration-sync.js +4 -2
  17. package/dist/exec/repo-integration.js +41 -4
  18. package/dist/exec/repo-trace.js +2 -0
  19. package/dist/exec/results.js +9 -5
  20. package/dist/exec/run/register-command.js +16 -0
  21. package/dist/exec/run/register-resume.js +11 -1
  22. package/dist/exec/run/register-worktree.js +29 -8
  23. package/dist/exec/run/schedule-prepare.js +7 -3
  24. package/dist/exec/strategy.js +2 -1
  25. package/dist/exec/task-repos.js +78 -16
  26. package/dist/exec/worktree-command.js +2 -2
  27. package/dist/exec/worktree.js +3 -3
  28. package/dist/register/core.js +5 -0
  29. package/dist/register/create-commands.js +54 -2
  30. package/dist/register/deliverable-target.js +24 -17
  31. package/dist/register/event-merge.js +4 -0
  32. package/dist/register/events.js +6 -0
  33. package/dist/register/external-project.js +2 -0
  34. package/dist/register/input.js +168 -0
  35. package/dist/register/item.js +61 -0
  36. package/dist/register/register.js +2 -2
  37. package/dist/register/renumber.js +4 -0
  38. package/dist/register/update.js +6 -0
  39. package/dist/schedule/approach.js +9 -0
  40. package/dist/schedule/strategy-profiles.js +22 -2
  41. package/dist/shared/agent-types.js +4 -1
  42. package/dist/shared/branch-template.js +26 -0
  43. package/dist/shared/commit-message-template.js +38 -0
  44. package/dist/shared/commit-types.js +15 -0
  45. package/dist/shared/specdojo-config.js +35 -4
  46. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  47. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  48. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  49. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  50. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  51. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  52. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  53. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  54. package/docs/ja/specdojo/guides/exec-config-guide.md +3 -1
  55. package/docs/ja/specdojo/guides/exec-operation-guide.md +96 -2
  56. package/docs/ja/specdojo/guides/register-operation-guide.md +14 -1
  57. package/docs/ja/specdojo/guides/remote-host-development-guide.md +1 -1
  58. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  59. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  60. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  61. package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
  62. package/docs/ja/specdojo/references/command-reference.md +44 -11
  63. package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
  64. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +8 -0
  65. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
  66. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
  67. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  68. package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
  69. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  70. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  71. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  72. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  73. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
  74. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  75. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  76. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  77. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  78. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  79. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  80. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  81. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  82. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
  83. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  84. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
  85. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  86. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +40 -2
  87. package/package.json +3 -2
  88. package/templates/antigravity/orchestrator.md +2 -0
  89. package/templates/claude/agents/specdojo-orchestrator.md +2 -0
  90. package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
  91. package/templates/codex/orchestrator.md +2 -0
  92. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +14 -8
  93. package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
@@ -123,6 +123,7 @@ properties:
123
123
  type: string
124
124
  enum:
125
125
  - author-deliverable
126
+ - draft-with-context
126
127
  - bootstrap-kata-set
127
128
  - reflect-implementation
128
129
  - deduplicate-across-deliverables
@@ -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 exec branch for product-side PR review.
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.5.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
- local id
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>" \