Release: develop を main にマージ

.coderabbit.yaml

@@ -2,13 +2,21 @@
 # https://docs.coderabbit.ai/guides/configure-coderabbit
 #
 # 自動レビューの対象とする base ブランチを指定する。
-# default branch (main) は常に含まれるため、ここでは追加ブランチのみ指定する。
-# Configure the base branches for auto review. The default branch (main)
-# is always included, so only list additional branches here.
+# default branch は常に含まれるため、ここでは追加ブランチのみ指定する。
+# Configure the base branches for auto review. The default branch is always
+# included, so only list additional branches here.
+#
+# 移行期間メモ: default branch を main → develop へ切り替える作業（#734）と
+# この設定変更は非同期に行われるため、切替完了までは main / develop の両方を
+# 明示しておく。切替完了後に `develop` を削除するクリーンアップ PR を出す。
+# Transition note: the default-branch switch (#734) is handled outside this
+# repo. Keep both `main` and `develop` listed until the switch is complete,
+# then drop `develop` (it will be covered implicitly as the default branch).
 reviews:
   auto_review:
     enabled: true
     base_branches:
+      - "main"
       - "develop"
       - "release/.*"
       - "feature/.*"

.github/workflows/ci.yml

@@ -167,6 +167,36 @@ jobs:
         working-directory: server/api
         run: bunx tsc --noEmit
 
+  drizzle-migration-check:
+    name: Drizzle Migration Check
+    # Drizzle TS スキーマを変更したら必ずマイグレーション SQL を追加するルールの強制。
+    # PR #728 のように TS スキーマだけ更新して `server/api/drizzle/*.sql` を忘れると、
+    # 本番 DB がスキーマに追いつかず 500 エラーになるため、PR 段階で検出する。
+    # PR 限定（push にはマージベースの計算対象が無い）。
+    #
+    # Enforce: any change under `server/api/src/schema/**` must come with a new
+    # migration SQL file and an updated `_journal.json`. Detects PR #728-style
+    # regressions where production drifts from the application schema.
+    if: github.event_name == 'pull_request' && !github.event.pull_request.draft
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6.0.2
+        with:
+          # PR ベースとの diff を取るため履歴を全部取得する。
+          # Need full history so the script can diff against the PR base.
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: ".nvmrc"
+
+      - name: Run drizzle migration consistency check
+        env:
+          DRIZZLE_DIFF_BASE: origin/${{ github.base_ref }}
+          PR_TITLE: ${{ github.event.pull_request.title }}
+          PR_BODY: ${{ github.event.pull_request.body }}
+        run: node scripts/check-drizzle-migrations.mjs
+
   mcp-test:
     name: MCP Server Tests
     if: github.event_name != 'pull_request' || !github.event.pull_request.draft

.github/workflows/claude-code-review.yml

@@ -1,9 +1,19 @@
 # Claude Code Review - main/develop 向け PR で自動実行
+# Claude Code Review - runs automatically on PRs targeting main / develop.
 #
 # 初回セットアップ時の注意:
-# OIDC 検証のため、ワークフローはデフォルトブランチ(main)に存在し同一内容である必要があります。
-# 初回の PR では Claude Code Review が失敗しますが、マージ後・develop→main リリース後に
-# 以降の PR で正常動作します。continue-on-error により初回失敗時もマージをブロックしません。
+# OIDC 検証のため、ワークフローは「現在のデフォルトブランチ」に存在し、
+# 対象ブランチ側にも同一内容である必要があります。
+# 初回の PR では Claude Code Review が失敗する場合がありますが、
+# 必要な反映後の PR で正常動作します。
+# continue-on-error により初回失敗時もマージをブロックしません。
+#
+# Initial setup note:
+# For OIDC verification, this workflow must exist on the repository's current
+# default branch and its contents must match the workflow on the target branch.
+# The first PR after a default-branch change may fail, but subsequent PRs work
+# normally once the workflow is propagated. `continue-on-error: true` ensures
+# that initial failures do not block merges.
 # ref: https://github.com/anthropics/claude-code-action/issues/722
 #
 name: Claude Code Review

AGENTS.md

@@ -55,6 +55,22 @@ bun run test:run       # Vitest 単体テスト
 - 既存のディレクトリ構成・命名規則に合わせる。
 - Conventional Commits 形式でコミット（`feat:`, `fix:`, `docs:` 等）。
 
