@einja/dev-cli 0.1.45 → 0.1.49

package/presets/default/docs/einja/steering/development/frontend-development.md

@@ -60,10 +60,10 @@ apps/web/
 │   │   │   │       └── page.tsx     # 投稿詳細
 │   │   │   └── profile/
 │   │   │       └── page.tsx
-│   │   ├── api/                      # API Routes
-│   │   │   └── rpc/
-│   │   │       └── [[...route]]/
-│   │   │           └── route.ts     # Honoエントリーポイント
+│   │   ├── api/rpc/                  # ドメインベースRPC
+│   │   │   ├── users/[[...route]]/route.ts
+│   │   │   ├── auth/[[...route]]/route.ts
+│   │   │   └── posts/[[...route]]/route.ts
 │   │   ├── layout.tsx                # ルートレイアウト
 │   │   └── page.tsx                  # トップページ
 │   ├── components/                   # UIコンポーネント
@@ -84,7 +84,7 @@ apps/web/
 │   │           └── RegisterForm.tsx
 │   ├── lib/                          # ユーティリティ
 │   │   ├── api/
-│   │   │   ├── client.ts            # Hono Client設定
+│   │   │   ├── rpc.ts              # Hono RPCクライアント設定
 │   │   │   └── parse-response.ts    # レスポンスパース＆バリデーション
 │   │   ├── query-client.ts           # Tanstack Query設定
 │   │   └── utils.ts                  # 共通ユーティリティ
@@ -116,10 +116,9 @@ apps/admin/
 │   │   │   │   │   └── page.tsx
 │   │   │   │   └── analytics/
 │   │   │   │       └── page.tsx
-│   │   ├── api/
-│   │   │   └── rpc/
-│   │   │       └── [[...route]]/
-│   │   │           └── route.ts
+│   │   ├── api/rpc/                  # ドメインベースRPC
+│   │   │   ├── users/[[...route]]/route.ts
+│   │   │   └── posts/[[...route]]/route.ts
 │   │   ├── layout.tsx
 │   │   └── page.tsx
 │   ├── components/
