@gaonjs/cli 0.63.1 → 0.65.0

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

@@ -74,7 +74,9 @@ npm i @gaonjs/seal        # pnpm add @gaonjs/seal · yarn add @gaonjs/seal 동
 2) 앱 설정에서 켠다:
 
 ```ts
-// apps/<앱>/app.config.ts — 앱 wire 전체 봉인(요청/응답 JSON + 최초 문서 data-page).
+// apps/web/app.config.ts — 앱 wire 전체 봉인(요청/응답 JSON + 최초 문서 data-page).
+import { defineAppConfig } from 'gaonjs/config'
+
 export default defineAppConfig({
   seal: true, // 또는 { except: ['/webhooks/*'], strictQuery: true } — except = 외부가 seal 을 모르는 경로만 평문 통과 · strictQuery = 평문 쿼리도 거부(결정 354)
 })
@@ -82,10 +84,15 @@ export default defineAppConfig({
 3) 클라이언트를 배선한다:
 
 ```ts
-// apps/<앱>/main.ts — seal 클라이언트를 정적 import 해 createGaonApp 에 넘긴다.
+// apps/web/main.ts — seal 클라이언트를 정적 import 해 createGaonApp 에 넘긴다.
 import { createGaonApp } from 'gaonjs/vue'
 import * as sealClient from '@gaonjs/seal/client'   // 정적 import (사용자 vite 가 wasm 포함 번들)
-void createGaonApp({ pages, layouts, /* ... */ sealClient })
+import { routes } from './.gaon/routes.manifest.js'
+
+const pages = import.meta.glob('./pages/**/*.vue')
+const layouts = import.meta.glob('./layouts/*.vue', { eager: true })
+
+void createGaonApp({ pages, layouts, routes, sealClient })
 ```
 
 - **왜 main.ts 배선이 필요한가 (결정 124 · §3.1)**: `@gaonjs/vue` 는 선택 플러그인 seal 을 **몰라야** 한다
@@ -194,16 +201,27 @@ seal 앱 응답에만 `script-src` 에 `'wasm-unsafe-eval'` 을 **자동 주입*
 
 ```ts
 // apps/web/app.config.ts — 앱 wire 전체 봉인.
+import { defineAppConfig } from 'gaonjs/config'
+
 export default defineAppConfig({ seal: true })
 ```
 ```ts
 // apps/web/main.ts — seal 클라이언트 정적 import 를 createGaonApp 에 주입(결정 124 · doctor 가 강제·fixer 자동 배선).
 import { createGaonApp } from 'gaonjs/vue'
 import * as sealClient from '@gaonjs/seal/client'
-void createGaonApp({ pages, layouts, /* ... */ sealClient })
+import { routes } from './.gaon/routes.manifest.js'
+
+const pages = import.meta.glob('./pages/**/*.vue')
+const layouts = import.meta.glob('./layouts/*.vue', { eager: true })
+
+void createGaonApp({ pages, layouts, routes, sealClient })
 ```
 ```ts
+// apps/web/controllers/posts.ts
 // 컨트롤러는 그대로 — seal 을 전혀 모른다(요청/응답 JSON·최초 문서 data-page·WS 프레임이 자동 봉인).
