Skip to content

docs(field-trials): FT6 (cli-tooling) report を追加して trial を閉じる#293

Merged
hideyukiMORI merged 1 commit into
mainfrom
docs/292-field-trial-6-cli-tooling
May 21, 2026
Merged

docs(field-trials): FT6 (cli-tooling) report を追加して trial を閉じる#293
hideyukiMORI merged 1 commit into
mainfrom
docs/292-field-trial-6-cli-tooling

Conversation

@hideyukiMORI
Copy link
Copy Markdown
Owner

Summary

  • `docs/field-trials/2026-05-field-trial-6.md` を追加。CLI 経路 (cli/initSQLite.php, cli/setupDatabase.php) を fresh-installer 視点で実走検証したレポート。Closes FT6: CLI tooling (initSQLite.php, setupDatabase.php) against post-FT5 baseline #292.
  • Headline: `setupDatabase.php` は実用十分 (--env/--yes/--help、idempotent、MySQL+SQLite 両対応)。Friction は structural + discoverability。
  • F-1: initSQLite.php と setupDatabase.php の overlap (canonical 化必要)
  • F-2: schema が 3 箇所重複 — FT2 F-7 が documented 2 箇所だが `class/xion/DatabaseInstaller.php` も同じ schema を inline で保持
  • F-3: initSQLite.php に `--yes` 無し
  • F-4: `--env=PATH` の typo が silent fallback
  • F-5: composer scripts に CLI shortcut 無し
  • F-6 / F-7: positive (connect-fail メッセージ + --help)

self-review checklist 適用: `docs/review/field-trial-report.md` (#291 で landed)。

Test plan

  • FT6 trial clone で `composer test`: 45/45, 129 assertions
  • `composer test:http`: 21/21, 205 assertions, 1 expected skip
  • 両 CLI スクリプトの interactive / noninteractive / error path を実走確認
  • schema 3 箇所の重複を grep + diff で確認

🤖 Generated with Claude Code

FT6 は CLI 経路 (cli/initSQLite.php, cli/setupDatabase.php) を
fresh-installer / DBA 視点で実走検証した。

結果:
- setupDatabase.php は --env/--yes/--help が綺麗、idempotent、
  MySQL/SQLite 両対応で実用十分 (F-6/F-7 positive)
- 主要 friction は structural / discoverability:
  F-1 (initSQLite.php と setupDatabase.php の overlap)
  F-2 (schema が 3 箇所重複: mysql init SQL / initSQLite.php /
       DatabaseInstaller.php — FT2 F-7 は 2 箇所だけ documented)
  F-5 (composer scripts に CLI shortcut が無い)
- 操作系の小さい friction: F-3 (initSQLite に --yes 無し),
  F-4 (--env=typo silent fallback)

5 件の follow-up Issue を起票予定 (4 framework fix + 1 docs)。
F-6/F-7 は positive、no action。Closes #292.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@hideyukiMORI hideyukiMORI enabled auto-merge May 21, 2026 13:28
@hideyukiMORI hideyukiMORI merged commit d3b8a44 into main May 21, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

FT6: CLI tooling (initSQLite.php, setupDatabase.php) against post-FT5 baseline

1 participant