superset-setup

Superset プロジェクトのセットアップ

目標：このリポジトリで新しいワークスペース（独立した git worktree）を作成するたびに、手動の手順なしで準備が整った状態にします。依存関係がインストールされ、環境が用意され、サービスに接続できる状態にします。

1. リポジトリを調査する

新しい worktree に必要なものを確認し、不明な点があれば質問します。

• パッケージマネージャーとインストールコマンド（lockfiles を確認します：bun/pnpm/yarn/npm、cargo、uv、など）
• 環境ファイル：通常 .env は gitignore されているため、新しい worktree ではメインのチェックアウトからコピーするか、.env.example から生成する必要があります
• サービス（docker-compose、データベース）、開発コマンド、ポート
• モノレポの構成（セットアップに cwd が必要かどうか）

2. .superset/config.json を作成する

ライフサイクルスクリプトを設定するのはこのファイルです。config.json がない単独の setup.sh は認識されません。スキーマ：

{
  "setup": ["./.superset/setup.sh"],
  "teardown": ["./.superset/teardown.sh"],
  "run": ["bun dev"],
  "cwd": "optional/subdir"
}

各キーには、ワークスペースの作成／削除／実行時に worktree 内で実行されるシェルコマンドの配列を指定します。ガイドライン：

• セットアップは冪等かつ高速にしてください（1 分未満を目指します。時間のかかる手順があると、ワークスペースを作成するたびに負担になります）
• セットアップ時にメインのチェックアウトからシークレットや環境ファイルをコピーし、決してコミットしないでください
• .superset/config.local.json（gitignore されます）を使うと、個々のユーザーが共有設定に触れずに before／after 配列でスクリプトを拡張できます

提案するファイルをユーザーに見せ、書き込む前に明示的な承認を得てください。

3. 実際に検証する

superset workspaces create --project <id> --name "setup-test" で使い捨てのワークスペースを作成し、「Workspace Setup」のターミナル出力を確認します。正常に完了するまで修正と再実行を繰り返し、その後テスト用ワークスペースを削除します。実際のワークスペースが正常に起動するまでは、セットアップは完了していません。