@gaonjs/cli 0.25.0 → 0.26.0

package/dist/commands/test.js

@@ -22,6 +22,10 @@
 import { spawn } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { loadGaonConfig } from '@gaonjs/config';
+import { deriveTestDatabaseConfig, ensureTestDatabaseExists, destroyAllConnections, } from '@gaonjs/data';
+import { registerTsResolve } from '../tsResolve.js';
+import { runDbMigrate } from '../db/migrate.js';
 /** 사용자 프로젝트에 `test` 스크립트가 있는지. */
 function hasTestScript(cwd) {
     const pkgPath = join(cwd, 'package.json');
@@ -52,6 +56,66 @@ function scopeArgs(scope) {
     }
     return [];
 }
+/**
+ * 결정 111: 테스트 전용 DB 자동 준비 — gaon.config 의 각 커넥션을 `<db>_test` 로
+ * 파생해 없으면 만들고(CREATE DATABASE) 마이그레이션을 적용한다. 테스트 프로세스는
+ * test/setup.ts 의 `connectTestDatabase()` 로 같은 DB 에 붙고, 매 테스트 뒤
+ * `truncateAll()` 로 격리한다(§9 실 인프라 · truncate 격리 근거는 결정 111).
+ *
+ * scope='unit' 은 실 인프라가 필요 없으므로 건너뛴다. config 가 없거나 db 커넥션이
+ * 없으면 조용히 스킵(순수 vitest 위임). DB 접속 실패는 수리 안내와 함께 실패한다.
+ */
+async function provisionTestDatabases(cwd, json) {
+    registerTsResolve();
+    let config;
+    try {
+        config = await loadGaonConfig(cwd);
+    }
+    catch {
+        return true; // config 로드 실패 = 최소 프로젝트 · DB 준비 스킵
+    }
+    const dbs = config.db ? Object.entries(config.db) : [];
+    if (dbs.length === 0)
+        return true;
+    const prepared = [];
+    try {
+        for (const [key, cfg] of dbs) {
+            const testCfg = deriveTestDatabaseConfig(cfg);
+            await ensureTestDatabaseExists(testCfg);
+            const res = await runDbMigrate({
+                cwd,
+                dbKey: key,
+                json: false,
+                dryRun: false,
+                connectionOverride: testCfg,
+            });
+            if (res.exitCode !== 0) {
+                if (!json)
+                    process.stderr.write(`  ✗ 테스트 DB '${key}' 마이그레이션 실패\n${res.text}\n`);
+                return false;
+            }
+            prepared.push(key);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const hint = `  ✗ 테스트 DB 준비 실패: ${msg}\n` +
+            `  → DB 가 떠 있는지 확인하세요(docker compose up -d db). 테스트는 실 인프라가 필요합니다(§9).\n`;
+        if (json)
+            process.stdout.write(JSON.stringify({ ok: false, kind: 'provision', error: msg }) + '\n');
+        else
+            process.stderr.write(hint);
+        return false;
+    }
+    finally {
+        await destroyAllConnections();
+    }
+    if (json)
+        process.stdout.write(JSON.stringify({ kind: 'provisioned', dbs: prepared }) + '\n');
+    else
+        process.stdout.write(`  gaon test · 테스트 DB 준비 완료 (${prepared.join(', ')}) — <db>_test\n`);
+    return true;
+}
 /**
  * `gaon test` 진입점. args 는 사용자가 넘긴 잔여 인자(필터 문자열 등).
  * pnpm test 는 pnpm 관례상 `pnpm test -- <args>` 로 넘겨야 vitest 까지 도달.
@@ -60,6 +124,12 @@ export async function runTestCommand(args = [], opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
     const scope = opts.scope ?? 'all';
     const json = opts.json ?? false;
+    // 결정 111: unit 이 아니면 실행 전 테스트 DB 를 준비한다(생성 + 마이그레이션).
+    if (scope !== 'unit') {
+        const ok = await provisionTestDatabases(cwd, json);
+        if (!ok)
+            return 1;
+    }
     const scopeExtras = scopeArgs(scope);
     const passthrough = [...scopeExtras, ...args];
     let cmd;

package/dist/db/migrate.d.ts

@@ -1,3 +1,4 @@
+import { type ConnectionConfig } from '@gaonjs/data';
 import { listMigrationFiles } from './replay.js';
 export interface DbMigrateOptions {
     readonly cwd: string;
@@ -7,6 +8,8 @@ export interface DbMigrateOptions {
     /** `gaon db migrate down` — 가장 최근 이력 한 건 롤백. */
     readonly down?: boolean;
     readonly configPath?: string;
+    /** 명시 커넥션 오버라이드(결정 111 · gaon test 의 <db>_test). */
+    readonly connectionOverride?: ConnectionConfig;
 }
 export interface DbMigrateResult {
     readonly exitCode: number;

package/dist/db/migrate.js

@@ -41,6 +41,7 @@ export async function runDbMigrate(opts) {
         cwd: opts.cwd,
         dbKey: opts.dbKey,
         configPath: opts.configPath,
+        connectionOverride: opts.connectionOverride,
     });
     try {
         if (opts.down)

package/dist/db/resolve.d.ts

@@ -1,4 +1,4 @@
-import { type TableDef } from '@gaonjs/data';
+import { type ConnectionConfig, type TableDef } from '@gaonjs/data';
 import type { Kysely } from 'kysely';
 import { type Dialect, type AdapterName } from '@gaonjs/data';
 export interface ResolveDbOptions {
@@ -6,6 +6,12 @@ export interface ResolveDbOptions {
     readonly dbKey: string;
     /** --config <path> 로 사용자가 지정한 config 경로. 없으면 cwd 관례. */
     readonly configPath?: string;
+    /**
+     * 명시 커넥션 설정 오버라이드(결정 111). 주면 config.db·GAON_DATABASE_URL 보다
+     * 우선한다 — `gaon test` 가 <db>_test 로 마이그레이션을 돌릴 때 쓴다. 스키마 스캔
+     * (tables)은 여전히 config/cwd 관례를 따른다.
+     */
+    readonly connectionOverride?: ConnectionConfig;
 }
 export interface ResolvedDbTarget {
     readonly dbKey: string;

package/dist/db/resolve.js

@@ -92,7 +92,11 @@ export async function resolveDbTarget(opts) {
     const dbKey = opts.dbKey;
     const cfg = config.db?.[dbKey];
     let connCfg;
-    if (cfg) {
+    if (opts.connectionOverride) {
+        // 결정 111: 명시 오버라이드(gaon test 의 <db>_test) 최우선.
+        connCfg = opts.connectionOverride;
+    }
+    else if (cfg) {
         connCfg = cfg;
     }
     else if (dbKey === 'main') {

package/dist/index.js

@@ -100,7 +100,7 @@ function renderHelp(version = VERSION) {
         "    gaon serve --workers <n|auto>      node:cluster 워커 다중화 (env WEB_CONCURRENCY · 기본 1)",
         "    gaon check         typecheck · vue-tsc · build 통합 검사 (--only <step> · --include-doctor)",
         "    gaon console       프로젝트 컨텍스트 REPL (--no-config)",
-        "    gaon test          테스트 러너 (--scope unit|integration|all · -- vitest 인자)",
+        "    gaon test          테스트 러너 (테스트 DB <db>_test 자동 생성·마이그레이션 후 vitest · --scope unit|integration|all · -- vitest 인자)",
         "    gaon doctor        정적 검사 (22 검사 · 응답 혼용·N+1·의존·커넥션·마이그·컴포저블 순수·자동 import·파일명/컬럼 관례·인증 배선·UI 킷 배선·라우트 등록·정적 충돌·_method·CSRF 배선·내부 앵커·pageProps 구조분해·비동기 오프로드·페이지 레이아웃 브레이크포인트)",
         "    gaon doctor --json                        자동화용 JSON 출력",
         "    gaon doctor --check=n-plus-one,connections  선택 검사만 실행",

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

@@ -0,0 +1,29 @@
+// 웹 앱 팩토리 — 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

@@ -0,0 +1,14 @@
+// 서버 진입점 — 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} 에서 실행 중입니다.`)

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

@@ -179,9 +179,9 @@ export const posts = table('posts', {
 | `where` | `(col, op, val?)` | `Chain` | op 에 따라 val 형태 강제 (위 표) |
 | `whereIn` | `(col, vals)` | `Chain` | `where(col, 'in', vals)` 축약 |
 | `orWhere` | `(col, op, val?)` | `Chain` | op 12종 전부 (M2C) · 결합은 `(a AND b) OR c` (Rails 관습 · `model.ts:245-262`) |
-| `orderBy` | `(col, dir?)` | `Chain` | dir 기본 `'asc'` · 호출마다 누적 (다중 정렬) |
+| `orderBy` | `(col, dir?)` | `Chain` | dir 기본 `'asc'` · 호출마다 누적 (다중 정렬) · 정렬 뒤 PK 타이브레이커 자동 부가(결정 110) |
 | `reorder` | `(col, dir?)` | `Chain` | 기존 정렬 전부 버리고 재지정 |
-| `latest` | `()` | `Chain` | `orderBy('createdAt', 'desc')` 고정 축약 |
+| `latest` | `()` | `Chain` | `orderBy('createdAt', 'desc')` 고정 축약 · id 타이브레이커로 결정적(결정 110) |
 | `limit` | `(n)` | `Chain` | |
 | `offset` | `(n)` | `Chain` | 페이지네이션 = `orderBy·offset·limit` 조합 |
 | `first` | `()` | `Promise<Rec \| undefined>` | 자동 `limit 1` |
@@ -420,6 +420,10 @@ async create() {
 - `pick()` 결과도 폼이다 — 부분집합으로 다시 `pick()` 할 수 있다.
 - 스키마에 없는 컬럼을 지정하면 즉시 throw(수리 안내 포함) · 빈
   `pick()` 도 throw · 중복 지정은 조용히 하나로 합친다.
+- **정적 default 컬럼은 빈 입력이면 그 default 로 채워진다**(결정 108) —
+  `t.string().default('N/A')` 같은 컬럼을 pick 해 빈 값('')·미전송으로 받으면
+  런타임이 default 를 채운다(폼 타입이 required 인데 undefined 로 새지 않는다).
+  동적 default(`now()`·`gen_random_uuid()`·bigserial)는 채우지 않고 DB 가 채운다.
 - `omit`·`extend`·`merge` 는 **없다** — 폼 변형은 `pick()` 하나가 The One Way.
 
 ### 9. 서비스 (`service()`) — 트랜잭션 작업 흐름 (정본 §5.3 · `packages/data/src/service.ts`)
@@ -646,4 +650,6 @@ await Post.upsert({ id, title, body })                // onConflict 생략 = 기
 | 결정 46 | doctor 컬럼(column-casing)·모델/페이지 파일명 검사 3종 |
 | 결정 47 | `gaon g model` 다단어 테이블명 snake_case(마지막 단어 복수) |
 | 결정 104 | 스키마 파생 폼에 name·defs 탑재(실검증) · `Model.form.pick()` 검증되는 부분 폼(§8.1) |
+| 결정 108 | 정적 default 컬럼 빈 입력 채움(§8.1) · 동적 default 는 DB 위임 |
+| 결정 110 | `latest()`·`orderBy` 정렬 뒤 PK 타이브레이커 자동 부가(결정적 페이지네이션 · §4) |
 | E-4 | 컬럼 타입·수식어·체이닝 확장 · `Post.query()` 정정 · Serialized 명명 |

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

@@ -252,7 +252,9 @@ import PageShell from '@shared/components/ui/PageShell.vue'
 - **폼은 UI 킷 Form + gaonjs `useForm`(결정 64)** — `Form` 은 얇은 `<form>` 래퍼로
   `@submit` 을 `useForm` 의 `post/put/delete` 로 넘긴다. vee-validate 를 끌어오지
   않는다(검증·상태는 `useForm`). `FormField label error` + `FormMessage` 로 라벨·
-  오류를 붙이고, `:error="form.errors.<field>"` 로 서버 검증을 표시한다.
+  오류를 붙이고, `:error="form.errors.<field>"` 로 서버 검증을 표시한다 —
+  서버 스키마 검증 실패는 `form.errors.<field>` 로 **자동 반영**된다(결정 109 ·
+  컨트롤러가 손으로 다시 렌더하지 않는다 · `agents/web.md` §4.1).
 - **`class` 는 폴스루로 병합** — 단일 루트 컴포넌트는 `<Button class="w-full">` 처럼
   넘긴 클래스가 루트로 흘러간다(별도 `class` prop 선언 없음). `cn` 은 충돌 클래스
   자동 해소를 하지 않는다 — 오버라이드가 잦으면 tailwind-merge 를 설치해 `cn` 만 교체.
@@ -364,4 +366,5 @@ async function runSearch(q: string) {
 | 결정 105 | UI 킷 shared 이전(`shared/components/ui` 프로젝트당 한 벌 · `@shared` alias · 결정 75 개정) |
 | 결정 106 | 최소 4블록(PageShell·PageHeader·EmptyState·Pagination · 성격 중립) |
 | 결정 107 | 반응형은 킷 책임(페이지 레이아웃 브레이크포인트 지양 · doctor page-layout-breakpoint 안내 경고 · 터치 44px·폰트 최소 크기 토큰) |
+| 결정 109 | 서버 스키마 검증 실패 → `form.errors.<field>` 자동 반영(303 back + 플래시 · `agents/web.md` §4.1) |
 | E-3 §C | 타입드 `api()` 클라이언트 (routes.d.ts 브리지 재사용) |

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

@@ -16,9 +16,12 @@
 테스트를 통과해 운영에서 터지는 구멍이었다.
 
 - 테스트 전에 compose 로 DB · NATS 를 띄우고, **테스트 전용
-  데이터베이스**(트랜잭션 롤백 격리) + **테스트 전용 스트림 프리픽스**
-  를 쓴다.
-- `gaon test` 는 compose 의 테스트 전용 데이터베이스를 자동 준비한다.
+  데이터베이스**(truncate 격리 · 결정 111) + **테스트 전용 스트림
+  프리픽스**를 쓴다.
+- `gaon test` 가 테스트 전용 데이터베이스(`<db>_test`)를 **자동 준비**한다
+  — 없으면 만들고(CREATE DATABASE) 마이그레이션까지 적용한 뒤 vitest 를
+  돌린다. 스캐폴드 `test/setup.ts` 가 그 DB 에 붙고(`connectTestDatabase`)
+  매 테스트 뒤 전 테이블을 비운다(`truncateAll`). 아래 §5 참고.
 - SQLite 는 Docker 가 불가능한 환경의 폴백으로만 남고 공식 경로가
   아니다.
 
@@ -78,11 +81,54 @@ describe('SendWelcomeMail (실 NATS JetStream)', () => {
 - `configureJobs` 는 헬퍼가 대신 해 준다 — 테스트가 부팅 코드를 흉내낼
   필요가 없다.
 
+### 5. DB 테스트 격리 — `gaon test` + `test/setup.ts` (결정 111)
+
+DB 테스트는 손으로 커넥션을 배선하지 않는다 — `gaon test` 와 스캐폴드
+`test/setup.ts` 가 The One Way 를 제공한다:
+
+- `gaon test` 가 테스트 전용 DB(`<db>_test`)를 만들고 마이그레이션한다.
+- `test/setup.ts` 가 그 DB 에 붙고(`connectTestDatabase`) 매 테스트 뒤
+  전 테이블을 비운다(`truncateAll`) — 새 테스트는 항상 빈 DB 에서 시작한다.
+
+스캐폴드가 심어 주는 `test/setup.ts`(수정 불필요):
+
+```ts
+import { afterAll, afterEach, beforeAll } from 'vitest'
+import { connectTestDatabase, truncateAll, type TestDbHandle } from 'gaonjs/testing'
+
+let handle: TestDbHandle
+beforeAll(async () => { handle = await connectTestDatabase() })
+afterEach(async () => { await truncateAll() })
+afterAll(async () => { await handle?.close() })
+```
+
+그러면 테스트는 격리 코드 없이 모델·서비스를 그대로 부른다:
+
+```ts
+// test/posts.integration.test.ts
+import { describe, it, expect } from 'vitest'
+import { Post } from '../domain/models/Post.js'
+
+describe('Post', () => {
+  it('생성·조회', async () => {
+    await Post.create({ title: '첫 글', body: '...' })
+    expect(await Post.count()).toBe(1n) // 다음 테스트 전 truncateAll 로 0 으로 리셋
+  })
+})
+```
+
+**왜 truncate 인가(트랜잭션 롤백 아님) · 결정 111**: `service()` 는 실제
+BEGIN/COMMIT 을 여는 대상이라, 테스트를 바깥 트랜잭션으로 감싸면 service
+안의 COMMIT 이 그 바깥 트랜잭션을 커밋해 롤백 격리가 조용히 깨진다(실측).
+그래서 격리는 service 가 실제로 커밋하는 운영 경로를 그대로 두고 매 테스트
+뒤 truncate 로 비운다 — service 든 아니든 항상 안전하다.
+
 ## 정본 예시
 
-위 §4 의 `welcomeMail.integration.test.ts` 가 잡 검증의 정본 예시다.
-발행 도착만 확인하고 싶으면 raw JetStream 구독(§3)도 정합이지만, 기본
-경로는 `expectJobProcessed` 하나다 (The One Way).
+위 §4 의 `welcomeMail.integration.test.ts` 가 잡 검증의 정본 예시이고,
+§5 의 `test/setup.ts` + 모델 테스트가 DB 격리의 정본 예시다. 발행 도착만
+확인하고 싶으면 raw JetStream 구독(§3)도 정합이지만, 기본 경로는
+`expectJobProcessed` 하나다 (The One Way).
 
 ## 알려진 함정
 
@@ -99,5 +145,6 @@ describe('SendWelcomeMail (실 NATS JetStream)', () => {
 | 결정 | 내용 |
 |---|---|
 | 결정 42 | 비동기 테스트 헬퍼 `expectJobProcessed` (`gaonjs/testing`) |
+| 결정 111 | `gaon test` 테스트 DB 자동 준비 + `connectTestDatabase`·`truncateAll` 격리(truncate · service COMMIT 실측) |
 | §9 (v0.15) | 실 인프라 필수 · 목업/인메모리 금지 |
 | 결정 32 | 잡 발행 위치 자유 — publish 함수가 서비스 경유여도 검증 대상 |

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

@@ -178,6 +178,31 @@ router.delete('/session', { headers: { 'x-csrf-token': props.csrf } })
 `?_method=DELETE` 같은 우회는 **서버가 해석하지 않는다** — POST 로 나가
 엉뚱한 액션(create)에 도달한다.
 
+### 4.1 폼 검증 에러 — 스키마 검증만으로 `useForm.errors` 자동 반영 (결정 109)
+
+Inertia 폼(`useForm(...).post()`)의 검증 실패는 컨트롤러가 손으로 다시
+렌더하지 않는다 — `this.params(Model.form)` 이 던진 검증 실패를 프레임웍이
+**303 back + 세션 플래시 errors** 로 처리하고, 클라이언트 `useForm` 이 다음
+방문의 `errors` 로 `form.errors.<필드>` 를 **자동으로 채운다**. 입력값은
+`useForm` 이 그대로 보존한다(재제출 방지). 컨트롤러는 성공 경로만 쓴다:
+
+```ts
+// 컨트롤러 — 검증 실패 분기를 손으로 쓰지 않는다(결정 109).
+async create() {
+  const data = this.params(Post.form.pick('title', 'body'))  // 실패 시 프레임웍이 303 back
+  await Post.create(data)
+  return this.redirect('/posts')
+}
+```
+
+```vue
+<!-- 페이지 — form.errors.<필드> 는 서버 검증 실패 시 자동으로 채워진다. -->
+<input v-model="form.title" />
+<p v-if="form.errors.title">{{ form.errors.title }}</p>
+```
+
+순수 JSON/API 앱(X-Inertia 아님·세션 없음)은 기존대로 **422 JSON** 을 받는다.
+
 ### 5. 비밀번호 해싱 — `hashPassword` · `verifyPassword` (`gaonjs/web`)
 
 회원가입·로그인에서 비밀번호를 다룰 때는 **직접 crypto/bcrypt 를 import 하거나
@@ -345,4 +370,6 @@ export default controller({
 | 결정 59 | 인증 배선 = `app.config.ts` 의 `session`+`auth(loadUser)` — 없으면 currentUser 영구 null |
 | 결정 95 (W4) | 폼 모양 2종 — 스키마 파생 `Model.form`(검증) vs 애드혹 `{ _row }`(타입만) · 라우트 파라미터는 둘 다 자동 병합 |
 | 결정 104 | `Model.form.pick('a','b')` = 검증되는 부분 폼(결정 95 회부 종결) · 폼 변형은 pick 하나(omit/extend/merge 없음) |
+| 결정 108 | 정적 default 컬럼 빈 입력 채움(coerceParams) · 동적 default 는 DB 위임 |
+| 결정 109 | Inertia 폼 검증 실패 = 303 back + 플래시 errors → `useForm.errors` 자동(§4.1) · JSON/API 는 422 유지 |
 | E-1 | 파사드 = `gaonjs` · CLI = `gaon` |

package/dist/templates/project/test/setup.ts.tpl

@@ -0,0 +1,24 @@
+// test/setup.ts — 테스트 격리 부트스트랩 (§9 실 인프라 · 결정 111).
+//
+// `gaon test` 가 테스트 전용 DB(<db>_test)를 만들고 마이그레이션한 뒤 vitest 를
+// 돌린다. 이 파일이 그 DB 에 붙고(connectTestDatabase), 매 테스트 뒤 전 테이블을
+// 비운다(truncateAll). 트랜잭션 롤백이 아니라 truncate 인 이유: service() 는 실제
+// COMMIT 을 해서 바깥 트랜잭션으로 되돌릴 수 없다(결정 111 · agents/testing.md).
+//
+// 목업·인메모리 금지(§9) — 실 DB 로만 검증한다.
+import { afterAll, afterEach, beforeAll } from 'vitest'
+import { connectTestDatabase, truncateAll, type TestDbHandle } from 'gaonjs/testing'
+
+let handle: TestDbHandle
+
+beforeAll(async () => {
+  handle = await connectTestDatabase()
+})
+
+afterEach(async () => {
+  await truncateAll()
+})
+
+afterAll(async () => {
+  await handle?.close()
+})

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

@@ -0,0 +1,23 @@
+// vitest.config.ts — 테스트 러너 설정 (§9 실 인프라 · 결정 111).
+//
+// `gaon test`(= vitest)가 이 설정으로 돈다. 프론트 빌드는 vite.config.ts 가,
+// 테스트는 이 파일이 담당한다(vitest 는 vitest.config 를 우선한다).
+//
+// 격리: `gaon test` 가 테스트 전용 DB(<db>_test)를 만들고 마이그레이션한 뒤,
+// test/setup.ts 가 그 DB 에 붙고 매 테스트 뒤 전 테이블을 비운다(truncate).
+// 실 DB 하나를 공유하므로 파일 병렬을 끈다 — 병렬이면 서로의 데이터를 지운다.
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    setupFiles: ['./test/setup.ts'],
+    include: [
+      'test/**/*.test.ts',
+      'domain/**/*.test.ts',
+      'apps/**/*.test.ts',
+      'shared/**/*.test.ts',
+    ],
+    // 실 DB 를 공유하는 통합 테스트 격리 — 파일 병렬 금지(§9 · 결정 111).
+    fileParallelism: false,
+  },
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/cli",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Gaon CLI 구현: 제너레이터·스캐폴딩·로드맵 출력 (M1 스텁)",
   "type": "module",
   "license": "MIT",
@@ -27,12 +27,12 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "typescript": "^5.9.0",
     "vite": "^7.0.0",
-    "@gaonjs/data": "0.10.0",
-    "@gaonjs/config": "0.5.4",
+    "@gaonjs/async": "0.6.1",
+    "@gaonjs/config": "0.6.0",
     "@gaonjs/core": "0.2.1",
-    "@gaonjs/mail": "0.1.3",
-    "@gaonjs/web": "0.7.2",
-    "@gaonjs/async": "0.6.1"
+    "@gaonjs/web": "0.8.0",
+    "@gaonjs/data": "0.11.0",
+    "@gaonjs/mail": "0.1.3"
   },
   "scripts": {
     "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json && node -e \"require('fs').cpSync('src/templates','dist/templates',{recursive:true})\""