@gaonjs/cli 0.35.0 → 0.37.1

package/dist/templates/project/agents/web.md.tpl

@@ -239,6 +239,35 @@ async create() {
 
 순수 JSON/API 앱(X-Inertia 아님·세션 없음)은 기존대로 **422 JSON** 을 받는다.
 
+#### 검증 사유 로케일화 — 예약 namespace `validation.*` (결정 183)
+
+검증 실패의 **필드별 사유**(`form.errors.<필드>` 로 엔드유저에 노출되는 부분)는 요청
+로케일로 번역된다 — `i18n` 이 설정돼 있고 앱이 `locales/<lng>.json` 의 **예약 namespace
+`validation.<code>`** 로 번역을 제공하면. 프레임웍은 **안정적 코드만** 노출하고 번역은
+앱 몫이다(The One Way: 코드는 프레임웍, 문안은 앱). 키가 없으면 내장 fallback(한국어)로
+떨어져 거동이 보존된다. i18n 미설정이면 항상 fallback.
+
+| code | 파라미터 | 언제 |
+|---|---|---|
+| `required` | — | 필수 컬럼 누락 |
+| `too_long` | `{ max, len }` | `.max(n)` 초과 |
+| `not_allowed` | `{ value, allowed }` | enum 밖 값 |
+| `not_integer` | `{ value }` | bigint 변환 실패 |
+| `not_boolean` | `{ value }` | boolean 변환 실패 |
+| `not_date` | `{ value }` | 날짜 변환 실패 |
+
+```json
+// locales/en.json — 앱이 검증 문안을 로케일별로 준다(i18next {{max}} 보간).
+{ "validation": {
+    "required": "This field is required.",
+    "too_long": "At most {{max}} characters (got {{len}})."
+} }
+```
+
+주의: 상단 개발자용 422 `message`(스키마 어느 파일을 고치라는 §7.5.3 **수리 안내**)는
+로케일화하지 않는다 — AI/개발자용 고정 안내다. 로케일화 대상은 **엔드유저에 닿는 필드별
+사유**뿐이다.
+
 #### 세션/CSRF 실패·415 도 코어가 Inertia-네이티브로 마감한다 (결정 165)
 
 폼 검증(결정 109)과 **대칭**으로, 컨트롤러 액션 밖(디스패처 try-catch 밖)에서 나는
@@ -423,6 +452,13 @@ const ok = await verifyPassword(plain, user.passwordDigest) // Promise<boolean>
 
   API 앱(JWT)은 세션 대신 `this.jwt.issue(user)` / `this.jwt.refresh(token)` 를 쓴다.
 
+- **API 앱은 프론트엔드가 없다(JSON 전용).** `apps/<app>/app.config.ts`(`auth: { strategy:'jwt', … }`)
+  + `routes.ts` + `controllers/` 만 두면 된다 — `index.html`·`main.ts`·`pages/` 는 만들지 않는다.
+  앱 발견은 `routes.ts` 기준이라 `gaon serve` 가 이 앱을 `/<app>` 프리픽스로 정상 마운트하고,
+  `gaon build`·`gaon check` 는 프론트 앱(=`index.html` 보유)만 검사하므로 API 앱을 프론트로
+  오검사하지 않는다. JWT 앱의 표준 형태다("프론트엔드는 프로젝트당 하나" 규칙은 Vue 앱 한정 ·
+  API 앱은 그 규칙 밖).
+
 - **`this.auth.user`/`requireAuth()` 사용자 타입은 앱이 증강한다** (결정 58).
   `GaonCurrentUser` 는 빈 인터페이스라 증강 없이는 `user.id` 접근이 타입에러다.
   `gaon g auth` 가 `apps/<app>/auth.ts` 에 심는다:

package/dist/templates/project/package.json.tpl

@@ -3,7 +3,7 @@
   "version": "0.1.0",
   "private": true,
   "type": "module",
-  "packageManager": "pnpm@10.27.0",
+  "packageManager": "{{PACKAGE_MANAGER}}",
   "engines": {
     "node": ">=22"
   },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gaonjs/cli",
-  "version": "0.35.0",
-  "description": "Gaon CLI 구현: 제너레이터·스캐폴딩·로드맵 출력 (M1 스텁)",
+  "version": "0.37.1",
+  "description": "Gaon CLI — 스캐폴딩·제너레이터·마이그레이션·dev/serve/work/hub·doctor·check (bin: gaon)",
   "type": "module",
   "license": "MIT",
   "homepage": "https://gaonjs.dev",
@@ -27,13 +27,13 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "typescript": "^5.9.0",
     "vite": "^7.0.0",
-    "@gaonjs/config": "0.14.1",
-    "@gaonjs/data": "0.16.0",
-    "@gaonjs/async": "0.11.0",
-    "@gaonjs/i18n": "0.2.0",
-    "@gaonjs/mail": "0.2.0",
-    "@gaonjs/core": "0.2.1",
-    "@gaonjs/web": "0.17.0"
+    "@gaonjs/async": "0.12.0",
+    "@gaonjs/config": "0.15.2",
+    "@gaonjs/core": "0.2.2",
+    "@gaonjs/mail": "0.2.1",
+    "@gaonjs/i18n": "0.2.1",
+    "@gaonjs/data": "0.16.1",
+    "@gaonjs/web": "0.18.1"
   },
   "scripts": {
     "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json && node -e \"require('fs').cpSync('src/templates','dist/templates',{recursive:true})\""

package/dist/templates/auth/app.ts.tpl

@@ -1,29 +0,0 @@
-// 웹 앱 팩토리 — gaon g auth 스캐폴드. createWebApp 으로 세션·인증을 배선한다.
-import { createApp, type AppSessionOptions } from 'gaonjs/web'
-import appRoutes from './routes.js'
-import session from './controllers/session.js'
-import registration from './controllers/registration.js'
-import dashboard from './controllers/dashboard.js'
-import { loadUser } from './auth.js'
-
-export interface WebAppDeps {
-  /** 세션 설정 — { redisUrl, secret } (또는 redis 인스턴스). */
-  readonly session: AppSessionOptions
-  /** 서명 쿠키/CSRF 용 비밀. */
-  readonly cookieSecret?: string
-}
-
-export function createWebApp(deps: WebAppDeps) {
-  return createApp({
-    apps: [
-      {
-        name: '{{APP_NAME}}',
-        routes: appRoutes,
-        controllers: { session, registration, dashboard },
-        session: deps.session,
-        auth: { loadUser, loginRedirect: '/session/new' },
-      },
-    ],
-    cookieSecret: deps.cookieSecret,
-  })
-}

package/dist/templates/auth/server.ts.tpl

@@ -1,14 +0,0 @@
-// 서버 진입점 — gaon g auth 스캐폴드. `node dist/server.js` 로 실행.
-import { createWebApp } from './apps/{{APP_NAME}}/app.js'
-
-const app = await createWebApp({
-  session: {
-    redisUrl: process.env.REDIS_URL ?? 'redis://127.0.0.1:6379',
-    secret: process.env.SESSION_SECRET ?? 'change-me-to-a-32+char-random-secret!!',
-  },
-  cookieSecret: process.env.COOKIE_SECRET,
-})
-
-const port = Number(process.env.PORT ?? 3000)
-await app.listen({ port, host: '0.0.0.0' })
-console.log(`web 앱이 http://localhost:${port} 에서 실행 중입니다.`)