PJR-0157 CLI生成系動詞の用語整理と破壊的リネーム
1. 概要
exec build→exec refresh、catalog generate→deliverable scaffoldへ改名し、生成系動詞(scaffold/build/refresh/run)の用語標準を明文化する
CLI の生成系動詞が多義・重複しており、とくに exec build(揮発的な実行状態の算出)と catalog build(派生ビュー生成)で build が別レイヤに並び、catalog scaffold(カタログ生成)と catalog generate(成果物本体生成)も語と意味が対応していない。生成系動詞を scaffold(起点)/ build(派生物)/ refresh(揮発状態)/ run(実行)の4語へ整理し、用語標準を明文化したうえで、破壊的リネームを一括で実施する(未公開プロジェクトのためエイリアスは設けない)。
2. 完了条件
- 生成系動詞の用語標準(
scaffold/build/refresh/runの定義・判定軸・object 一覧)が SSOT として明文化されている。 exec buildがexec refreshに改名され、旧名は残さない(ヘルプ・出力・docs すべて更新)。catalog generateがdeliverable scaffold(独立サブコマンド・object 明示)に改名され、旧名は残さない。schedule buildは据え置き(strategy → sch-track の committed 派生物生成としてbuildを維持)。- コード・
lefthook.ymlの hook 名(exec-build)・build-command.tsの umbrella 連鎖・スクリプト・docs・tests のすべての参照が新名へ更新されている。 npm run build/lint:ts/lint:md/validate:catalog/npm testが成功する。- 旧名(
exec build/catalog generate)を実行するとエラーになる(残存参照がない)。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 用語標準を明文化(scaffold/build/refresh/run の定義・判定軸・現行対応表) | ARC | open | 新規 standard または cli-overview-guide に節追加 |
| 2 | exec build → exec refresh の実装(コマンド定義・ヘルプ・出力文言) | ARC | open | src/exec-*.ts。staleness 警告文言も更新 |
| 3 | catalog generate → deliverable scaffold(独立サブコマンド)へ改名 | ARC | open | src/catalog-generate.ts ほか。object を deliverable に明示 |
| 4 | lefthook.yml の exec-build hook・build-command.ts の umbrella 連鎖を更新 | ARC | open | hook 名と subArgs/label |
| 5 | docs 一括更新(command-reference・各 guide・quick-start・kata 等) | ARC | open | exec refresh / deliverable scaffold へ |
| 6 | tests 更新(exec build/catalog generate 参照を新名へ) | ARC | open | tests/** |
| 7 | 検証(npm run build / lint:ts / lint:md / validate:catalog / npm test) | ARC | open | 旧名の残存参照が無いことを grep で確認 |
4. 対応結果
5. 関連ドキュメント
- specdojo:waza-guide
- specdojo:schedule-design-guide
docs/ja/specdojo/references/command-reference.mdsrc/build-command.tssrc/exec-schedule.tssrc/catalog-generate.tslefthook.yml