+## DB スキーマ変更（必読） / Database schema changes (must read)
+
+- **TS スキーマと SQL マイグレーションは常に対で更新する**。`server/api/src/schema/**/*.ts` を編集したら、必ず `server/api/drizzle/NNNN_*.sql` を新規追加し、`server/api/drizzle/meta/_journal.json` にエントリを追記する。  
+  _Always pair TS schema edits with a SQL migration: add a new `server/api/drizzle/NNNN_\*.sql`and append an entry to`server/api/drizzle/meta/_journal.json`. Skipping this caused PR #728 → production 500s on `/api/onboarding/status`and`/api/pages`._
+- **正本のマイグレーション置き場は `server/api/drizzle/` のみ**。CI (`deploy-{dev,prod}.yml`) は `bunx drizzle-kit migrate` だけを実行するため、ここ以外に SQL を置いても本番には適用されない。  
+  _Source of truth is `server/api/drizzle/`. CI runs only `bunx drizzle-kit migrate`; SQL placed elsewhere is dead code._
+- **マイグレーションの書き方**:
+  - 既存の手書き例（`0017_add_link_type.sql` など）の体裁に合わせ、ステートメント間に `--> statement-breakpoint` を入れる。
+  - 既存環境で重複適用されても安全になるよう、原則として `IF NOT EXISTS` / `ON CONFLICT DO NOTHING` を使う。
+  - 必要であればバックフィル（既存行への初期値投入）も同じファイル内で行う。
+  - `bunx drizzle-kit generate` で雛形を作るときは、過去スナップショットが欠落しているため巨大な diff が出ることがある。その場合は `--name` 指定の出力を手で削減し、既存マイグレーション間で重複しない形に整えてから commit する（snapshot ファイルは生成物のみ、当面コミットしない方針）。
+- **CI ガード**: `.github/workflows/ci.yml` の `drizzle-migration-check` ジョブが PR で `server/api/src/schema/**` の変更と新規 `server/api/drizzle/*.sql` がペアになっているかを検証する。例外的に SQL 不要な場合（コメント/JSDoc 修正のみなど）は PR 本文かコミットメッセージに `[skip drizzle-check]` を入れる。  
+  _CI guard `drizzle-migration-check` enforces the schema/migration pairing. Use the `[skip drizzle-check]` marker only for non-DDL edits (comments, JSDoc, type aliases that do not affect SQL)._
+- **環境別の自動適用**: `develop` への push → `deploy-dev.yml` が development DB へ migrate。`main` への push → `deploy-prod.yml` が production DB へ migrate。スキーマ追従はこの 2 本だけ。  
+  _Auto-apply: push to `develop` migrates dev DB; push to `main` migrates prod DB. No other path applies migrations._
+
 ## ブランチ・PR の命名規則
 
 - **ブランチ**: `feature/説明`、`fix/説明`、`hotfix/説明`、`chore/説明` など（例: `feature/ai-models-ui`, `fix/search-crash`）。Issue 番号から作る場合は `feature/123`。
@@ -93,6 +109,17 @@ terraform/        # インフラ定義
 
 - ルート `package.json` の `workspaces` は `packages/*` と `admin` のみを含む。`server/api`, `server/hocuspocus`, `server/mcp` は **意図的にルートの Bun workspace から外して**、個別の Bun プロジェクトとして管理する。  
   _Root `workspaces` covers only `packages/*` and `admin`. The three `server/*` services (`api`, `hocuspocus`, `mcp`) are intentionally kept **outside** the root Bun workspace and managed as standalone Bun projects._