@@ -198,27 +197,39 @@ export const paginatedUserListSchema = z.object({
 
 ### セットアップ
 
-**Hono Clientの初期化**:
+**RPCクライアントの初期化**:
 
-```typescript
-// apps/web/src/lib/api/client.ts
-import { hc } from 'hono/client'
-import type { AppType } from '@/app/api/rpc/[[...route]]/route'
+> **Note**: 以下は複数ドメインを追加した場合の完成形の例です。現在のテンプレートでは `users` ドメインのみ実装されています。
 
-export const apiClient = hc<AppType>('/')
+```typescript
+// apps/web/src/lib/api/rpc.ts
+import type { UsersAppType } from "@/app/api/rpc/users/[[...route]]/route";
+import type { AuthAppType } from "@/app/api/rpc/auth/[[...route]]/route";
+import type { PostsAppType } from "@/app/api/rpc/posts/[[...route]]/route";
+import { hc } from "hono/client";
+
+const usersClient = hc<UsersAppType>("/");
+const authClient = hc<AuthAppType>("/");
+const postsClient = hc<PostsAppType>("/");
+
+export const rpc = {
+  users: usersClient.api.rpc.users,
+  auth: authClient.api.rpc.auth,
+  posts: postsClient.api.rpc.posts,
+} as const;
 ```
 
-**型定義のエクスポート**:
+**型定義のエクスポート**（ドメインごとのルートファイル）:
 
 ```typescript
-// apps/web/src/app/api/rpc/[[...route]]/route.ts
+// apps/web/src/app/api/rpc/users/[[...route]]/route.ts
 import { Hono } from 'hono'
 import { handle } from 'hono/vercel'
 import { userRoutes } from '@web/server/presentation/routes/userRoutes'
 
-const app = new Hono().basePath('/api/rpc')
+const app = new Hono().basePath('/api/rpc/users')
 
-const routes = app.route('/users', userRoutes)
+const routes = app.route('/', userRoutes)
 
 export const GET = handle(app)
 export const POST = handle(app)
@@ -226,7 +237,7 @@ export const PUT = handle(app)
 export const DELETE = handle(app)
 
 // 型のエクスポート（フロントエンドで使用）
-export type AppType = typeof routes
+export type UsersAppType = typeof routes
 ```
 
 ### API呼び出しパターン
@@ -235,7 +246,7 @@ export type AppType = typeof routes
 
 ```typescript
 // ユーザー一覧取得
-const response = await apiClient.api.rpc.users.$get({
+const response = await rpc.users.$get({
   query: { page: '1', limit: '10' }
 })
 const data = await response.json() // 型推論: { users: User[], total: number }
@@ -245,7 +256,7 @@ const data = await response.json() // 型推論: { users: User[], total: number
 
 ```typescript
 // ユーザー作成
-const response = await apiClient.api.rpc.users.$post({
+const response = await rpc.users.$post({
   json: { email: 'user@example.com', name: 'User Name' }
 })
 const data = await response.json() // 型推論: { user: User }
@@ -255,7 +266,7 @@ const data = await response.json() // 型推論: { user: User }
 
 ```typescript
 // ユーザー詳細取得
-const response = await apiClient.api.rpc.users[':id'].$get({
+const response = await rpc.users[':id'].$get({
   param: { id: '123' }
 })
 const data = await response.json() // 型推論: { user: User }
@@ -265,7 +276,7 @@ const data = await response.json() // 型推論: { user: User }
 
 ```typescript
 // ユーザー更新
-const response = await apiClient.api.rpc.users[':id'].$put({
+const response = await rpc.users[':id'].$put({
   param: { id: '123' },
   json: { name: 'Updated Name' }
 })
@@ -276,7 +287,7 @@ const data = await response.json() // 型推論: { user: User }
 
 ```typescript
 // ユーザー削除
-const response = await apiClient.api.rpc.users[':id'].$delete({
+const response = await rpc.users[':id'].$delete({
   param: { id: '123' }
 })
 const data = await response.json() // 型推論: { success: true }
@@ -344,13 +355,13 @@ export async function parseResponse<T>(
 import { useQuery } from "@tanstack/react-query";
 import { parseResponse } from "@/lib/api/parse-response";
 import { paginatedUserListSchema } from "@/shared/schemas/user";
-import { apiClient } from "@/lib/api/client";
+import { rpc } from "@/lib/api/rpc";
 
 export function useUsers(filters: UserFilters = {}) {
   return useQuery({
     queryKey: ["users", filters],
     queryFn: async () => {
-      const response = await apiClient.api.rpc.users.$get({
+      const response = await rpc.users.$get({
         query: { page: String(filters.page || 1), limit: String(filters.limit || 10) },
       });
       return parseResponse(response, paginatedUserListSchema);
@@ -417,11 +428,11 @@ try {
 ```typescript
 // app/posts/page.tsx (Server Component - デフォルト)
 import { PostList } from '@/components/features/posts/PostList'
-import { apiClient } from '@/lib/api-client'
+import { rpc } from '@/lib/api/rpc'
 
 export default async function PostsPage() {
   // サーバー側でデータフェッチ
-  const response = await apiClient.posts.$get({
+  const response = await rpc.posts.$get({
     query: { page: '1', limit: '10' }
   })
   const data = await response.json()
@@ -546,11 +557,11 @@ export default function PostsPage() {
 import { Header } from '@/components/features/Header'
 import { Sidebar } from '@/components/features/Sidebar'
 import { PostListContainer } from '@/components/features/posts/PostListContainer'
-import { apiClient } from '@/lib/api-client'
+import { rpc } from '@/lib/api/rpc'
 
 export default async function PostsPage() {
   // サーバー側でデータフェッチ
-  const response = await apiClient.posts.$get()
+  const response = await rpc.posts.$get()
   const data = await response.json()
 
   return (
@@ -596,11 +607,11 @@ export function PostListContainer({ initialData }) {
 ```typescript
 // app/posts/[id]/page.tsx (Server Component)
 import { PostDetail } from '@/components/features/posts/PostDetail'
-import { apiClient } from '@/lib/api-client'
+import { rpc } from '@/lib/api/rpc'
 
 export default async function PostDetailPage({ params }: { params: { id: string } }) {
   // サーバー側でデータフェッチ
-  const response = await apiClient.posts[':id'].$get({
+  const response = await rpc.posts[':id'].$get({
     param: { id: params.id }
   })
   const { post } = await response.json()
@@ -797,13 +808,13 @@ export default function RootLayout({ children }) {
 
 ```typescript
 import { useQuery } from '@tanstack/react-query'
-import { apiClient } from '@/lib/api-client'
+import { rpc } from '@/lib/api/rpc'
 
 export function usePostList(page: number, limit: number) {
   return useQuery({
     queryKey: ['posts', page, limit], // キャッシュキー
     queryFn: async () => {
-      const response = await apiClient.posts.$get({
+      const response = await rpc.posts.$get({
         query: { page: String(page), limit: String(limit) }
       })
       if (!response.ok) {
@@ -841,7 +852,7 @@ export function PostList() {
 
 ```typescript
 import { useMutation, useQueryClient } from '@tanstack/react-query'
-import { apiClient } from '@/lib/api-client'
+import { rpc } from '@/lib/api/rpc'
 import type { CreatePostInput } from '@repo/server-core/domain/validators/post'
 
 export function useCreatePost() {
@@ -849,7 +860,7 @@ export function useCreatePost() {
 
   return useMutation({
     mutationFn: async (data: CreatePostInput) => {
-      const response = await apiClient.posts.$post({ json: data })
+      const response = await rpc.posts.$post({ json: data })
       if (!response.ok) {
         throw new Error('Failed to create post')
       }
@@ -1111,7 +1122,7 @@ export function PostCard({ post }: PostCardProps) {
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
 import { parseResponse } from '@/lib/api/parse-response'
 import { paginatedPostListSchema } from '@/shared/schemas/post'
-import { apiClient } from '@/lib/api/client'
+import { rpc } from '@/lib/api/rpc'
 import type { CreatePostInput, UpdatePostInput } from '@repo/server-core/domain/validators/post'
 
 // 投稿一覧取得
@@ -1119,7 +1130,7 @@ export function usePostList(page: number, limit: number) {
   return useQuery({
     queryKey: ['posts', page, limit],
     queryFn: async () => {
-      const response = await apiClient.api.posts.$get({
+      const response = await rpc.posts.$get({
         query: { page: String(page), limit: String(limit) }
       })
       return parseResponse(response, paginatedPostListSchema)
@@ -1132,7 +1143,7 @@ export function usePost(id: string) {
   return useQuery({
     queryKey: ['posts', id],
     queryFn: async () => {
-      const response = await apiClient.api.posts[':id'].$get({ param: { id } })
+      const response = await rpc.posts[':id'].$get({ param: { id } })
       return parseResponse(response, postSchema)
     },
   })
@@ -1144,7 +1155,7 @@ export function useCreatePost() {
 
   return useMutation({
     mutationFn: async (data: CreatePostInput) => {
-      const response = await apiClient.api.posts.$post({ json: data })
+      const response = await rpc.posts.$post({ json: data })
       return parseResponse(response, postSchema)
     },
     onSuccess: () => {
@@ -1159,7 +1170,7 @@ export function useUpdatePost(id: string) {
 
   return useMutation({
     mutationFn: async (data: UpdatePostInput) => {
-      const response = await apiClient.api.posts[':id'].$put({
+      const response = await rpc.posts[':id'].$put({
         param: { id },
         json: data
       })
@@ -1178,7 +1189,7 @@ export function useDeletePost() {
 
   return useMutation({
     mutationFn: async (id: string) => {
-      const response = await apiClient.api.posts[':id'].$delete({ param: { id } })
+      const response = await rpc.posts[':id'].$delete({ param: { id } })
       return parseResponse(response, deleteResponseSchema)
     },
     onSuccess: () => {
@@ -1332,12 +1343,12 @@ export default function DashboardLayout({ children }: { children: React.ReactNod
 // ✅ page.tsxはServer Component（'use client'なし）
 import { PostListContainer } from '@/components/features/posts/PostListContainer'
 import { Button } from '@/components/ui/button'
-import { apiClient } from '@/lib/api-client'
+import { rpc } from '@/lib/api/rpc'
 import Link from 'next/link'
 
 export default async function PostsPage() {
   // サーバー側でデータフェッチ
-  const response = await apiClient.posts.$get({
+  const response = await rpc.posts.$get({
     query: { page: '1', limit: '10' }
   })
   const data = await response.json()
@@ -1402,11 +1413,11 @@ export default function PostNewPage() {
 ```typescript
 // ✅ page.tsxはServer Component（'use client'なし）
 import { PostDetail } from '@/components/features/posts/PostDetail'
-import { apiClient } from '@/lib/api-client'
+import { rpc } from '@/lib/api/rpc'
 
 export default async function PostDetailPage({ params }: { params: { id: string } }) {
   // サーバー側でデータフェッチ
-  const response = await apiClient.posts[':id'].$get({
+  const response = await rpc.posts[':id'].$get({
     param: { id: params.id }
   })
   const { post } = await response.json()
@@ -1453,7 +1464,7 @@ export function usePostList(page: number, limit: number) {
   return useQuery({
     queryKey: ['posts', page, limit],
     queryFn: async () => {
-      const response = await apiClient.posts.$get({
+      const response = await rpc.posts.$get({
         query: { page: String(page), limit: String(limit) }
       })
 
@@ -1531,7 +1542,7 @@ export class ErrorBoundary extends Component<Props, State> {
 // ✅ page.tsxはServer Component（'use client'なし）
 import { PostListWithPagination } from '@/components/features/posts/PostListWithPagination'
 import { Button } from '@/components/ui/button'
-import { apiClient } from '@/lib/api-client'
+import { rpc } from '@/lib/api/rpc'
 import Link from 'next/link'
 
 interface PostsPageProps {
@@ -1543,7 +1554,7 @@ export default async function PostsPage({ searchParams }: PostsPageProps) {
   const limit = 10
 
   // サーバー側でデータフェッチ
-  const response = await apiClient.posts.$get({
+  const response = await rpc.posts.$get({
     query: { page: String(page), limit: String(limit) }
   })
   const data = await response.json()

package/presets/default/docs/einja/steering/development/review-guidelines.md

@@ -71,6 +71,8 @@ APIエンドポイントやアプリケーション機能の実装レビュー
   - Zodスキーマによるバリデーションが全エンドポイントで実装されているか
   - **🔗 Honoのメソッドチェーン形式が守られているか** - `new Hono().get().post().put().delete()`の形式で実装すること。個別呼び出し形式（`app.get(); app.post();`）では`typeof app`による型推論が損なわれ、Hono Clientでの型安全性が失われる（詳細: [API開発ガイド - メソッドチェーンパターン](./development/api-development.md#メソッドチェーンパターン)）
   - **🔗 サブルート内で`.use()`を使っていないか** - ミドルウェアはメインアプリ側で適用すること。サブルート内で`.use()`を使うと型が`ClientRequest<{}>`になり型推論が壊れる（詳細: [API開発ガイド - ミドルウェアと型推論](./development/api-development.md#ミドルウェアと型推論の注意点)）
+  - **🔗 ドメインベースRPC分割が守られているか** - 各ドメインごとに `/api/rpc/{domain}/[[...route]]/route.ts` のエントリーポイントを作成すること
+  - **🔗 単一catch-allに全ルートを集約していないか** - 1つの `[[...route]]/route.ts` に複数ドメインのルートをまとめて登録してはならない。ドメインごとにエントリーポイントを分割すること
   - エラーハンドリングがApplicationErrorで統一されているか
   - loggerが使用され、console.logが使われていないか
   - **相対パスの使用禁止** - import文、require文、ファイルパス指定で`../`や`./`などの相対パスが使用されていないか。必ずアプリ固有エイリアス（`@web/*`、`@admin/*`等）またはパッケージ名（`@repo/server-core`等）を使用すること
@@ -82,7 +84,8 @@ APIエンドポイントやアプリケーション機能の実装レビュー
 - [ ] **APIクライアント実装ガイドの実装ルール遵守**
   - Tanstack QueryとHonoクライアントを使用した型安全な実装になっているか
   - Zodスキーマによるレスポンス検証が実装されているか
-  - apiClientsディレクトリ構成が守られているか（フェッチ関数とhooksの分離）
+  - `rpc`オブジェクト（ドメインごとのHono Client）を使用しているか
+  - 旧`apiClient`パターン（単一クライアント）を使用していないか（使用禁止）
   - useMutationでのキャッシュ無効化が適切に実装されているか
   - エラーハンドリングが実装されているか
   - 型定義の整合性が保たれているか（バックエンドとフロントエンド間）

package/presets/default/docs/einja/steering/development/testing-strategy.md

@@ -425,7 +425,7 @@ describe('UserRepository - データベースエラー', () => {
 
 ```typescript
 // apps/web/__tests__/integration/post-api.test.ts
-import { apiClient } from '@/lib/api-client'
+import { rpc } from '@/lib/api/rpc'
 import { prisma } from '@repo/server-core/infrastructure/database/client'
 
 describe('Post API統合テスト', () => {
@@ -454,7 +454,7 @@ describe('Post API統合テスト', () => {
     })
 
     // When: API呼び出し
-    const response = await apiClient.posts.$get({
+    const response = await rpc.posts.$get({
       query: { page: '1', limit: '10' }
     })
 
@@ -475,7 +475,7 @@ describe('Post API統合テスト', () => {
     })
 
     // When: 投稿作成APIを呼び出し
-    const response = await apiClient.posts.$post({
+    const response = await rpc.posts.$post({
       json: {
         title: 'New Post',
         content: 'Content',

package/presets/default/package.json

@@ -0,0 +1,73 @@
+{
+	"name": "einja-management-monorepo",
+	"version": "0.1.0",
+	"private": true,
+	"packageManager": "pnpm@10.14.0",
+	"workspaces": [
+		"apps/*",
+		"packages/*"
+	],
+	"scripts": {
+		"prepare": "husky",
+		"dev": "tsx scripts/worktree/dev.ts",
+		"dev:bg": "tsx scripts/worktree/dev.ts --background",
+		"dev:stop": "tsx scripts/worktree/dev.ts --stop",
+		"dev:status": "tsx scripts/worktree/dev.ts --status",
+		"dev:logs": "tail -f log/dev.log",
+		"dev:skip-setup": "turbo run dev",
+		"build": "dotenvx run -f .env.production -- turbo run build",
+		"build:dev": "dotenvx run -f .env.develop -- turbo run build",
+		"build:local": "turbo run build",
+		"start": "turbo run start",
+		"generate": "turbo run generate",
+		"lint": "turbo run lint",
+		"lint:fix": "turbo run lint:fix",
+		"format": "turbo run format",
+		"format:fix": "turbo run format:fix",
+		"typecheck": "turbo run typecheck",
+		"test": "turbo run test",
+		"test:watch": "turbo run test:watch",
+		"test:ui": "turbo run test:ui",
+		"test:coverage": "turbo run test:coverage",
+		"prepush": "pnpm prepush:lint && pnpm prepush:typecheck && pnpm prepush:test",
+		"prepush:lint": "lint-staged",
+		"prepush:typecheck": "turbo run typecheck",
+		"prepush:test": "turbo run test",
+		"db:generate": "turbo run db:generate",
+		"db:push": "turbo run db:push",
+		"db:migrate": "turbo run db:migrate",
+		"db:migrate:deploy": "turbo run db:migrate:deploy",
+		"db:studio": "turbo run db:studio",
+		"db:seed": "turbo run db:seed",
+		"dev:setup": "tsx scripts/setup-dev.ts",
+		"dotenvx": "dotenvx",
+		"env:update": "tsx scripts/env.ts",
+		"env:encrypt": "dotenvx encrypt",
+		"env:show": "tsx scripts/env-show.ts",
+		"env:rotate-secrets": "tsx scripts/env-rotate-secrets.ts",
+		"einja:sync": "npx --yes @einja/dev-cli@latest sync",
+		"init:github": "tsx scripts/init-github.ts",
+		"task:loop": "npx --yes @einja/dev-cli@latest task:loop",
+		"changeset": "changeset"
+	},
+	"devDependencies": {
+		"@changesets/changelog-github": "^0.5.1",
+		"@changesets/cli": "^2.29.0",
+		"@clack/prompts": "^0.11.0",
+		"@dotenvx/dotenvx": "^1.51.4",
+		"@types/node": "^25.0.3",
+		"husky": "^9.1.7",
+		"lint-staged": "^16.1.0",
+		"tsx": "^4.7.0",
+		"turbo": "^2.5.8"
+	},
+	"volta": {
+		"node": "22.16.0",
+		"pnpm": "10.14.0"
+	},
+	"dependencies": {
+		"@hono/zod-validator": "^0.7.6",
+		"hono": "^4.11.3",
+		"zod": "^4.3.5"
+	}
+}

package/presets/default/preset.yaml

@@ -124,8 +124,8 @@ requirements:
     "format:fix": "biome format --write ."
     typecheck: "tsc --noEmit"
     prepush: "{pm} run lint && {pm} run typecheck"
-    "task:loop": "npx @einja/dev-cli task:loop"
-    "einja:sync": "npx @einja/dev-cli sync"
+    "task:loop": "npx @einja/dev-cli@latest task:loop"
+    "einja:sync": "npx @einja/dev-cli@latest sync"
 
   # システムコマンド（警告表示のみ、自動インストールしない）
   systemCommands:

package/presets/default/scripts/ensure-serena.sh

@@ -7,15 +7,34 @@ _SERENA_BASE="${1:-$(pwd)}"
 _SERENA_PORT_FILE="$_SERENA_BASE/.serena-port"
 _SERENA_DEFAULT_PORT="${SERENA_PORT:-9850}"
 
-# --- 既存インスタンスチェック（PIDベース） ---
+# --- ヘルパー関数 ---
+_is_uint() {
+  case "$1" in
+    ""|0|*[!0-9]*) return 1 ;;
+    *) return 0 ;;
+  esac
+}
+_escape_ere() {
+  printf '%s' "$1" | sed -e 's/[][(){}.^$*+?|\\]/\\&/g'
+}
+
+# --- 既存インスタンスチェック（PID×プロセス検証） ---
 if [ -f "$_SERENA_PORT_FILE" ]; then
-  read -r _saved_port _saved_pid < "$_SERENA_PORT_FILE"
-  if [ -n "$_saved_pid" ] && kill -0 "$_saved_pid" 2>/dev/null; then
-    # PIDが生存 → 自プロジェクトのSerena
-    export SERENA_PORT="$_saved_port"
-    return 0 2>/dev/null || true
+  IFS=' ' read -r _saved_port _saved_pid _rest < "$_SERENA_PORT_FILE" || true
+
+  if _is_uint "$_saved_pid" && _is_uint "$_saved_port"; then
+    _cmd="$(ps -p "$_saved_pid" -ww -o command= 2>/dev/null || true)"
+    _base_ere="$(_escape_ere "$_SERENA_BASE")"
+
+    if [ -n "$_cmd" ] \
+       && printf '%s\n' "$_cmd" | grep -Eq -- "(^|[[:space:]])--project(=|[[:space:]])${_base_ere}([[:space:]]|$)"; then
+      # 自プロジェクトのSerenaプロセス → 再利用
+      export SERENA_PORT="$_saved_port"
+      return 0 2>/dev/null || true
+    fi
   fi
-  # PID死亡 → クリーンアップ
+
+  # PID死亡 or 数値不正 or 別プロセス/別プロジェクトのSerena → クリーンアップ
   rm -f "$_SERENA_PORT_FILE"
 fi