@gaonjs/cli 0.47.0 → 0.55.0

package/dist/dev.d.ts

@@ -13,6 +13,8 @@ export interface DevLayout {
     readonly apps: readonly DevApp[];
     /** locales/ (없으면 undefined — messages 축 생략 · 결정 158 · W2). */
     readonly localesDir?: string;
+    /** 기준 로케일 = config i18n.fallbackLng (정적 분석 · 결정 352 · 못 읽으면 undefined). */
+    readonly messagesBaseLng?: string;
     /** .gaon/messages.d.ts */
     readonly messagesOut: string;
     /** 프론트 진입(index.html)이 있는 앱이 하나라도 있는가 — env 축 적용 조건(결정 198). */
@@ -26,8 +28,8 @@ export interface DevDeps {
     readonly layout: DevLayout;
     regenerateTables(schemaDir: string, out: string): Promise<unknown>;
     regenerateRoutes(appDir: string, out: string): Promise<unknown>;
-    /** locales/ → .gaon/messages.d.ts (결정 158 · W2). i18n 축을 쓰는 호출자만 준다. */
-    regenerateMessages?(localesDir: string, out: string): unknown;
+    /** locales/ → .gaon/messages.d.ts (결정 158 · W2 · 기준 로케일 = 결정 352). i18n 축을 쓰는 호출자만 준다. */
+    regenerateMessages?(localesDir: string, out: string, baseLng?: string): unknown;
     /** `.env` → .gaon/env.d.ts (결정 198 · F-9 ②). env 축을 쓰는 호출자만 준다. */
     regenerateEnv?(envFile: string, out: string): unknown;
     watch(dir: string, opts: WatchOptions): WatchHandle;
@@ -58,8 +60,8 @@ export declare function startDev(deps: DevDeps): Promise<DevHandle>;
 export interface RegenDeps {
     regenerateTables(schemaDir: string, out: string): Promise<unknown>;
     regenerateRoutes(appDir: string, out: string): Promise<unknown>;
-    /** locales/ → .gaon/messages.d.ts (결정 158 · W2). i18n 축을 쓰는 호출자만 준다. */
-    regenerateMessages?(localesDir: string, out: string): unknown;
+    /** locales/ → .gaon/messages.d.ts (결정 158 · W2 · 기준 로케일 = 결정 352). i18n 축을 쓰는 호출자만 준다. */
+    regenerateMessages?(localesDir: string, out: string, baseLng?: string): unknown;
     /** `.env` → .gaon/env.d.ts (결정 198 · F-9 ②). env 축을 쓰는 호출자만 준다. */
     regenerateEnv?(envFile: string, out: string): unknown;
 }

package/dist/dev.js

@@ -13,6 +13,7 @@
  */
 import { readdirSync, existsSync } from 'node:fs';
 import { join, resolve } from 'node:path';
+import { analyzeProjectI18n, resolveLocalesDir } from './i18n-config.js';
 /** locales/*.json 변경(메시지 카탈로그) — messages.d.ts 재생성 트리거. */
 const isMessagesChange = (f) => !f.includes('.gaon') && f.endsWith('.json');
 const isSchemaChange = (f) => f.endsWith('.ts') && !f.endsWith('.d.ts') && !f.endsWith('.test.ts') && !f.includes('.gaon');
@@ -39,7 +40,7 @@ export async function startDev(deps) {
     }
     // 결정 158(W2): locales/ → messages.d.ts.
     if (layout.localesDir && deps.regenerateMessages) {
-        await deps.regenerateMessages(layout.localesDir, layout.messagesOut);
+        await deps.regenerateMessages(layout.localesDir, layout.messagesOut, layout.messagesBaseLng);
         deps.log({ kind: 'regen', target: 'messages' });
     }
     // 결정 198(F-9 ②): 프론트 앱이 있으면 .env → env.d.ts(VITE_* 타입 브리지). `.env` 부재는
@@ -79,7 +80,7 @@ export async function startDev(deps) {
         handles.push(deps.watch(localesDir, {
             filter: isMessagesChange,
             onChange: async () => {
-                await regenerateMessages(localesDir, layout.messagesOut);
+                await regenerateMessages(localesDir, layout.messagesOut, layout.messagesBaseLng);
                 deps.log({ kind: 'regen', target: 'messages' });
             },
             onError: deps.onError,
@@ -110,7 +111,7 @@ export async function regenerateGaonOnce(layout, deps) {
     // 결정 158(W2): locales/ 가 있으면 messages.d.ts 도 재생성한다(i18n 키 타입 브리지).
     let messages = false;
     if (layout.localesDir && deps.regenerateMessages) {
-        messages = (await deps.regenerateMessages(layout.localesDir, layout.messagesOut)) === true;
+        messages = (await deps.regenerateMessages(layout.localesDir, layout.messagesOut, layout.messagesBaseLng)) === true;
     }
     // 결정 198(F-9 ②): 프론트 앱이 있으면 .env → env.d.ts. `.env` 부재는 throw(수리 안내).
     let env = false;
@@ -144,12 +145,16 @@ export function resolveDevLayout(cwd) {
             });
         }
     }
-    const localesDirPath = join(root, 'locales');
+    // 결정 352: 카탈로그 위치·기준 로케일은 gaon.config.ts 의 i18n 블록을 따른다
+    // (정적 분석 · 하드코딩 'locales' 는 dir 커스텀 프로젝트에서 타입 축을 무소음으로 껐다).
+    const i18nCfg = analyzeProjectI18n(root);
+    const localesDirPath = resolveLocalesDir(root, i18nCfg.dir);
     return {
         schemaDir: existsSync(schemaDirPath) ? schemaDirPath : undefined,
         tablesOut: join(root, '.gaon', 'tables.d.ts'),
         apps: apps.sort((a, b) => a.name.localeCompare(b.name)),
         localesDir: existsSync(localesDirPath) ? localesDirPath : undefined,
+        messagesBaseLng: i18nCfg.fallbackLng,
         messagesOut: join(root, '.gaon', 'messages.d.ts'),
         hasFrontendApps,
         envFile: join(root, '.env'),

package/dist/doctor/fixers/index.d.ts

@@ -14,7 +14,7 @@ export declare const FIXERS: Partial<Record<DoctorRule, Fixer>>;
  * 규칙별 fix 지원 여부 카탈로그. 리포트가 사용자에게 무엇이 자동 · 무엇이
  * 수동 · 이유는 무엇인지 표시하는 데 쓴다(진단 = 수리 안내서 · §7.5.3).
  *
- * **정직성 규약(결정 241)**: 이 배열은 `ALL_RULES` 27종을 **빠짐없이** 담는다 —
+ * **정직성 규약(결정 241)**: 이 배열은 `ALL_RULES` 28종을 **빠짐없이** 담는다 —
  * fixer 가 없는 규칙도 `hasFixer:false` + 구체적 수동 안내로 명시한다. 항목이
  * 빠지면 --fix 리포트가 그 규칙 위반에 대해 일반 문구("수동 수정 필요")만 내
  * 사용자가 왜 자동이 안 되는지 알 수 없다. 전수성은 테스트가 고정한다

package/dist/doctor/fixers/index.js

@@ -28,7 +28,7 @@ export const FIXERS = {
  * 규칙별 fix 지원 여부 카탈로그. 리포트가 사용자에게 무엇이 자동 · 무엇이
  * 수동 · 이유는 무엇인지 표시하는 데 쓴다(진단 = 수리 안내서 · §7.5.3).
  *
- * **정직성 규약(결정 241)**: 이 배열은 `ALL_RULES` 27종을 **빠짐없이** 담는다 —
+ * **정직성 규약(결정 241)**: 이 배열은 `ALL_RULES` 28종을 **빠짐없이** 담는다 —
  * fixer 가 없는 규칙도 `hasFixer:false` + 구체적 수동 안내로 명시한다. 항목이
  * 빠지면 --fix 리포트가 그 규칙 위반에 대해 일반 문구("수동 수정 필요")만 내
  * 사용자가 왜 자동이 안 되는지 알 수 없다. 전수성은 테스트가 고정한다
@@ -165,6 +165,11 @@ export const FIXER_CAPABILITIES = [
         hasFixer: false,
         note: '수동 · .vue 의 import.meta.env(TS1470)는 env 접근자로 전환하세요 — 접근자 도입은 코드 편집이 필요합니다(결정 198).',
     },
+    {
+        rule: 'render-return',
+        hasFixer: false,
+        note: '수동 · this.render/redirect/json 호출 앞에 return 을 붙이세요 — 반환값이 곧 응답입니다(결정 340 · 의도된 204 는 응답 호출 없이 return).',
+    },
     {
         rule: 'locale-parity',
         hasFixer: false,

package/dist/doctor/locale-parity.js

@@ -11,6 +11,7 @@
 import { existsSync } from 'node:fs';
 import { join, relative } from 'node:path';
 import { loadLocales, flattenKeys } from '@gaonjs/i18n';
+import { analyzeProjectI18n, resolveLocalesDir } from '../i18n-config.js';
 // 경고 한 줄이 폭주하지 않게 나열 상한 — 넘으면 "…외 N개" 로 접는다(detail 에는 전량).
 const MAX_KEYS_SHOWN = 20;
 // i18next 복수형 접미사(결정 181 · generator.ts 와 동일 규약). 로케일마다 필요한 접미사만
@@ -26,7 +27,9 @@ function pluralBase(key) {
  * 비교 대상이 없어 건너뛴다(i18n 미사용·단일 로케일 프로젝트는 무소음).
  */
 export async function checkLocaleParity(cwd) {
-    const localesDir = join(cwd, 'locales');
+    // 결정 352: 카탈로그 위치는 config i18n.dir 을 따른다(정적 분석 · 하드코딩이던
+    // 'locales' 는 dir 커스텀 프로젝트에서 이 검사를 무소음으로 껐다).
+    const localesDir = resolveLocalesDir(cwd, analyzeProjectI18n(cwd).dir);
     if (!existsSync(localesDir))
         return { rule: 'locale-parity', issues: [] };
     const resources = loadLocales(localesDir);

package/dist/doctor/render-return.d.ts

@@ -0,0 +1,11 @@
+import type { RuleReport } from './types.js';
+export interface DiscardedResponse {
+    readonly file: string;
+    readonly action: string;
+    readonly method: string;
+    readonly line: number;
+}
+/** 소스 문자열 하나에서 "버려진 응답 호출" 을 수집한다(단위 테스트 진입점). */
+export declare function inspectDiscardedResponses(file: string, source: string): DiscardedResponse[];
+/** apps/ 를 훑어 버려진 응답 호출(무신호 204)을 모두 낸다(경고 등급). */
+export declare function checkRenderReturn(cwd: string): Promise<RuleReport>;

package/dist/doctor/render-return.js

@@ -0,0 +1,143 @@
+// @gaonjs/cli · doctor · render-return 검사 (결정 340)
+//
+// 액션 본문이 `this.render(...)` / `this.redirect(...)` / `this.json(...)` 을
+// **호출만 하고 return 하지 않으면** 반환값(=응답)이 버려져 액션이 void 로 끝나고,
+// 디스패처는 조용히 204 No Content 를 낸다 — 컴파일은 통과하고 페이지는 백지다
+// (무신호 파손 클래스 · agents/web.md 함정 "return 누락 = 204").
+//
+// 정적 분석: 컨트롤러 액션 안에서 위 3종 호출이 ExpressionStatement(또는
+// `await` 만 감싼 문장)로 서 있으면 경고. return · 변수 대입 · 인자 전달 등
+// 값이 소비되는 위치는 오탐 방지로 제외한다. notFound/requireAuth 는 throw
+// 기반 가드라 대상이 아니다(response-mixing 의 GUARD_METHODS 와 정합).
+import { readdir, readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import ts from 'typescript';
+const RESPONSE_METHODS = new Set(['render', 'redirect', 'json']);
+/** 소스 문자열 하나에서 "버려진 응답 호출" 을 수집한다(단위 테스트 진입점). */
+export function inspectDiscardedResponses(file, source) {
+    const sf = ts.createSourceFile(file, source, ts.ScriptTarget.ES2022, true);
+    const found = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node) && isControllerCall(node)) {
+            const arg = node.arguments[0];
+            if (arg && ts.isObjectLiteralExpression(arg)) {
+                for (const prop of arg.properties) {
+                    const action = actionName(prop);
+                    const body = actionBody(prop);
+                    if (!action || !body || !ts.isBlock(body))
+                        continue;
+                    collectDiscarded(sf, body, action, file, found);
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sf);
+    return found;
+}
+function isControllerCall(node) {
+    const e = node.expression;
+    if (ts.isIdentifier(e) && e.text === 'controller')
+        return true;
+    if (ts.isPropertyAccessExpression(e) && e.name.text === 'controller')
+        return true;
+    return false;
+}
+function actionName(prop) {
+    if (ts.isMethodDeclaration(prop) && ts.isIdentifier(prop.name))
+        return prop.name.text;
+    if (ts.isPropertyAssignment(prop) &&
+        ts.isIdentifier(prop.name) &&
+        (ts.isArrowFunction(prop.initializer) || ts.isFunctionExpression(prop.initializer))) {
+        return prop.name.text;
+    }
+    return undefined;
+}
+function actionBody(prop) {
+    if (ts.isMethodDeclaration(prop))
+        return prop.body;
+    if (ts.isPropertyAssignment(prop)) {
+        if (ts.isArrowFunction(prop.initializer))
+            return prop.initializer.body;
+        if (ts.isFunctionExpression(prop.initializer))
+            return prop.initializer.body;
+    }
+    return undefined;
+}
+/** 문장 위치에 버려진 this.render/redirect/json 호출이 있으면 수집한다. */
+function collectDiscarded(sf, body, action, file, out) {
+    const visit = (node) => {
+        if (ts.isExpressionStatement(node)) {
+            const method = responseCallName(node.expression);
+            if (method) {
+                const { line } = sf.getLineAndCharacterOfPosition(node.getStart(sf));
+                out.push({ file, action, method, line: line + 1 });
+                return; // 이 문장은 판정 완료 — 내부 재방문 불요.
+            }
+        }
+        // 중첩 함수(콜백) 안의 호출은 반환 의미가 달라 제외(오탐 방지).
+        if (ts.isFunctionDeclaration(node) || ts.isFunctionExpression(node) || ts.isArrowFunction(node))
+            return;
+        ts.forEachChild(node, visit);
+    };
+    visit(body);
+}
+/** 식이 (await 를 벗긴) this.render/redirect/json 호출이면 메서드 이름을 돌려준다. */
+function responseCallName(expr) {
+    const inner = ts.isAwaitExpression(expr) ? expr.expression : expr;
+    if (!ts.isCallExpression(inner))
+        return undefined;
+    const c = inner.expression;
+    if (ts.isPropertyAccessExpression(c) &&
+        c.expression.kind === ts.SyntaxKind.ThisKeyword &&
+        RESPONSE_METHODS.has(c.name.text)) {
+        return c.name.text;
+    }
+    return undefined;
+}
+/** apps/ 를 훑어 버려진 응답 호출(무신호 204)을 모두 낸다(경고 등급). */
+export async function checkRenderReturn(cwd) {
+    const appsDir = join(cwd, 'apps');
+    const issues = [];
+    for (const app of await safeListDirs(appsDir)) {
+        const ctrlDir = join(appsDir, app, 'controllers');
+        for (const file of await safeListFiles(ctrlDir)) {
+            if (!file.endsWith('.ts') || file.endsWith('.d.ts') || file.endsWith('.test.ts'))
+                continue;
+            const full = join(ctrlDir, file);
+            const source = await readFile(full, 'utf8');
+            for (const d of inspectDiscardedResponses(full, source)) {
+                const rel = relative(cwd, full);
+                issues.push({
+                    rule: 'render-return',
+                    level: 'warning',
+                    file: rel,
+                    line: d.line,
+                    message: `버려진 응답 호출: ${rel}:${d.line} · 액션 '${d.action}' 이 this.${d.method}(...) 를 호출만 하고 return 하지 않습니다.\n` +
+                        `→ 반환값이 곧 응답입니다(errata E-3) — return 이 없으면 액션이 void 로 끝나 조용히 204 No Content(백지)가 나갑니다.\n` +
+                        `→ \`return this.${d.method}(...)\` 로 고치세요. (의도된 204 는 아무 응답 호출 없이 그냥 return 합니다.)`,
+                    detail: { action: d.action, method: d.method },
+                });
+            }
+        }
+    }
+    return { rule: 'render-return', issues };
+}
+async function safeListDirs(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+async function safeListFiles(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries.filter((e) => e.isFile()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}

package/dist/doctor/types.d.ts

@@ -1,4 +1,4 @@
-export type DoctorRule = 'response-mixing' | 'n-plus-one' | 'dependency-direction' | 'connections' | 'migration-diff' | 'shared-purity' | 'no-auto-import' | 'schema-filename' | 'agents-doc-index' | 'column-casing' | 'model-filename' | 'page-filename' | 'auth-wiring' | 'ui-kit-wiring' | 'route-registration' | 'static-collision' | 'method-override' | 'csrf-wiring' | 'internal-anchor' | 'pageprops-destructure' | 'async-offload' | 'page-layout-breakpoint' | 'link-button-nesting' | 'seal-security' | 'schema-relations' | 'no-import-meta-env' | 'locale-parity';
+export type DoctorRule = 'response-mixing' | 'n-plus-one' | 'dependency-direction' | 'connections' | 'migration-diff' | 'shared-purity' | 'no-auto-import' | 'schema-filename' | 'agents-doc-index' | 'column-casing' | 'model-filename' | 'page-filename' | 'auth-wiring' | 'ui-kit-wiring' | 'route-registration' | 'static-collision' | 'method-override' | 'csrf-wiring' | 'internal-anchor' | 'pageprops-destructure' | 'async-offload' | 'page-layout-breakpoint' | 'link-button-nesting' | 'seal-security' | 'schema-relations' | 'no-import-meta-env' | 'locale-parity' | 'render-return';
 export type DoctorLevel = 'passed' | 'warning' | 'error';
 export interface DoctorCheck {
     readonly rule: DoctorRule;

package/dist/doctor.d.ts

@@ -2,6 +2,7 @@ import { type DoctorCheck, type DoctorFatal, type DoctorFatalCode, type DoctorLe
 export type { DoctorCheck, DoctorFatal, DoctorFatalCode, DoctorLevel, DoctorResult, DoctorRule, RuleReport, };
 export type { ResponseKind, ActionUsage } from './doctor/response-mixing.js';
 export { inspectControllerSource, checkResponseMixing } from './doctor/response-mixing.js';
+export { inspectDiscardedResponses, checkRenderReturn } from './doctor/render-return.js';
 export { inspectControllerForNPlusOne, checkNPlusOne } from './doctor/n-plus-one.js';
 export { extractRelativeImports, checkDependencyDirection } from './doctor/dependency-direction.js';
 export { extractConfigDbKeys, analyzeConfigDb, extractKeyUses, checkConnections, } from './doctor/connections.js';
@@ -26,10 +27,10 @@ export { checkLocaleParity } from './doctor/locale-parity.js';
 export { renderHuman, renderJson } from './doctor/reporter.js';
 export { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, } from './doctor/setup.js';
 /**
- * 실행할 검사 이름. 지정 없음(undefined) = 27개 모두.
+ * 실행할 검사 이름. 지정 없음(undefined) = 28개 모두.
  */
 /**
- * doctor 정적 검사 27종의 정본 목록(§2.2). `--check=` 필터의 인정 집합도
+ * doctor 정적 검사 28종의 정본 목록(§2.2). `--check=` 필터의 인정 집합도
  * 이 배열을 단일 출처로 삼는다(parseDoctorChecks) — 새 규칙 추가 시 여기만
  * 늘리면 실행·필터·타입이 함께 정합된다(손유지 중복 리스트 표류 방지).
  */

package/dist/doctor.js

@@ -1,7 +1,7 @@
 /**
  * @gaonjs/cli · `gaon doctor` — 정적 검사 (M9-E · CLI DX 완성 · E-5 확장)
  *
- * 27 검사를 조립한다:
+ * 28 검사를 조립한다:
  *  1) response-mixing (errata E-3 §C · 라이브)
  *  2) n-plus-one (errata E-4 (e))
  *  3) dependency-direction (CLAUDE.md §5 · 4 규칙)
@@ -29,6 +29,7 @@
  * 25) schema-relations (§4.5 · 결정 134 · 커넥션 가로지르는 belongsTo·관계 · 대상 부재 error)
  * 26) no-import-meta-env (결정 198 · F-9 ② · `.vue` 의 import.meta.env = TS1470 → env 접근자 안내 error)
  * 27) locale-parity (결정 216 · 13차 W4 · 로케일 간 키 부분 누락 = fallback 조용 노출 경고)
+ * 28) render-return (결정 340 · this.render/redirect/json 호출만 하고 return 누락 = 무신호 204 경고)
  *
  * 각 검사는 순수 함수(cwd → RuleReport). 상위 runDoctorCommand 가 조립해
  * DoctorResult 로 낸다. --json 은 자동화(CI)를 위해 반드시 파싱 가능한
@@ -42,6 +43,7 @@ import { existsSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import ts from 'typescript';
 import { checkResponseMixing } from './doctor/response-mixing.js';
+import { checkRenderReturn } from './doctor/render-return.js';
 import { checkNPlusOne } from './doctor/n-plus-one.js';
 import { checkDependencyDirection } from './doctor/dependency-direction.js';
 import { checkConnections } from './doctor/connections.js';
@@ -73,6 +75,7 @@ import { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, }
 import { makeResult, } from './doctor/types.js';
 import { FIXERS, FIXER_CAPABILITIES } from './doctor/fixers/index.js';
 export { inspectControllerSource, checkResponseMixing } from './doctor/response-mixing.js';
+export { inspectDiscardedResponses, checkRenderReturn } from './doctor/render-return.js';
 export { inspectControllerForNPlusOne, checkNPlusOne } from './doctor/n-plus-one.js';
 export { extractRelativeImports, checkDependencyDirection } from './doctor/dependency-direction.js';
 export { extractConfigDbKeys, analyzeConfigDb, extractKeyUses, checkConnections, } from './doctor/connections.js';
@@ -97,10 +100,10 @@ export { checkLocaleParity } from './doctor/locale-parity.js';
 export { renderHuman, renderJson } from './doctor/reporter.js';
 export { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, } from './doctor/setup.js';
 /**
- * 실행할 검사 이름. 지정 없음(undefined) = 27개 모두.
+ * 실행할 검사 이름. 지정 없음(undefined) = 28개 모두.
  */
 /**
- * doctor 정적 검사 27종의 정본 목록(§2.2). `--check=` 필터의 인정 집합도
+ * doctor 정적 검사 28종의 정본 목록(§2.2). `--check=` 필터의 인정 집합도
  * 이 배열을 단일 출처로 삼는다(parseDoctorChecks) — 새 규칙 추가 시 여기만
  * 늘리면 실행·필터·타입이 함께 정합된다(손유지 중복 리스트 표류 방지).
  */
@@ -132,6 +135,7 @@ export const ALL_RULES = [
     'schema-relations',
     'no-import-meta-env',
     'locale-parity',
+    'render-return',
 ];
 const CHECKERS = {
     'response-mixing': checkResponseMixing,
@@ -161,6 +165,7 @@ const CHECKERS = {
     'schema-relations': checkSchemaRelations,
     'no-import-meta-env': checkNoImportMetaEnv,
     'locale-parity': checkLocaleParity,
+    'render-return': checkRenderReturn,
 };
 /**
  * 규칙을 순서대로 실행해 RuleReport[] 를 낸다. 규칙 하나가 크래시해도 나머지는
@@ -269,10 +274,16 @@ export async function runDoctorCommand(opts = {}) {
     // --fix: fixer 를 계획하고, --yes 이면 실제 편집한다. reports 를 그대로
     // 넘겨 규칙별 위반을 fixer 가 판단한다(passed 는 건너뜀).
     const fixReport = await runDoctorFix(reports, root, opts.yes === true);
-    const resultWithFix = { ...baseResult, fix: fixReport };
+    // 결정 359: 편집이 실제로 일어났으면 **재검사 결과**를 리포트·종료 코드의 기준으로
+    // 삼는다 — 적용 전 리포트로 판정하면 "전부 자동 수정됐는데 exit 1" 로 역전돼
+    // CI 자동화(--fix --yes 후 green 기대)가 깨졌다. errors/warnings = 적용 후 잔여.
+    const finalResult = fixReport.applied && fixReport.outcomes.some((o) => o.applied)
+        ? makeResult(await runRules(root, rules))
+        : baseResult;
+    const resultWithFix = { ...finalResult, fix: fixReport };
     const out = json
         ? JSON.stringify(resultWithFix)
-        : renderHuman(baseResult) + '\n\n' + renderFixHuman(fixReport);
+        : renderHuman(finalResult) + '\n\n' + renderFixHuman(fixReport);
     process.stdout.write(out + '\n');
     return resultWithFix;
 }

package/dist/generate.d.ts

@@ -7,6 +7,12 @@ export interface AuthScaffoldOptions {
      * `--public` 로 비-web 앱도 공개 가입을 opt-in 한다(공개 비-web 앱용 탈출구).
      */
     readonly public?: boolean;
+    /**
+     * 결정 338: JWT(API 앱) 변형 — 세션·페이지 대신 토큰 발급/재발급/내 정보
+     * 컨트롤러(JSON 전용)와 `auth: { strategy:'jwt' }` 배선을 깐다. API 앱 전용이라
+     * `--app <이름>`(비-web) 이 필수다(web 은 세션이 정본 · §7).
+     */
+    readonly jwt?: boolean;
 }
 /** 생성할 파일 하나 — 경로는 프로젝트 루트 기준. */
 export interface ScaffoldFile {
@@ -19,6 +25,12 @@ export interface ScaffoldResult {
     readonly patched: string[];
     /** 손 수리가 필요한 지점 — 수리 안내 문장(§7.5.3)을 그대로 담는다. */
     readonly warnings: string[];
+    /**
+     * 결정 361: 인증 **배선이 미완**인가(app.config auth/routes 자동 패치 실패 —
+     * 이대로면 currentUser 영구 null / 로그인 라우트 부재). 안내성 경고(JWT stateless
+     * 한계 등)와 구분해, 이 값만 종료 코드(비-0)·JSON ok:false 로 이어진다.
+     */
+    readonly incomplete: boolean;
 }
 /**
  * 결정 155·142: `g auth --app <앱>` 이 앱별 세션 secret 환경변수를 .env·.env.example
@@ -32,7 +44,7 @@ export interface ScaffoldResult {
  * .env 를 새로 만드는 관례가 없어(사용자가 cp .env.example .env), 존재하는 파일만 패치한다.
  * 반환: 실제로 키를 추가한 상대 경로들.
  */
-export declare function patchEnvFiles(root: string, app: string): string[];
+export declare function patchEnvFiles(root: string, app: string, kind?: 'session' | 'jwt'): string[];
 /** 인증 스캐폴드가 생성하는 파일 목록(라우트 제외). 템플릿을 읽어 렌더링한다.
  *  결정 155: 공개 가입 여부(includePublic)로 registration·Signup·dashboard 변형을 가른다. */
 export declare function authScaffoldFiles(opts?: AuthScaffoldOptions): ScaffoldFile[];
@@ -40,6 +52,11 @@ export declare function authScaffoldFiles(opts?: AuthScaffoldOptions): ScaffoldF
  * 기존 routes.ts 에 세션·회원가입 리소스를 끼워 넣는다. 이미 있으면 null.
  * `routes((r) => {` 콜백 여는 지점 뒤에 두 줄을 삽입한다.
  */
+/**
+ * 결정 338: 기존 routes.ts 에 JWT 토큰 라우트 3종을 끼워 넣는다. 이미 session#create
+ * 참조가 있으면 null(중복 방지). 삽입 지점 규칙은 patchRoutes 와 동일.
+ */
+export declare function patchRoutesJwt(existing: string): string | null;
 export declare function patchRoutes(existing: string, includePublic?: boolean): string | null;
 /**
  * 기존 app.config.ts 에 auth 배선을 끼워 넣는다 (결정 93 · gaon new 기본 web 앱은
@@ -57,6 +74,8 @@ export interface GenerateAuthOptions {
     readonly json?: boolean;
     /** 결정 155: 비-web 앱도 공개 회원가입을 opt-in(공개 비-web 앱용 탈출구). */
     readonly public?: boolean;
+    /** 결정 338: JWT(API 앱) 변형 — `--app <비-web 이름>` 필수 · `--public` 과 배타. */
+    readonly jwt?: boolean;
 }
 /** `gaon g auth` 진입점. 스캐폴드를 쓰고 결과를 사람/JSON 으로 출력한다. */
 export declare function runGenerateAuthCommand(opts?: GenerateAuthOptions): number;