@gaonjs/cli 0.13.1 → 0.13.2

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

@@ -434,6 +434,28 @@ gaon db seed          # domain/seed.ts 실행
 **파일명 순으로 실제 실행**(replay)하고, ② 그 뒤 스키마 diff 로 나머지를
 적용한다.
 
+- **replay 가 diff 보다 먼저다 — 손작성 마이그는 "아직 diff 가 안 만든 테이블"을
+  참조할 수 없다** (결정 65). 스키마에만 선언돼 있고 아직 DB 에 없는 테이블을
+  FK 로 거는 마이그레이션은 **빈 DB 에서만** `relation "posts" does not exist` 로
+  실패한다(테이블이 이미 있는 개발 DB 에서는 통과 — 그래서 CI·새 클론에서만
+  터진다). 조인 테이블처럼 남의 테이블을 참조해야 하면 **참조 대상도 같은/앞선
+  마이그 파일에서 함께 만든다**:
+
+  ```ts
+  // 20260728_add_tags.ts — posts 를 FK 로 걸려면 posts 가 먼저 존재해야 한다.
+  export async function up(db: Kysely<any>): Promise<void> {
+    await db.schema.createTable('tags')/* … */.execute()
+    await db.schema.createTable('posts_tags')
+      .addColumn('postId', 'bigint', (c) => c.notNull().references('posts.id').onDelete('cascade'))
+      // ↑ posts 가 스키마에만 있고 DB 에 없으면 빈 DB 에서 실패한다.
+      .execute()
+  }
+  ```
+
+  전부 스키마 우선으로 두면(손작성 마이그 없이) diff 가 의존 순서를 알아서
+  잡으므로 이 함정 자체가 없다 — **손작성 마이그는 diff 로 표현 못 하는 것에만**
+  쓴다(rename·백필·수동 DDL).
+
 - **손작성 마이그는 `db/migrations/<파일명>.ts`** 에 두고 `up(db)`·`down(db)`
   (Kysely) 를 export 한다. **파일명이 곧 버전 키** — `0001_add_posts.ts`
   시퀀스든 `20260724_add_posts.ts` 타임스탬프든 사전순 정렬이 안정적이면 된다

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

@@ -172,6 +172,35 @@ const ok = await verifyPassword(plain, user.passwordDigest) // Promise<boolean>
   }
   ```
 
+- **세션을 확정·해제하는 것은 `this.auth`** (결정 65). `requireAuth()` 는 이미
+  로그인된 요청을 **지키는** 쪽이고, 로그인 자체를 **성립시키는** 호출은 따로다:
+
+  | 호출 | 하는 일 |
+  |---|---|
+  | `this.auth.user` | 현재 사용자 (`GaonCurrentUser \| null`) |
+  | `this.auth.login(user)` | 세션에 사용자 id 를 심어 로그인 상태로 만든다 |
+  | `this.auth.logout()` | 세션에서 사용자를 지운다 |
+
+  ```ts
+  // 로그인 — 폼 액션의 유일한 render+redirect 혼용 예외(결정 57 보완)
+  async create() {
+    const { email, password } = this.params({ _row: {} as { email: string; password: string } })
+    const user = await User.where('email', '=', email).first()
+    if (!user || !(await verifyPassword(password, user.passwordDigest))) {
+      return this.render('Auth/Login', { error: '이메일 또는 비밀번호가 올바르지 않습니다.', csrf: this.csrfToken() })
+    }
+    this.auth.login(user)                       // 세션 확정
+    return this.redirect('/dashboard')
+  }
+  // 로그아웃 — DELETE /session (페이지에서 router.delete 로 호출 · 결정 64)
+  async destroy() {
+    this.auth.logout()
+    return this.redirect('/session/new')
+  }
+  ```
+
+  API 앱(JWT)은 세션 대신 `this.jwt.issue(user)` / `this.jwt.refresh(token)` 를 쓴다.
+
 - **`this.auth.user`/`requireAuth()` 사용자 타입은 앱이 증강한다** (결정 58).
   `GaonCurrentUser` 는 빈 인터페이스라 증강 없이는 `user.id` 접근이 타입에러다.
   `gaon g auth` 가 `apps/<app>/auth.ts` 에 심는다:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/cli",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "description": "Gaon CLI 구현: 제너레이터·스캐폴딩·로드맵 출력 (M1 스텁)",
   "type": "module",
   "license": "MIT",
@@ -28,11 +28,11 @@
     "typescript": "^5.9.0",
     "vite": "^7.0.0",
     "@gaonjs/async": "0.3.1",
-    "@gaonjs/config": "0.3.0",
     "@gaonjs/core": "0.1.4",
+    "@gaonjs/mail": "0.1.1",
     "@gaonjs/data": "0.8.4",
     "@gaonjs/web": "0.5.3",
-    "@gaonjs/mail": "0.1.1"
+    "@gaonjs/config": "0.3.0"
   },
   "scripts": {
     "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json && node -e \"require('fs').cpSync('src/templates','dist/templates',{recursive:true})\""