pw add

pw add [registered|discovered|devbox|database|dynamo|firestore|redis-valkey|auth|tailwind|images]
pw add <module-path>

pw init はどの機能から始めるかを尋ねますが、それはプロジェクトを理解しきる前の判断です。pw add は後から 1 つ追加します。断った答えは、そのプロジェクトが背負い続ける決定ではありません。

このコマンドは既存プロジェクトの中で動き、質問はウィザードで行います。フラグ形式はありません。新しいディレクトリを作る pw init と違い、こちらはプロジェクトが既に依存している設定・マイグレーション・ソースを編集します。その編集を承認する場所がレビュー画面です。

最初の要素にドットを含む引数は、モジュールパスとして読まれます。この場合はコンポーネントパッケージを導入します。こちらにはウィザードもレビュー画面もありません。何もコピーしないからです。go.mod の require と [[packages]] の 1 エントリを書き、残りのコマンドを表示して終わります。利用側を参照してください。

カタログ

機能	追加されるもの
`registered`	ハンドラのツリー、その mux、Go で書かれたルート登録が1つ
`discovered`	ページツリー、そのレイアウト、それを読ませる `generate.pages` の項目
`devbox`	`devbox.json` と `devbox.lock`。このプロジェクトが既に使っているツールチェインを含む
`database`	`[middleware.rdb]` セクション、マイグレーションディレクトリ、型付き SQL の例
`dynamo`	`[middleware.dynamo]` セクション、型付きレコード、ローカルの DynamoDB サーバー
`firestore`	`[middleware.firestore]` セクション、型付きエンティティ、`.pw.firestore` クエリ
`redis-valkey`	`devbox.json` の Valkey 開発サーバー
`auth`	ログインセッション、フレームワークのテーブル、アカウントリゾルバ
`tailwind`	ピン留めした Tailwind ツールチェイン、CSS エントリ、`[assets.tailwind]` ブロック
`images`	ピン留めした画像エンコーダと、変換を有効にする `[assets.images]` ブロック

引数は最初のステップの初期選択になります。省略すると、そのプロジェクトがまだ持っていないものだけが並びます。他に依存するものが 2 つあります。auth はログイン記録の保存先として database、dynamo、firestore のいずれかを必要とし、redis-valkey は devbox を必要とします。Valkey の選択は Devbox のパッケージ以外に何も書かないからです。依存を持たないプロジェクトで選ぶと、先に依存を追加し、その旨をレビュー画面に表示します。

images がエンコーダとスイッチを1ステップで書くのは意図的です。ツール無しでスイッチだけ入れたプロジェクトは何も変換せず、それを毎ビルド報告し続けます。スイッチ無しでツールだけ入れたプロジェクトは、使わないパッケージを2つ抱えることになります。Devbox が無い場合はピン留めする先が無いので、必要なツールを言葉で挙げてインストールは任せます。

検出

機能の有無は、それを担っているファイルから検出します。popcornweb.toml の一覧ではありません。マニフェストは手編集されたプロジェクトと食い違い得るからです。

機能	根拠
`devbox`	`devbox.json`
`database`	環境設定ファイルの `[middleware.rdb]`
`dynamo`	環境設定ファイルの `[middleware.dynamo]`
`firestore`	環境設定ファイルの `[middleware.firestore]`
`redis-valkey`	`devbox.json` の Valkey パッケージ
`auth`	`[auth]` セクション、または `init_popcornweb_auth` マイグレーション（バージョンは問わない）
`tailwind`	`popcornweb.toml` の `assets.tailwind.enabled`
`images`	`popcornweb.toml` の `assets.images.enabled`

既にある機能を追加しようとすると、根拠のファイルを名指しして失敗します。

pw: add: this project already has auth, per migrations/00003_init_popcornweb_auth.sql

書き込む内容

レビュー画面が、何も書く前に変更を全て列挙します。

  Review
    Capability     auth
    OIDC provider  External provider

    create  handlers/accounts.go
    create  migrations/00002_init_popcornweb_session.sql
    create  migrations/00003_init_popcornweb_auth.sql
    append  config.dev.toml
    edit    cmd/lean/main.go
    then    pw migrate up

  enter add  ·  esc back  ·  ctrl+c cancel

この一覧を支配する規則は 4 つです。

マイグレーションは次に空いているバージョンを取ります。 00001 から 00007 まで適用済みのプロジェクトなら 00008 です。番号の振り直しは行いません。適用済みかもしれないマイグレーションを動かすことは決してできないからです。

設定は追記で、書き換えではありません。 コメントや調整した値はそのまま残ります。同名のセクションが既にあればコマンドは停止します。

アプリケーション所有のファイルは上書きしません。 衝突を報告して何も書きません。フレームワークが代わりにやらないこと（main.go の呼び出し、ドキュメントシェルへのスタイルシートのリンク）は、手作業のステップとして表示します。

中途半端な状態を作りません。 全ファイルを先に計算してからまとめて書くので、失敗するステップがあればプロジェクトは元のままです。

終了ステータス

状況	終了コード
機能を追加した	0
ウィザードをキャンセルした	0、何も書かない
端末がない	非ゼロ、usage を表示
既に存在する、または衝突	非ゼロ、パスと理由を表示