feat: presentation 基盤

.github/workflows/autofix.yml

@@ -52,10 +52,11 @@ jobs:
       - name: Install JS dependencies
         run: nix develop --command pnpm install --frozen-lockfile --ignore-scripts
 
-      - name: Apply autofix (control-plane / realtime / lp / web)
+      - name: Apply autofix (control-plane / realtime / presentation / lp / web)
         run: |
           nix run .#control-plane -- fix
           nix run .#realtime -- fix
+          nix run .#presentation -- fix
           nix run .#lp -- fix
           nix run .#web -- fix
 

.github/workflows/ci.yml

@@ -2,7 +2,7 @@ name: CI
 
 # オーケストレーション。変更のあった領域だけ reusable workflow を呼び、
 # 最後に集約ゲート (job: ci) を必須チェックにする。
-# 各領域の実体: control-plane.yml / realtime.yml / web.yml / lp.yml / unity.yml。
+# 各領域の実体: control-plane.yml / presentation.yml / realtime.yml / web.yml / lp.yml / unity.yml。
 #
 # paths-ignore は設けない。docs-only PR でも workflow を起動し、changes で全領域が
 # skip → 集約 job `CI` が成功することで、必須ステータスチェックが常に報告される。
@@ -38,6 +38,7 @@ jobs:
       control-plane: ${{ steps.filter.outputs.control-plane }}
       realtime: ${{ steps.filter.outputs.realtime }}
       web: ${{ steps.filter.outputs.web }}
+      presentation: ${{ steps.filter.outputs.presentation }}
       lp: ${{ steps.filter.outputs.lp }}
       unity: ${{ steps.filter.outputs.unity }}
     steps:
@@ -53,7 +54,7 @@ jobs:
             shared: &shared
               - 'flake.nix'
               - 'flake.lock'
-              - 'scripts/lib/**'
+              - 'scripts/**'
               - '.github/workflows/ci.yml'
             js-shared: &js-shared
               - 'pnpm-lock.yaml'
@@ -83,6 +84,14 @@ jobs:
               - 'scripts/ci/web.sh'
               - 'app/web/**'
               - 'packages/api-client-typescript/**'
+            presentation:
+              - *shared
+              - *js-shared
+              - '.github/workflows/presentation.yml'
+              - 'scripts/ci/presentation.sh'
+              - 'packages/contracts/**'
+              - 'packages/api-client-csharp/**'
+              - 'packages/presentation-*/**'
             lp:
               - *shared
               - *js-shared
@@ -111,6 +120,12 @@ jobs:
     if: needs.changes.outputs.web == 'true'
     uses: ./.github/workflows/web.yml
 
+  presentation:
+    name: Presentation Packages
+    needs: changes
+    if: needs.changes.outputs.presentation == 'true'
+    uses: ./.github/workflows/presentation.yml
+
   lp:
     name: LP
     needs: changes
@@ -126,7 +141,7 @@ jobs:
   ci:
     name: CI
     # 必須ステータスチェック。全領域の結果を集約する。
-    needs: [changes, control-plane, realtime, web, lp, unity]
+    needs: [changes, control-plane, realtime, web, presentation, lp, unity]
     if: always()
     runs-on: ubuntu-latest
     steps:

.github/workflows/presentation.yml

@@ -0,0 +1,25 @@
+name: Presentation Packages
+
+on:
+  workflow_call:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    name: presentation / check
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: DeterminateSystems/nix-installer-action@33c9ab3ef95cd57c164d9d6eb1f9a46338538d41 # main
+      - uses: DeterminateSystems/magic-nix-cache-action@55718cd9ebf1737a061487d5ada21abf31e99a98 # main
+
+      - name: Install JS dependencies
+        run: nix develop --command pnpm install --frozen-lockfile
+
+      - name: shared config / typecheck / lint / test
+        run: nix run .#presentation

CONTRIBUTING.md

