specdojo 0.2.0 → 0.3.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 +165 -0
- package/CHANGELOG.md +280 -0
- package/README.md +143 -30
- package/dist/agent-response.js +20 -0
- package/dist/agent.js +4 -4
- package/dist/build-command.js +28 -8
- package/dist/dashboard.js +140 -9
- package/dist/devcontainer-command.js +43 -0
- package/dist/devcontainer-scaffold.js +165 -0
- package/dist/exec-agent-config.js +107 -9
- package/dist/exec-agent-git-state.js +18 -0
- package/dist/exec-agent-protected-config.js +46 -8
- package/dist/exec-evidence.js +254 -11
- package/dist/exec-format.js +13 -4
- package/dist/exec-handoff.js +336 -0
- package/dist/exec-parent-validation.js +317 -43
- package/dist/exec-pipeline-state.js +74 -9
- package/dist/exec-plans.js +115 -113
- package/dist/exec-protection-handoff.js +43 -2
- package/dist/exec-provider-scaffold.js +247 -15
- package/dist/exec-register-resume.js +65 -19
- package/dist/exec-register.js +9 -3
- package/dist/exec-repo-integration.js +811 -0
- package/dist/exec-repo-trace.js +182 -0
- package/dist/exec-reporter.js +613 -132
- package/dist/exec-results.js +81 -56
- package/dist/exec-run-lock.js +110 -107
- package/dist/exec-run.js +1585 -356
- package/dist/exec-shared.js +7 -0
- package/dist/exec-slot-lock.js +242 -0
- package/dist/exec-task-repos.js +415 -0
- package/dist/exec-trial.js +51 -25
- package/dist/exec-worktree-command.js +87 -43
- package/dist/exec-worktree-ops.js +502 -57
- package/dist/exec-worktree.js +114 -27
- package/dist/exec.js +13 -6
- package/dist/grade-result.js +128 -0
- package/dist/grade.js +809 -72
- package/dist/init-command.js +443 -0
- package/dist/job.js +160 -10
- package/dist/orchestrator.js +213 -0
- package/dist/package-paths.js +19 -1
- package/dist/register-event-merge.js +169 -0
- package/dist/register-item.js +7 -1
- package/dist/register.js +294 -86
- package/dist/review-grade.js +252 -0
- package/dist/review-plan.js +111 -1
- package/dist/review-types.js +40 -1
- package/dist/routine.js +72 -5
- package/dist/schedule-build.js +2 -2
- package/dist/schedule.js +17 -4
- package/dist/specdojo-config.js +466 -20
- package/dist/specdojo-gitignore.js +135 -0
- package/dist/specdojo.js +8 -1
- package/dist/viewpoint-document-kinds-check.js +128 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
- package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
- package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
- package/docs/ja/specdojo/guides/exec-config-guide.md +91 -47
- package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
- package/docs/ja/specdojo/guides/kata-guide.md +4 -4
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +25 -4
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
- package/docs/ja/specdojo/guides/quick-start-guide.md +261 -32
- package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
- package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +184 -0
- package/docs/ja/specdojo/guides/review-guide.md +195 -158
- package/docs/ja/specdojo/guides/routine-operation-guide.md +74 -9
- package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
- package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
- package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
- package/docs/ja/specdojo/guides/waza-guide.md +15 -2
- package/docs/ja/specdojo/index.md +2 -2
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
- package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
- package/docs/ja/specdojo/references/command-reference.md +336 -93
- package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
- package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
- package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
- package/docs/ja/specdojo/samples/bps-sample.md +74 -21
- package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
- package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
- package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
- package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
- package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
- package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
- package/docs/ja/specdojo/templates/bps-template.md +91 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
- package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
- package/package.json +16 -9
- package/templates/antigravity/README.md +60 -0
- package/templates/antigravity/agent-members-snippet.yaml +61 -0
- package/templates/antigravity/exec-defaults-snippet.yaml +39 -0
- package/templates/antigravity/orchestrator.md +157 -0
- package/templates/antigravity/settings.global.json +55 -0
- package/templates/claude/agents/claude-executor.md +14 -0
- package/templates/claude/agents/claude-reporter.md +16 -0
- package/templates/claude/agents/specdojo-orchestrator.md +164 -0
- package/templates/claude/settings.edit.json +27 -1
- package/templates/codex/README.md +5 -4
- package/templates/codex/agents/specdojo-orchestrator.toml +165 -0
- package/templates/codex/orchestrator.md +157 -0
- package/templates/copilot/README.md +7 -5
- package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
- package/templates/devcontainer/devcontainer.json +27 -0
- package/templates/devcontainer/emacs/init.el +88 -0
- package/templates/devcontainer/post-create.sh +62 -0
- package/templates/init-agent-members.yaml +200 -0
- package/templates/init-exec-defaults.yaml +72 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +204 -0
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
package/README.md
CHANGED
|
@@ -1,13 +1,44 @@
|
|
|
1
1
|
# SpecDojo
|
|
2
2
|
|
|
3
|
-
SpecDojo
|
|
4
|
-
|
|
3
|
+
SpecDojo は、仕様道(Spec-Dō)の道場です。
|
|
4
|
+
仕様と設計を作り、運用まで保つための体系を整えます。判断を記帳し、型に沿って実戦で書き、評定で鍛え続け、講評で完了を判断します。人と生成 AI が同じ成果物を作成・検証・更新できるようにし、仕様駆動開発のツールに対しては、その上流で仕様と設計の体系を担います。
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
**記して、形にして、磨き続ける。**
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
-
|
|
10
|
-
|
|
8
|
+
**記帳ひとつから始められます。** 設定 2 行で使い始め、必要になった分だけ広げられます。
|
|
9
|
+
迷いを question として起票し、decision で決め、仕様書に書き、後日 change-request で直すまでを 10 分で体験できます。kata(型)を事前に用意する必要はありません。手順は [Quick Start ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/quick-start-guide.html) 冒頭の「10分で体験する — 仕様の判断台帳」を参照してください。
|
|
10
|
+
|
|
11
|
+
| 道場の言葉 | SpecDojo の仕組み |
|
|
12
|
+
| ---------- | ------------------------------------------------------------------------------------------------------- |
|
|
13
|
+
| 型(Kata) | 成果物の作り方を定める rulebook・recipe・sample・template |
|
|
14
|
+
| 技(Waza) | `specdojo` CLI。決定を残す記帳、成果物を作る実戦、品質を見る評定、完了を見る講評 |
|
|
15
|
+
| 流(Ryu) | 成果物・型・技をつなぐ `approach`。タスクごとに型をどこまで基準にして技を使うか(守・破・離など)を表す |
|
|
16
|
+
|
|
17
|
+
## できること
|
|
18
|
+
|
|
19
|
+
### 記帳 — 気づいたことを、型に沿って残せる
|
|
20
|
+
|
|
21
|
+
作業だけでなく、判断・保留・観測・リスク・変更要求も同じ登録簿へ記録します。種別を選ぶと
|
|
22
|
+
本文の章構成が与えられるため、「選択肢を比較して理由を書く」といった記録が形を保ちます。
|
|
23
|
+
正本は Markdown なので、`git log` でそのまま読め、3 年後も SpecDojo なしで読めます。
|
|
24
|
+
決定ログ・課題ログ・リスク登録簿は、この記録から生成されます。
|
|
25
|
+
|
|
26
|
+
### 会話で進められる
|
|
27
|
+
|
|
28
|
+
同梱の対話型オーケストレーターを配置すると、やりたいことを話すだけで進みます。
|
|
29
|
+
調査や議論の内容がそのまま個票の本文になるため、別途まとめ直す必要がありません。
|
|
30
|
+
状態を変える操作は実行前に提示して承認を求め、`git push` や破壊的操作は行いません。
|
|
31
|
+
|
|
32
|
+
### 型と実戦 — 必要になったら、成果物の型へ広げられる
|
|
33
|
+
|
|
34
|
+
要件、設計、テスト、運用まで 100 種類以上の記述規則・手順・テンプレート・サンプルを持ちます。
|
|
35
|
+
使うものだけをカタログで宣言し、型に沿った実戦で成果物を作れます。最初から全部を用意する必要はありません。
|
|
36
|
+
|
|
37
|
+
### 評定と講評 — 品質評価と完了判断を分けて残せる
|
|
38
|
+
|
|
39
|
+
`grade` は成果物の品質を共通の観点で評価し、`review` はその結果と実行記録・完了条件を照合して、タスクを完了してよいかを判断します。品質の finding とタスクの未充足事項を混同せず、最終的な `ready` への確定は人が行います。
|
|
40
|
+
|
|
41
|
+
v0.3.0 の `grade` は試験的な機能です。npm package では `grade list` / `plan` / `apply` / `validate` / `result` などの部品を利用できますが、これらを通しで実行する SpecDojo 本体リポジトリの開発用スクリプト `tools/grade/run-per-document.sh` は package に含まれません。成果物を評価するには、project の `catalog_path` も設定してください。1 文書を部品で評価する手順は [CLI コマンドリファレンス](docs/ja/specdojo/references/command-reference.md#81-npm-package-で-1-文書を評価する)を参照してください。
|
|
11
42
|
|
|
12
43
|
日本語ドキュメントは [SpecDojo ドキュメントサイト](https://specdojo.github.io/specdojo/ja/) で公開しています。
|
|
13
44
|
|
|
@@ -18,39 +49,107 @@ SpecDojo は、次のものを npm package とオープンソースのテンプ
|
|
|
18
49
|
|
|
19
50
|
## 使い始める
|
|
20
51
|
|
|
52
|
+
現在の変更点は [CHANGELOG](CHANGELOG.md) にまとめています。v0.2.1 から更新する場合は、
|
|
53
|
+
レビュー観点、rubric、review テンプレートに互換性のない変更があるため、
|
|
54
|
+
[v0.3.0 移行ガイド](docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md)を先に確認してください。
|
|
55
|
+
|
|
21
56
|
### npm で導入する
|
|
22
57
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
58
|
+
既定では、SpecDojo の記録をプロダクトの Git 履歴に混ぜないため、次の **別リポジトリ構成**で始めます。
|
|
59
|
+
|
|
60
|
+
- **プロダクトリポジトリ** `app1/`: ソースコードと、仕様・設計などのプロダクトドキュメントを置きます。
|
|
61
|
+
- **プロジェクトリポジトリ** `app1-specdojo/`: 登録簿・計画・実行記録などのプロジェクトドキュメントと、文書の作り方を定める型(Kata)を置きます。1つのプロジェクトリポジトリに、複数のプロジェクトを格納できます。
|
|
62
|
+
- **worktree 用ディレクトリ** `app1-specdojo-worktrees/`: タスクごとの変更を隔離して進めるために、Git worktree を作る場所です。名前はプロジェクトリポジトリのディレクトリ名から決まります。
|
|
63
|
+
|
|
64
|
+
```text
|
|
65
|
+
app1-workspace/
|
|
66
|
+
├── app1/ # プロダクトリポジトリ
|
|
67
|
+
├── app1-specdojo/ # プロジェクトリポジトリ
|
|
68
|
+
└── app1-specdojo-worktrees/ # タスクごとの作業場所
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
`app1-workspace/` 直下で次を実行します。
|
|
26
72
|
|
|
27
73
|
```sh
|
|
28
|
-
mkdir app1-specdojo
|
|
74
|
+
mkdir app1-specdojo
|
|
29
75
|
git -C app1-specdojo init
|
|
30
76
|
cd app1-specdojo
|
|
31
77
|
npm init -y
|
|
32
|
-
npm install specdojo
|
|
33
|
-
npm install --save-dev @specdojo/docs-lint
|
|
78
|
+
npm install --save-dev specdojo @specdojo/docs-lint
|
|
34
79
|
npx specdojo config init
|
|
35
80
|
```
|
|
36
81
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
82
|
+
SpecDojo は開発時に使う文書・実行管理ツールなので、`--save-dev` で導入します。kata は、成果物を書くための規則・手順・テンプレート・サンプルの総称です。kata もインストールした package から参照されるため、`package-lock.json` によって SpecDojo と同じ版へ固定されます。
|
|
83
|
+
|
|
84
|
+
`config init` は、登録簿を使い始めるための最小設定を `.specdojo/specdojo.config.json` に作成します。worktree の既定先はリポジトリのディレクトリ名から `../<リポジトリ名>-worktrees` として作られます。設定を変える方法は、後述の「設定を変えたいとき」を参照してください。
|
|
85
|
+
|
|
86
|
+
あわせて、`npm install` で作られる `node_modules/` と SpecDojo の生成物(`docs/**/generated/*`、`.specdojo/doc-index.json` など)を git の管理から外す行を `.gitignore` に用意します。`.gitignore` が無ければ作成し、既にあれば足りない行だけを末尾へ追記します。`node_modules`、`/node_modules` など同じ意味の行が既にあれば `node_modules/` は追記しません。生成物を管理外にしておくと、登録簿の項目を並行実行したときに生成物どうしが衝突しません。追記する行は `npx specdojo config init --dry-run` で事前に確認できます。すでに `node_modules/` や生成物を git で管理している場合は、表示される案内に従って `git rm -r --cached` で管理から外し、コミットします。
|
|
42
87
|
|
|
43
|
-
|
|
44
|
-
|
|
88
|
+
### オーケストレーターを配置する
|
|
89
|
+
|
|
90
|
+
SpecDojo は、会話を CLI 操作へ変換する対話型オーケストレーターを同梱しています。利用する AI ツール(provider)の設定を配置します。次は Claude Code を使う例です。
|
|
45
91
|
|
|
46
92
|
```sh
|
|
47
|
-
npx specdojo config scaffold --provider
|
|
93
|
+
npx specdojo config scaffold --provider claude
|
|
48
94
|
```
|
|
49
95
|
|
|
50
|
-
|
|
51
|
-
|
|
96
|
+
このコマンドを実行すると、オーケストレーターの定義ファイルが配置され、`package.json` へ起動用のスクリプトが追加されます(`package.json` が存在する場合)。追加されたスクリプトで起動します。
|
|
97
|
+
|
|
98
|
+
| provider | 配置先 | 起動(`package.json` がある場合) |
|
|
99
|
+
| ------------- | ------------------------------------------- | --------------------------------- |
|
|
100
|
+
| `claude` | `.claude/agents/specdojo-orchestrator.md` | `npm run orch:opus` ほか |
|
|
101
|
+
| `opencode` | `.opencode/agents/specdojo-orchestrator.md` | `npm run orch:opencode` |
|
|
102
|
+
| `codex` | `.specdojo/codex/orchestrator.md` | `npm run orch:codex` |
|
|
103
|
+
| `antigravity` | `.specdojo/antigravity/orchestrator.md` | `npm run orch:agy` |
|
|
104
|
+
|
|
105
|
+
配置されるファイルのモデル名は、手元で使えるモデルに合わせて編集してください。provider ごとの詳しい設定は [オーケストレーター運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/orchestrator-operation-guide.html) を参照してください。
|
|
52
106
|
|
|
53
|
-
|
|
107
|
+
Antigravity CLI を無人実行する場合は、利用者のグローバル設定へ permission rule を追加します。この設定はすべてのリポジトリに効くため、必ず先に差分を確認してから適用してください。通常の scaffold はグローバル設定へ触れません。
|
|
108
|
+
|
|
109
|
+
```sh
|
|
110
|
+
npx specdojo config scaffold --provider antigravity --global --dry-run
|
|
111
|
+
npx specdojo config scaffold --provider antigravity --global
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
実適用では既存設定を残し、変更前のファイルをバックアップします。追加する allow は `git status` / `diff` / `log` / `show` の読み取り操作だけです。
|
|
115
|
+
|
|
116
|
+
#### Dev Container を使う場合(任意)
|
|
117
|
+
|
|
118
|
+
利用環境として Dev Container を使う場合は、オーケストレーターの配置に加えて次のコマンドを実行すると、指定した provider の CLI が組み込まれた `.devcontainer/` を生成できます。
|
|
119
|
+
|
|
120
|
+
```sh
|
|
121
|
+
npx specdojo devcontainer scaffold --provider claude --dry-run
|
|
122
|
+
npx specdojo devcontainer scaffold --provider claude
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
既存の `.devcontainer/` は上書きせず、置き換える場合だけ `--force` を指定します。生成設定は provider の設定ディレクトリを名前付きボリュームに保存し、ホストの認証情報・秘密鍵・`.env` はマウントしません。生成後、VS Code などでコンテナを立ち上げると、分離された環境ですぐにオーケストレーターを起動できます。Ollama 接続、cron、tmux はそれぞれ `--ollama`、`--cron`、`--tmux` で追加できます。
|
|
126
|
+
|
|
127
|
+
### 会話で操作する
|
|
128
|
+
|
|
129
|
+
起動したら、やりたいことをそのまま伝えます。オーケストレーターがコマンドへ翻訳し、実行前に内容を提示します。
|
|
130
|
+
|
|
131
|
+
```text
|
|
132
|
+
あなた : このプロジェクトを始めたい。まず登録簿を用意して、最初の作業を起票して。
|
|
133
|
+
オーケストレーター : 次を実行します。よろしいですか。
|
|
134
|
+
npx specdojo register scaffold --project prj-0001
|
|
135
|
+
npx specdojo register add --project prj-0001 --type todo --title "..."
|
|
136
|
+
あなた : お願いします。
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
状態を変える操作は承認を得てから実行し、`git push` や破壊的操作は行いません。起票した項目の
|
|
140
|
+
実行、状況の確認、成果物の生成も同じ流れで進みます。
|
|
141
|
+
|
|
142
|
+
```text
|
|
143
|
+
PJR-XXXX を実行して
|
|
144
|
+
今の状況は?
|
|
145
|
+
kata の rulebook を確認したい
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
詳しい進め方は [オーケストレーター運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/orchestrator-operation-guide.html) を参照してください。
|
|
149
|
+
|
|
150
|
+
### CLI を直接使う
|
|
151
|
+
|
|
152
|
+
オーケストレーターを使わずに操作することもできます。最初の登録簿と、実施する作業を表す `todo` を作り、一覧を生成します。
|
|
54
153
|
|
|
55
154
|
```sh
|
|
56
155
|
npx specdojo register scaffold --project prj-0001
|
|
@@ -61,16 +160,17 @@ npx specdojo register add \
|
|
|
61
160
|
npx specdojo register build --project prj-0001
|
|
62
161
|
```
|
|
63
162
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
163
|
+
`exec run` と並行して記帳し、その変更だけを commit まで完了させる場合は、`register add` / `update` / `renumber` または状態遷移コマンドへ `--commit` を付けます。同じ project の `register lifecycle` 枠が空くまで待ち、ほかの未 commit 変更を含めずに記帳・一覧再生成・commit を行います。対象の個票や event に既存差分がある場合は、混在を避けるため記帳前に停止します。
|
|
164
|
+
|
|
165
|
+
ここまでの手順は、利用側へ kata をコピーせずに実行できます。生成された `todo` の個票が編集対象、
|
|
166
|
+
`generated/pjr-index.md` が個票から作る一覧です。`register add` が表示した ID を使い、AI に作業を
|
|
167
|
+
依頼する前に実行計画(exec plan)の内容まで確認できます。
|
|
67
168
|
|
|
68
169
|
```sh
|
|
69
170
|
npx specdojo exec plan --project prj-0001 --register PJR-XXXX
|
|
70
171
|
```
|
|
71
172
|
|
|
72
|
-
kata は既定で npm package 内のものを参照します。適用中の rulebook
|
|
73
|
-
上書きする場合だけ eject します。
|
|
173
|
+
kata は既定で npm package 内のものを参照します。適用中の rulebook(成果物ごとの記述規則)を確認し、プロジェクトで変更する場合だけ `eject` でリポジトリへコピーします。
|
|
74
174
|
|
|
75
175
|
```sh
|
|
76
176
|
npx specdojo kata list --kind rulebook
|
|
@@ -78,13 +178,26 @@ npx specdojo kata show specdojo:pjr-rulebook
|
|
|
78
178
|
npx specdojo kata eject --id specdojo:pjr-rulebook
|
|
79
179
|
```
|
|
80
180
|
|
|
81
|
-
provider
|
|
82
|
-
確認し、登録項目を close します。
|
|
181
|
+
provider の設定を終えた後は、同じ登録項目を AI に実行させられます。成功後は人が実行結果(result)と成果物を確認し、登録項目を完了(close)します。
|
|
83
182
|
|
|
84
183
|
```sh
|
|
85
184
|
npx specdojo exec run --project prj-0001 --register PJR-XXXX
|
|
86
185
|
```
|
|
87
186
|
|
|
187
|
+
AI による実行は数分から数十分かかり、定期処理として登録した `routine` は決めた時刻に実行されます。作業端末の状態に依存せず
|
|
188
|
+
実行を続けたい場合は、常時稼働するホストへリモート接続する構成例を
|
|
189
|
+
[常時稼働ホスト運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/remote-host-development-guide.html) に示しています。
|
|
190
|
+
|
|
191
|
+
### 設定を変えたいとき
|
|
192
|
+
|
|
193
|
+
`config init` が作る設定は、`prj-0001` の登録簿から始める例です。別のプロジェクト ID や配置を使う場合は、`.specdojo/specdojo.config.json` を変更します。
|
|
194
|
+
|
|
195
|
+
- `current_project`: `--project` を省略したときに使うプロジェクトです。
|
|
196
|
+
- `projects`: このプロジェクトリポジトリで扱うプロジェクトを定義します。複数登録できます。
|
|
197
|
+
- `base_path`: 各プロジェクトの文書を置く基準パスです。
|
|
198
|
+
|
|
199
|
+
成果物カタログやスケジュールへ進むときに追加する設定は、[SpecDojo設定リファレンス](https://specdojo.github.io/specdojo/ja/specdojo/references/specdojo-config-reference.html) を参照してください。
|
|
200
|
+
|
|
88
201
|
### テンプレートリポジトリとして導入する
|
|
89
202
|
|
|
90
203
|
npm package の参照方式ではなく、SpecDojo のソースと文書体系一式を最初から配置して
|
package/dist/agent-response.js
CHANGED
|
@@ -20,6 +20,26 @@ export function extractJsonText(raw) {
|
|
|
20
20
|
return unfenced;
|
|
21
21
|
return unfenced.slice(start, end + 1);
|
|
22
22
|
}
|
|
23
|
+
/**
|
|
24
|
+
* agent の生応答から JSON 配列の本文を取り出す。
|
|
25
|
+
* 配列内の文字列にオブジェクト記号が含まれていても、配列全体を優先する。
|
|
26
|
+
*/
|
|
27
|
+
export function extractJsonArrayText(raw) {
|
|
28
|
+
const unfenced = stripCodeFence(raw.trim());
|
|
29
|
+
for (let start = unfenced.indexOf("["); start >= 0; start = unfenced.indexOf("[", start + 1)) {
|
|
30
|
+
for (let end = unfenced.lastIndexOf("]"); end > start; end = unfenced.lastIndexOf("]", end - 1)) {
|
|
31
|
+
const candidate = unfenced.slice(start, end + 1);
|
|
32
|
+
try {
|
|
33
|
+
if (Array.isArray(JSON.parse(candidate)))
|
|
34
|
+
return candidate;
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
// 別の角括弧または不完全な配列を飛ばし、次の候補を試す。
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
return unfenced;
|
|
42
|
+
}
|
|
23
43
|
// 最初のコードフェンスの中身を返す。フェンスが無ければ入力をそのまま返す。
|
|
24
44
|
function stripCodeFence(text) {
|
|
25
45
|
const fenced = /```[a-z]*\r?\n([\s\S]*?)```/i.exec(text);
|
package/dist/agent.js
CHANGED
|
@@ -13,14 +13,14 @@ export function resolveAgentMember(roster, nickname) {
|
|
|
13
13
|
return candidate.type === "agent" && candidate.nickname === nickname;
|
|
14
14
|
});
|
|
15
15
|
if (!members || members.length === 0) {
|
|
16
|
-
return { error: `--by agent nickname not found in
|
|
16
|
+
return { error: `--by agent nickname not found in agent-members.yaml: ${nickname}` };
|
|
17
17
|
}
|
|
18
18
|
if (members.length !== 1) {
|
|
19
|
-
return { error: `--by agent nickname is not unique in
|
|
19
|
+
return { error: `--by agent nickname is not unique in agent-members.yaml: ${nickname}` };
|
|
20
20
|
}
|
|
21
21
|
const [member] = members;
|
|
22
22
|
if (member.disabled) {
|
|
23
|
-
return { error: `--by agent is disabled in
|
|
23
|
+
return { error: `--by agent is disabled in agent-members.yaml: ${nickname}` };
|
|
24
24
|
}
|
|
25
25
|
return { member };
|
|
26
26
|
}
|
|
@@ -84,7 +84,7 @@ export function registerAgentCommands(program) {
|
|
|
84
84
|
.command("run")
|
|
85
85
|
.description("Feed a plan to one agent and capture its stdout")
|
|
86
86
|
.requiredOption("--plan <path>", "Plan file passed to the agent on stdin")
|
|
87
|
-
.requiredOption("--by <nickname>", "Agent nickname defined in
|
|
87
|
+
.requiredOption("--by <nickname>", "Agent nickname defined in agent-members.yaml")
|
|
88
88
|
.option("--out <path>", "Write the agent stdout to this file instead of the terminal")
|
|
89
89
|
.option("--project <projectId>", "Project id in specdojo.config.json")
|
|
90
90
|
.option("--exec-defaults <path>", "Override the exec-defaults.yaml path")
|
package/dist/build-command.js
CHANGED
|
@@ -30,7 +30,29 @@ function isStepApplicable(scope, project) {
|
|
|
30
30
|
return !!project.execution_path?.trim();
|
|
31
31
|
}
|
|
32
32
|
}
|
|
33
|
-
|
|
33
|
+
/**
|
|
34
|
+
* register build の対象 project を決める。index build はリポジトリ内のすべての登録簿の
|
|
35
|
+
* generated/pjr-index.md を要求する一方、生成物は git 管理外で新しい worktree には無い。
|
|
36
|
+
* そのため `--project` を明示しない build では、登録簿を持つ全 project を対象にする。
|
|
37
|
+
* `--project` を明示した場合は、従来どおりその project だけを対象にする。
|
|
38
|
+
*/
|
|
39
|
+
export function resolveRegisterProjectIds(config, projectId, isProjectExplicit) {
|
|
40
|
+
if (!config)
|
|
41
|
+
return [];
|
|
42
|
+
if (isProjectExplicit) {
|
|
43
|
+
const project = projectId ? config.projects[projectId] : undefined;
|
|
44
|
+
return projectId && isStepApplicable("register", project) ? [projectId] : [];
|
|
45
|
+
}
|
|
46
|
+
return Object.keys(config.projects)
|
|
47
|
+
.filter((id) => isStepApplicable("register", config.projects[id]))
|
|
48
|
+
.sort();
|
|
49
|
+
}
|
|
50
|
+
export function resolveSteps(scope, projectArgs, project, registerProjectIds) {
|
|
51
|
+
const registerSteps = registerProjectIds.map((id) => ({
|
|
52
|
+
scope: "register",
|
|
53
|
+
label: registerProjectIds.length > 1 ? `register build (${id})` : "register build",
|
|
54
|
+
subArgs: ["register", "build", "--project", id],
|
|
55
|
+
}));
|
|
34
56
|
const candidates = [
|
|
35
57
|
{
|
|
36
58
|
scope: "exec",
|
|
@@ -42,11 +64,7 @@ function resolveSteps(scope, projectArgs, project) {
|
|
|
42
64
|
label: "catalog build",
|
|
43
65
|
subArgs: ["catalog", "build", ...projectArgs],
|
|
44
66
|
},
|
|
45
|
-
|
|
46
|
-
scope: "register",
|
|
47
|
-
label: "register build",
|
|
48
|
-
subArgs: ["register", "build", ...projectArgs],
|
|
49
|
-
},
|
|
67
|
+
...registerSteps,
|
|
50
68
|
{
|
|
51
69
|
scope: "yaml-pages",
|
|
52
70
|
label: "yaml-pages build",
|
|
@@ -67,7 +85,8 @@ function resolveSteps(scope, projectArgs, project) {
|
|
|
67
85
|
},
|
|
68
86
|
];
|
|
69
87
|
const active = scope === "all" ? candidates : candidates.filter((s) => s.scope === scope);
|
|
70
|
-
|
|
88
|
+
// register の対象は registerProjectIds で解決済み。他の段は従来どおり 1 project で判定する。
|
|
89
|
+
return active.filter((s) => s.scope === "register" || isStepApplicable(s.scope, project));
|
|
71
90
|
}
|
|
72
91
|
// ================================
|
|
73
92
|
// Logging
|
|
@@ -110,7 +129,8 @@ export function registerBuildCommand(program) {
|
|
|
110
129
|
return;
|
|
111
130
|
}
|
|
112
131
|
const projectArgs = projectId ? ["--project", projectId] : [];
|
|
113
|
-
const
|
|
132
|
+
const registerProjectIds = resolveRegisterProjectIds(config, projectId, !!opts.project?.trim());
|
|
133
|
+
const steps = resolveSteps(scope, projectArgs, project, registerProjectIds);
|
|
114
134
|
if (steps.length === 0) {
|
|
115
135
|
logError(`No applicable steps for scope "${scope}". ` +
|
|
116
136
|
`Check that required paths are configured in specdojo.config.json.`);
|
package/dist/dashboard.js
CHANGED
|
@@ -3,7 +3,7 @@ import { join } from "node:path";
|
|
|
3
3
|
import yaml from "js-yaml";
|
|
4
4
|
import { defaultScheduleCalendar, buildScheduleIndex } from "./exec-schedule-index.js";
|
|
5
5
|
import { addWorkingDaysToDate } from "./exec-schedule-calendar.js";
|
|
6
|
-
import { readJson, toArtifactPath } from "./exec-shared.js";
|
|
6
|
+
import { readJson, stripTerminalControlSequences, toArtifactPath } from "./exec-shared.js";
|
|
7
7
|
import { readAllEventFiles } from "./exec-events.js";
|
|
8
8
|
import { getProjectExecutionPath, getProjectRoutinesPath, getProjectSchedulePath, getProjectTimelinePath, loadConfig, loadEnv, specdojoRootDir, } from "./specdojo-config.js";
|
|
9
9
|
import { resolveRegisterPaths, loadRegisterItems, } from "./register.js";
|
|
@@ -603,8 +603,18 @@ function routineScheduleLabel(doc) {
|
|
|
603
603
|
// ================================
|
|
604
604
|
// Markdown rendering
|
|
605
605
|
// ================================
|
|
606
|
-
|
|
607
|
-
|
|
606
|
+
const MAX_DASHBOARD_CELL_LENGTH = 200;
|
|
607
|
+
// dashboard の表へは event や subprocess 由来の文字列も入る。表へ埋める直前に
|
|
608
|
+
// ターミナル制御シーケンスと改行類を除き、列区切りをエスケープして長さを制限する。
|
|
609
|
+
export function sanitizeDashboardCell(text) {
|
|
610
|
+
const singleLine = stripTerminalControlSequences(text)
|
|
611
|
+
.replace(/[\t\r\n]+/g, " ")
|
|
612
|
+
.replace(/ +/g, " ")
|
|
613
|
+
.trim();
|
|
614
|
+
const truncated = singleLine.length <= MAX_DASHBOARD_CELL_LENGTH
|
|
615
|
+
? singleLine
|
|
616
|
+
: `${singleLine.slice(0, MAX_DASHBOARD_CELL_LENGTH)}…`;
|
|
617
|
+
return truncated.replace(/\|/g, "\\|");
|
|
608
618
|
}
|
|
609
619
|
const STATUS_ORDER = [
|
|
610
620
|
"open",
|
|
@@ -721,7 +731,7 @@ function renderTimelineSection(paths) {
|
|
|
721
731
|
const row = schedule.find((s) => s.track === tk.track);
|
|
722
732
|
if (!row)
|
|
723
733
|
continue;
|
|
724
|
-
lines.push(`| ${wave.wave} | \`${tk.track}\` | \`${tk.catalog_status}\` | ${formatEstimate(tk)} | ${row.startDate ?? "-"} | ${row.endDate ?? "-"} | ${
|
|
734
|
+
lines.push(`| ${wave.wave} | \`${tk.track}\` | \`${tk.catalog_status}\` | ${formatEstimate(tk)} | ${row.startDate ?? "-"} | ${row.endDate ?? "-"} | ${sanitizeDashboardCell(row.parallel_group ?? "-")} | ${sanitizeDashboardCell(row.depends_on.join(", ") || "-")} |`);
|
|
725
735
|
}
|
|
726
736
|
}
|
|
727
737
|
lines.push("");
|
|
@@ -776,7 +786,7 @@ function renderRoutineSection(paths) {
|
|
|
776
786
|
lines.push("| id | name | enabled | 間隔 / cron | kind | 最終実行 / 結果 | due |");
|
|
777
787
|
lines.push("| --- | --- | --- | --- | --- | --- | :---: |");
|
|
778
788
|
for (const row of agg.rows) {
|
|
779
|
-
lines.push(`| \`${row.id}\` | ${
|
|
789
|
+
lines.push(`| \`${row.id}\` | ${sanitizeDashboardCell(row.name ?? "-")} | ${row.enabled ? "enabled" : "disabled"} | \`${sanitizeDashboardCell(row.schedule)}\` | \`${row.kind}\` | ${sanitizeDashboardCell(row.lastRun)} | ${row.due} |`);
|
|
780
790
|
}
|
|
781
791
|
lines.push("");
|
|
782
792
|
return lines;
|
|
@@ -826,7 +836,7 @@ function renderGradeSection(paths) {
|
|
|
826
836
|
}
|
|
827
837
|
lines.push("| 成果物 | 対象 | verdict | score | findings |", "| --- | --- | --- | ---: | ---: |");
|
|
828
838
|
for (const result of results) {
|
|
829
|
-
lines.push(`| \`${
|
|
839
|
+
lines.push(`| \`${sanitizeDashboardCell(result.document)}\` | \`${result.target}\` | \`${result.verdict}\` | ${result.score} | ${gradeFindingCount(result)} |`);
|
|
830
840
|
}
|
|
831
841
|
lines.push("");
|
|
832
842
|
return lines;
|
|
@@ -858,7 +868,7 @@ function renderRecommendedRegisterSection(projectId) {
|
|
|
858
868
|
: dueMs < todayMs
|
|
859
869
|
? `期日超過 ${Math.ceil((todayMs - dueMs) / 86_400_000)}日`
|
|
860
870
|
: `期日まで ${Math.ceil((dueMs - todayMs) / 86_400_000)}日`;
|
|
861
|
-
lines.push(`| ${index + 1} | \`${row.id}\` | \`${row.type}\` | ${
|
|
871
|
+
lines.push(`| ${index + 1} | \`${row.id}\` | \`${row.type}\` | ${sanitizeDashboardCell(row.title)} | ${row.due} | \`${row.priority}\` | ${row.relatedOpenPjrCount} | ${row.registeredAt} | ${dueReason}、優先度 ${row.priority}、関連 open PJR ${row.relatedOpenPjrCount}件 |`);
|
|
862
872
|
});
|
|
863
873
|
lines.push("");
|
|
864
874
|
return lines;
|
|
@@ -874,7 +884,7 @@ function renderAttentionSection(paths) {
|
|
|
874
884
|
lines.push("| 種別 | id | 理由 | 次の行動 |");
|
|
875
885
|
lines.push("| --- | --- | --- | --- |");
|
|
876
886
|
for (const row of rows) {
|
|
877
|
-
lines.push(`| ${row.source} | \`${row.id}\` | ${
|
|
887
|
+
lines.push(`| ${row.source} | \`${row.id}\` | ${sanitizeDashboardCell(row.reason)} | ${sanitizeDashboardCell(row.nextAction)} |`);
|
|
878
888
|
}
|
|
879
889
|
}
|
|
880
890
|
catch (error) {
|
|
@@ -883,6 +893,121 @@ function renderAttentionSection(paths) {
|
|
|
883
893
|
lines.push("");
|
|
884
894
|
return lines;
|
|
885
895
|
}
|
|
896
|
+
// ================================
|
|
897
|
+
// 9. Exec records (plan / result 一覧)
|
|
898
|
+
// ================================
|
|
899
|
+
export const EXEC_RECORDS_FILE = "exec-records.md";
|
|
900
|
+
function readSpecdojoFrontmatter(filePath) {
|
|
901
|
+
try {
|
|
902
|
+
const content = readFileSync(filePath, "utf8");
|
|
903
|
+
const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
|
|
904
|
+
if (!match)
|
|
905
|
+
return {};
|
|
906
|
+
const parsed = yaml.load(match[1]);
|
|
907
|
+
if (typeof parsed !== "object" || parsed === null)
|
|
908
|
+
return {};
|
|
909
|
+
const specdojo = parsed.specdojo;
|
|
910
|
+
return typeof specdojo === "object" && specdojo !== null && !Array.isArray(specdojo)
|
|
911
|
+
? specdojo
|
|
912
|
+
: {};
|
|
913
|
+
}
|
|
914
|
+
catch {
|
|
915
|
+
// 壊れた frontmatter の記録も一覧から辿れるよう、属性なしの行として残す。
|
|
916
|
+
return {};
|
|
917
|
+
}
|
|
918
|
+
}
|
|
919
|
+
function frontmatterText(value) {
|
|
920
|
+
if (typeof value === "string" && value.trim())
|
|
921
|
+
return value.trim();
|
|
922
|
+
if (value instanceof Date)
|
|
923
|
+
return value.toISOString();
|
|
924
|
+
return undefined;
|
|
925
|
+
}
|
|
926
|
+
function listMarkdownFiles(dir, suffix) {
|
|
927
|
+
if (!existsSync(dir))
|
|
928
|
+
return [];
|
|
929
|
+
return readdirSync(dir)
|
|
930
|
+
.filter((name) => name.endsWith(suffix))
|
|
931
|
+
.sort();
|
|
932
|
+
}
|
|
933
|
+
// execution/exec/{plans,results} の記録を実行単位(ファイル名の stem)でまとめる。
|
|
934
|
+
// 並びは開始日時の新しい順、開始日時が無いものは後ろに stem 順で置く。
|
|
935
|
+
export function collectExecRecords(execPath) {
|
|
936
|
+
const rows = new Map();
|
|
937
|
+
const rowFor = (stem) => {
|
|
938
|
+
const existing = rows.get(stem);
|
|
939
|
+
if (existing)
|
|
940
|
+
return existing;
|
|
941
|
+
const created = { stem };
|
|
942
|
+
rows.set(stem, created);
|
|
943
|
+
return created;
|
|
944
|
+
};
|
|
945
|
+
for (const name of listMarkdownFiles(join(execPath, "plans"), "-plan.md")) {
|
|
946
|
+
const row = rowFor(name.slice(0, -"-plan.md".length));
|
|
947
|
+
const fm = readSpecdojoFrontmatter(join(execPath, "plans", name));
|
|
948
|
+
row.planFile = name;
|
|
949
|
+
row.taskId ??= frontmatterText(fm.task_id);
|
|
950
|
+
row.mode ??= frontmatterText(fm.mode);
|
|
951
|
+
}
|
|
952
|
+
for (const name of listMarkdownFiles(join(execPath, "results"), "-result.md")) {
|
|
953
|
+
const row = rowFor(name.slice(0, -"-result.md".length));
|
|
954
|
+
const fm = readSpecdojoFrontmatter(join(execPath, "results", name));
|
|
955
|
+
row.resultFile = name;
|
|
956
|
+
row.taskId = frontmatterText(fm.task_id) ?? row.taskId;
|
|
957
|
+
row.mode = frontmatterText(fm.mode) ?? row.mode;
|
|
958
|
+
row.status = frontmatterText(fm.status);
|
|
959
|
+
row.startedAt = frontmatterText(fm.started_at);
|
|
960
|
+
}
|
|
961
|
+
return [...rows.values()].sort((a, b) => {
|
|
962
|
+
if (a.startedAt && b.startedAt && a.startedAt !== b.startedAt) {
|
|
963
|
+
return a.startedAt < b.startedAt ? 1 : -1;
|
|
964
|
+
}
|
|
965
|
+
if (a.startedAt && !b.startedAt)
|
|
966
|
+
return -1;
|
|
967
|
+
if (!a.startedAt && b.startedAt)
|
|
968
|
+
return 1;
|
|
969
|
+
return a.stem.localeCompare(b.stem);
|
|
970
|
+
});
|
|
971
|
+
}
|
|
972
|
+
function execRecordLink(dir, file, label) {
|
|
973
|
+
return file ? `[${label}](../exec/${dir}/${file})` : "-";
|
|
974
|
+
}
|
|
975
|
+
export function buildExecRecordsMarkdown(projectId, rows) {
|
|
976
|
+
const lines = [
|
|
977
|
+
"# 実行記録一覧",
|
|
978
|
+
"",
|
|
979
|
+
`- project_id: \`${projectId}\``,
|
|
980
|
+
`- 再生成: \`specdojo dashboard build --project ${projectId}\``,
|
|
981
|
+
"",
|
|
982
|
+
"> このページは `specdojo dashboard build` が生成した派生ビューです。正本は `execution/exec/` 配下の plan / result であり、このページを手編集しても次回のビルドで失われます。実行記録はサイドバーに載せないため、このページから辿ります。",
|
|
983
|
+
"",
|
|
984
|
+
];
|
|
985
|
+
if (rows.length === 0) {
|
|
986
|
+
lines.push("- 実行記録はまだありません。");
|
|
987
|
+
return lines.join("\n");
|
|
988
|
+
}
|
|
989
|
+
lines.push(`- 件数: ${rows.length}`, "");
|
|
990
|
+
lines.push("| 開始日時 | task | mode | status | plan | result |");
|
|
991
|
+
lines.push("| --- | --- | --- | --- | --- | --- |");
|
|
992
|
+
for (const row of rows) {
|
|
993
|
+
const task = row.taskId ? `\`${sanitizeDashboardCell(row.taskId)}\`` : "-";
|
|
994
|
+
const mode = row.mode ? `\`${sanitizeDashboardCell(row.mode)}\`` : "-";
|
|
995
|
+
const status = row.status ? `\`${sanitizeDashboardCell(row.status)}\`` : "-";
|
|
996
|
+
lines.push(`| ${row.startedAt ? sanitizeDashboardCell(row.startedAt) : "-"} | ${task} | ${mode} | ${status} | ${execRecordLink("plans", row.planFile, "plan")} | ${execRecordLink("results", row.resultFile, "result")} |`);
|
|
997
|
+
}
|
|
998
|
+
return lines.join("\n");
|
|
999
|
+
}
|
|
1000
|
+
function execRecordsPath(paths) {
|
|
1001
|
+
return join(paths.executionGeneratedPath, "..", "exec");
|
|
1002
|
+
}
|
|
1003
|
+
function renderExecRecordsSection(paths) {
|
|
1004
|
+
const lines = ["## 9. 実行記録", ""];
|
|
1005
|
+
const rows = collectExecRecords(execRecordsPath(paths));
|
|
1006
|
+
const plans = rows.filter((row) => row.planFile).length;
|
|
1007
|
+
const results = rows.filter((row) => row.resultFile).length;
|
|
1008
|
+
lines.push(`- [実行記録一覧](./${EXEC_RECORDS_FILE})(plan ${plans} 件、result ${results} 件)`, "");
|
|
1009
|
+
return lines;
|
|
1010
|
+
}
|
|
886
1011
|
export function buildDashboardMarkdown(paths) {
|
|
887
1012
|
const lines = [];
|
|
888
1013
|
const nowLabel = new Date().toISOString().replace(/\.\d{3}Z$/, "");
|
|
@@ -902,6 +1027,7 @@ export function buildDashboardMarkdown(paths) {
|
|
|
902
1027
|
lines.push(...renderRecommendedRegisterSection(paths.projectId));
|
|
903
1028
|
lines.push(...renderAttentionSection(paths));
|
|
904
1029
|
lines.push(...renderGradeSection(paths));
|
|
1030
|
+
lines.push(...renderExecRecordsSection(paths));
|
|
905
1031
|
// 各セクションは次のセクションとの区切りとして空行で終わる。最後のセクションの空行を
|
|
906
1032
|
// そのまま残すと、書き出し時に付ける改行と合わさって末尾が空行2行になり markdownlint の
|
|
907
1033
|
// MD012 に触れるため、ここで末尾の空行を落とす。
|
|
@@ -914,6 +1040,11 @@ export function writeDashboard(paths) {
|
|
|
914
1040
|
const mdPath = join(paths.executionGeneratedPath, "dashboard.md");
|
|
915
1041
|
writeFileSync(mdPath, markdown + "\n", "utf8");
|
|
916
1042
|
generatedFiles.push(toArtifactPath(mdPath));
|
|
1043
|
+
// 実行記録はサイドバーに載せないため、ダッシュボードから辿る一覧ページを並置する。
|
|
1044
|
+
const recordsPath = join(paths.executionGeneratedPath, EXEC_RECORDS_FILE);
|
|
1045
|
+
const recordsMarkdown = buildExecRecordsMarkdown(paths.projectId, collectExecRecords(execRecordsPath(paths)));
|
|
1046
|
+
writeFileSync(recordsPath, recordsMarkdown + "\n", "utf8");
|
|
1047
|
+
generatedFiles.push(toArtifactPath(recordsPath));
|
|
917
1048
|
// timeline gantt SVG を並置。tml-index が無い/壊れている場合はスキップ。
|
|
918
1049
|
const indexPath = join(paths.timelinePath, "tml-index.yaml");
|
|
919
1050
|
if (existsSync(indexPath)) {
|
|
@@ -938,7 +1069,7 @@ export function buildDashboard(opts) {
|
|
|
938
1069
|
}
|
|
939
1070
|
// build-command ステップで使う出力先の解決を公開する。
|
|
940
1071
|
export function dashboardOutputFiles(paths) {
|
|
941
|
-
return ["dashboard.md", "dashboard-timeline-gantt.svg"].map((name) => toArtifactPath(join(paths.executionGeneratedPath, name)));
|
|
1072
|
+
return ["dashboard.md", EXEC_RECORDS_FILE, "dashboard-timeline-gantt.svg"].map((name) => toArtifactPath(join(paths.executionGeneratedPath, name)));
|
|
942
1073
|
}
|
|
943
1074
|
// ================================
|
|
944
1075
|
// CLI command
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { runDevcontainerScaffold } from "./devcontainer-scaffold.js";
|
|
2
|
+
import { specdojoPackageRootDir } from "./package-paths.js";
|
|
3
|
+
import { specdojoRootDir } from "./specdojo-config.js";
|
|
4
|
+
export function registerDevcontainerCommands(program) {
|
|
5
|
+
const dc = program.command("devcontainer").description("Dev Container helpers");
|
|
6
|
+
dc.command("scaffold")
|
|
7
|
+
.description("Scaffold .devcontainer/ configuration for the repository")
|
|
8
|
+
.option("--provider <names>", "Comma-separated list of agent providers to install (e.g. claude,codex,opencode,antigravity)", "")
|
|
9
|
+
.option("--editor <names>", "Comma-separated list of editors to install and configure (currently: emacs)", "")
|
|
10
|
+
.option("--ollama", "Add Ollama connection settings", false)
|
|
11
|
+
.option("--cron", "Add cron support", false)
|
|
12
|
+
.option("--tmux", "Add tmux", false)
|
|
13
|
+
.option("--force", "Overwrite existing .devcontainer/", false)
|
|
14
|
+
.option("--dry-run", "Show planned files without writing", false)
|
|
15
|
+
.action(async (opts) => {
|
|
16
|
+
try {
|
|
17
|
+
await runDevcontainerScaffold({
|
|
18
|
+
packageRoot: specdojoPackageRootDir(),
|
|
19
|
+
repoRoot: specdojoRootDir(),
|
|
20
|
+
providers: opts.provider
|
|
21
|
+
? String(opts.provider)
|
|
22
|
+
.split(",")
|
|
23
|
+
.map((s) => s.trim())
|
|
24
|
+
: [],
|
|
25
|
+
editors: opts.editor
|
|
26
|
+
? String(opts.editor)
|
|
27
|
+
.split(",")
|
|
28
|
+
.map((s) => s.trim())
|
|
29
|
+
: [],
|
|
30
|
+
ollama: !!opts.ollama,
|
|
31
|
+
cron: !!opts.cron,
|
|
32
|
+
tmux: !!opts.tmux,
|
|
33
|
+
force: !!opts.force,
|
|
34
|
+
dryRun: !!opts.dryRun,
|
|
35
|
+
});
|
|
36
|
+
}
|
|
37
|
+
catch (error) {
|
|
38
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
39
|
+
process.stderr.write(`${message}\n`);
|
|
40
|
+
process.exitCode = 1;
|
|
41
|
+
}
|
|
42
|
+
});
|
|
43
|
+
}
|