+import { controller } from 'gaonjs/web'
+import { Post } from '../../../domain/models/Post.js'
+
 export default controller({
   async index() {
     return this.render('Posts/Index', { posts: await Post.latest().all() })

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

@@ -249,7 +249,7 @@
 
 ## 정본 예시
 
-```ts
+```ts fragment
 // 시크릿 — env 로만 (gaonjs/env)
 import { env } from 'gaonjs/env'
 const apiKey = env('PAYMENT_API_KEY')   // .env / 배포 환경변수

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

@@ -52,21 +52,26 @@
 ### 2. 설정 (`gaon.config.ts`)
 
 ```ts
-storage: process.env.STORAGE_ENDPOINT
-  ? {
-      default: 'main',
-      disks: {
-        main: {
-          driver: 's3',                              // 's3' | 'local'
-          bucket: process.env.STORAGE_BUCKET ?? 'myapp',
-          endpoint: process.env.STORAGE_ENDPOINT,    // MinIO/R2 = 필수 · AWS S3 = 생략
-          accessKeyId: process.env.STORAGE_ACCESS_KEY,
-          secretAccessKey: process.env.STORAGE_SECRET_KEY,
-          // publicUrl: 'https://cdn.example.com',    // 있으면 url()이 공개 URL
+// gaon.config.ts
+import { defineConfig } from 'gaonjs/config'
+
+export default defineConfig({
+  storage: process.env.STORAGE_ENDPOINT
+    ? {
+        default: 'main',
+        disks: {
+          main: {
+            driver: 's3',                            // 's3' | 'local'
+            bucket: process.env.STORAGE_BUCKET ?? 'myapp',
+            endpoint: process.env.STORAGE_ENDPOINT,  // MinIO/R2 = 필수 · AWS S3 = 생략
+            accessKeyId: process.env.STORAGE_ACCESS_KEY,
+            secretAccessKey: process.env.STORAGE_SECRET_KEY,
+            // publicUrl: 'https://cdn.example.com', // 있으면 url()이 공개 URL
+          },
         },
-      },
-    }
-  : undefined,
+      }
+    : undefined,
+})
 ```
 
 - dev 는 compose 의 `createbuckets` 가 버킷을 만들어 **첫 업로드부터 동작**한다
@@ -86,6 +91,9 @@ storage: process.env.STORAGE_ENDPOINT
 
 ```ts
 // apps/web/controllers/profile.ts
+import { controller } from 'gaonjs/web'
+import { Storage } from 'gaonjs/storage'
+
 export default controller({
   async updateAvatar() {
     const f = this.file('avatar')                     // UploadedFile | undefined
@@ -139,7 +147,7 @@ export default controller({
 
 ## 정본 예시
 
-```ts
+```ts fragment
 // 저장 → 공개/서명 URL 얻기(드라이버 무관 · 같은 코드). url() 은 async.
 // 화면에 표시할 파일이면 키를 public/ 아래에 둔다 — 로컬 디스크의 서빙 범위가
 // publicPrefix(기본 'public/')로 한정되기 때문이다(결정 401 · 밖이면 404).

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

@@ -56,7 +56,7 @@
 
 ### 3. 실 NATS 접속 관례
 
-```ts
+```ts test
 import { connectNats } from 'gaonjs/async'
 
 // 인자 없이 부르면 env NATS_URL(없으면 nats://127.0.0.1:4222)에 붙는다.
@@ -147,7 +147,7 @@ describe('PostPublished (실 NATS JetStream)', () => {
   표준 하네스(`connectTestDatabase` · `config.nats` + `main` 커넥션)가 배선하므로, `gaon test`
   로 도는 통합 테스트에서 그냥 성립한다.
 
-```ts
+```ts test
 // service() 가 emit 하는 흐름도 같은 한 줄로 확증된다(트리거만 서비스 호출로 바꾸면 됨).
 await expectEventProcessed(PostPublished, () => PublishPost.call({ postId: 1n }), { nats })
 ```
@@ -190,7 +190,7 @@ DB 테스트는 손으로 커넥션을 배선하지 않는다 — `gaon test`
 
 스캐폴드가 심어 주는 `test/setup.ts`(수정 불필요):
 
-```ts
+```ts test
 import { afterAll, afterEach, beforeAll } from 'vitest'
 import { connectTestDatabase, truncateAllConnections, type TestDbHandle } from 'gaonjs/testing'
 
@@ -273,7 +273,7 @@ describe('AuditLog(실 mongod)', () => {
   서비스가 반환하기 **전에** 실행되므로, 테스트는 서비스 호출을 `await` 한 직후 몽고
   문서를 단언하면 된다(별도 대기·폴링 불필요).
 
-```ts
+```ts test
 // SQL 커밋 → 몽고 감사 로그 순서를 한 흐름으로 확증한다.
 const user = await SignUp.call({ email: 'a@b.c', password: 'x' })   // main(SQL) 커밋 + afterCommit
 expect(await AuditLog.countDocuments({ actorId: String(user.id) })).toBe(1)
@@ -298,7 +298,7 @@ expect(await AuditLog.countDocuments({ actorId: 'dup' })).toBe(0)
 정본 = "직렬화 결과 어디에도 hidden 컬럼명이 없다" 를 **재귀로** 단언한다
 (배열·중첩 관계 전부 훑는 헬퍼). 관계를 포함한 픽스처에 적용한다:
 
-```ts
+```ts test
 // 직렬화 결과(JSON-safe)에 hidden 컬럼명이 어느 깊이에도 없음을 확인.
 function assertNoHiddenLeak(value: unknown, hidden: readonly string[]): void {
   const walk = (v: unknown): void => {

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

@@ -231,7 +231,7 @@ handler 안에서 파싱). **결정 342 이후 헤더 부착은 프레임웍 자
 (참고: 지원 Content-Type 은 `application/json` · `multipart/form-data` 뿐이라
 `x-www-form-urlencoded` 로 폼을 보내면 415 로 거부된다 · `inertia.ts` · §아래 415.)
 
-```vue
+```vue fragment
 <script setup lang="ts">
 import { useForm } from 'gaonjs/vue'
 const form = useForm({ avatar: null as File | null })
@@ -259,8 +259,10 @@ redirect 로 처리한다 — 전체 페이지 리로드도, 별도 REST 엔드
 폼 API 는 **`gaonjs/vue` 의 `useForm`·`router`** 뿐이다(결정 64) —
 `@inertiajs/vue3` 를 직접 import 하지 않는다(파사드가 The One Way).
 
-```ts
+```ts fragment
 // 로그인 폼 — 제출은 Inertia SPA 방식, 서버는 redirect 로 답한다.
+import { pageProps, router, useForm } from 'gaonjs/vue'
+
 // pageProps 는 반응형 — 변수로 받아 props.x 로 접근한다(구조분해 금지 · 결정 99).
 // CSRF 토큰은 프레임웍이 자동 부착한다(결정 342) — _csrf 바디도, 수동 헤더도 없다.
 const props = pageProps<'web:session#new'>()
@@ -282,7 +284,7 @@ Inertia 폼(`useForm(...).post()`)의 검증 실패는 컨트롤러가 손으로
 방문의 `errors` 로 `form.errors.<필드>` 를 **자동으로 채운다**. 입력값은
 `useForm` 이 그대로 보존한다(재제출 방지). 컨트롤러는 성공 경로만 쓴다:
 
-```ts
+```ts controller-action
 // 컨트롤러 — 검증 실패 분기를 손으로 쓰지 않는다(결정 109).
 async create() {
   const data = this.params(Post.form.pick('title', 'body'))  // 실패 시 프레임웍이 303 back
@@ -291,10 +293,18 @@ async create() {
 }
 ```
 
-```vue
+```vue fragment
 <!-- 페이지 — form.errors.<필드> 는 서버 검증 실패 시 자동으로 채워진다. -->
-<input v-model="form.title" />
-<p v-if="form.errors.title">{{ form.errors.title }}</p>
+<script setup lang="ts">
+import { useForm } from 'gaonjs/vue'
+
+const form = useForm({ title: '', body: '' })
+</script>
+
+<template>
+  <input v-model="form.title" />
+  <p v-if="form.errors.title">{{ form.errors.title }}</p>
+</template>
 ```
 
 순수 JSON/API 앱(X-Inertia 아님·세션 없음)은 기존대로 **422 JSON** 을 받는다.
@@ -302,8 +312,9 @@ async create() {
 #### 검증 사유 로케일화 — 예약 namespace `validation.*` (결정 183)
 
 검증 실패의 **필드별 사유**(`form.errors.<필드>` 로 엔드유저에 노출되는 부분)는 요청
-로케일로 번역된다 — `i18n` 이 설정돼 있고 앱이 `locales/<lng>.json` 의 **예약 namespace
-`validation.<code>`** 로 번역을 제공하면. 프레임웍은 **안정적 코드만** 노출하고 번역은
+로케일로 번역된다 — `i18n` 이 설정돼 있고 프로젝트가 `domain/locales/<로케일>/backend.json`
+의 **예약 namespace `validation.<code>`** 로 번역을 제공하면(결정 459 — 검증 문안은 화면
+밖 문구라 도메인이 소유한다). 프레임웍은 **안정적 코드만** 노출하고 번역은
 앱 몫이다(The One Way: 코드는 프레임웍, 문안은 앱). 키가 없으면 내장 fallback(한국어)로
 떨어져 거동이 보존된다. i18n 미설정이면 항상 fallback.
 
@@ -320,7 +331,7 @@ async create() {
 | `invalid` | — | 그 외 coerce 예외(비-CoerceError) |
 
 ```json
-// locales/en.json — 앱이 검증 문안을 로케일별로 준다(i18next {{max}} 보간).
+// domain/locales/en/backend.json — 검증 문안을 로케일별로 준다(i18next {{max}} 보간).
 { "validation": {
     "required": "This field is required.",
     "too_long": "At most {{max}} characters (got {{len}})."
@@ -381,6 +392,8 @@ async create() {
 
 ```ts
 // apps/web/app.config.ts
+import { defineAppConfig } from 'gaonjs/config'
+
 export default defineAppConfig({
   sharedProps: (ctx) => ({ locale: ctx.session?.locale ?? 'en', theme: 'dark' }),
 })
@@ -414,7 +427,7 @@ shared.locale                            // 로그인/로그아웃·플래시로
 메서드(스코프)**, 대등한 조합이면 `domain/services/`(`agents/data.md` §8). 컨트롤러가
 `pluck`·교집합·사이드바 질의를 인라인 조립하기 시작하면 서비스/스코프로 옮긴다.
 
-```ts
+```ts fragment
 // ❌ 컨트롤러가 검색 교집합·태그 필터를 인라인 조립
 // ✅ const rows = await Post.searchPublished(term).latest().offset(o).limit(n).all()
 // ✅ 페이지네이션은 스코프 체인 종단 paginate — 컨트롤러는 여전히 한 줄(결정 119)
@@ -450,7 +463,7 @@ shared.locale                            // 로그인/로그아웃·플래시로
 base64·해시를 손으로 짜지 말고** `gaonjs/web` 의 헬퍼를 쓴다(The One Way · §7 인증).
 bcrypt(cost 10)로 해싱하며 상수시간 비교를 제공한다.
 
-```ts
+```ts fragment
 import { hashPassword, verifyPassword } from 'gaonjs/web'
 
 // 가입 — 서비스에서 평문을 해싱해 hidden 컬럼(passwordDigest)에 저장.

package/dist/templates/project/{locales → apps/web/locales}/en/frontend.json.tpl

@@ -1,5 +1,6 @@
 {
   "nav": { "home": "Home" },
+  "home": { "tagline": "You are on Gaon." },
   "common": {
     "loading": "Checking status…",
     "items_one": "{{count}} item",

package/dist/templates/project/{locales → apps/web/locales}/ko/frontend.json.tpl

@@ -1,5 +1,6 @@
 {
   "nav": { "home": "홈" },
+  "home": { "tagline": "가온에 올라탔습니다." },
   "common": {
     "loading": "상태 확인 중…",
     "items_other": "항목 {{count}}개"

package/dist/templates/project/gaon.config.ts.tpl

@@ -54,11 +54,12 @@ export default defineConfig({
       }
     : undefined,
 
-  // 다국어(§7 · 결정 454). 카탈로그는 언어별 폴더 + 스코프 분리다:
-  //   locales/<로케일>/frontend.json — 화면 문구. 클라 t()(gaonjs/vue)가 쓰고 앱 번들 청크로 나간다.
-  //   locales/<로케일>/backend.json  — 메일·잡·검증 등 **서버 전용**. 클라로 나가지 않는다.
-  //   apps/<앱>/locales/<로케일>.json — 그 앱 전용 화면 문구(그 앱 청크에만 실린다).
-  // 요청 로케일은 세션>쿠키>Accept-Language 로 자동 협상된다(결정 159 · this.setLocale 로 전환).
+  // 다국어(§7 · 결정 459). 문구의 **소유자**가 위치를 정한다 — 화면이면 그 앱, 화면 밖이면 domain:
+  //   apps/<앱>/locales/<로케일>/frontend.json — 그 앱 화면 문구. 클라 t()(gaonjs/vue) · 그 앱 청크로만 나간다.
+  //   apps/<앱>/locales/<로케일>/backend.json  — 그 앱 컨트롤러 전용 서버 문구(선택).
+  //   domain/locales/<로케일>/backend.json     — 메일·잡·검증 등 도메인 공통 **서버 전용**. 클라로 나가지 않는다.
+  // 위치는 관례로 고정이라 dir 설정이 없다. 요청 로케일은 세션>쿠키>Accept-Language 로
+  // 자동 협상된다(결정 159 · this.setLocale 로 전환).
   i18n: { fallbackLng: 'ko', supportedLngs: ['ko', 'en'] },
 
   // 웹 서버 리슨 옵션. --port · env PORT 로 덮을 수 있다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/cli",
-  "version": "0.63.1",
+  "version": "0.65.0",
   "description": "Gaon CLI — 스캐폴딩·제너레이터·마이그레이션·dev/serve/work/hub·doctor·check (bin: gaon)",
   "type": "module",
   "license": "MIT",
@@ -33,14 +33,14 @@
     "typescript": "^5.9.0",
     "vite": "^7.0.0",
     "@gaonjs/async": "0.22.0",
-    "@gaonjs/config": "0.25.11",
+    "@gaonjs/config": "0.26.0",
     "@gaonjs/core": "0.3.0",
-    "@gaonjs/data": "0.26.1",
-    "@gaonjs/i18n": "0.4.1",
-    "@gaonjs/mail": "0.5.3",
-    "@gaonjs/web": "0.32.0"
+    "@gaonjs/i18n": "0.5.0",
+    "@gaonjs/mail": "0.5.4",
+    "@gaonjs/web": "0.33.0",
+    "@gaonjs/data": "0.26.2"
   },
   "scripts": {
-    "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json && node -e \"const fs=require('fs');fs.cpSync('src/templates','dist/templates',{recursive:true,filter:(s)=>!s.endsWith('.ts')});fs.rmSync('dist/templates/index.ts',{force:true})\""
+    "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json && node -e \"const fs=require('fs');fs.rmSync('dist/templates/project',{recursive:true,force:true});fs.cpSync('src/templates','dist/templates',{recursive:true,filter:(s)=>!s.endsWith('.ts')});fs.rmSync('dist/templates/index.ts',{force:true})\""
   }
 }

package/dist/templates/project/apps/web/locales/en.json.tpl

@@ -1,3 +0,0 @@
-{
-  "home": { "tagline": "You are on Gaon." }
-}

package/dist/templates/project/apps/web/locales/ko.json.tpl

@@ -1,3 +0,0 @@
-{
-  "home": { "tagline": "가온에 올라탔습니다." }
-}