@@ -87,17 +87,17 @@ nix run .#setup
 公式のタスク入口は Nix flake apps です。複雑な処理の実体は `scripts/` にあり、
 通常は内部スクリプトを直接実行せず、次の入口を使用します。
 
-| 用途 | コマンド |
-| --- | --- |
-| 開発環境 | `nix develop` |
-| 依存関係と hook のセットアップ | `nix run .#setup` |
-| 全体品質ゲート | `nix run .#check` |
-| Control Plane check / test / build | `nix run .#control-plane` |
-| Realtime check / test / build / race | `nix run .#realtime` |
-| Web check / test / build | `nix run .#web` |
-| LP test / check / build | `nix run .#lp` |
-| Notion 同期 | `nix run .#notion-sync` |
-| flake の評価と formatter 検証 | `nix flake check` |
+| 用途                                 | コマンド                  |
+| ------------------------------------ | ------------------------- |
+| 開発環境                             | `nix develop`             |
+| 依存関係と hook のセットアップ       | `nix run .#setup`         |
+| 全体品質ゲート                       | `nix run .#check`         |
+| Control Plane check / test / build   | `nix run .#control-plane` |
+| Realtime check / test / build / race | `nix run .#realtime`      |
+| Web check / test / build             | `nix run .#web`           |
+| LP test / check / build              | `nix run .#lp`            |
+| Notion 同期                          | `nix run .#notion-sync`   |
+| flake の評価と formatter 検証        | `nix flake check`         |
 
 `nix flake check` は flake の評価と formatter を検証します。アプリケーションの
 品質ゲートではありません。コード変更時の全体品質ゲートは
@@ -130,16 +130,17 @@ generated-file notice を保持します。C# generator は未接続のため、
 各 package の `package.json` にある script を JavaScript の実行方法の正とします。
 テストフレームワークを推測してコマンドを追加しません。
 
-| 対象 | 現在のテスト | 今後の方針 |
-| --- | --- | --- |
-| `app/web/` | package script で実行 | 機能追加に合わせて拡張 |
-| `app/server/realtime/` | Go `testing`、race detector | gRPC contract と session 実装に合わせて拡張 |
-| `lp/` | package script、`svelte-check`、静的 build | ページ追加に合わせて拡張 |
-| `app/unity/` | Unity Test Framework の EditMode/PlayMode | Unity Editor で実行 |
+| 対象                   | 現在のテスト                               | 今後の方針                                  |
+| ---------------------- | ------------------------------------------ | ------------------------------------------- |
+| `app/web/`             | package script で実行                      | 機能追加に合わせて拡張                      |
+| `app/server/realtime/` | Go `testing`、race detector                | gRPC contract と session 実装に合わせて拡張 |
+| `lp/`                  | package script、`svelte-check`、静的 build | ページ追加に合わせて拡張                    |
+| `app/unity/`           | Unity Test Framework の EditMode/PlayMode  | Unity Editor で実行                         |
 
-`nix run .#check` は現在、Control Plane、Realtime、LP、Web の検証を実行します。
-現在は Unity Editor テストを実行しません。ドキュメント link check や security
-check も、この品質ゲートには含まれません。
+`nix run .#check` は現在、Control Plane、Presentation packages、Realtime、LP、Web
+の検証を実行します。Presentation gate は共有 `packages/config` の hook fixture と設定
+check も実行します。現在は Unity Editor テストを実行しません。ドキュメント link
+check や security check も、この品質ゲートには含まれません。
 
 Unity の動作変更では、Unity `6000.3.14f1` の Editor で EditMode/PlayMode テストを
 実行します。GitHub-hosted runner の Unity workflow は `dotnet format`、PowerShell
