specdojo 0.8.0 → 0.9.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 +4 -1
- package/CHANGELOG.md +64 -0
- package/dist/catalog/catalog.js +16 -14
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +4 -2
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard.js +5 -3
- package/dist/dashboard/routines.js +4 -7
- package/dist/dashboard/timeline.js +14 -14
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +146 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +9 -0
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +31 -18
- package/dist/exec/events.js +34 -14
- package/dist/exec/evidence.js +13 -3
- package/dist/exec/parent-validation.js +56 -3
- package/dist/exec/plans-core.js +21 -2
- package/dist/exec/plans-generation.js +6 -7
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/repo-integration-sync.js +17 -5
- package/dist/exec/reporter.js +2 -2
- package/dist/exec/results.js +24 -4
- package/dist/exec/review-kata.js +4 -1
- package/dist/exec/run/agent-pipeline.js +3 -2
- package/dist/exec/run/agent.js +12 -6
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +4 -1
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +56 -19
- package/dist/exec/run/lifecycle-commands.js +1 -1
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/register-command.js +8 -5
- package/dist/exec/run/register-mode.js +68 -8
- package/dist/exec/run/register-resume.js +68 -14
- package/dist/exec/run/register-state.js +13 -8
- package/dist/exec/run/register-worktree.js +140 -125
- package/dist/exec/run/schedule-mode.js +75 -14
- package/dist/exec/run/schedule-prepare.js +3 -0
- package/dist/exec/run/schedule-task.js +88 -38
- package/dist/exec/run/shared.js +5 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +13 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trial-commands.js +5 -2
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +9 -1
- package/dist/exec/worktree-ops-commit.js +2 -2
- package/dist/exec/worktree.js +13 -2
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +5 -3
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +5 -1
- package/dist/grade/run.js +64 -8
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +79 -23
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/maintenance-commands.js +2 -2
- package/dist/register/register.js +31 -7
- package/dist/routine/definition.js +9 -0
- package/dist/routine/routine.js +137 -43
- package/dist/routine/status.js +62 -0
- package/dist/schedule/schedule.js +38 -39
- package/dist/shared/agent-types.js +5 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +44 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/specdojo-config.js +34 -20
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +9 -1
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
- package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
- package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
- package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
- package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
- package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
- package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
- package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
- package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +257 -117
- package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
- package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bds-sample.md +58 -71
- package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
- package/docs/ja/specdojo/samples/bes-sample.md +43 -53
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +40 -52
- package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
- package/docs/ja/specdojo/samples/clis-sample.md +70 -77
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
- package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
- package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
- package/docs/ja/specdojo/samples/sf-sample.md +73 -85
- package/docs/ja/specdojo/samples/sld-sample.md +60 -79
- package/docs/ja/specdojo/samples/uis-sample.md +98 -121
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +9 -6
- package/templates/antigravity/orchestrator.md +4 -1
- package/templates/claude/agents/specdojo-orchestrator.md +4 -1
- package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
- package/templates/codex/orchestrator.md +4 -1
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
|
@@ -22,6 +22,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
22
22
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
23
23
|
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
24
24
|
- 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
|
|
25
|
+
- 書き込みを伴う git 操作(commit・merge・add・restore など)は `npx specdojo git --project <project-id> -- <git の引数>` で流し、runner の統合と同じロックに並べる。register の記帳は、これまでどおり `register ... --commit` を使う。
|
|
25
26
|
- commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
|
|
26
27
|
- register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
|
|
27
28
|
- 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
|
|
@@ -31,7 +32,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
31
32
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
32
33
|
- 状態遷移の `--by` には、実際にその判断や作業をした主体を書く。利用者が決定・承認した記録は、役割の名前(`PO` など)ではなく人の名簿の nickname で残す。自分が確かめて close する記録や、自分で行った起票・記帳は `specdojo-orchestrator` で残す。`--by` は人と agent の名簿の nickname・alias と予約名(`SpecDojo`・`specdojo-orchestrator`・`night-orchestrator`)だけを受け付け、それ以外は記帳の前にエラーで止まる。
|
|
33
34
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
34
|
-
- `specdojo.config.json` の project に `repos`
|
|
35
|
+
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリ(`.specdojo/specdojo.local.config.json` で追加・パスを差し替えたものを含む。`specdojo config show` で確かめる)は参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
35
36
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
36
37
|
- 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
|
|
37
38
|
- タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
|
|
@@ -68,6 +69,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
68
69
|
| 進捗の俯瞰 | `dashboard` | `dashboard build` |
|
|
69
70
|
| 品質評価 | `grade` | `grade list` / `plan` / `apply` |
|
|
70
71
|
| ドキュメントIDインデックス | `index` | `index build` |
|
|
72
|
+
| 保存先の確認 | `where` | `where <kind> --project <project-id>` |
|
|
71
73
|
| 全生成物の一括更新 | `build` | `build` |
|
|
72
74
|
|
|
73
75
|
正確なオプションは実行前に `npx specdojo <command> --help` で確認する。詳細は `docs/ja/specdojo/references/command-reference.md`、設定キーは `docs/ja/specdojo/references/specdojo-config-reference.md` を参照する。
|
|
@@ -172,6 +174,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
172
174
|
|
|
173
175
|
- `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
|
|
174
176
|
- 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
|
|
177
|
+
- grade・`exec run`・build を順に流すときは、待ち合わせのシェルスクリプトを書かず `specdojo exec queue add <queue-id> --step "..."` で予約し、`specdojo exec queue run <queue-id>` を background で流す。進み具合は `exec queue status <queue-id>` か `exec status` の `queues:` で確かめる。止まった予約は原因を直してから同じ `exec queue run` で再開する。
|
|
175
178
|
- プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
|
|
176
179
|
- 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
|
|
177
180
|
- 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
|
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,70 @@ SpecDojo の利用者に影響する変更を記録します。
|
|
|
4
4
|
|
|
5
5
|
## [Unreleased]
|
|
6
6
|
|
|
7
|
+
## [0.9.0] - 2026-11-20
|
|
8
|
+
|
|
9
|
+
同梱パッケージは `@specdojo/docs-lint` 0.5.0 と `@specdojo/docs-site` 0.6.0 を同時に公開します。動作に必要な Node.js は 22.17 以上です。
|
|
10
|
+
|
|
11
|
+
### 利用者から見て動きが変わる点
|
|
12
|
+
|
|
13
|
+
- 動作に必要な Node.js を 22.17 以上にしました。ファイル検索を `tinyglobby` から Node.js 組み込みの `fs.globSync` へ移したためです。`@specdojo/docs-lint` も 22.13 から 22.17 へ引き上げました(PJR-5CTM)。
|
|
14
|
+
- `@specdojo/docs-lint` の `**` による検索は、ディレクトリへのシンボリックリンクの中へ入らなくなりました。ファイルへのシンボリックリンクは今までどおり対象です(PJR-5CTM)。
|
|
15
|
+
- `@specdojo/docs-lint` の markdownlint-cli を 0.50 へ上げました。ファイルの末尾に空行が続く Markdown を MD012 として検出するようになります(PJR-A5FY)。
|
|
16
|
+
- `<kind> where` は 1 版の移行期間の互換の入口になりました。`specdojo where <kind>` を使ってください。旧構文は標準エラーへ新構文と削除予定を警告します(PJR-JKQX)。
|
|
17
|
+
- schedule のタスクの agent は、track に書いた値ではなく strategy の `owner_rules[].phase_overrides[].agent`・phase の `agent` から決まります。track を直接編集すると `exec validate` と `exec run --auto` が警告します(PJR-YGZF)。
|
|
18
|
+
|
|
19
|
+
### 追加機能
|
|
20
|
+
|
|
21
|
+
- `specdojo exec queue` を追加しました。grade・`exec run`(register・schedule)・`post-integration build-dist` を混ぜた順番を `execution/queues/<queue-id>.json` に予約し、前の段の終わりを待って順に流します。段ごとに失敗時の停止・継続を指定でき、止まった段から再開できます。進み具合は `exec queue status` と `exec status` で確かめられます(PJR-1565)。
|
|
22
|
+
- `specdojo exec smoke` を追加しました。統合済みの項目を確認用の個票へ記帳し、開き直して worktree で流し、今回の start と review の event と実体の actor を確かめるところまでを 1 つのコマンドで行います。`--dry-run` に対応します(PJR-8NB8)。
|
|
23
|
+
- `specdojo git -- <Git の引数>` を追加しました。Git の書き込みを runner と同じ lifecycle ロックに並べ、hook の実行中も排他します。読み取りはロックを待ちません。lefthook の scaffold は、run 中のロックのない commit を警告します(PJR-30SA)。
|
|
24
|
+
- `specdojo where <kind>` で exec・catalog・schedule・timeline・job・routine の保存先を確かめられるようにしました(PJR-JKQX)。
|
|
25
|
+
- git で管理しないローカル設定 `.specdojo/specdojo.local.config.json` で、`repos[].path` の差し替えとローカルのリポジトリの追加をできるようにしました。`specdojo config show` を追加し、`where exec` と executor の evidence の `local_config_overrides` でローカル由来の値を示します。`config init` は `.gitignore` にこのファイルを足します(PJR-NC9R)。
|
|
26
|
+
- `exec run` の worktree 実行で、統合した変更が `paths` に当たるときだけ、統合の後に `pipeline.post_integration` の固定の処理(`build-dist` = `npm run build`)を流せるようにしました。失敗しても統合は戻さず、次の `exec` は dist の鮮度の判定で止まります(PJR-8KXJ)。
|
|
27
|
+
- 1 段の時間を短くする設定を追加しました。`pipeline.parent_validations` の要素の `paths` で、executor が変えたファイルに合う検証だけを流します。`pipeline.commit_hook_skips` で、親の検証で済んだ検査の hook を統合の commit で流し直さないようにできます。`pipeline.mechanical_result: true` で、決まった形の edit の result を reporter の agent を起こさずに runner が作ります。worktree の準備の `npm ci` には `--prefer-offline --no-audit --no-fund` を付けました(PJR-T01P)。
|
|
28
|
+
- register の並べた実行・join と schedule の自動実行で、変更範囲が重なる項目を、先の項目の統合の後まで待たせるようにしました。推定できない範囲は `--unknown-scope parallel|serialize` で扱いを選べます(PJR-MJ8V)。
|
|
29
|
+
- command Job の `task.steps` で、exec・grade・build を順に流せるようにしました。段ごとの停止・継続、終了コードと状態ファイルによる完了の判定、ロックの有限の待機、実行時間の上限、試行ごとの段の結果を記録し、routine や cron から起動できます(PJR-V0FQ)。
|
|
30
|
+
- `routine status` を追加しました。routine の状態、busy で skip した回の流し直し待ち、skip の内訳つきの直近の実行履歴を表示します(PJR-KVWH)。
|
|
31
|
+
- agent の習熟度に最上位の `frontier` を追加しました。名前指定か `proficiency: frontier` を明示したときだけ使い、自動選択や rate limit の代わりの候補には含めません。provider の `by_proficiency.frontier` の設定が必要です(PJR-DGRZ)。
|
|
32
|
+
- 親の検証の記録(`parent-validation-metrics.jsonl`)に、検証ごとの待ち時間と所要時間、同時に動いている run と executor の数、Linux の負荷、時間切れのときに実行中だったテストのファイルを残すようにしました(PJR-C07H)。
|
|
33
|
+
- `grade run` は、完了と失敗の文書が混ざると終了コード 2、rate limit で 75 を返します。`--reference-per-kind` で、kata の各文書を同じ種別の `prj-overview` の文書と比べられます(PJR-R7BQ)。
|
|
34
|
+
- `specdojo yaml-pages build` が、外部システムI/F一覧(`ifx-index*.yaml`)から表形式の表示ページを生成するようになりました。連携の一覧・連携ごとの詳細・注記を表示します(PJR-QJ41)。
|
|
35
|
+
- 実装の段の型として、agent 向けのコーディング規約(言語別の instructions)の型 `cdr` の rulebook・sample・template を追加しました(PJR-981V)。
|
|
36
|
+
- VS Code 拡張の「SpecDojo: Open Document by ID」の画面仕様(`uis-open-document-by-id`)を追加しました(PJR-3MTS)。
|
|
37
|
+
- `@specdojo/docs-site` は、利用リポジトリに `docs/index.md` がないとき、SpecDojo の文書と project ごとのトップへのリンクを置いたトップのページを用意するようになりました。今までは `/<base>/` が 404 になっていました。`docs/` の下の project のトップ(`/ja/projects/<project-id>/`)に `index.md` がないときも、登録簿の一覧・派生ビュー・管理ログへのリンクを置いたページを用意します(PJR-PEJS)。
|
|
38
|
+
|
|
39
|
+
### 変更
|
|
40
|
+
|
|
41
|
+
- 実践の型の rulebook と recipe から、どの成果物にも共通する文書の運用(役割の表、status の昇格と承認、公開の条件、改訂と廃止の手順、未決事項の管理台帳の列など)と、rulebook と同じ判断の言い直しを外し、ドキュメントメタ情報標準とメンバー定義への参照にしました。型ごとの判断の基準・良い例と悪い例・禁止事項・受入の確認は残しています。変えた rulebook と recipe の 137 ファイルで、空白を除いた文字数を約 24% 減らしました(kata-slim-2)。
|
|
42
|
+
- 区分ごとの生成を `build --only <区分>` にまとめました。index・catalog・schedule・register・dashboard・yaml-pages を選べます。今までの個別の build と `build --scope` は内部の互換用として残します(PJR-C4J1)。
|
|
43
|
+
- `grade` の `plan`・`apply`・`translation-plan`・`localize`・`state`・`result`・`validate`、`agent launch`・`agent run`、`exec trial`・`exec slots`・`exec scheduler` を、内部用として help の一覧から外しました。コマンドは今までどおり実行できます。定期の job(`job-grade-kata`・`job-grade-deliverable`)は `grade run` で評価します(PJR-R7BQ)。
|
|
44
|
+
- 画面仕様(uis)の rulebook と sample から共通の運用の記述を外し、ファイル名の規則を `uis-<term>.md` に改めました(PJR-3MTS)。
|
|
45
|
+
- 概念クラス図(ccd)の向きを上から下を既定にし、ccd-mermaid-rulebook に向きの決まりを足しました(PJR-K3Z2)。
|
|
46
|
+
- 移行計画の sample(`mip-index-sample`)を rulebook の章の構成で書き直しました。`docs/ja/index.md` の表から古い駄菓子屋の sample(`sample-gcs-projects/`・`sample-gcs-product/`)の行を外しました(PJR-QTB6)。
|
|
47
|
+
- exec の設定の `rate_limit_policy.on_non_critical` が互換用の必須項目で、実行時には使われないことを、schema・設定ガイド・初期設定の例に書きました。受け付ける形式と動きは変えていません(PJR-DH8E)。
|
|
48
|
+
- 配る依存の npm audit の high と moderate をなくしました。`tinyglobby` を依存から外し(PJR-5CTM)、`@specdojo/docs-lint` の markdownlint-cli を 0.50 へ上げました。`glob`・`minimatch` 起因の moderate は上流の修正を待ちます(PJR-A5FY)。
|
|
49
|
+
- YAML を正本とする業務データ辞書・ロールとメンバーの定義・レビュー観点・外部コマンドとファイルの連携仕様・旧トラック順序計画・成果物カタログ・マイルストーンの表示ページを表形式にし、YAML の正本を折りたたんで添えるようにしました(PJR-2HT5)。
|
|
50
|
+
- 用語集の YAML の表示ページを分類ごとの表にし、関連用語へのページ内リンクと YAML の正本の折りたたみを足しました(PJR-4YS7)。
|
|
51
|
+
|
|
52
|
+
### 不具合修正
|
|
53
|
+
|
|
54
|
+
- `register ... --commit` の `-m` を繰り返せるようにし、`git commit -m` と同じく件名と本文の段落にしました。今までは 2 つ目の `-m` だけが message になり、commitlint に拒まれて記帳だけが残っていました。commit に失敗したときは、記帳済みで未 commit のファイルを示して終了コード 1 で終わります(PJR-Y3XS)。
|
|
55
|
+
- schedule のタスクの統合が、`register ... --commit` と同じ lifecycle ロックを取るようにしました。記帳の commit の途中に始まった統合が `Staged changes in integration target` で止まらなくなります(PJR-Y3XS)。
|
|
56
|
+
- `register ... --commit` と `specdojo git -- commit ... -- <pathspec>` の後に、commit の hook が整形して stage したファイルが index に残らないようにしました(PJR-Y3XS)。
|
|
57
|
+
- 完了条件の「保護された設定は変えない」「`CHANGELOG.md` は変えず」などの文のパスを変更範囲に含め、関係のない項目を順番待ちや未統合のエラーにしていた誤判定を直しました。kata を扱う run も、変更を許すディレクトリ全体ではなく個別の対象ファイルで範囲を判定します(PJR-9JN6)。
|
|
58
|
+
- 変更範囲の推定から、生成した plan の共通の手順と生成物を外しました。範囲の重ならない項目が、共通の文の `pjr-index.md` で順番待ちになっていました(PJR-MJ8V)。
|
|
59
|
+
- `kind: generated` の成果物がカタログで rulebook を宣言しているとき、rulebook-maintenance などの型の整備の段の plan が、編集対象の型を `_MISSING_`(unresolved)にせず宣言どおりに解決するようにしました(PJR-DM9B)。
|
|
60
|
+
- pjr の rulebook など、登録簿の個票ではない `pjr-*.md` だけを変えた run で、executor が `npm run validate:history-links` を `not_applicable` と報告すると runner が拒んで止まる不具合を直しました(PJR-8Z71)。
|
|
61
|
+
- `exec run` の register の再開で、wait の commit を結果なしでやり直した後や記帳を手で commit した後でも、executor が個票に書いた対応結果が再開の前の同期で消えないようにしました(PJR-EWZG)。
|
|
62
|
+
- executor の commit の対象外の変更で止まったときの理由に、4 件目以降のパスも含めるようにしました(PJR-1Y1M)。
|
|
63
|
+
- `routine` で、別の run がロックを持っていて skip した回を、済んだ回として記録しないようにしました。cron の routine は `missed_run` が `latest`・`all` のとき空いた次の `routine run --due` でその回を流し直し、interval の routine は次の回で due になります。busy の skip が 24 回を超えて続いたら、その回を済んだ回として扱います(PJR-KVWH)。
|
|
64
|
+
- 夜間の job の worktree の中で止まった register の子の run を、主の作業ツリーから `exec run --register <id> --resume` で再開できるようにしました(PJR-97KE)。
|
|
65
|
+
- `exec run` の worktree 実行で、統合の後の worktree と exec ブランチの撤去を lifecycle ロックの外で行うようにしました。撤去に時間がかかっても、別の項目の記帳と `specdojo git` が待たされません(PJR-NHT7)。
|
|
66
|
+
- `exec run --register` で、指名した agent が難易度別の振り分けの代わりの agent と重なるとき、start の記帳や worktree の作成の前に終了コード 1 で止まるようにしました。今までは start の後に止まり、終了コード 0 で終わっていました(PJR-A61W)。
|
|
67
|
+
- 文書サイトのビルドの対象から run 単位の plan と result を外し、実行記録の一覧などのリンクを GitHub の正本へ向けました。`docs:build` のメモリ不足を直しました(PJR-T4X7)。
|
|
68
|
+
- reporter の停止・再開と統合の停止が同じ秒に記録されたとき、イベントの並び順によって統合の再開で reporter を余分に起動していた問題を直しました(PJR-ZK3T)。
|
|
69
|
+
- runner が executor の condense の記録と `block_reason` を result の frontmatter へ書き写すとき、山括弧の語をコードの書式で包むようにしました。今までは lint-fm を落としていました(PJR-V141)。
|
|
70
|
+
|
|
7
71
|
## [0.8.0] - 2026-11-16
|
|
8
72
|
|
|
9
73
|
同梱パッケージは `@specdojo/docs-site` 0.5.0 と `@specdojo/docs-lint` 0.4.1 を同時に公開します。docs-site 0.5.0 は、対話のコードブロックの描画(`chat`・`chat tui`、PJR-GZ42)と、型の文書から作るメニュー(PJR-C8J8)を含みます。docs-lint 0.4.1 は、remark の無視対象の扱い(PJR-FTRC)と履歴リンクの検査の対象の更新(PJR-C4KF)を含みます。
|
package/dist/catalog/catalog.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { registerDeprecatedWhereAlias } from "../shared/where-alias.js";
|
|
1
2
|
import { join, relative, resolve } from "node:path";
|
|
2
3
|
import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
3
4
|
import { dirname } from "node:path";
|
|
@@ -216,21 +217,20 @@ function runPlanScaffold(opts) {
|
|
|
216
217
|
if (!allOk)
|
|
217
218
|
process.exitCode = 1;
|
|
218
219
|
}
|
|
220
|
+
export function printCatalogPaths(opts) {
|
|
221
|
+
try {
|
|
222
|
+
const catalogPath = resolveCatalogPath(opts);
|
|
223
|
+
process.stdout.write(`catalog-path: ${catalogPath}\n`);
|
|
224
|
+
process.stdout.write(`generated : ${join(catalogPath, "generated")}\n`);
|
|
225
|
+
process.stdout.write(`plans : ${resolvePlansDir(catalogPath)}\n`);
|
|
226
|
+
}
|
|
227
|
+
catch (error) {
|
|
228
|
+
printCommandError(error);
|
|
229
|
+
}
|
|
230
|
+
}
|
|
219
231
|
export function registerCatalogCommands(program) {
|
|
220
232
|
const cat = program.command("catalog").description("Deliverables catalog (dct-*.yaml) commands");
|
|
221
|
-
|
|
222
|
-
addProjectOption(wcmd);
|
|
223
|
-
wcmd.action((opts) => {
|
|
224
|
-
try {
|
|
225
|
-
const catalogPath = resolveCatalogPath(opts);
|
|
226
|
-
process.stdout.write(`catalog-path: ${catalogPath}\n`);
|
|
227
|
-
process.stdout.write(`generated : ${join(catalogPath, "generated")}\n`);
|
|
228
|
-
process.stdout.write(`plans : ${resolvePlansDir(catalogPath)}\n`);
|
|
229
|
-
}
|
|
230
|
-
catch (error) {
|
|
231
|
-
printCommandError(error);
|
|
232
|
-
}
|
|
233
|
-
});
|
|
233
|
+
registerDeprecatedWhereAlias(cat, printCatalogPaths);
|
|
234
234
|
const vcmd = cat.command("validate").description("Validate dct-*.yaml files");
|
|
235
235
|
addProjectOption(vcmd);
|
|
236
236
|
vcmd.action((opts) => {
|
|
@@ -314,7 +314,9 @@ export function registerCatalogCommands(program) {
|
|
|
314
314
|
printCommandError(error);
|
|
315
315
|
}
|
|
316
316
|
});
|
|
317
|
-
const bcmd = cat
|
|
317
|
+
const bcmd = cat
|
|
318
|
+
.command("build", { hidden: true })
|
|
319
|
+
.description("Internal compatibility entry for build --only catalog");
|
|
318
320
|
addProjectOption(bcmd);
|
|
319
321
|
bcmd.action((opts) => {
|
|
320
322
|
try {
|
package/dist/commands/agent.js
CHANGED
|
@@ -4,9 +4,11 @@ import { runOrchestratorLaunch } from "./orchestrator.js";
|
|
|
4
4
|
import { AGENT_RUN_RATE_LIMIT_EXIT_CODE, runAgentPlan, writeAgentOutput, } from "../exec/agent-plan.js";
|
|
5
5
|
export { AGENT_RUN_RATE_LIMIT_EXIT_CODE, resolveAgentMember, resolveAgentCommand, readAgentPlan, writeAgentOutput, runAgentPlan, } from "../exec/agent-plan.js";
|
|
6
6
|
export function registerAgentCommands(program) {
|
|
7
|
-
const agent = program
|
|
7
|
+
const agent = program
|
|
8
|
+
.command("agent", { hidden: true })
|
|
9
|
+
.description("Run a plan with a specific agent");
|
|
8
10
|
agent
|
|
9
|
-
.command("launch")
|
|
11
|
+
.command("launch", { hidden: true })
|
|
10
12
|
.description("Launch agy with role-specific session permissions and runner-declared roots")
|
|
11
13
|
.requiredOption("--provider <name>", "Provider CLI (antigravity)")
|
|
12
14
|
.requiredOption("--role <role>", "Pipeline role (edit|review|report)")
|
|
@@ -36,7 +38,7 @@ export function registerAgentCommands(program) {
|
|
|
36
38
|
}
|
|
37
39
|
});
|
|
38
40
|
agent
|
|
39
|
-
.command("run")
|
|
41
|
+
.command("run", { hidden: true })
|
|
40
42
|
.description("Feed a plan to one agent and capture its stdout")
|
|
41
43
|
.requiredOption("--plan <path>", "Plan file passed to the agent on stdin")
|
|
42
44
|
.requiredOption("--by <nickname>", "Agent nickname defined in agent-members.yaml")
|
package/dist/commands/build.js
CHANGED
|
@@ -1,9 +1,11 @@
|
|
|
1
|
+
import { Option } from "commander";
|
|
1
2
|
import { spawnSync } from "node:child_process";
|
|
2
3
|
import { loadConfig, loadEnv, specdojoRootDir } from "../shared/specdojo-config.js";
|
|
3
4
|
import { selfRunArgs } from "../shared/spawn-self.js";
|
|
4
5
|
const VALID_SCOPES = [
|
|
5
6
|
"exec",
|
|
6
7
|
"catalog",
|
|
8
|
+
"schedule",
|
|
7
9
|
"register",
|
|
8
10
|
"yaml-pages",
|
|
9
11
|
"dashboard",
|
|
@@ -23,6 +25,8 @@ function isStepApplicable(scope, project) {
|
|
|
23
25
|
return !!(project.schedule_path?.trim() && project.execution_path?.trim());
|
|
24
26
|
case "catalog":
|
|
25
27
|
return !!project.catalog_path?.trim();
|
|
28
|
+
case "schedule":
|
|
29
|
+
return !!project.schedule_path?.trim();
|
|
26
30
|
case "register":
|
|
27
31
|
return !!project.project_register_path?.trim();
|
|
28
32
|
case "dashboard":
|
|
@@ -47,11 +51,40 @@ export function resolveRegisterProjectIds(config, projectId, isProjectExplicit)
|
|
|
47
51
|
.filter((id) => isStepApplicable("register", config.projects[id]))
|
|
48
52
|
.sort();
|
|
49
53
|
}
|
|
50
|
-
export function resolveSteps(scope, projectArgs, project, registerProjectIds) {
|
|
54
|
+
export function resolveSteps(scope, projectArgs, project, registerProjectIds, opts = {}) {
|
|
55
|
+
// schedule build は管理対象の track YAML を上書きし得るため、従来の一括 build には
|
|
56
|
+
// 加えず、track を明示した --only schedule のときだけ実行する。
|
|
57
|
+
if (scope === "schedule") {
|
|
58
|
+
const track = opts.track?.trim();
|
|
59
|
+
if (!track)
|
|
60
|
+
throw new Error("--only schedule requires --track <track>");
|
|
61
|
+
return isStepApplicable(scope, project)
|
|
62
|
+
? [
|
|
63
|
+
{
|
|
64
|
+
scope,
|
|
65
|
+
label: "schedule build",
|
|
66
|
+
subArgs: [
|
|
67
|
+
"schedule",
|
|
68
|
+
"build",
|
|
69
|
+
...projectArgs,
|
|
70
|
+
"--track",
|
|
71
|
+
track,
|
|
72
|
+
...(opts.force ? ["--force"] : []),
|
|
73
|
+
],
|
|
74
|
+
},
|
|
75
|
+
]
|
|
76
|
+
: [];
|
|
77
|
+
}
|
|
51
78
|
const registerSteps = registerProjectIds.map((id) => ({
|
|
52
79
|
scope: "register",
|
|
53
80
|
label: registerProjectIds.length > 1 ? `register build (${id})` : "register build",
|
|
54
|
-
subArgs: [
|
|
81
|
+
subArgs: [
|
|
82
|
+
"register",
|
|
83
|
+
"build",
|
|
84
|
+
"--project",
|
|
85
|
+
id,
|
|
86
|
+
...(opts.registerScope ? ["--scope", opts.registerScope] : []),
|
|
87
|
+
],
|
|
55
88
|
}));
|
|
56
89
|
const candidates = [
|
|
57
90
|
{
|
|
@@ -68,7 +101,7 @@ export function resolveSteps(scope, projectArgs, project, registerProjectIds) {
|
|
|
68
101
|
{
|
|
69
102
|
scope: "yaml-pages",
|
|
70
103
|
label: "yaml-pages build",
|
|
71
|
-
subArgs: ["yaml-pages", "build"],
|
|
104
|
+
subArgs: ["yaml-pages", "build", ...(opts.root ? ["--root", opts.root] : [])],
|
|
72
105
|
},
|
|
73
106
|
// dashboard は execution/generated/dashboard.md + timeline Gantt SVG を生成する。
|
|
74
107
|
// state.json / ready.json(exec refresh)と tml-index / rtn-*.yaml / routine-state.json
|
|
@@ -81,7 +114,12 @@ export function resolveSteps(scope, projectArgs, project, registerProjectIds) {
|
|
|
81
114
|
{
|
|
82
115
|
scope: "index",
|
|
83
116
|
label: "index build",
|
|
84
|
-
subArgs: [
|
|
117
|
+
subArgs: [
|
|
118
|
+
"index",
|
|
119
|
+
"build",
|
|
120
|
+
...(opts.root ? ["--root", opts.root] : []),
|
|
121
|
+
...(opts.output ? ["--output", opts.output] : []),
|
|
122
|
+
],
|
|
85
123
|
},
|
|
86
124
|
];
|
|
87
125
|
const active = scope === "all" ? candidates : candidates.filter((s) => s.scope === scope);
|
|
@@ -103,14 +141,35 @@ function logError(msg) {
|
|
|
103
141
|
export function registerBuildCommand(program) {
|
|
104
142
|
program
|
|
105
143
|
.command("build")
|
|
106
|
-
.description("Run
|
|
144
|
+
.description("Run default build steps (exec → catalog → register → yaml-pages → dashboard → index); select one with --only")
|
|
107
145
|
.option("--project <id>", "Project ID (specdojo.config.json)")
|
|
108
|
-
.
|
|
146
|
+
.addOption(new Option("--only <category>", "Build only this category")
|
|
147
|
+
.choices(VALID_SCOPES.filter((scope) => scope !== "all"))
|
|
148
|
+
.conflicts("scope"))
|
|
149
|
+
.addOption(new Option("--scope <scope>", "Compatibility alias for --only (all runs every default step)")
|
|
150
|
+
.choices(VALID_SCOPES)
|
|
151
|
+
.hideHelp())
|
|
152
|
+
.option("--track <track>", "Track name (required for --only schedule)")
|
|
153
|
+
.option("--force", "Overwrite existing track YAML (only with --only schedule)")
|
|
154
|
+
.option("--root <path>", "Root directory to scan (only with --only index or yaml-pages)")
|
|
155
|
+
.option("--output <path>", "Index output path (only with --only index)")
|
|
156
|
+
.addOption(new Option("--register-scope <scope>", "Views to generate (only with --only register)").choices(["register", "controls", "all"]))
|
|
109
157
|
.option("--dry-run", "Print commands without executing", false)
|
|
110
158
|
.action((opts) => {
|
|
111
|
-
const scope = opts.scope;
|
|
112
|
-
|
|
113
|
-
|
|
159
|
+
const scope = (opts.only ?? opts.scope ?? "all");
|
|
160
|
+
const optionError = scope === "schedule" && !opts.track?.trim()
|
|
161
|
+
? "--only schedule requires --track <track>"
|
|
162
|
+
: scope !== "schedule" && (opts.track !== undefined || opts.force !== undefined)
|
|
163
|
+
? "--track and --force require --only schedule"
|
|
164
|
+
: opts.root !== undefined && scope !== "index" && scope !== "yaml-pages"
|
|
165
|
+
? "--root requires --only index or --only yaml-pages"
|
|
166
|
+
: opts.output !== undefined && scope !== "index"
|
|
167
|
+
? "--output requires --only index"
|
|
168
|
+
: opts.registerScope !== undefined && scope !== "register"
|
|
169
|
+
? "--register-scope requires --only register"
|
|
170
|
+
: undefined;
|
|
171
|
+
if (optionError) {
|
|
172
|
+
logError(optionError);
|
|
114
173
|
process.exitCode = 1;
|
|
115
174
|
return;
|
|
116
175
|
}
|
|
@@ -130,7 +189,7 @@ export function registerBuildCommand(program) {
|
|
|
130
189
|
}
|
|
131
190
|
const projectArgs = projectId ? ["--project", projectId] : [];
|
|
132
191
|
const registerProjectIds = resolveRegisterProjectIds(config, projectId, !!opts.project?.trim());
|
|
133
|
-
const steps = resolveSteps(scope, projectArgs, project, registerProjectIds);
|
|
192
|
+
const steps = resolveSteps(scope, projectArgs, project, registerProjectIds, opts);
|
|
134
193
|
if (steps.length === 0) {
|
|
135
194
|
logError(`No applicable steps for scope "${scope}". ` +
|
|
136
195
|
`Check that required paths are configured in specdojo.config.json.`);
|
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
import { spawn, spawnSync } from "node:child_process";
|
|
2
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
3
|
+
import { constants as osConstants } from "node:os";
|
|
4
|
+
import { join, resolve } from "node:path";
|
|
5
|
+
import { registerLifecyclePoolPath } from "../register/lifecycle-lock.js";
|
|
6
|
+
import { CrossProcessMutex, GIT_LOCK_TOKENS_ENV, isLiveLock, livePoolHolders, } from "../shared/cross-process-lock.js";
|
|
7
|
+
import { gitEnvironment } from "../shared/git-environment.js";
|
|
8
|
+
import { restoreIndexAfterPathspecCommit } from "../shared/git.js";
|
|
9
|
+
import { getProjectExecutionPath, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
10
|
+
const READ_COMMANDS = new Set([
|
|
11
|
+
"status",
|
|
12
|
+
"log",
|
|
13
|
+
"diff",
|
|
14
|
+
"show",
|
|
15
|
+
"grep",
|
|
16
|
+
"ls-files",
|
|
17
|
+
"ls-tree",
|
|
18
|
+
"rev-parse",
|
|
19
|
+
"rev-list",
|
|
20
|
+
"describe",
|
|
21
|
+
"shortlog",
|
|
22
|
+
"name-rev",
|
|
23
|
+
"merge-base",
|
|
24
|
+
"cat-file",
|
|
25
|
+
"version",
|
|
26
|
+
"help",
|
|
27
|
+
]);
|
|
28
|
+
const VALUE_OPTIONS = ["-C", "-c", "--git-dir", "--work-tree", "--namespace", "--config-env"];
|
|
29
|
+
const FLAG_OPTIONS = new Set([
|
|
30
|
+
"--bare",
|
|
31
|
+
"--no-pager",
|
|
32
|
+
"--paginate",
|
|
33
|
+
"-p",
|
|
34
|
+
"-P",
|
|
35
|
+
"--no-replace-objects",
|
|
36
|
+
"--literal-pathspecs",
|
|
37
|
+
"--glob-pathspecs",
|
|
38
|
+
"--noglob-pathspecs",
|
|
39
|
+
"--icase-pathspecs",
|
|
40
|
+
"--no-optional-locks",
|
|
41
|
+
"--no-lazy-fetch",
|
|
42
|
+
"--no-advice",
|
|
43
|
+
]);
|
|
44
|
+
export function inspectGitArguments(args) {
|
|
45
|
+
const globals = [];
|
|
46
|
+
let customConfig = false;
|
|
47
|
+
let index = 0;
|
|
48
|
+
while (index < args.length && args[index].startsWith("-")) {
|
|
49
|
+
const arg = args[index++];
|
|
50
|
+
if (arg === "--version" || arg === "--help" || arg === "-h") {
|
|
51
|
+
return { globals, needsLock: false };
|
|
52
|
+
}
|
|
53
|
+
const valueOption = VALUE_OPTIONS.find((option) => arg === option ||
|
|
54
|
+
(option.startsWith("--") ? arg.startsWith(`${option}=`) : arg.startsWith(option)));
|
|
55
|
+
if (valueOption) {
|
|
56
|
+
globals.push(arg);
|
|
57
|
+
if (arg === valueOption) {
|
|
58
|
+
if (index === args.length)
|
|
59
|
+
throw new Error(`Missing value for git ${arg}`);
|
|
60
|
+
globals.push(args[index++]);
|
|
61
|
+
}
|
|
62
|
+
if (valueOption === "-c" || valueOption === "--config-env")
|
|
63
|
+
customConfig = true;
|
|
64
|
+
}
|
|
65
|
+
else if (FLAG_OPTIONS.has(arg) || arg.startsWith("--exec-path=")) {
|
|
66
|
+
globals.push(arg);
|
|
67
|
+
if (arg.startsWith("--exec-path="))
|
|
68
|
+
customConfig = true;
|
|
69
|
+
}
|
|
70
|
+
else {
|
|
71
|
+
throw new Error(`Unsupported git global option: ${arg}`);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
const command = args[index];
|
|
75
|
+
// Aliases, unknown commands and output-writing variants join the same queue as writes.
|
|
76
|
+
const writesOutput = args
|
|
77
|
+
.slice(index + 1)
|
|
78
|
+
.some((arg) => arg === "--output" || arg.startsWith("--output="));
|
|
79
|
+
return { globals, needsLock: customConfig || !READ_COMMANDS.has(command) || writesOutput };
|
|
80
|
+
}
|
|
81
|
+
// `commit ... -- <pathspec>` の pathspec を返す。`--` の無い commit や commit 以外は空を返す。
|
|
82
|
+
// pathspec 付きの commit は一時 index で行われ、hook が整形した内容が本来の index に残るため、
|
|
83
|
+
// 呼び出し側が commit の後に index を戻す対象にする(PJR-Y3XS)。
|
|
84
|
+
export function commitPathspecs(args) {
|
|
85
|
+
const { globals } = inspectGitArguments(args);
|
|
86
|
+
if (args[globals.length] !== "commit")
|
|
87
|
+
return [];
|
|
88
|
+
const rest = args.slice(globals.length + 1);
|
|
89
|
+
const separator = rest.indexOf("--");
|
|
90
|
+
return separator === -1 ? [] : rest.slice(separator + 1);
|
|
91
|
+
}
|
|
92
|
+
// Avoid loading .env: a transparent Git wrapper must not alter the caller's credentials or env.
|
|
93
|
+
export function gitExecutionPath(root, projectOption) {
|
|
94
|
+
const configPath = join(root, ".specdojo", "specdojo.config.json");
|
|
95
|
+
if (!existsSync(configPath))
|
|
96
|
+
throw new Error(`No config found: ${configPath}`);
|
|
97
|
+
const config = JSON.parse(readFileSync(configPath, "utf8"));
|
|
98
|
+
if (config?.version !== 1 || !config.projects || typeof config.projects !== "object") {
|
|
99
|
+
throw new Error(`Invalid SpecDojo config: ${configPath}`);
|
|
100
|
+
}
|
|
101
|
+
const projectId = projectOption ||
|
|
102
|
+
process.env.SPECDOJO_PROJECT ||
|
|
103
|
+
config.current_project ||
|
|
104
|
+
Object.keys(config.projects)[0];
|
|
105
|
+
const project = config.projects[projectId];
|
|
106
|
+
if (!project || typeof project !== "object")
|
|
107
|
+
throw new Error(`Unknown project: ${projectId}`);
|
|
108
|
+
return resolve(root, getProjectExecutionPath(project));
|
|
109
|
+
}
|
|
110
|
+
function gitRoot(globals, cwd) {
|
|
111
|
+
const result = spawnSync("git", [...globals, "rev-parse", "--show-toplevel"], {
|
|
112
|
+
cwd,
|
|
113
|
+
env: gitEnvironment(),
|
|
114
|
+
encoding: "utf8",
|
|
115
|
+
});
|
|
116
|
+
if (result.error)
|
|
117
|
+
throw result.error;
|
|
118
|
+
if (result.status !== 0)
|
|
119
|
+
throw new Error(result.stderr.trim() || "Unable to resolve Git worktree");
|
|
120
|
+
return result.stdout.trim();
|
|
121
|
+
}
|
|
122
|
+
export function unlockedGitWarning(executionPath, env) {
|
|
123
|
+
const locksDir = join(executionPath, "exec", ".locks");
|
|
124
|
+
const runActive = isLiveLock(join(locksDir, "exec-run.lock")) ||
|
|
125
|
+
livePoolHolders(join(locksDir, "exec-run-join")).length > 0;
|
|
126
|
+
if (!runActive)
|
|
127
|
+
return undefined;
|
|
128
|
+
const tokens = new Set((env[GIT_LOCK_TOKENS_ENV] ?? "").split(","));
|
|
129
|
+
const held = livePoolHolders(registerLifecyclePoolPath(executionPath)).some((slot) => slot.owner && tokens.has(slot.owner.token));
|
|
130
|
+
return held
|
|
131
|
+
? undefined
|
|
132
|
+
: "[specdojo] warning: exec run is active; use specdojo git -- commit ... to serialize with runner integration.\n";
|
|
133
|
+
}
|
|
134
|
+
export function runGitChild(args, cwd, needsLock) {
|
|
135
|
+
return new Promise((resolveExit, reject) => {
|
|
136
|
+
const env = { ...gitEnvironment(), ...(needsLock ? {} : { GIT_OPTIONAL_LOCKS: "0" }) };
|
|
137
|
+
const child = spawn("git", args, { cwd, env, stdio: "inherit" });
|
|
138
|
+
// Keep the lifecycle lock until Git (including hooks) exits, even when the wrapper is signalled.
|
|
139
|
+
const signals = ["SIGINT", "SIGTERM", "SIGHUP", "SIGQUIT"];
|
|
140
|
+
const handlers = signals.map((signal) => () => {
|
|
141
|
+
child.kill(signal);
|
|
142
|
+
});
|
|
143
|
+
signals.forEach((signal, index) => process.on(signal, handlers[index]));
|
|
144
|
+
const cleanup = () => {
|
|
145
|
+
signals.forEach((signal, index) => process.off(signal, handlers[index]));
|
|
146
|
+
};
|
|
147
|
+
child.once("error", (error) => {
|
|
148
|
+
cleanup();
|
|
149
|
+
reject(error);
|
|
150
|
+
});
|
|
151
|
+
child.once("close", (code, signal) => {
|
|
152
|
+
cleanup();
|
|
153
|
+
resolveExit(code ?? (signal ? 128 + osConstants.signals[signal] : 1));
|
|
154
|
+
});
|
|
155
|
+
});
|
|
156
|
+
}
|
|
157
|
+
export async function runSerializedGit(args, options = {}) {
|
|
158
|
+
if (args.length === 0)
|
|
159
|
+
throw new Error("Usage: specdojo git [--project <id>] -- <git arguments>");
|
|
160
|
+
const cwd = options.cwd ?? process.cwd();
|
|
161
|
+
const { globals, needsLock } = inspectGitArguments(args);
|
|
162
|
+
if (!needsLock)
|
|
163
|
+
return runGitChild(args, cwd, false);
|
|
164
|
+
const executionPath = gitExecutionPath(gitRoot(globals, cwd), options.project);
|
|
165
|
+
const mutex = new CrossProcessMutex(registerLifecyclePoolPath(executionPath), {
|
|
166
|
+
actor: "specdojo-git",
|
|
167
|
+
label: "git write",
|
|
168
|
+
}, {
|
|
169
|
+
onWait: () => process.stderr.write("Waiting for the exec-lifecycle lock held by another operation\n"),
|
|
170
|
+
});
|
|
171
|
+
const pathspecs = commitPathspecs(args);
|
|
172
|
+
return mutex.runExclusive(async () => {
|
|
173
|
+
const code = await runGitChild(args, cwd, true);
|
|
174
|
+
if (code !== 0 || pathspecs.length === 0)
|
|
175
|
+
return code;
|
|
176
|
+
const restored = restoreIndexAfterPathspecCommit(cwd, pathspecs, globals);
|
|
177
|
+
if (restored.length > 0) {
|
|
178
|
+
process.stderr.write(`[specdojo] restored hook-formatted paths left in the index after commit: ${restored.join(", ")}\n`);
|
|
179
|
+
}
|
|
180
|
+
return code;
|
|
181
|
+
});
|
|
182
|
+
}
|
|
183
|
+
export function registerGitCommand(program) {
|
|
184
|
+
program
|
|
185
|
+
.command("git")
|
|
186
|
+
.description("Run Git writes under the runner lifecycle lock; pass Git arguments after --")
|
|
187
|
+
.option("--project <id>", "Project whose lifecycle lock is used")
|
|
188
|
+
.option("--warn-unlocked", "Pre-commit check: warn about unlocked commits during exec run")
|
|
189
|
+
.argument("[gitArgs...]", "Git arguments after --")
|
|
190
|
+
.action(async (args, options) => {
|
|
191
|
+
try {
|
|
192
|
+
if (options.warnUnlocked) {
|
|
193
|
+
const warning = unlockedGitWarning(gitExecutionPath(specdojoRootDir(), options.project), process.env);
|
|
194
|
+
if (warning)
|
|
195
|
+
process.stderr.write(warning);
|
|
196
|
+
}
|
|
197
|
+
else {
|
|
198
|
+
process.exitCode = await runSerializedGit(args, options);
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
catch (error) {
|
|
202
|
+
process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
|
|
203
|
+
process.exitCode = options.warnUnlocked ? 0 : 1;
|
|
204
|
+
}
|
|
205
|
+
});
|
|
206
|
+
}
|
package/dist/commands/init.js
CHANGED
|
@@ -357,14 +357,16 @@ function writeExecConfiguration(repoRoot, packageRoot, providers, dryRun) {
|
|
|
357
357
|
const executor = members.find((member) => member.provider === provider &&
|
|
358
358
|
member.stage_role === "executor" &&
|
|
359
359
|
member.mode === "edit" &&
|
|
360
|
-
member.proficiency !== "expert"
|
|
360
|
+
member.proficiency !== "expert" &&
|
|
361
|
+
member.proficiency !== "frontier");
|
|
361
362
|
const expertExecutor = members.find((member) => member.provider === provider &&
|
|
362
363
|
member.stage_role === "executor" &&
|
|
363
364
|
member.mode === "edit" &&
|
|
364
365
|
member.proficiency === "expert");
|
|
365
366
|
const reporter = members.find((member) => member.provider === provider &&
|
|
366
367
|
member.stage_role === "reporter" &&
|
|
367
|
-
member.proficiency !== "expert"
|
|
368
|
+
member.proficiency !== "expert" &&
|
|
369
|
+
member.proficiency !== "frontier");
|
|
368
370
|
if (!executor || !reporter) {
|
|
369
371
|
throw new Error(`init-agent-members.yaml must define an edit executor and reporter for ${provider}`);
|
|
370
372
|
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { Argument } from "commander";
|
|
2
|
+
import { printCatalogPaths } from "../catalog/catalog.js";
|
|
3
|
+
import { printTimelinePaths } from "../dashboard/timeline.js";
|
|
4
|
+
import { printExecPaths } from "../exec/commands.js";
|
|
5
|
+
import { printJobPaths } from "../job/job.js";
|
|
6
|
+
import { printRoutinePaths } from "../routine/routine.js";
|
|
7
|
+
import { printSchedulePaths } from "../schedule/schedule.js";
|
|
8
|
+
const pathPrinters = {
|
|
9
|
+
exec: printExecPaths,
|
|
10
|
+
catalog: printCatalogPaths,
|
|
11
|
+
schedule: printSchedulePaths,
|
|
12
|
+
timeline: printTimelinePaths,
|
|
13
|
+
job: printJobPaths,
|
|
14
|
+
routine: printRoutinePaths,
|
|
15
|
+
};
|
|
16
|
+
export function registerWhereCommand(program) {
|
|
17
|
+
program
|
|
18
|
+
.command("where")
|
|
19
|
+
.description("Print resolved project paths and files for a kind")
|
|
20
|
+
.addArgument(new Argument("<kind>", "Kind of paths to display").choices(Object.keys(pathPrinters)))
|
|
21
|
+
.option("--project <projectId>", "Project id in specdojo.config.json")
|
|
22
|
+
.action((kind, opts) => {
|
|
23
|
+
pathPrinters[kind](opts);
|
|
24
|
+
});
|
|
25
|
+
}
|
|
@@ -899,10 +899,12 @@ function printCommandError(error) {
|
|
|
899
899
|
process.exitCode = 1;
|
|
900
900
|
}
|
|
901
901
|
export function registerDashboardCommands(program) {
|
|
902
|
-
const dash = program
|
|
902
|
+
const dash = program
|
|
903
|
+
.command("dashboard", { hidden: true })
|
|
904
|
+
.description("Per-project dashboard build commands");
|
|
903
905
|
const bcmd = dash
|
|
904
|
-
.command("build")
|
|
905
|
-
.description("
|
|
906
|
+
.command("build", { hidden: true })
|
|
907
|
+
.description("Internal compatibility entry for build --only dashboard")
|
|
906
908
|
.option("--project <id>", "Project id in specdojo.config.json")
|
|
907
909
|
.option("--dry-run", "Print generated content to stdout without writing", false);
|
|
908
910
|
bcmd.action((opts) => {
|
|
@@ -3,7 +3,7 @@ import { join } from "node:path";
|
|
|
3
3
|
import { load } from "../shared/yaml.js";
|
|
4
4
|
import { readJson } from "../shared/fs.js";
|
|
5
5
|
import { migrateRoutineStorage } from "../routine/storage.js";
|
|
6
|
-
import { cronMatches,
|
|
6
|
+
import { cronMatches, isRoutineEntryDue, routineActionKindLabel, } from "../routine/definition.js";
|
|
7
7
|
// routine ファイル(rtn-*.yaml)を読み、端末側の状態ファイルと突き合わせて
|
|
8
8
|
// 最終実行・実行結果・due 状況を得る。CLI 出力(routine list)の転記に依存しない。
|
|
9
9
|
export function aggregateRoutines(routinesPath, repoRoot) {
|
|
@@ -190,6 +190,7 @@ function readRoutineStateEntries(statePath) {
|
|
|
190
190
|
last_run: typeof entry.last_run === "string" ? entry.last_run : undefined,
|
|
191
191
|
last_result: typeof entry.last_result === "string" ? entry.last_result : undefined,
|
|
192
192
|
last_scheduled_for: typeof entry.last_scheduled_for === "string" ? entry.last_scheduled_for : undefined,
|
|
193
|
+
busy_skip_count: typeof entry.busy_skip_count === "number" ? entry.busy_skip_count : undefined,
|
|
193
194
|
};
|
|
194
195
|
}
|
|
195
196
|
}
|
|
@@ -238,12 +239,8 @@ function buildRoutineRow(result, doc, stateEntries, now) {
|
|
|
238
239
|
export function computeRoutineDue(doc, stateEntry, enabled, now) {
|
|
239
240
|
if (!enabled)
|
|
240
241
|
return "disabled";
|
|
241
|
-
if (doc.trigger) {
|
|
242
|
-
|
|
243
|
-
return occurrences.length > 0 ? "due" : "-";
|
|
244
|
-
}
|
|
245
|
-
if (doc.interval) {
|
|
246
|
-
return isRoutineDue(doc, stateEntry?.last_run, now) ? "due" : "-";
|
|
242
|
+
if (doc.trigger || doc.interval) {
|
|
243
|
+
return isRoutineEntryDue(doc, stateEntry, now) ? "due" : "-";
|
|
247
244
|
}
|
|
248
245
|
return "-";
|
|
249
246
|
}
|