+
+### サーバ／クライアント間で共有する定数 / Sharing constants between server and client
+
+- `packages/shared`（`@zedi/shared`）は、フロント・admin・サーバすべてで共通利用したいピュアな TypeScript 定数を集約するためのワークスペースパッケージ。React や Node 専用 API には依存させない。  
+  _`packages/shared` (`@zedi/shared`) is a workspace package for pure TypeScript constants shared by client, admin, and (logically) server code. Keep it free of React or Node-only dependencies._
+- フロント (`src/`) と `admin/` はワークスペース内なので `import { ... } from "@zedi/shared/..."` で直接利用できる。  
+  _Workspace consumers (`src/`, `admin/`) import via `@zedi/shared/...`._
+- `server/api` 等のサーバプロジェクトはワークスペース外なので `@zedi/shared` を **直接 import できない**。代わりに同じ値を当該サーバ内に二重定義し、フロント側の vitest が `fs.readFileSync` でサーバファイルを読んで両者の文字列一致を検証するドリフト検知テスト（例: `src/lib/tagCharacterClassSync.test.ts`）を置くことで CI で同期を担保する。  
+  _Server projects (e.g. `server/api`) cannot import `@zedi/shared` because they are intentionally outside the workspace. Duplicate the constant inside the server source and add a client-side vitest (e.g. `src/lib/tagCharacterClassSync.test.ts`) that reads the server file via `fs.readFileSync` and asserts the two literals match. This keeps drift detectable in CI._
+- 値を更新する際は **`packages/shared` とサーバ側コピーを同時に編集すること**。ドリフト検知テストが落ちたら、片方しか変更していないサインなのでもう一方も追従させる。  
+  _When updating a shared value, edit `packages/shared` and the server-side copy together. If the drift test fails, the change touched only one side; sync the other._
 - 理由 / Rationale:
   - Railway の Dockerfile ビルドは「各サービスの Root Directory」を build context に取る (例: `server/mcp`)。ここからルート `bun.lock` を参照するのは面倒で、context をサービス単位に閉じるほうが再現性が高い。  
     _Railway Dockerfile builds take each service's Root Directory as the build context. Scoping `bun.lock` per service keeps the build self-contained and reproducible._

CLAUDE.md

@@ -27,6 +27,11 @@
 - エラーハンドリングとログが適切か。
 - 日本語・英語のコメント・ドキュメントがプロジェクトのトーンに合っているか。
 
+## DB スキーマ変更
+
+- TS スキーマ (`server/api/src/schema/**`) を変更した PR では必ず `server/api/drizzle/NNNN_*.sql` を新規追加し、`server/api/drizzle/meta/_journal.json` にもエントリを追記する。詳細は [AGENTS.md §「DB スキーマ変更」](./AGENTS.md#db-スキーマ変更必読--database-schema-changes-must-read) を参照。
+- CI の `drizzle-migration-check` ジョブが PR でスキーマ変更と SQL 追加のペアを強制する。
+
 ## その他
 
 - 変更が大きい場合は小さな PR に分けることを推奨する。

README.md

@@ -245,7 +245,7 @@ VITE_REALTIME_URL=ws://localhost:1234   # 本番は wss://realtime.zedi-note.app
 | **Visualization** | Recharts / `@xyflow/react` (React Flow) / Mermaid / KaTeX / Tesseract.js (OCR)                       |
 | **Auth**          | [Better Auth](https://better-auth.com/) (OAuth / セッション cookie)                                  |
 | **API**           | `server/api` — Hono on Bun + Drizzle ORM (PostgreSQL)                                                |
-| **Database**      | PostgreSQL (Drizzle migrations: `db/migrations`, `server/api/drizzle`) / IndexedDB (local・ブラウザ) |
+| **Database**      | PostgreSQL (Drizzle migrations: `server/api/drizzle/`) / IndexedDB (local・ブラウザ)                 |
 | **Realtime**      | `server/hocuspocus` — Hocuspocus (Y.js) によるリアルタイム共同編集                                   |
 | **MCP**           | `server/mcp` — Claude Code 連携（stdio / HTTP、詳細は [server/mcp/README.md](server/mcp/README.md)） |
 | **Storage**       | AWS S3（API 経由でアップロード、`@aws-sdk/client-s3`）                                               |
@@ -337,7 +337,7 @@ packages/                # Bun workspaces（共有ライブラリ）
 
 admin/                   # 管理画面アプリ（別 Vite + React + Tailwind / `@zedi/ui` 利用）
 extension/               # ブラウザ拡張（Manifest v3、Web Clipper）
-db/migrations/           # PostgreSQL マイグレーション SQL
+server/api/drizzle/      # PostgreSQL マイグレーション（drizzle-kit が読む正本 / source of truth）
 terraform/cloudflare/    # Cloudflare 関連インフラ定義
 e2e/                     # Playwright E2E テスト
 scripts/                 # セットアップ / sidecar ビルド / Stryker / 拡張ビルド等のスクリプト