@@ -155,6 +156,8 @@ skip された検証を成功したとは報告しません。
 領域別の自動修正は次のコマンドで実行します。
 
 ```bash
+nix run .#control-plane -- fix
+nix run .#presentation -- fix
 nix run .#realtime -- fix
 nix run .#lp -- fix
 nix run .#web -- fix
@@ -167,10 +170,10 @@ Pull Request では `autofix.yml` が format と lint の自動修正を行う
 `nix develop` または `nix run .#setup` により、repository-local の
 `core.hooksPath=packages/config/githooks` が有効になります。
 
-現在 tracked されている hook は `prepare-commit-msg` です。commit message を変換
-しますが、pre-commit の format や staged file の検証を保証するものではありません。
-Vite+ の staged 設定が存在していても、設定された `core.hooksPath` と hook file を
-確認せずに自動実行を前提にしません。
+tracked hook の `pre-commit` は repository root の Vite+ staged 設定を解決し、対象の
+staged file に `vp check --fix` または `vp fmt` を実行します。`prepare-commit-msg` は
+commit message を変換します。hook を前提にする前に、repository-local の
+`core.hooksPath` が `packages/config/githooks` を指すことを確認します。
 
 現在の変換例は次のとおりです。
 

app/server/control-plane/package.json

@@ -20,7 +20,7 @@
     "db:migrate:remote": "wrangler d1 migrations apply unframe-control-plane --remote",
     "r2:cors:apply": "wrangler r2 bucket cors set unframe-assets --file ./r2-cors.json",
     "r2:cors:list": "wrangler r2 bucket cors list unframe-assets",
-    "contracts:check": "pnpm --filter @unframe/contracts check:control-plane",
+    "contracts:check": "pnpm --filter @unframe/contracts check",
     "client:check": "pnpm --filter @unframe/api-client-typescript check",
     "check": "pnpm types:check && pnpm typecheck && pnpm lint && pnpm test && pnpm contracts:check && pnpm client:check && pnpm build"
   },

app/server/control-plane/test/modules/realtime-bootstrap/credential.test.ts

@@ -10,6 +10,18 @@ const fromBase64Url = (value: string) => {
   return Uint8Array.from(atob(padded), (character) => character.charCodeAt(0));
 };
 
+const generatePrivateJwk = async () => {
+  const generatedKey = await crypto.subtle.generateKey({ name: "Ed25519" }, true, [
+    "sign",
+    "verify",
+  ]);
+  if (!("privateKey" in generatedKey)) throw new Error("Ed25519 must generate a key pair");
+
+  const exportedKey = await crypto.subtle.exportKey("jwk", generatedKey.privateKey);
+  if (exportedKey instanceof ArrayBuffer) throw new Error("JWK export must return a JSON key");
+  return exportedKey;
+};
+
 describe("RealtimeBootstrapCredentials", () => {
   it("rejects a signing key that is not an Ed25519 private JWK", () => {
     expect(
@@ -26,8 +38,7 @@ describe("RealtimeBootstrapCredentials", () => {
   });
 
   it("issues a verifiable EdDSA session credential and only publishes its public JWK", async () => {
-    const keyPair = await crypto.subtle.generateKey({ name: "Ed25519" }, true, ["sign", "verify"]);
-    const privateJwk = await crypto.subtle.exportKey("jwk", keyPair.privateKey);
+    const privateJwk = await generatePrivateJwk();
     const credentials = new RealtimeBootstrapCredentials(privateJwk, {
       issuer: "https://control-plane.example.com",
       keyId: "realtime-2026-08",
@@ -107,8 +118,7 @@ describe("RealtimeBootstrapCredentials", () => {
   });
 
   it("UTF-8 audienceを含むcredentialを発行する", async () => {
-    const keyPair = await crypto.subtle.generateKey({ name: "Ed25519" }, true, ["sign", "verify"]);
-    const privateJwk = await crypto.subtle.exportKey("jwk", keyPair.privateKey);
+    const privateJwk = await generatePrivateJwk();
     const credentials = new RealtimeBootstrapCredentials(privateJwk, {
       issuer: "https://control-plane.example.com",
       keyId: "realtime-2026-08",