@gaonjs/cli 0.15.0 → 0.18.0

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/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';
 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
+// 14 검사(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 검사를 조립한다:
+ * 14 검사를 조립한다:
  *  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,7 @@
  * 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 배선)
  *
  * 각 검사는 순수 함수(cwd → RuleReport). 상위 runDoctorCommand 가 조립해
  * DoctorResult 로 낸다. --json 은 자동화(CI)를 위해 반드시 파싱 가능한
@@ -40,6 +41,7 @@ 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 { renderHuman, renderJson } from './doctor/reporter.js';
 import { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, } from './doctor/setup.js';
 import { makeResult, } from './doctor/types.js';
@@ -57,10 +59,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) = 14개 모두.
  */
 const ALL_RULES = [
     'response-mixing',
@@ -76,6 +79,7 @@ const ALL_RULES = [
     'model-filename',
     'page-filename',
     'auth-wiring',
+    'ui-kit-wiring',
 ];
 const CHECKERS = {
     'response-mixing': checkResponseMixing,
@@ -91,6 +95,7 @@ const CHECKERS = {
     'model-filename': checkModelFilename,
     'page-filename': checkPageFilename,
     'auth-wiring': checkAuthWiring,
+    'ui-kit-wiring': checkUiKitWiring,
 };
 /**
  * 규칙을 순서대로 실행해 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";

package/dist/index.js

@@ -17,6 +17,7 @@ import { runNewCommand } from "./commands/new.js";
 import { runConsoleCommand } from "./commands/console.js";
 import { runTestCommand } from "./commands/test.js";
 import { runGenerateAuthCommand } from "./generate.js";
+import { runGenerateUiKitCommand } from "./uikit.js";
 import { runGenerateCommand } from "./commands/g.js";
 import { runHubCommand } from "./hub.js";
 import { runServeCommand } from "./serve.js";
@@ -25,7 +26,7 @@ import { runJobsCommand } from "./jobs.js";
 import { runDbCommand } from "./commands/db.js";
 import { runDoctorCommand } from "./doctor.js";
 import { runMcpCommand } from "./commands/mcp.js";
-export { startDev, resolveDevLayout, } from "./dev.js";
+export { startDev, resolveDevLayout, regenerateGaonOnce, } from "./dev.js";
 export { runDevCommand } from "./commands/dev.js";
 export { createDevConsole, findComposeFile, isDockerAvailable, inspectCompose, composeUp, composeDown, ensureInfra, startTscWatchers, killChild, startRestartWatcher, isRestartChange, resolveWatchRoots, } from "./dev/index.js";
 export { runCheckCommand, } from "./commands/check.js";
@@ -33,6 +34,7 @@ export { runNewCommand } from "./commands/new.js";
 export { runConsoleCommand } from "./commands/console.js";
 export { runTestCommand } from "./commands/test.js";
 export { writeAuthScaffold, authScaffoldFiles, patchRoutes, runGenerateAuthCommand, } from "./generate.js";
+export { writeUiKitScaffold, writeUiKitFiles, uiKitScaffoldFiles, authUiKitFiles, runGenerateUiKitCommand, } from "./uikit.js";
 export { runGenerateCommand, planScaffold, parseGenerateArgs, } from "./commands/g.js";
 export { runHubCommand } from "./hub.js";
 export { runServeCommand } from "./serve.js";
@@ -101,7 +103,7 @@ function renderHelp(version = VERSION) {
         "    gaon check         typecheck · vue-tsc · build 통합 검사 (--only <step> · --include-doctor)",
         "    gaon console       프로젝트 컨텍스트 REPL (--no-config)",
         "    gaon test          테스트 러너 (--scope unit|integration|all · -- vitest 인자)",
-        "    gaon doctor        정적 검사 (13 검사 · 응답 혼용·N+1·의존·커넥션·마이그·컴포저블 순수·자동 import·파일명/컬럼 관례·인증 배선)",
+        "    gaon doctor        정적 검사 (14 검사 · 응답 혼용·N+1·의존·커넥션·마이그·컴포저블 순수·자동 import·파일명/컬럼 관례·인증 배선·UI 킷 배선)",
         "    gaon doctor --json                        자동화용 JSON 출력",
         "    gaon doctor --check=n-plus-one,connections  선택 검사만 실행",
         "    gaon doctor --fix                         기계 정정 가능한 위반 계획(dry-run · v0.16 §7.5.3)",
@@ -228,7 +230,7 @@ export function runCli(argv, opts = {}) {
         });
         return;
     }
-    // `gaon doctor` — 정적 검사(M9-E · 13 검사). --check=<이름>[,<이름>...] 로
+    // `gaon doctor` — 정적 검사(M9-E · 14 검사). --check=<이름>[,<이름>...] 로
     // 선택 실행, --json 은 자동화 파싱용.
     // exit code (M9-E-Fix): fatal → 2(사용자 오류) / errors > 0 → 1 / 그 외 → 0.
     if (argv[0] === "doctor") {
@@ -351,6 +353,13 @@ export function runCli(argv, opts = {}) {
             process.exitCode = code;
             return;
         }
+        if (argv[1] === "ui-kit" || argv[1] === "ui") {
+            const appIdx = argv.indexOf("--app");
+            const app = appIdx >= 0 ? argv[appIdx + 1] : undefined;
+            const code = runGenerateUiKitCommand({ app, json: argv.includes("--json") });
+            process.exitCode = code;
+            return;
+        }
         const known = ["controller", "model", "page", "job", "app"];
         const type = argv[1];
         if (type && known.includes(type)) {
@@ -395,7 +404,7 @@ export function runCli(argv, opts = {}) {
             return;
         }
         process.stderr.write(`  ✗ 알 수 없는 제너레이터: ${argv[1] ?? "(없음)"}\n` +
-            `  → 현재 지원: gaon g auth | controller | model | page | job | app\n` +
+            `  → 현재 지원: gaon g auth | ui-kit | controller | model | page | job | app\n` +
             `  → 옵션: --app <이름> · --overwrite · --json\n`);
         process.exitCode = 1;
         return;

package/dist/scaffold/app-wiring.d.ts

@@ -0,0 +1,12 @@
+import type { ScaffoldFile } from './controller.js';
+/**
+ * 대상 앱의 프론트 배선 파일(main.ts·style.css·index.html)을 web 정본에서
+ * 파생해 반환한다. 실제 쓰기는 writeScaffold/writeUiKitFiles 가 담당(멱등).
+ */
+export declare function appWiringFiles(app: string, projectName: string): ScaffoldFile[];
+/** 배선 파일 3종의 대상 경로(존재 검사용). */
+export declare function appWiringPaths(app: string): string[];
+/** 대상 앱에 Tailwind 배선(style.css + main.ts 의 style.css import)이 있는지. */
+export declare function hasAppWiring(cwd: string, app: string): boolean;
+/** 프로젝트 package.json 의 name — 배선 title 치환용. 없으면 'app'. */
+export declare function readProjectName(cwd: string): string;

package/dist/scaffold/app-wiring.js

@@ -0,0 +1,68 @@
+// @gaonjs/cli · scaffold · app-wiring — 앱 프론트 배선 (결정 76)
+//
+// 새 앱(`gaon g app admin`)과 web 앱(`gaon new`)이 프론트 배선에서 동등해야
+// 한다: Tailwind CSS 파이프라인(style.css)·Vite 진입(main.ts·index.html).
+// 이 배선이 없으면 그 앱에서 `gaon g ui-kit --app admin` 으로 심은 UI 킷
+// 컴포넌트가 Tailwind 유틸을 못 받아 스타일 없이 렌더된다(결정 74·75).
+//
+// 단일 소스: web 앱의 정본 템플릿(templates/project/apps/web/{main.ts,style.css,
+// index.html}.tpl)을 그대로 읽어 `{{PROJECT_NAME}}` 만 치환하고 대상 앱으로
+// 재타겟한다. style.css 는 앱 무관(토큰만)이라 web 과 바이트 동일하고, main.ts·
+// index.html 은 프로젝트명 title 만 다르다 — 템플릿을 복제하지 않아 드리프트가
+// 없다(결정 76).
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { renderTemplate, templateDir } from '../templates/index.js';
+/** web 정본 템플릿을 대상 앱으로 재타겟하는 배선 파일 3종의 원본 경로. */
+const WIRING = [
+    { tpl: 'apps/web/main.ts.tpl', out: 'main.ts' },
+    { tpl: 'apps/web/style.css.tpl', out: 'style.css' },
+    { tpl: 'apps/web/index.html.tpl', out: 'index.html' },
+];
+/**
+ * 대상 앱의 프론트 배선 파일(main.ts·style.css·index.html)을 web 정본에서
+ * 파생해 반환한다. 실제 쓰기는 writeScaffold/writeUiKitFiles 가 담당(멱등).
+ */
+export function appWiringFiles(app, projectName) {
+    const base = templateDir();
+    const tokens = { projectName, gaonjsVersion: readGaonjsVersion() };
+    return WIRING.map(({ tpl, out }) => {
+        const raw = readFileSync(join(base, tpl), 'utf8');
+        // 주석 안 `apps/web/…` 경로 표기를 대상 앱으로 맞춘다(import 는 상대라 무관).
+        const retargeted = renderTemplate(raw, tokens).replaceAll('apps/web/', `apps/${app}/`);
+        return { path: `apps/${app}/${out}`, contents: retargeted };
+    });
+}
+/** 배선 파일 3종의 대상 경로(존재 검사용). */
+export function appWiringPaths(app) {
+    return WIRING.map(({ out }) => `apps/${app}/${out}`);
+}
+/** 대상 앱에 Tailwind 배선(style.css + main.ts 의 style.css import)이 있는지. */
+export function hasAppWiring(cwd, app) {
+    const styleCss = join(cwd, 'apps', app, 'style.css');
+    const mainTs = join(cwd, 'apps', app, 'main.ts');
+    if (!existsSync(styleCss) || !existsSync(mainTs))
+        return false;
+    const css = readFileSync(styleCss, 'utf8');
+    const main = readFileSync(mainTs, 'utf8');
+    return /@tailwind\b/.test(css) && /['"]\.\/style\.css['"]/.test(main);
+}
+/** 프로젝트 package.json 의 name — 배선 title 치환용. 없으면 'app'. */
+export function readProjectName(cwd) {
+    return readPackageField(cwd, (pkg) => (typeof pkg.name === 'string' ? pkg.name : undefined)) ?? 'app';
+}
+/** 설치된 gaonjs 버전(배선 템플릿엔 미사용이나 렌더 계약상 채운다). */
+function readGaonjsVersion() {
+    return '';
+}
+function readPackageField(cwd, pick) {
+    const pj = join(cwd, 'package.json');
+    if (!existsSync(pj))
+        return undefined;
+    try {
+        return pick(JSON.parse(readFileSync(pj, 'utf8')));
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/templates/auth/Dashboard.vue.tpl

@@ -1,5 +1,12 @@
 <script setup lang="ts">
 import { pageProps, router } from 'gaonjs/vue'
+import Card from '../components/ui/Card.vue'
+import CardHeader from '../components/ui/CardHeader.vue'
+import CardTitle from '../components/ui/CardTitle.vue'
+import CardDescription from '../components/ui/CardDescription.vue'
+import CardContent from '../components/ui/CardContent.vue'
+import CardFooter from '../components/ui/CardFooter.vue'
+import Button from '../components/ui/Button.vue'
 
 // dashboard#show 의 render props — user 는 직렬화되며 passwordDigest 는 없다(§4.2).
 const { user, csrf } = pageProps<'{{APP_NAME}}:dashboard#show'>()
@@ -14,9 +21,18 @@ function logout(): void {
 </script>
 
 <template>
-  <main>
-    <h1>환영합니다, {{ user.name }}님</h1>
-    <p>{{ user.email }}</p>
-    <button type="button" @click="logout">로그아웃</button>
-  </main>
+  <div class="mx-auto max-w-2xl px-4 py-10">
+    <Card>
+      <CardHeader>
+        <CardTitle>환영합니다, {{ user.name }}님</CardTitle>
+        <CardDescription>{{ user.email }}</CardDescription>
+      </CardHeader>
+      <CardContent>
+        <p class="text-sm text-muted-foreground">보호된 페이지입니다 — this.requireAuth() 로 지킵니다.</p>
+      </CardContent>
+      <CardFooter>
+        <Button variant="outline" @click="logout">로그아웃</Button>
+      </CardFooter>
+    </Card>
+  </div>
 </template>

package/dist/templates/auth/Login.vue.tpl

@@ -1,5 +1,16 @@
 <script setup lang="ts">
 import { pageProps, useForm } from 'gaonjs/vue'
+import Card from '../../components/ui/Card.vue'
+import CardHeader from '../../components/ui/CardHeader.vue'
+import CardTitle from '../../components/ui/CardTitle.vue'
+import CardDescription from '../../components/ui/CardDescription.vue'
+import CardContent from '../../components/ui/CardContent.vue'
+import Form from '../../components/ui/Form.vue'
+import FormField from '../../components/ui/FormField.vue'
+import Input from '../../components/ui/Input.vue'
+import Button from '../../components/ui/Button.vue'
+import Alert from '../../components/ui/Alert.vue'
+import AlertDescription from '../../components/ui/AlertDescription.vue'
 
 // 컨트롤러 session#new 의 render props 타입이 그대로 흐른다(§6.2).
 const { error, csrf } = pageProps<'{{APP_NAME}}:session#new'>()
@@ -10,12 +21,30 @@ const form = useForm({ email: '', password: '', _csrf: csrf })
 </script>
 
 <template>
-  <form @submit.prevent="form.post('/session')">
-    <h1>로그인</h1>
-    <p v-if="error" class="error">{{ error }}</p>
-    <label>이메일 <input v-model="form.email" type="email" required /></label>
-    <label>비밀번호 <input v-model="form.password" type="password" required /></label>
-    <button type="submit" :disabled="form.processing">로그인</button>
-    <a href="/registration/new">회원가입</a>
-  </form>
+  <div class="mx-auto flex min-h-[70vh] max-w-sm items-center px-4">
+    <Card class="w-full">
+      <CardHeader>
+        <CardTitle>로그인</CardTitle>
+        <CardDescription>계정으로 로그인하세요.</CardDescription>
+      </CardHeader>
+      <CardContent>
+        <Alert v-if="error" variant="destructive" class="mb-4">
+          <AlertDescription>{{ error }}</AlertDescription>
+        </Alert>
+        <Form @submit="form.post('/session')">
+          <FormField label="이메일" :error="form.errors.email">
+            <Input v-model="form.email" type="email" required />
+          </FormField>
+          <FormField label="비밀번호" :error="form.errors.password">
+            <Input v-model="form.password" type="password" required />
+          </FormField>
+          <Button type="submit" class="w-full" :disabled="form.processing">로그인</Button>
+        </Form>
+        <p class="mt-4 text-center text-sm text-muted-foreground">
+          계정이 없으신가요?
+          <a href="/registration/new" class="font-medium text-primary underline-offset-4 hover:underline">회원가입</a>
+        </p>
+      </CardContent>
+    </Card>
+  </div>
 </template>

package/dist/templates/auth/Signup.vue.tpl

@@ -1,5 +1,16 @@
 <script setup lang="ts">
 import { pageProps, useForm } from 'gaonjs/vue'
+import Card from '../../components/ui/Card.vue'
+import CardHeader from '../../components/ui/CardHeader.vue'
+import CardTitle from '../../components/ui/CardTitle.vue'
+import CardDescription from '../../components/ui/CardDescription.vue'
+import CardContent from '../../components/ui/CardContent.vue'
+import Form from '../../components/ui/Form.vue'
+import FormField from '../../components/ui/FormField.vue'
+import Input from '../../components/ui/Input.vue'
+import Button from '../../components/ui/Button.vue'
+import Alert from '../../components/ui/Alert.vue'
+import AlertDescription from '../../components/ui/AlertDescription.vue'
 
 const { error, csrf } = pageProps<'{{APP_NAME}}:registration#new'>()
 
@@ -8,13 +19,33 @@ const form = useForm({ name: '', email: '', password: '', _csrf: csrf })
 </script>
 
 <template>
-  <form @submit.prevent="form.post('/registration')">
-    <h1>회원가입</h1>
-    <p v-if="error" class="error">{{ error }}</p>
-    <label>이름 <input v-model="form.name" required /></label>
-    <label>이메일 <input v-model="form.email" type="email" required /></label>
-    <label>비밀번호 <input v-model="form.password" type="password" required /></label>
-    <button type="submit" :disabled="form.processing">회원가입</button>
-    <a href="/session/new">로그인</a>
-  </form>
+  <div class="mx-auto flex min-h-[70vh] max-w-sm items-center px-4">
+    <Card class="w-full">
+      <CardHeader>
+        <CardTitle>회원가입</CardTitle>
+        <CardDescription>새 계정을 만드세요.</CardDescription>
+      </CardHeader>
+      <CardContent>
+        <Alert v-if="error" variant="destructive" class="mb-4">
+          <AlertDescription>{{ error }}</AlertDescription>
+        </Alert>
+        <Form @submit="form.post('/registration')">
+          <FormField label="이름" :error="form.errors.name">
+            <Input v-model="form.name" required />
+          </FormField>
+          <FormField label="이메일" :error="form.errors.email">
+            <Input v-model="form.email" type="email" required />
+          </FormField>
+          <FormField label="비밀번호" :error="form.errors.password">
+            <Input v-model="form.password" type="password" required />
+          </FormField>
+          <Button type="submit" class="w-full" :disabled="form.processing">회원가입</Button>
+        </Form>
+        <p class="mt-4 text-center text-sm text-muted-foreground">
+          이미 계정이 있으신가요?
+          <a href="/session/new" class="font-medium text-primary underline-offset-4 hover:underline">로그인</a>
+        </p>
+      </CardContent>
+    </Card>
+  </div>
 </template>

package/dist/templates/project/AGENTS.md.tpl

@@ -104,7 +104,7 @@ Gaon 의 제1 설계 목표는 **"AI 가 개발을 가장 잘하는 프레임웍
   컬럼명 · 스키마 파일 ↔ 테이블 ↔ `tables.d.ts` 키 변환 규칙)은
   `agents/data.md` "DB 네이밍" 표가 정본이다 — 먼저 읽는다.
 
-### 2.2 `gaon doctor` 검사 13종
+### 2.2 `gaon doctor` 검사 14종
 
 1. `response-mixing` — 한 액션 안 render/JSON/redirect 혼용 (E-3)
 2. `n-plus-one` — include 미사용 · loop 안 관계 호출 (E-4)
@@ -119,6 +119,7 @@ Gaon 의 제1 설계 목표는 **"AI 가 개발을 가장 잘하는 프레임웍
 11. `model-filename` — 모델 파일명 PascalCase 관례 (결정 32·46 · `--fix` 지원)
 12. `page-filename` — Vue 페이지 파일명 PascalCase 관례 (결정 32·46)
 13. `auth-wiring` — requireAuth/this.auth 사용 ↔ `app.config.ts` 인증 배선 (결정 59)
+14. `ui-kit-wiring` — UI 킷 컴포넌트 import ↔ `apps/<앱>/style.css` Tailwind 배선 (결정 76 · 경고)
 
 ## 3. 로직 배치 One Way 판단표
 
@@ -159,7 +160,7 @@ Gaon 의 제1 설계 목표는 **"AI 가 개발을 가장 잘하는 프레임웍
 ```bash
 gaon check        # .gaon 재생성 → typecheck + vue-tsc + build (+doctor)
 gaon test         # vitest — DB·NATS 는 실 인프라 (agents/testing.md)
-gaon doctor       # 정적 검사 13종 (§2.2)
+gaon doctor       # 정적 검사 14종 (§2.2)
 ```
 
 ### 4.1 CLI 명령 (전 명령 `--json` 지원)