sync: update from private repo (2336949a)

.env.caddy.example

@@ -0,0 +1,63 @@
+# ---------------------------------------------------------------------------
+# Caddy リバースプロキシ用の設定
+#
+#   cp .env.caddy.example .env.caddy
+#
+# 読み込むのは docker-compose.caddy.yml の caddy サービスだけ。
+# ベースの .env とは意図的に分けてある — .env は maestro サービスの env_file
+# なので、Cloudflare のトークンをそちらに書くとエージェントが動くコンテナの
+# 環境変数に入り、Bash ツールから読めてしまう。
+#
+# このファイル (.env.caddy) は .gitignore 済み。実際の値をコミットしないこと。
+#
+# 【重要】使わないキーは「行ごとコメントアウトしたまま」にすること。
+#   NG:  GATEWAY_HOSTNAME=          ← 等号だけの空行。空文字が設定された扱いになる
+#   OK:  # GATEWAY_HOSTNAME=...     ← 未設定。Caddyfile 側の既定値が効く
+# Caddyfile の既定値つき置換 ({$NAME:既定値}) は「未設定のとき」だけ既定値に
+# 落ちる。空文字を入れると空文字がそのまま入り、起動しない (GATEWAY_HOSTNAME)
+# か、黙って別の動きになる (GATEWAY_UPSTREAM_PORT は 80 番へ中継)。
+# ---------------------------------------------------------------------------
+
+# --- Cloudflare -------------------------------------------------------------
+# API トークン。ダッシュボードの My Profile → API Tokens → Create Token から
+# 「Custom token」で作る。権限は次の 2 つだけに絞ること:
+#   Zone / Zone      : Read
+#   Zone / DNS       : Edit
+# Zone Resources は対象のゾーン 1 つだけを選ぶ (All zones にしない)。
+# Global API Key は使わない (アカウント全体の権限を持つため)。
+#
+# これは必須のキーなので空の行のまま置いてある (上の「コメントアウトのまま」は
+# 使わないキーの話)。空のまま起動すると
+# `API token '' appears invalid` で止まるので、黙って進むことはない。
+CLOUDFLARE_API_TOKEN=
+
+# --- ホスト名 ---------------------------------------------------------------
+# 下の 2 つは自分のドメインに必ず書き換えること (CHANGE-ME.example のままだと
+# 存在しない名前で証明書を要求し続ける)。
+#
+# ワイルドカード証明書の対象。*.<この値> の証明書を 1 枚取る。
+# 先頭のドットやアスタリスクは付けない。空文字にすると *. という成立しない
+# 名前で発行を要求し続ける (Caddy は警告を出さない)。
+#   例: MAESTRO_BASE_DOMAIN=example.com      → *.example.com
+#       MAESTRO_BASE_DOMAIN=home.example.com → *.home.example.com
+MAESTRO_BASE_DOMAIN=CHANGE-ME.example
+
+# MAESTRO を出すホスト名。MAESTRO_BASE_DOMAIN の 1 つ下の階層にすること。
+MAESTRO_HOSTNAME=maestro.CHANGE-ME.example
+
+# --- AAO ゲートウェイ (使っていないなら、下の 2 行はコメントアウトのまま) ---
+# ゲートウェイ (OpenAI 互換の中継口) も HTTPS で出す場合だけ、# を外して書く。
+# コメントアウトしたままなら、この経路は無効のまま起動する。
+#
+# 【注意】`GATEWAY_HOSTNAME=` と等号だけ書くと Caddy が起動しない
+#         (module value cannot be null)。使わないなら # を外さないこと。
+# MAESTRO_BASE_DOMAIN の 1 つ下の階層にすること。別ドメインや 2 階層下だと
+# 証明書もサイトの照合も覆わず、そのホスト名は無反応になる (警告は出ない)。
+# GATEWAY_HOSTNAME=gateway.CHANGE-ME.example
+
+# ゲートウェイの待ち受けポート。config.yaml の gateway.listen_port を既定
+# (4000) から変えている場合だけ、# を外して同じ値を書く。
+#
+# 【注意】`GATEWAY_UPSTREAM_PORT=` と等号だけ書くと、エラーも警告も出ないまま
+#         80 番へ中継され、502 になる。既定のままなら # を外さないこと。
+# GATEWAY_UPSTREAM_PORT=4000