@gaonjs/cli 0.15.0 → 0.21.2

package/dist/commands/g.js

@@ -17,6 +17,7 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { appScaffoldFiles, controllerScaffold, inflectModel, jobScaffold, jobTestScaffold, modelScaffoldFiles, pageScaffold, writeScaffold, } from '../scaffold/index.js';
+import { appWiringFiles, readProjectName } from '../scaffold/app-wiring.js';
 /** argv 에서 옵션을 뽑는다(간단 파서 · runCli 관례와 일치). */
 export function parseGenerateArgs(argv) {
     const type = argv[0];
@@ -114,6 +115,13 @@ export function runGenerateCommand(type, name, opts = {}) {
             return 1;
         }
     }
+    // gaon g app: web 앱과 동등한 프론트 배선(style.css·main.ts·index.html)을
+    // 함께 심는다 — 이후 gaon g ui-kit --app <name> 이 심는 UI 킷 컴포넌트가
+    // Tailwind 유틸을 받아 스타일대로 렌더되도록(결정 76). web 정본 템플릿에서
+    // 파생하므로 드리프트가 없다(scaffold/app-wiring).
+    if (type === 'app') {
+        files = [...files, ...appWiringFiles(name, readProjectName(cwd))];
+    }
     const write = writeScaffold(cwd, files, { overwrite: opts.overwrite });
     // overwrite 없이 기존 파일이 있으면 실패(사고 방지 · Rails 관례).
     const failed = write.skipped.length > 0;

package/dist/commands/new.js

@@ -23,6 +23,7 @@ import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { readFileSync } from 'node:fs';
 import { renderProjectFiles } from '../templates/index.js';
+import { writeUiKitScaffold } from '../uikit.js';
 /** 이름 유효성 — npm 패키지명 규칙(단순 부분)만 검사. */
 function validateProjectName(name) {
     if (!name)
@@ -175,6 +176,10 @@ export async function runNewCommand(name, opts = {}) {
     try {
         mkdirSync(root, { recursive: true });
         filesCreated = writeAll(root, files);
+        // 결정 74·75: 기본 앱(web)에 UI 킷을 심는다(배터리 포함 · 단일 소스
+        // templates/ui-kit). 랜딩(Home/Index.vue)이 Card 를 쓰고, gaon g auth 도
+        // 이 세트를 재사용한다. 정적 중복 없이 프로그램적으로 생성한다.
+        filesCreated += writeUiKitScaffold(root, { app: 'web' }).created.length;
     }
     catch (err) {
         return emitError(`파일 생성 실패: ${err instanceof Error ? err.message : String(err)}`, Date.now() - t0);

package/dist/dev/health.d.ts

@@ -1,4 +1,4 @@
-import { type GaonNats, type StreamStat } from '@gaonjs/async';
+import { type GaonNats, type StreamStat, type ChannelStat } from '@gaonjs/async';
 import type { GaonConfig } from '@gaonjs/config';
 /** registerDevHealth 가 프로브에 쓰는 컨텍스트(serve 가 채운다). */
 export interface DevHealthContext {
@@ -38,7 +38,10 @@ export type HubHealth = {
 } | {
     readonly configured: true;
     readonly connected: boolean;
+    /** 잡·이벤트 스트림의 실 대기(pending) 메시지 수(결정 71). */
     readonly streams?: readonly StreamStat[];
+    /** 채널별 실 접속자 수(프레즌스 KV 권위). null = 아직 아무도 접속 안 함(결정 71). */
+    readonly channels?: readonly ChannelStat[] | null;
     readonly error?: string;
 };
 export interface DoctorHealth {

package/dist/dev/health.js

@@ -21,7 +21,7 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { VERSION } from '@gaonjs/core';
 import { getConnection, hasConnection, snapshotFromDb, postgresDialect, MIGRATIONS_TABLE, } from '@gaonjs/data';
-import { streamStats } from '@gaonjs/async';
+import { streamStats, presenceStats } from '@gaonjs/async';
 import { computeDoctorResult } from '../doctor.js';
 /** web 앱은 관례상 프리픽스 '/', 그 외는 '/<앱>'(dispatch.prefixFor 와 정합). */
 function prefixFor(name) {
@@ -81,8 +81,10 @@ async function probeHub(config, nats) {
     if (!connected)
         return { configured: true, connected: false };
     try {
-        const streams = await streamStats(nats);
-        return { configured: true, connected: true, streams };
+        // jobs = JetStream 스트림 대기 수 · channels = 프레즌스 KV 접속자 수.
+        // 둘 다 실 introspection(하드코딩·가장 없음 · 결정 71).
+        const [streams, channels] = await Promise.all([streamStats(nats), presenceStats(nats)]);
+        return { configured: true, connected: true, streams, channels };
     }
     catch (err) {
         return {

package/dist/doctor/method-override.d.ts

@@ -0,0 +1,5 @@
+import type { RuleReport } from './types.js';
+/** 소스에 _method 오버라이드 hack 이 있는지(단위 테스트 진입점 · 주석은 제외). */
+export declare function usesMethodOverride(source: string): boolean;
+/** apps/ 의 .vue·.ts 를 훑어 _method 오버라이드 hack 을 경고로 낸다. */
+export declare function checkMethodOverride(cwd: string): Promise<RuleReport>;

package/dist/doctor/method-override.js

@@ -0,0 +1,75 @@
+// @gaonjs/cli · doctor · _method 오버라이드 hack 검출 (결정 89 · 경고)
+//
+// Gaon 은 `_method`(Rails/Laravel 식 HTTP 메서드 스푸핑)를 지원하지 않는다 —
+// Inertia 는 실 DELETE/PUT/PATCH 를 보낸다. `?_method=DELETE` 쿼리·`<input
+// name="_method">` 폼 필드·`{ _method: 'DELETE' }` 를 쓰면 컴파일은 통과하지만
+// 런타임이 조용히 파손된다(서버가 무시). 이 검사가 그 패턴을 경고로 잡는다.
+// (auth-flow 벤치 (d) 실측 근거 · AGENTS 절대 규칙 6). 판정은 소스 텍스트 기반.
+import { readdir, readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+// 메서드 오버라이드 hack 패턴: 쿼리(?_method=DELETE)·폼 필드(name="_method")·
+// 객체 키(_method: 'DELETE' · 따옴표 유무 무관 · 값이 HTTP 메서드일 때만 — 오탐 방지).
+const METHOD_OVERRIDE = /[?&]_method=|name\s*=\s*['"]_method['"]|['"]?\b_method\b['"]?\s*:\s*['"]?(?:DELETE|PUT|PATCH)/i;
+// 주석을 제거한다(줄 주석·블록 주석·HTML/Vue 주석) — 안티패턴을 "쓰지 말라"고
+// 설명하는 주석이 오탐을 내지 않도록. 실제 실행 코드만 남긴다.
+function stripComments(source) {
+    return source
+        .replace(/\/\*[\s\S]*?\*\//g, ' ')
+        .replace(/<!--[\s\S]*?-->/g, ' ')
+        .replace(/(^|[^:])\/\/[^\n]*/g, '$1'); // // 줄 주석(http:// 는 보존)
+}
+/** 소스에 _method 오버라이드 hack 이 있는지(단위 테스트 진입점 · 주석은 제외). */
+export function usesMethodOverride(source) {
+    return METHOD_OVERRIDE.test(stripComments(source));
+}
+/** apps/ 의 .vue·.ts 를 훑어 _method 오버라이드 hack 을 경고로 낸다. */
+export async function checkMethodOverride(cwd) {
+    const appsDir = join(cwd, 'apps');
+    const issues = [];
+    for (const abs of await walkSources(appsDir)) {
+        const source = await readFile(abs, 'utf8').catch(() => '');
+        if (!usesMethodOverride(source))
+            continue;
+        issues.push({
+            rule: 'method-override',
+            level: 'warning',
+            file: relative(cwd, abs),
+            message: `_method 오버라이드 hack 발견: ${relative(cwd, abs)} 이 \`_method\`(Rails/Laravel 식 HTTP ` +
+                `메서드 스푸핑)를 씁니다. Gaon 은 이를 지원하지 않아 컴파일은 통과해도 런타임이 조용히 ` +
+                `파손됩니다(서버가 무시 · 결정 89).\n` +
+                `→ Gaon 은 \`_method\` 를 지원하지 않습니다. HTML 폼이 못 보내는 메서드는 ` +
+                `\`router.delete(...)\` / \`useForm(...).delete(...)\` 를 쓰세요 (AGENTS 절대 규칙 6).`,
+            detail: { file: relative(cwd, abs) },
+        });
+    }
+    return { rule: 'method-override', issues };
+}
+/** apps/ 하위 .vue·.ts(선언·테스트 제외) 절대경로. */
+async function walkSources(dir) {
+    const out = [];
+    const walk = async (d) => {
+        let entries;
+        try {
+            entries = await readdir(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const abs = join(d, e.name);
+            if (e.isDirectory()) {
+                if (e.name === 'node_modules' || e.name === '.gaon')
+                    continue;
+                await walk(abs);
+            }
+            else if (e.isFile()) {
+                if (e.name.endsWith('.d.ts') || e.name.endsWith('.test.ts'))
+                    continue;
+                if (e.name.endsWith('.vue') || e.name.endsWith('.ts'))
+                    out.push(abs);
+            }
+        }
+    };
+    await walk(dir);
+    return out.sort();
+}

package/dist/doctor/route-registration.d.ts

@@ -0,0 +1,5 @@
+import type { RuleReport } from './types.js';
+/** routes.ts 소스에서 참조된 컨트롤러 이름 집합을 뽑는다(단위 테스트 진입점). */
+export declare function referencedControllers(routesSource: string): Set<string>;
+/** apps/ 를 훑어 라우트에 등록되지 않은(고아) 컨트롤러를 경고로 낸다. */
+export declare function checkRouteRegistration(cwd: string): Promise<RuleReport>;

package/dist/doctor/route-registration.js

@@ -0,0 +1,77 @@
+// @gaonjs/cli · doctor · 라우트 미등록(고아 컨트롤러) 검사 (결정 79)
+//
+// apps/<앱>/controllers/<name>.ts 가 있는데 그 앱 routes.ts 어디에서도 참조되지
+// 않으면(= `<name>#action` 대상도, `resource(s)('<name>')` 도 없음) 그 컨트롤러는
+// 어떤 URL 로도 도달할 수 없다 — "라우트 미등록" 상태다. 컴파일은 통과하므로
+// check 로는 안 잡히는 조용한 누락이라, 이 검사가 경고로 낸다(라우트가 없는
+// 컨트롤러 파일은 배선을 깜빡한 흔한 실수 · §7.5.3 수리 안내).
+//
+// routes.ts 가 참조하는데 파일이 없는 반대 경우는 이미 generator 가 하드 에러로
+// 잡으므로(gaon check 중 throw) 여기서는 고아 컨트롤러만 본다. 판정은 소스 텍스트
+// 기반(가벼운 정적 검사) — routes.ts 를 실행하지 않는다.
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** routes.ts 소스에서 참조된 컨트롤러 이름 집합을 뽑는다(단위 테스트 진입점). */
+export function referencedControllers(routesSource) {
+    const names = new Set();
+    // 메서드 대상: r.get('/', 'posts#index') → 'posts'
+    for (const m of routesSource.matchAll(/['"]([A-Za-z_]\w*)#\w+['"]/g))
+        names.add(m[1]);
+    // 리소스: r.resource('posts') · r.resources('posts')
+    for (const m of routesSource.matchAll(/\bresources?\s*\(\s*['"]([A-Za-z_]\w*)['"]/g))
+        names.add(m[1]);
+    return names;
+}
+/** apps/ 를 훑어 라우트에 등록되지 않은(고아) 컨트롤러를 경고로 낸다. */
+export async function checkRouteRegistration(cwd) {
+    const appsDir = join(cwd, 'apps');
+    const issues = [];
+    for (const app of await safeListDirs(appsDir)) {
+        const routesPath = join(appsDir, app, 'routes.ts');
+        const routesSource = await readFile(routesPath, 'utf8').catch(() => undefined);
+        // routes.ts 가 없으면 참조 집합을 알 수 없어 diff 불가 — 건너뛴다
+        // (routes.ts 자체 부재는 다른 층의 관심사).
+        if (routesSource === undefined)
+            continue;
+        const referenced = referencedControllers(routesSource);
+        const controllersDir = join(appsDir, app, 'controllers');
+        for (const stem of await controllerStems(controllersDir)) {
+            if (referenced.has(stem))
+                continue;
+            issues.push({
+                rule: 'route-registration',
+                level: 'warning',
+                file: `apps/${app}/controllers/${stem}.ts`,
+                message: `라우트 미등록: apps/${app}/controllers/${stem}.ts 가 있는데 ` +
+                    `apps/${app}/routes.ts 어디에서도 참조되지 않습니다 — 이 컨트롤러는 어떤 URL 로도 ` +
+                    `도달할 수 없습니다(결정 79).\n` +
+                    `→ apps/${app}/routes.ts 에 \`r.get('/${stem}', '${stem}#index')\`(또는 \`r.resources('${stem}')\`)를 ` +
+                    `추가하거나, 쓰지 않는 컨트롤러라면 파일을 지우세요.`,
+                detail: { app, controller: stem },
+            });
+        }
+    }
+    return { rule: 'route-registration', issues };
+}
+/** apps/<앱>/controllers/*.ts 의 stem 목록(선언·테스트 제외). */
+async function controllerStems(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isFile() && e.name.endsWith('.ts') && !e.name.endsWith('.d.ts') && !e.name.endsWith('.test.ts'))
+            .map((e) => e.name.slice(0, -'.ts'.length))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+async function safeListDirs(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}

package/dist/doctor/static-collision.d.ts

@@ -0,0 +1,5 @@
+import type { RuleReport } from './types.js';
+/** routes.ts 소스에서 리터럴 라우트 경로 집합을 뽑는다(단위 테스트 진입점). */
+export declare function routePaths(routesSource: string): Set<string>;
+/** apps/ 를 훑어 라우트/에셋에 가려지는 정적 파일을 경고로 낸다. */
+export declare function checkStaticCollision(cwd: string): Promise<RuleReport>;

package/dist/doctor/static-collision.js

@@ -0,0 +1,84 @@
+// @gaonjs/cli · doctor · 정적 파일 ↔ 예약 경로 충돌 검사 (결정 85 · 경고)
+//
+// apps/<앱>/static/ 의 파일은 앱 prefix 아래로 서빙되지만, **명시 라우트와
+// /assets/ 는 항상 우선**한다(결정 85 · appStatic 은 폴백). 따라서 라우트가
+// 이미 쓰는 경로(또는 /assets/*)에 같은 이름의 정적 파일을 두면 그 파일은
+// **영원히 도달 불가**(조용히 라우트에 가려짐)다. 이 검사가 그 상태를 경고한다.
+// 판정은 소스 텍스트 기반(정적 · routes.ts 를 실행하지 않는다).
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** routes.ts 소스에서 리터럴 라우트 경로 집합을 뽑는다(단위 테스트 진입점). */
+export function routePaths(routesSource) {
+    const paths = new Set();
+    // r.get('/path', ...) · r.post("/x/:id", ...) 등 — 첫 문자열 인자가 경로.
+    for (const m of routesSource.matchAll(/\br\.(?:get|post|put|patch|delete)\s*\(\s*['"]([^'"]+)['"]/g)) {
+        paths.add(m[1]);
+    }
+    // resource(s)('name') → REST 표준 경로의 콜리전 후보(/name).
+    for (const m of routesSource.matchAll(/\bresources?\s*\(\s*['"]([A-Za-z_]\w*)['"]/g)) {
+        paths.add(`/${m[1]}`);
+    }
+    return paths;
+}
+/** apps/ 를 훑어 라우트/에셋에 가려지는 정적 파일을 경고로 낸다. */
+export async function checkStaticCollision(cwd) {
+    const appsDir = join(cwd, 'apps');
+    const issues = [];
+    for (const app of await safeListDirs(appsDir)) {
+        const staticDir = join(appsDir, app, 'static');
+        const files = await listFiles(staticDir, staticDir);
+        if (files.length === 0)
+            continue;
+        const routesSource = await readFile(join(appsDir, app, 'routes.ts'), 'utf8').catch(() => '');
+        const routes = routePaths(routesSource);
+        for (const rel of files) {
+            const urlPath = `/${rel}`;
+            const shadowedByRoute = routes.has(urlPath);
+            const shadowedByAssets = rel === 'assets' || rel.startsWith('assets/');
+            if (!shadowedByRoute && !shadowedByAssets)
+                continue;
+            const by = shadowedByAssets ? '프론트 에셋(/assets/*)' : `라우트 ${urlPath}`;
+            issues.push({
+                rule: 'static-collision',
+                level: 'warning',
+                file: `apps/${app}/static/${rel}`,
+                message: `정적 파일 가려짐: apps/${app}/static/${rel} 은 ${by} 에 가려져 서빙되지 않습니다 ` +
+                    `(결정 85 · 라우트·에셋이 정적 폴더보다 우선).\n` +
+                    `→ 정적 파일 이름을 바꾸거나, 그 경로를 라우트로 직접 응답하세요.`,
+                detail: { app, path: urlPath },
+            });
+        }
+    }
+    return { rule: 'static-collision', issues };
+}
+/** staticDir 하위 파일을 상대 경로(posix)로 나열. */
+async function listFiles(dir, base) {
+    const out = [];
+    const walk = async (d) => {
+        let entries;
+        try {
+            entries = await readdir(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const abs = join(d, e.name);
+            if (e.isDirectory())
+                await walk(abs);
+            else if (e.isFile())
+                out.push(abs.slice(base.length + 1).split('\\').join('/'));
+        }
+    };
+    await walk(dir);
+    return out;
+}
+async function safeListDirs(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).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-composable-purity' | 'no-auto-import' | 'schema-filename' | 'agents-doc-index' | 'column-casing' | 'model-filename' | 'page-filename' | 'auth-wiring';
+export type DoctorRule = 'response-mixing' | 'n-plus-one' | 'dependency-direction' | 'connections' | 'migration-diff' | 'shared-composable-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';
 export type DoctorLevel = 'passed' | 'warning' | 'error';
 export interface DoctorCheck {
     readonly rule: DoctorRule;

package/dist/doctor/types.js

@@ -1,9 +1,9 @@
 // @gaonjs/cli · doctor 공용 타입 (M9-E · M9-E-Fix · M9-E 확장 · E-5)
 //
-// 12 검사(response-mixing · n-plus-one · dependency-direction · connections
+// 17 검사(response-mixing · n-plus-one · dependency-direction · connections
 // · migration-diff · shared-composable-purity · no-auto-import · schema-filename
-// · agents-doc-index · column-casing · model-filename · page-filename)가 모두
-// 이 DoctorCheck 를 낸다. 상위(runDoctorCommand)는 level 로 passed/
+// · agents-doc-index · column-casing · model-filename · page-filename · auth-wiring
+// · ui-kit-wiring)가 모두 이 DoctorCheck 를 낸다. 상위(runDoctorCommand)는 level 로 passed/
 // warnings/errors 로 갈라 담는다. 자동화(CI)는 JSON 을 파싱해
 // errors.length > 0 이면 fail 로 판단한다.
 //

package/dist/doctor/ui-kit-wiring.d.ts

@@ -0,0 +1,5 @@
+import type { RuleReport } from './types.js';
+/** import 경로가 UI 킷 컴포넌트(components/ui/…)를 가리키는지(단위 테스트 진입점). */
+export declare function importsUiKit(source: string): boolean;
+/** apps/ 를 훑어 UI 킷 import ↔ Tailwind 배선 누락을 낸다. */
+export declare function checkUiKitWiring(cwd: string): Promise<RuleReport>;

package/dist/doctor/ui-kit-wiring.js

@@ -0,0 +1,93 @@
+// @gaonjs/cli · doctor · UI 킷 배선 검사 (결정 76)
+//
+// 앱이 UI 킷 컴포넌트(apps/<앱>/components/ui/*)를 import 하는데 그 앱에
+// Tailwind 배선(apps/<앱>/style.css 의 @tailwind + main.ts 의 style.css import)이
+// 없으면, UI 킷이 쓰는 유틸 클래스(bg-primary·rounded-lg …)가 펼쳐지지 않아
+// 컴포넌트가 스타일 없이 렌더된다 — 컴파일은 통과하므로 check 로는 안 잡히는
+// 조용한 런타임 파손이다(결정 74·75·76). 이 검사가 그 상태를 경고로 낸다.
+//
+// `gaon new`(web)·`gaon g app` 은 이제 배선을 함께 심으므로 정상 경로에서는
+// 걸리지 않는다. 이 규칙은 배선을 지웠거나 구버전 스캐폴드에서 만든 앱을 잡는
+// 안전망이다. 판정은 소스 텍스트 기반(가벼운 정적 검사).
+import { readdir, readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { hasAppWiring } from '../scaffold/app-wiring.js';
+/** import 경로가 UI 킷 컴포넌트(components/ui/…)를 가리키는지(단위 테스트 진입점). */
+export function importsUiKit(source) {
+    return /from\s+['"][^'"]*\bcomponents\/ui\/[^'"]+['"]/.test(source);
+}
+/** apps/ 를 훑어 UI 킷 import ↔ Tailwind 배선 누락을 낸다. */
+export async function checkUiKitWiring(cwd) {
+    const appsDir = join(cwd, 'apps');
+    const issues = [];
+    for (const app of await safeListDirs(appsDir)) {
+        // UI 킷을 import 하는 첫 파일을 찾는다.
+        const importer = await findUiKitImporter(join(appsDir, app), cwd);
+        if (!importer)
+            continue;
+        if (hasAppWiring(cwd, app))
+            continue;
+        issues.push({
+            rule: 'ui-kit-wiring',
+            level: 'warning',
+            file: importer,
+            message: `UI 킷 배선 누락: apps/${app} 이 UI 킷 컴포넌트(${importer})를 import 하는데 ` +
+                `apps/${app}/style.css 의 @tailwind 배선(또는 main.ts 의 style.css import)이 없습니다. ` +
+                `이대로면 UI 킷의 Tailwind 유틸 클래스가 펼쳐지지 않아 컴포넌트가 스타일 없이 렌더됩니다(결정 76).\n` +
+                `→ apps/${app}/style.css 에 @tailwind 지시자를 추가하거나 \`gaon g ui-kit --app ${app}\` 을 실행하세요 ` +
+                `(후자는 배선까지 멱등으로 보정합니다).`,
+            detail: { app, importer },
+        });
+    }
+    return { rule: 'ui-kit-wiring', issues };
+}
+/** 앱 디렉터리를 재귀 스캔해 UI 킷을 import 하는 첫 .vue/.ts 파일(cwd 상대)을 찾는다. */
+async function findUiKitImporter(appDir, cwd) {
+    for (const abs of await walkSources(appDir)) {
+        // components/ui 안의 컴포넌트 자체는 서로를 import 하므로 제외한다.
+        if (abs.includes(`${join(appDir, 'components', 'ui')}`))
+            continue;
+        const source = await readFile(abs, 'utf8').catch(() => '');
+        if (importsUiKit(source))
+            return relative(cwd, abs);
+    }
+    return undefined;
+}
+/** 디렉터리 트리에서 .vue·.ts(테스트·선언 제외) 파일 절대경로를 모은다. */
+async function walkSources(dir) {
+    const out = [];
+    const walk = async (d) => {
+        let entries;
+        try {
+            entries = await readdir(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const abs = join(d, e.name);
+            if (e.isDirectory()) {
+                if (e.name === 'node_modules' || e.name === '.gaon')
+                    continue;
+                await walk(abs);
+            }
+            else if (e.isFile()) {
+                if (e.name.endsWith('.d.ts') || e.name.endsWith('.test.ts'))
+                    continue;
+                if (e.name.endsWith('.vue') || e.name.endsWith('.ts'))
+                    out.push(abs);
+            }
+        }
+    };
+    await walk(dir);
+    return out.sort();
+}
+async function safeListDirs(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}

package/dist/doctor.d.ts

@@ -14,6 +14,7 @@ export { expectedColumnName, extractSnakeColumns, checkColumnCasing, } from './d
 export { isPascalCase, checkModelFilename } from './doctor/model-filename.js';
 export { checkPageFilename } from './doctor/page-filename.js';
 export { usesAuthSurface, hasAuthWiring, hasSessionWiring, checkAuthWiring, } from './doctor/auth-wiring.js';
+export { importsUiKit, checkUiKitWiring } from './doctor/ui-kit-wiring.js';
 export { renderHuman, renderJson } from './doctor/reporter.js';
 export { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, } from './doctor/setup.js';
 export interface DoctorCommandOptions {

package/dist/doctor.js

@@ -1,7 +1,7 @@
 /**
  * @gaonjs/cli · `gaon doctor` — 정적 검사 (M9-E · CLI DX 완성 · E-5 확장)
  *
- * 13 검사를 조립한다:
+ * 17 검사를 조립한다:
  *  1) response-mixing (errata E-3 §C · 라이브)
  *  2) n-plus-one (errata E-4 (e))
  *  3) dependency-direction (CLAUDE.md §5 · 4 규칙)
@@ -15,6 +15,10 @@
  * 11) model-filename (§3.4 · 결정 32·46 · 모델 파일명 PascalCase)
  * 12) page-filename (§3.4 · 결정 32·46 · Vue 페이지 파일명 PascalCase)
  * 13) auth-wiring (§7 · 결정 59 · requireAuth ↔ app.config.ts auth 배선)
+ * 14) ui-kit-wiring (§6.4 · 결정 76 · UI 킷 import ↔ apps/<앱>/style.css Tailwind 배선)
+ * 15) route-registration (결정 79 · 고아 컨트롤러 = routes.ts 미참조 경고)
+ * 16) static-collision (결정 85 · 정적 파일이 라우트/에셋에 가려짐 경고)
+ * 17) method-override (결정 89 · _method HTTP 스푸핑 hack 경고)
  *
  * 각 검사는 순수 함수(cwd → RuleReport). 상위 runDoctorCommand 가 조립해
  * DoctorResult 로 낸다. --json 은 자동화(CI)를 위해 반드시 파싱 가능한
@@ -40,6 +44,10 @@ import { checkColumnCasing } from './doctor/column-casing.js';
 import { checkModelFilename } from './doctor/model-filename.js';
 import { checkPageFilename } from './doctor/page-filename.js';
 import { checkAuthWiring } from './doctor/auth-wiring.js';
+import { checkUiKitWiring } from './doctor/ui-kit-wiring.js';
+import { checkRouteRegistration } from './doctor/route-registration.js';
+import { checkStaticCollision } from './doctor/static-collision.js';
+import { checkMethodOverride } from './doctor/method-override.js';
 import { renderHuman, renderJson } from './doctor/reporter.js';
 import { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, } from './doctor/setup.js';
 import { makeResult, } from './doctor/types.js';
@@ -57,10 +65,11 @@ export { expectedColumnName, extractSnakeColumns, checkColumnCasing, } from './d
 export { isPascalCase, checkModelFilename } from './doctor/model-filename.js';
 export { checkPageFilename } from './doctor/page-filename.js';
 export { usesAuthSurface, hasAuthWiring, hasSessionWiring, checkAuthWiring, } from './doctor/auth-wiring.js';
+export { importsUiKit, checkUiKitWiring } from './doctor/ui-kit-wiring.js';
 export { renderHuman, renderJson } from './doctor/reporter.js';
 export { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, } from './doctor/setup.js';
 /**
- * 실행할 검사 이름. 지정 없음(undefined) = 13개 모두.
+ * 실행할 검사 이름. 지정 없음(undefined) = 17개 모두.
  */
 const ALL_RULES = [
     'response-mixing',
@@ -76,6 +85,10 @@ const ALL_RULES = [
     'model-filename',
     'page-filename',
     'auth-wiring',
+    'ui-kit-wiring',
+    'route-registration',
+    'static-collision',
+    'method-override',
 ];
 const CHECKERS = {
     'response-mixing': checkResponseMixing,
@@ -91,6 +104,10 @@ const CHECKERS = {
     'model-filename': checkModelFilename,
     'page-filename': checkPageFilename,
     'auth-wiring': checkAuthWiring,
+    'ui-kit-wiring': checkUiKitWiring,
+    'route-registration': checkRouteRegistration,
+    'static-collision': checkStaticCollision,
+    'method-override': checkMethodOverride,
 };
 /**
  * 규칙을 순서대로 실행해 RuleReport[] 를 낸다. 규칙 하나가 크래시해도 나머지는

package/dist/generate.js

@@ -15,6 +15,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { authUiKitFiles, writeUiKitFiles } from './uikit.js';
 // ── 템플릿 로드·치환 ───────────────────────────────────────────
 // 템플릿은 이 모듈과 같은 위치의 templates/auth/ 에 있다(빌드가 dist 로 복사).
 const TEMPLATE_DIR = join(dirname(fileURLToPath(import.meta.url)), 'templates', 'auth');
@@ -76,6 +77,13 @@ export function writeAuthScaffold(cwd, opts = {}) {
     const skipped = [];
     const patched = [];
     const warnings = [];
+    // 결정 75: auth 페이지(Login/Signup/Dashboard)는 UI 킷 컴포넌트를 쓴다.
+    // 필요한 최소 세트를 먼저 보장한다 — 이미 있으면(gaon g ui-kit 를 먼저 돌린
+    // 경우) skip, 없으면 생성. 이 보장이 없으면 스캐폴드 직후 페이지가 컴포넌트를
+    // 해상하지 못해 vue-tsc 가 깨진다(gaon new → g auth 단독 경로 · 결정 60 게이트).
+    const ui = writeUiKitFiles(root, authUiKitFiles(app));
+    created.push(...ui.created);
+    skipped.push(...ui.skipped);
     for (const file of authScaffoldFiles(opts)) {
         const abs = join(root, file.path);
         if (existsSync(abs)) {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { type DoctorRule } from "./doctor.js";
-export { startDev, resolveDevLayout, type DevDeps, type DevLayout, type DevApp, type DevEvent, type DevHandle, } from "./dev.js";
+export { startDev, resolveDevLayout, regenerateGaonOnce, type DevDeps, type DevLayout, type DevApp, type DevEvent, type DevHandle, type RegenDeps, type RegenResult, } from "./dev.js";
 export { runDevCommand, type DevCommandOptions } from "./commands/dev.js";
 export { createDevConsole, findComposeFile, isDockerAvailable, inspectCompose, composeUp, composeDown, ensureInfra, startTscWatchers, killChild, startRestartWatcher, isRestartChange, resolveWatchRoots, type DevConsole, type DevConsoleOptions, type DevSource, type DevLevel, type ComposeStatus, type ComposeUpOptions, type EnsureInfraResult, type DockerLocateOptions, type TscWatcherOptions, type TscWatcherHandle, type RestartWatcherOptions, type RestartWatcherHandle, } from "./dev/index.js";
 export { runCheckCommand, type CheckCommandOptions, type CheckStep, type CheckStepStatus, type CheckStepResult, } from "./commands/check.js";
@@ -7,6 +7,7 @@ export { runNewCommand, type NewCommandOptions, type NewCommandResult } from "./
 export { runConsoleCommand, type ConsoleCommandOptions } from "./commands/console.js";
 export { runTestCommand, type TestCommandOptions, type TestScope } from "./commands/test.js";
 export { writeAuthScaffold, authScaffoldFiles, patchRoutes, runGenerateAuthCommand, type AuthScaffoldOptions, type ScaffoldFile, type ScaffoldResult, type GenerateAuthOptions, } from "./generate.js";
+export { writeUiKitScaffold, writeUiKitFiles, uiKitScaffoldFiles, authUiKitFiles, runGenerateUiKitCommand, type UiKitScaffoldOptions, type UiKitScaffoldFile, type UiKitScaffoldResult, type GenerateUiKitOptions, } from "./uikit.js";
 export { runGenerateCommand, planScaffold, parseGenerateArgs, type GenerateType, type GenerateOptions, type GenerateResult, } from "./commands/g.js";
 export { runHubCommand, type HubCommandOptions } from "./hub.js";
 export { runServeCommand, type ServeCommandOptions } from "./serve.js";