@gaonjs/cli 0.14.0 → 0.15.0

package/dist/commands/dev.js

@@ -54,7 +54,9 @@ function resolveSelfCliEntry() {
  */
 function spawnServe(args) {
     const { node, args: nodeArgs } = resolveSelfCliEntry();
-    const serveArgs = ['serve'];
+    // --dev: dev 전용 진단 라우트(/_gaon/health)를 켠다(결정 69). gaon dev 의
+    // serve 자식만 이 플래그를 받으므로 운영 serve 에는 진단이 노출되지 않는다.
+    const serveArgs = ['serve', '--dev'];
     if (args.json)
         serveArgs.push('--json');
     if (args.port != null)

package/dist/dev/health.d.ts

@@ -0,0 +1,72 @@
+import { type GaonNats, type StreamStat } from '@gaonjs/async';
+import type { GaonConfig } from '@gaonjs/config';
+/** registerDevHealth 가 프로브에 쓰는 컨텍스트(serve 가 채운다). */
+export interface DevHealthContext {
+    readonly cwd: string;
+    readonly config: GaonConfig;
+    readonly apps: readonly {
+        readonly name: string;
+        readonly dir: string;
+    }[];
+    readonly nats?: GaonNats;
+    readonly port: number;
+    readonly host: string;
+}
+export interface WebHealth {
+    readonly host: string;
+    readonly port: number;
+    readonly node: string;
+    readonly gaonjs: string;
+    readonly apps: readonly {
+        readonly name: string;
+        readonly prefix: string;
+    }[];
+}
+export type DatabaseHealth = {
+    readonly configured: false;
+} | {
+    readonly configured: true;
+    readonly connected: boolean;
+    readonly adapter?: string;
+    readonly tables?: number;
+    readonly tableNames?: readonly string[];
+    readonly migrations?: number;
+    readonly error?: string;
+};
+export type HubHealth = {
+    readonly configured: false;
+} | {
+    readonly configured: true;
+    readonly connected: boolean;
+    readonly streams?: readonly StreamStat[];
+    readonly error?: string;
+};
+export interface DoctorHealth {
+    readonly checks: number;
+    readonly passed: number;
+    readonly warnings: number;
+    readonly errors: number;
+    readonly level: 'pass' | 'warn' | 'error';
+    /** 사전 검사 실패(프로젝트 아님 등)면 코드. */
+    readonly fatal?: string;
+}
+export interface GaonHealth {
+    readonly ok: boolean;
+    readonly env: string;
+    readonly web: WebHealth;
+    readonly database: DatabaseHealth;
+    readonly hub: HubHealth;
+    readonly doctor: DoctorHealth;
+    /** 랜딩 코드 블록용 — 실 routes.ts 원문(dev only). */
+    readonly routes: {
+        readonly path: string;
+        readonly source: string;
+    } | null;
+}
+/**
+ * 라이브 헬스 스냅샷을 계산한다. 순수 조회(부작용 없음) — 각 프로브는 독립
+ * try/catch 라 하나가 실패해도 전체가 죽지 않는다.
+ */
+export declare function computeHealth(ctx: DevHealthContext): Promise<GaonHealth>;
+/** dev 전용 진단 라우트 경로. serve(--dev)가 이 경로에 computeHealth 를 건다. */
+export declare const DEV_HEALTH_PATH = "/_gaon/health";

package/dist/dev/health.js

@@ -0,0 +1,154 @@
+/**
+ * @gaonjs/cli · dev 전용 라이브 헬스 엔드포인트 (결정 69 · W10)
+ *
+ * `GET /_gaon/health` — 방금 `gaon new` 로 만든 앱이 "실제로 살아 있는지" 를
+ * 랜딩(Home/Index.vue)이 라이브로 보여주기 위한 dev 전용 진단 소스다.
+ *
+ * dev-only by construction:
+ *   `gaon dev` 는 `gaon serve` 를 자식으로 띄우고(commands/dev.ts), 그때
+ *   serve 에 `--dev` 를 넘긴다. serve 는 `--dev` 일 때만 이 라우트를 등록한다
+ *   (serve.ts). 운영 `gaon serve`(플래그 없음)는 등록조차 하지 않으므로
+ *   production 에 노출되지 않는다(§CLAUDE.md 6 · handover-w10 §3.5·§5).
+ *
+ * 층 배치: 이 모듈은 doctor(computeDoctorResult)·data introspection·async
+ * 스트림 통계를 import 하므로 **cli 층**에 둔다. web/config 에 두면
+ * cli→web/config→cli 역방향 사이클이 된다(handover-w10 §5-3).
+ *
+ * 모든 프로브는 개별 try/catch — 하나가 실패해도 나머지 카드는 채운다.
+ * 조회 실패를 0/true 로 가장하지 않는다(결정 60 · 과대 약속 금지).
+ */
+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 { computeDoctorResult } from '../doctor.js';
+/** web 앱은 관례상 프리픽스 '/', 그 외는 '/<앱>'(dispatch.prefixFor 와 정합). */
+function prefixFor(name) {
+    return name === 'web' ? '/' : `/${name}`;
+}
+async function probeDatabase(config) {
+    const main = config.db?.main;
+    if (!main)
+        return { configured: false };
+    const adapter = main.adapter;
+    try {
+        if (!hasConnection('main')) {
+            return { configured: true, connected: false, adapter, error: '커넥션 미등록' };
+        }
+        const db = getConnection('main');
+        // introspect 자체가 실 쿼리 — DB 가 죽어 있으면 여기서 throw → connected:false.
+        const snap = await snapshotFromDb(db, postgresDialect);
+        const tableNames = Object.keys(snap)
+            .filter((t) => t !== MIGRATIONS_TABLE)
+            .sort();
+        let migrations = 0;
+        try {
+            const row = await db
+                .selectFrom(MIGRATIONS_TABLE)
+                .select((eb) => eb.fn.countAll().as('c'))
+                .executeTakeFirst();
+            migrations = Number(row?.c ?? 0);
+        }
+        catch {
+            // _gaon_migrations 미생성(마이그레이션 이력 없음) — 0.
+            migrations = 0;
+        }
+        return {
+            configured: true,
+            connected: true,
+            adapter,
+            tables: tableNames.length,
+            tableNames,
+            migrations,
+        };
+    }
+    catch (err) {
+        return {
+            configured: true,
+            connected: false,
+            adapter,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+async function probeHub(config, nats) {
+    if (!config.nats)
+        return { configured: false };
+    if (!nats)
+        return { configured: true, connected: false };
+    const connected = !nats.nc.isClosed();
+    if (!connected)
+        return { configured: true, connected: false };
+    try {
+        const streams = await streamStats(nats);
+        return { configured: true, connected: true, streams };
+    }
+    catch (err) {
+        return {
+            configured: true,
+            connected: true,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+async function probeDoctor(cwd) {
+    try {
+        const result = await computeDoctorResult({ cwd });
+        if (result.fatal) {
+            return { checks: 0, passed: 0, warnings: 0, errors: 0, level: 'error', fatal: result.fatal.code };
+        }
+        const passed = result.passed.length;
+        const warnings = result.warnings.length;
+        const errors = result.errors.length;
+        const level = errors > 0 ? 'error' : warnings > 0 ? 'warn' : 'pass';
+        return { checks: passed + warnings + errors, passed, warnings, errors, level };
+    }
+    catch (err) {
+        return {
+            checks: 0,
+            passed: 0,
+            warnings: 0,
+            errors: 0,
+            level: 'error',
+            fatal: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/** 랜딩 코드 블록용 routes.ts 원문. web 앱 우선, 없으면 첫 앱. 실패는 null. */
+function readRoutesSource(ctx) {
+    const web = ctx.apps.find((a) => a.name === 'web') ?? ctx.apps[0];
+    if (!web)
+        return null;
+    const path = join(web.dir, 'routes.ts');
+    try {
+        return { path: `apps/${web.name}/routes.ts`, source: readFileSync(path, 'utf8') };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 라이브 헬스 스냅샷을 계산한다. 순수 조회(부작용 없음) — 각 프로브는 독립
+ * try/catch 라 하나가 실패해도 전체가 죽지 않는다.
+ */
+export async function computeHealth(ctx) {
+    const [database, hub, doctor] = await Promise.all([
+        probeDatabase(ctx.config),
+        probeHub(ctx.config, ctx.nats),
+        probeDoctor(ctx.cwd),
+    ]);
+    const web = {
+        host: ctx.host,
+        port: ctx.port,
+        node: process.version,
+        gaonjs: VERSION,
+        apps: ctx.apps.map((a) => ({ name: a.name, prefix: prefixFor(a.name) })),
+    };
+    const ok = doctor.level !== 'error' &&
+        (database.configured === false || database.connected) &&
+        (hub.configured === false || hub.connected);
+    return { ok, env: process.env.NODE_ENV ?? 'development', web, database, hub, doctor, routes: readRoutesSource(ctx) };
+}
+/** dev 전용 진단 라우트 경로. serve(--dev)가 이 경로에 computeHealth 를 건다. */
+export const DEV_HEALTH_PATH = '/_gaon/health';

package/dist/doctor.d.ts

@@ -52,6 +52,18 @@ export interface DoctorFixReport {
     /** 실제로 편집이 일어났는지(--yes 여부). */
     readonly applied: boolean;
 }
+/**
+ * doctor 검사를 실행해 결과만 반환한다 — **stdout 에 아무것도 쓰지 않는다.**
+ * runDoctorCommand 는 CLI 진입점이라 결과를 stdout 으로 흘리지만, 프로그램에서
+ * (예: dev 헬스 엔드포인트가) 결과가 필요할 때는 이 함수를 쓴다.
+ *
+ * fatal(프로젝트 아님 · TS API 없음)도 write 없이 DoctorResult.fatal 로 담아
+ * 반환한다. --fix 는 다루지 않는다(읽기 전용).
+ */
+export declare function computeDoctorResult(opts?: {
+    readonly cwd?: string;
+    readonly checks?: readonly DoctorRule[];
+}): Promise<DoctorResult>;
 /**
  * `gaon doctor` 진입점 (M9-E · 확장 · M9-E-Fix 하드닝).
  *

package/dist/doctor.js

@@ -92,6 +92,55 @@ const CHECKERS = {
     'page-filename': checkPageFilename,
     'auth-wiring': checkAuthWiring,
 };
+/**
+ * 규칙을 순서대로 실행해 RuleReport[] 를 낸다. 규칙 하나가 크래시해도 나머지는
+ * 계속 — 그 규칙만 error 리포트로 대체한다(부분 결과 확보).
+ */
+async function runRules(root, rules) {
+    const reports = [];
+    for (const rule of rules) {
+        const fn = CHECKERS[rule];
+        try {
+            reports.push(await fn(root));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            reports.push({
+                rule,
+                issues: [
+                    {
+                        rule,
+                        level: 'error',
+                        message: `${rule} 검사 중 예외 발생: ${msg}\n` +
+                            `→ 나머지 규칙만 임시로 실행하려면 '--check=<다른 규칙>' 를 쓰세요.`,
+                        detail: { thrown: msg },
+                    },
+                ],
+            });
+        }
+    }
+    return reports;
+}
+/**
+ * doctor 검사를 실행해 결과만 반환한다 — **stdout 에 아무것도 쓰지 않는다.**
+ * runDoctorCommand 는 CLI 진입점이라 결과를 stdout 으로 흘리지만, 프로그램에서
+ * (예: dev 헬스 엔드포인트가) 결과가 필요할 때는 이 함수를 쓴다.
+ *
+ * fatal(프로젝트 아님 · TS API 없음)도 write 없이 DoctorResult.fatal 로 담아
+ * 반환한다. --fix 는 다루지 않는다(읽기 전용).
+ */
+export async function computeDoctorResult(opts = {}) {
+    const root = resolve(opts.cwd ?? process.cwd());
+    if (!detectProject(root)) {
+        return { passed: [], warnings: [], errors: [], fatal: fatalNoProject(root) };
+    }
+    if (!checkTypeScriptApi()) {
+        const installed = ts.version;
+        return { passed: [], warnings: [], errors: [], fatal: fatalTsApiMissing(installed) };
+    }
+    const rules = opts.checks && opts.checks.length ? opts.checks : ALL_RULES;
+    return makeResult(await runRules(root, rules));
+}
 /**
  * `gaon doctor` 진입점 (M9-E · 확장 · M9-E-Fix 하드닝).
  *
@@ -139,30 +188,7 @@ export async function runDoctorCommand(opts = {}) {
         return result;
     }
     const rules = opts.checks && opts.checks.length ? opts.checks : ALL_RULES;
-    const reports = [];
-    for (const rule of rules) {
-        const fn = CHECKERS[rule];
-        try {
-            reports.push(await fn(root));
-        }
-        catch (err) {
-            // 규칙 하나가 크래시해도 나머지 규칙 실행은 계속한다. 사용자는
-            // 크래시 대신 어느 규칙이 왜 실패했는지 안내받는다.
-            const msg = err instanceof Error ? err.message : String(err);
-            reports.push({
-                rule,
-                issues: [
-                    {
-                        rule,
-                        level: 'error',
-                        message: `${rule} 검사 중 예외 발생: ${msg}\n` +
-                            `→ 나머지 규칙만 임시로 실행하려면 '--check=<다른 규칙>' 를 쓰세요.`,
-                        detail: { thrown: msg },
-                    },
-                ],
-            });
-        }
-    }
+    const reports = await runRules(root, rules);
     const baseResult = makeResult(reports);
     // --fix 가 없으면 종전 동작 그대로.
     if (!opts.fix) {

package/dist/generate.js

@@ -32,8 +32,11 @@ const TEMPLATES = [
     { tpl: 'session.controller.ts.tpl', out: (a) => `apps/${a}/controllers/session.ts` },
     { tpl: 'registration.controller.ts.tpl', out: (a) => `apps/${a}/controllers/registration.ts` },
     { tpl: 'dashboard.controller.ts.tpl', out: (a) => `apps/${a}/controllers/dashboard.ts` },
-    { tpl: 'Login.vue.tpl', out: (a) => `apps/${a}/pages/auth/Login.vue` },
-    { tpl: 'Signup.vue.tpl', out: (a) => `apps/${a}/pages/auth/Signup.vue` },
+    // 결정 32·46: Vue 페이지 경로 세그먼트는 PascalCase(Route 이름) — 'Auth/'.
+    // examples/blog 정본과 page-filename doctor 규칙에 정합(소문자 'auth/' 는
+    // doctor 가 error 로 잡던 스캐폴드 표류였다 · W10 실측).
+    { tpl: 'Login.vue.tpl', out: (a) => `apps/${a}/pages/Auth/Login.vue` },
+    { tpl: 'Signup.vue.tpl', out: (a) => `apps/${a}/pages/Auth/Signup.vue` },
     { tpl: 'Dashboard.vue.tpl', out: (a) => `apps/${a}/pages/Dashboard.vue` },
     // 결정 59: 세션·인증 배선은 app.config.ts — 표준 부팅(gaon dev/serve = wireGaon)이
     // 소비한다. 과거의 수동 부팅 스캐폴드(app.ts·server.ts)는 두 번째 부팅 경로를

package/dist/index.d.ts

@@ -10,12 +10,13 @@ export { writeAuthScaffold, authScaffoldFiles, patchRoutes, runGenerateAuthComma
 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";
+export { computeHealth, DEV_HEALTH_PATH, type DevHealthContext, type GaonHealth, } from "./dev/health.js";
 export { runWorkCommand, type WorkCommandOptions } from "./work.js";
 export { runJobsCommand, type JobsCommandOptions } from "./jobs.js";
 export { runDbSeedCommand, loadSeed, type DbSeedOptions, type DbSeedResult } from "./db.js";
 export { runDbCommand, type DbSubcommand, type DbCommandOptions, } from "./commands/db.js";
 export { runDbDiff, runDbMigrate, runDbReset, resolveDbTarget, type DbDiffOptions, type DbDiffResult, type DbMigrateOptions, type DbMigrateResult, type DbResetOptions, type DbResetResult, type ResolveDbOptions, type ResolvedDbTarget, } from "./db/index.js";
-export { runDoctorCommand, runDoctor, runDoctorFix, renderFixHuman, inspectControllerSource, checkResponseMixing, checkNPlusOne, checkDependencyDirection, checkConnections, checkMigrationDiff, renderHuman, renderJson, type DoctorResult, type DoctorResultWithFix, type DoctorCheck, type DoctorLevel, type DoctorRule, type RuleReport, type DoctorIssue, type LegacyDoctorResult, type ActionUsage, type ResponseKind, type DoctorCommandOptions, type FixOutcome, type DoctorFixReport, } from "./doctor.js";
+export { runDoctorCommand, computeDoctorResult, runDoctor, runDoctorFix, renderFixHuman, inspectControllerSource, checkResponseMixing, checkNPlusOne, checkDependencyDirection, checkConnections, checkMigrationDiff, renderHuman, renderJson, type DoctorResult, type DoctorResultWithFix, type DoctorCheck, type DoctorLevel, type DoctorRule, type RuleReport, type DoctorIssue, type LegacyDoctorResult, type ActionUsage, type ResponseKind, type DoctorCommandOptions, type FixOutcome, type DoctorFixReport, } from "./doctor.js";
 export { FIXERS, FIXER_CAPABILITIES, fixDependencyDirection, fixDomainToSharedTypeOnly, type Fixer, type FixerCapability, type FixerPlan, } from "./doctor/fixers/index.js";
 export { loadDomain, type LoadedDomain } from "./domain.js";
 export interface RoadmapReport {

package/dist/index.js

@@ -36,12 +36,15 @@ export { writeAuthScaffold, authScaffoldFiles, patchRoutes, runGenerateAuthComma
 export { runGenerateCommand, planScaffold, parseGenerateArgs, } from "./commands/g.js";
 export { runHubCommand } from "./hub.js";
 export { runServeCommand } from "./serve.js";
+// dev 전용 라이브 헬스(결정 69). serve(--dev)가 등록하고, 브라우저 e2e 층이
+// serve --dev 를 재현하기 위해 재사용한다.
+export { computeHealth, DEV_HEALTH_PATH, } from "./dev/health.js";
 export { runWorkCommand } from "./work.js";
 export { runJobsCommand } from "./jobs.js";
 export { runDbSeedCommand, loadSeed } from "./db.js";
 export { runDbCommand, } from "./commands/db.js";
 export { runDbDiff, runDbMigrate, runDbReset, resolveDbTarget, } from "./db/index.js";
-export { runDoctorCommand, runDoctor, runDoctorFix, renderFixHuman, inspectControllerSource, checkResponseMixing, checkNPlusOne, checkDependencyDirection, checkConnections, checkMigrationDiff, renderHuman, renderJson, } from "./doctor.js";
+export { runDoctorCommand, computeDoctorResult, runDoctor, runDoctorFix, renderFixHuman, inspectControllerSource, checkResponseMixing, checkNPlusOne, checkDependencyDirection, checkConnections, checkMigrationDiff, renderHuman, renderJson, } from "./doctor.js";
 export { FIXERS, FIXER_CAPABILITIES, fixDependencyDirection, fixDomainToSharedTypeOnly, } from "./doctor/fixers/index.js";
 export { loadDomain } from "./domain.js";
 /** `--json` 출력용 구조화 리포트. */
@@ -191,7 +194,9 @@ export function runCli(argv, opts = {}) {
         const hostIdx = argv.indexOf("--host");
         const port = portIdx >= 0 ? Number(argv[portIdx + 1]) : undefined;
         const host = hostIdx >= 0 ? argv[hostIdx + 1] : undefined;
-        void runServeCommand({ json: argv.includes("--json"), port, host }).catch((err) => {
+        // --dev: dev 전용 진단 라우트(/_gaon/health) 등록. gaon dev 가 자식
+        // serve 에 넘긴다(결정 69 · dev-only by construction).
+        void runServeCommand({ json: argv.includes("--json"), port, host, dev: argv.includes("--dev") }).catch((err) => {
             const msg = err instanceof Error ? err.message : String(err);
             process.stderr.write(`  ✗ gaon serve 실패: ${msg}\n`);
             process.exitCode = 1;

package/dist/serve.d.ts

@@ -5,6 +5,12 @@ export interface ServeCommandOptions {
     readonly port?: number;
     /** 리슨 호스트. 우선순위: 옵션 > config.web.host > '0.0.0.0'. */
     readonly host?: string;
+    /**
+     * dev 모드(gaon dev 자식). true 면 dev 전용 진단 라우트(/_gaon/health)를
+     * 등록한다. 운영 serve 는 이 플래그 없이 실행되어 진단 라우트가 노출되지
+     * 않는다(결정 69 · dev-only by construction).
+     */
+    readonly dev?: boolean;
     /** 프로세스 시그널(테스트 주입). 기본 process. */
     readonly signals?: {
         on(sig: 'SIGINT' | 'SIGTERM', fn: () => void): void;

package/dist/serve.js

@@ -14,6 +14,7 @@
 import { loadDotEnv } from '@gaonjs/core';
 import { loadGaonConfig, wireGaon, findConfigPath } from '@gaonjs/config';
 import { registerTsResolve } from './tsResolve.js';
+import { computeHealth, DEV_HEALTH_PATH } from './dev/health.js';
 function humanEvent(e) {
     switch (e.kind) {
         case 'starting': {
@@ -54,6 +55,14 @@ export async function runServeCommand(opts = {}) {
     const port = opts.port ??
         config.web?.port ??
         (process.env.PORT ? Number(process.env.PORT) : 3000);
+    // dev 전용 진단 라우트(결정 69). listen 전에 등록한다 — 운영 serve 는
+    // opts.dev 가 없어 등록되지 않으므로 /_gaon/health 는 production 에 없다.
+    // wired.app 은 여기서 FastifyInstance 로 해상되므로(cli 는 fastify 타입을
+    // 직접 의존하지 않는다) 라우트 등록은 serve 층에서 인라인으로 한다.
+    if (opts.dev) {
+        const healthCtx = { cwd, config, apps: wired.apps, nats: wired.nats, port, host };
+        wired.app.get(DEV_HEALTH_PATH, async () => computeHealth(healthCtx));
+    }
     await wired.app.listen({ host, port });
     const displayHost = host === '0.0.0.0' ? 'localhost' : host;
     emit({ kind: 'listening', host, port, url: `http://${displayHost}:${port}` });

package/dist/templates/auth/registration.controller.ts.tpl

@@ -5,7 +5,7 @@ import { User } from '../../../domain/models/User.js'
 export default controller({
   // GET /registration/new — 회원가입 폼
   async new() {
-    return this.render('auth/Signup', { error: null as string | null, csrf: this.csrfToken() })
+    return this.render('Auth/Signup', { error: null as string | null, csrf: this.csrfToken() })
   },
   // POST /registration — 회원가입
   async create() {

package/dist/templates/auth/session.controller.ts.tpl

@@ -5,7 +5,7 @@ import { User } from '../../../domain/models/User.js'
 export default controller({
   // GET /session/new — 로그인 폼
   async new() {
-    return this.render('auth/Login', { error: null as string | null, csrf: this.csrfToken() })
+    return this.render('Auth/Login', { error: null as string | null, csrf: this.csrfToken() })
   },
   // POST /session — 로그인
   async create() {
@@ -16,7 +16,7 @@ export default controller({
       this.auth.login(user)
       return this.redirect('/dashboard')
     }
-    return this.render('auth/Login', {
+    return this.render('Auth/Login', {
       error: '이메일 또는 비밀번호가 올바르지 않습니다.' as string | null,
       csrf: this.csrfToken(),
     })

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

@@ -36,7 +36,7 @@ Gaon 프레임웍 문서: https://gaonjs.dev
 9. **실시간은 v1 포함**(§7): 웹서버 ↔ 허브는 TCP 지속 연결 · NATS 는
    broadcast 전용(errata E-2). 운영 프로세스는 serve·work·hub 3종.
 10. **인증·폼은 Inertia SPA**(§6 · SSR 아님). 로그인/회원가입은
-    `this.render('auth/Login')` + `Inertia.post()` → 서버 redirect.
+    `this.render('Auth/Login')` + `Inertia.post()` → 서버 redirect.
     REST + `fetch()` 는 API 앱(JWT) 전용.
 11. **컴포저블·레이아웃**(errata E-5): 컴포저블은 컴포넌트와 대칭
     (`apps/<앱>/composables/` + `shared/composables/`, `use` 접두사).

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

@@ -151,6 +151,24 @@ Nuxt 식 자동 import 는 넣지 않는다. 모든 컴포넌트·컴포저블
 import 한다. `gaon doctor` 의 **no-auto-import** 검사가 자동 import
 설정을 잡는다.
 
+### 7. 랜딩·라이브 헬스 (결정 69 · 70)
+
+`gaon new` 첫 화면(`apps/web/pages/Home/Index.vue`)은 라이브 상태 랜딩이다 — 다크
+헤더 레이아웃(`layouts/Default.vue`) + 실 상태 카드(WEB·DATABASE·HUB·DOCTOR) + 동적
+다음 단계 + 실 `routes.ts` 코드 블록. 상태는 **하드코딩하지 않는다** — dev 전용
+엔드포인트 `/_gaon/health` 를 컴포저블(`composables/useGaonHealth.ts`)로 읽어 바인딩한다.
+이 엔드포인트는 `gaon dev` 에서만 등록되고(운영 빌드엔 없음), 404 면 컴포저블이
+`available=false` 로 우아하게 degrade 한다.
+
+- **스타일은 SFC `<style scoped>` + CSS 변수** — 스캐폴드에 Tailwind 를 넣지
+  않는다(의존성 경량 · 결정 69). 유틸 클래스 대신 scoped CSS 로 캡슐화.
+- **auth 링크는 수동(결정 70)** — `gaon g auth` 는 auth 페이지·라우트만 신설하고
+  랜딩·레이아웃 nav 를 편집하지 않는다. 헤더에 로그인 링크를 두려면 `Default.vue`
+  의 nav 에 `<a href="/session/new">로그인</a>` 을 직접 추가한다(Rails 관례).
+- **auth 페이지 경로 = `pages/Auth/`(PascalCase)** — `gaon g auth` 는 `Auth/Login.vue`
+  ·`Auth/Signup.vue` 를 내고 컨트롤러는 `this.render('Auth/Login')` 로 부른다.
+  소문자 `auth/` 는 doctor page-filename 이 잡는다(결정 32·46).
+
 ## 정본 예시
 
 ```vue
@@ -203,4 +221,6 @@ async function runSearch(q: string) {
 | 결정 25 (E-5) | 컴포저블·레이아웃 관례 · 프론트 로직 배치 3규칙 · 자동 import 금지 |
 | 결정 37 | bigint PK 컨트롤러 `String()` 정규화 |
 | 결정 46 | doctor page-filename(페이지 PascalCase)·model/column 검사 3종 |
+| 결정 69 | 랜딩 정본(라이브 헬스 카드 · 다크 헤더 레이아웃 · Tailwind 미편입 · scoped CSS) |
+| 결정 70 | auth 통합 = 수동(`gaon g auth` 는 랜딩·nav 를 안 건드림 · Rails 관례) |
 | E-3 §C | 타입드 `api()` 클라이언트 (routes.d.ts 브리지 재사용) |

package/dist/templates/project/apps/web/composables/useGaonHealth.ts.tpl

@@ -0,0 +1,79 @@
+// useGaonHealth — 앱 전용 컴포저블(errata E-5 §2.1).
+// gaon dev 가 띄운 서버의 dev 전용 진단 엔드포인트(/_gaon/health)를 읽어
+// 랜딩(Home/Index.vue)의 라이브 상태 카드에 바인딩한다.
+//
+// dev-only: 이 엔드포인트는 gaon dev(= gaon serve --dev)에서만 등록된다.
+// 운영 빌드에는 없다 — 404 면 available=false 로 우아하게 degrade하고(카드가
+// "개발 서버에서만" 로 표시), 에러를 던지지 않는다.
+import { ref, onMounted } from 'vue'
+
+// 서버 응답(GaonHealth) 의 앱 쪽 미러. 서버 타입을 import 하지 않고(앱은 프레임웍
+// 내부 타입에 의존하지 않는다) 랜딩이 쓰는 필드만 선언한다.
+export interface HealthWeb {
+  host: string
+  port: number
+  node: string
+  gaonjs: string
+  apps: { name: string; prefix: string }[]
+}
+export interface HealthDatabase {
+  configured: boolean
+  connected?: boolean
+  adapter?: string
+  tables?: number
+  tableNames?: string[]
+  migrations?: number
+  error?: string
+}
+export interface HealthHub {
+  configured: boolean
+  connected?: boolean
+  streams?: { stream: string; waiting: number | null }[]
+  error?: string
+}
+export interface HealthDoctor {
+  checks: number
+  passed: number
+  warnings: number
+  errors: number
+  level: 'pass' | 'warn' | 'error'
+  fatal?: string
+}
+export interface GaonHealth {
+  ok: boolean
+  env: string
+  web: HealthWeb
+  database: HealthDatabase
+  hub: HealthHub
+  doctor: HealthDoctor
+  routes: { path: string; source: string } | null
+}
+
+export function useGaonHealth() {
+  const health = ref<GaonHealth | null>(null)
+  const loading = ref(true)
+  // 엔드포인트가 있는가(= dev 서버인가). 운영 빌드에선 false 로 남는다.
+  const available = ref(false)
+
+  async function load(): Promise<void> {
+    loading.value = true
+    try {
+      const res = await fetch('/_gaon/health', { headers: { Accept: 'application/json' } })
+      if (!res.ok) {
+        available.value = false
+        return
+      }
+      health.value = (await res.json()) as GaonHealth
+      available.value = true
+    } catch {
+      // 네트워크·파싱 실패 = 진단 불가. 랜딩은 정적 안내로 degrade.
+      available.value = false
+    } finally {
+      loading.value = false
+    }
+  }
+
+  onMounted(load)
+
+  return { health, loading, available, reload: load }
+}

package/dist/templates/project/apps/web/layouts/Default.vue.tpl

@@ -5,39 +5,115 @@
 //
 // 레이아웃은 shared 에 두지 않는다(E-5 §2.3) — 앱마다 레이아웃이 다른 것이
 // 정상이고, 공용 조각(로고·푸터 등) 만 shared/components 로 뽑는다.
+//
+// 다크 헤더 + 라이트 본문(결정 69). 버전은 스캐폴드 시점 gaonjs 버전이 박힌다.
+//
+// 결정 70(auth = 수동): gaon g auth 는 이 nav 를 건드리지 않는다. 로그인 링크를
+// 헤더에 두려면 아래 nav 에 <a href="/session/new">로그인</a> 을 직접 추가한다.
+
+// package.json 의 gaonjs 의존 범위(예: ^0.9.2)에서 캐럿·틸드를 벗겨 표기.
+const version = '{{GAONJS_VERSION}}'.replace(/^[\^~]/, '')
 </script>
 
 <template>
-  <div class="layout">
-    <header class="layout-header">
-      <strong>{{PROJECT_NAME}}</strong>
+  <div class="gaon-layout">
+    <header class="gaon-header">
+      <a class="gaon-brand" href="/">
+        <span class="gaon-brand-mark">가온</span>
+        <span class="gaon-brand-word">GAONJS</span>
+        <span class="gaon-brand-ver">v{{ version }}</span>
+      </a>
+      <nav class="gaon-nav">
+        <a href="https://gaonjs.dev" target="_blank" rel="noreferrer">문서</a>
+        <a href="https://github.com/gaonjs" target="_blank" rel="noreferrer">GitHub</a>
+      </nav>
     </header>
-    <slot />
-    <footer class="layout-footer">
-      <small>Powered by <a href="https://gaonjs.dev" target="_blank">Gaon</a></small>
+
+    <main class="gaon-main">
+      <slot />
+    </main>
+
+    <footer class="gaon-footer">
+      <small>{{PROJECT_NAME}} · Powered by
+        <a href="https://gaonjs.dev" target="_blank" rel="noreferrer">Gaon</a></small>
     </footer>
   </div>
 </template>
 
 <style scoped>
-.layout {
+.gaon-layout {
   min-height: 100vh;
   display: flex;
   flex-direction: column;
+  background: #ffffff;
+  color: #1b1f24;
+  font-family: system-ui, -apple-system, 'Segoe UI', sans-serif;
+}
+
+/* 다크 헤더 — 본문 테마와 무관하게 브랜드 바는 어둡게. */
+.gaon-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 0.85rem 1.5rem;
+  background: #0d1117;
+  color: #e6edf3;
+  border-bottom: 1px solid #21262d;
+}
+.gaon-brand {
+  display: inline-flex;
+  align-items: baseline;
+  gap: 0.55rem;
+  text-decoration: none;
+  color: inherit;
 }
-.layout-header,
-.layout-footer {
-  padding: 1rem;
-  background: #f6f8fa;
-  border-color: #e1e4e8;
+.gaon-brand-mark {
+  display: inline-block;
+  padding: 0.15rem 0.45rem;
+  border-radius: 6px;
+  background: linear-gradient(135deg, #4f8cff, #7c5cff);
+  color: #fff;
+  font-weight: 700;
+  font-size: 0.8rem;
+  letter-spacing: 0.02em;
 }
-.layout-header {
-  border-bottom: 1px solid #e1e4e8;
+.gaon-brand-word {
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  font-size: 0.95rem;
 }
-.layout-footer {
-  border-top: 1px solid #e1e4e8;
-  margin-top: auto;
+.gaon-brand-ver {
+  font-size: 0.72rem;
+  color: #8b949e;
+  font-variant-numeric: tabular-nums;
+}
+.gaon-nav {
+  display: flex;
+  gap: 1.1rem;
+  font-size: 0.85rem;
+}
+.gaon-nav a {
+  color: #c9d1d9;
+  text-decoration: none;
+}
+.gaon-nav a:hover {
+  color: #fff;
+}
+
+.gaon-main {
+  flex: 1;
+  width: 100%;
+}
+
+.gaon-footer {
+  padding: 1.25rem 1.5rem;
   text-align: center;
   color: #6a737d;
+  border-top: 1px solid #eaecef;
+}
+.gaon-footer a {
+  color: #4f8cff;
+  text-decoration: none;
 }
 </style>

package/dist/templates/project/apps/web/pages/Home/Index.vue.tpl

@@ -1,36 +1,419 @@
 <script setup lang="ts">
+import { computed } from 'vue'
 import { pageProps } from 'gaonjs/vue'
+import { useGaonHealth, type HealthDoctor } from '../../composables/useGaonHealth.js'
 
 // home#index 의 render props — Serialized<> 로 넘어온다(§6.2).
 // 라우트 키는 .gaon/routes.d.ts 가 유효한 값을 알려준다.
 const props = pageProps<'web:home#index'>()
+
+// 라이브 상태(dev 전용 /_gaon/health). 운영 빌드에선 available=false 로 degrade.
+const { health, loading, available } = useGaonHealth()
+
+type CardStatus = 'ok' | 'warn' | 'error' | 'idle'
+interface Card {
+  readonly key: string
+  readonly title: string
+  readonly status: CardStatus
+  readonly headline: string
+  readonly lines: readonly string[]
+}
+
+function doctorNote(d: HealthDoctor | undefined): string {
+  if (!d) return '—'
+  if (d.fatal) return `검사 불가 (${d.fatal})`
+  return `${d.passed} 통과 · ${d.warnings} 경고 · ${d.errors} 오류`
+}
+
+const cards = computed<Card[]>(() => {
+  const h = health.value
+  const web = h?.web
+  const db = h?.database
+  const hub = h?.hub
+  const doc = h?.doctor
+
+  const webCard: Card = {
+    key: 'web',
+    title: 'WEB',
+    status: available.value ? 'ok' : 'idle',
+    headline: web ? `:${web.port}` : '대기',
+    lines: web
+      ? [`Node ${web.node}`, `gaonjs v${web.gaonjs}`, `앱 ${web.apps.map((a) => a.name).join(', ')}`]
+      : ['개발 서버에서만'],
+  }
+
+  const dbCard: Card = {
+    key: 'database',
+    title: 'DATABASE',
+    status: !db || !db.configured ? 'idle' : db.connected ? 'ok' : 'error',
+    headline: !db || !db.configured ? '미설정' : db.connected ? '연결됨' : '미연결',
+    lines:
+      db && db.configured
+        ? db.connected
+          ? [`${db.adapter ?? 'postgres'}`, `테이블 ${db.tables ?? 0}개`, `마이그레이션 ${db.migrations ?? 0}건`]
+          : [db.error ?? '연결 실패', '.env DATABASE_URL 확인']
+        : ['.env 에 DATABASE_URL', 'gaon.config.ts 에서 켜기'],
+  }
+
+  const hubCard: Card = {
+    key: 'hub',
+    title: 'HUB',
+    status: !hub || !hub.configured ? 'idle' : hub.connected ? 'ok' : 'error',
+    headline: !hub || !hub.configured ? '미설정' : hub.connected ? '연결됨' : '미연결',
+    lines:
+      hub && hub.configured
+        ? hub.connected
+          ? (hub.streams ?? []).map((s) => `${s.stream}: ${s.waiting === null ? '대기 없음' : `${s.waiting} 대기`}`)
+          : [hub.error ?? 'NATS 미연결']
+        : ['.env 에 NATS_URL', '실시간·비동기 백본'],
+  }
+
+  const doctorCard: Card = {
+    key: 'doctor',
+    title: 'DOCTOR',
+    status: !doc ? 'idle' : doc.level === 'pass' ? 'ok' : doc.level === 'warn' ? 'warn' : 'error',
+    headline: !doc
+      ? '대기'
+      : doc.fatal
+        ? '검사 불가'
+        : doc.errors > 0
+          ? `오류 ${doc.errors}`
+          : doc.warnings > 0
+            ? `경고 ${doc.warnings}`
+            : '통과',
+    lines: [doctorNote(doc), 'gaon check 로 재실행'],
+  }
+
+  return [webCard, dbCard, hubCard, doctorCard]
+})
+
+// 다음 단계 — 라이브 상태에서 완료 여부를 파생한다.
+interface Step {
+  readonly label: string
+  readonly cmd: string
+  readonly done: boolean
+  readonly note: string
+}
+const steps = computed<Step[]>(() => {
+  const h = health.value
+  const db = h?.database
+  const configured = !!(db && db.configured)
+  const connected = !!(db && db.configured && db.connected)
+  const tables = configured ? db!.tables ?? 0 : 0
+  return [
+    {
+      label: '개발 스택 부팅',
+      cmd: 'gaon dev',
+      done: available.value,
+      note: 'Docker · .gaon 타입 브리지 · 서버 · watch',
+    },
+    {
+      label: '데이터베이스 연결',
+      cmd: configured ? 'gaon db migrate' : '.env: DATABASE_URL',
+      done: connected,
+      note: configured ? (connected ? '연결됨' : '설정됨 · 미연결') : '미설정',
+    },
+    {
+      label: '첫 모델 만들기',
+      cmd: 'gaon g model Post',
+      done: tables > 0,
+      note: tables > 0 ? `테이블 ${tables}개` : '스키마 + 모델 (E-4)',
+    },
+    {
+      label: '인증 배터리',
+      cmd: 'gaon g auth',
+      done: false,
+      note: '가입 · 로그인 · 세션 (수동 통합 · 결정 70)',
+    },
+    {
+      label: '검사 통과',
+      cmd: 'gaon check',
+      done: h?.doctor.level === 'pass',
+      note: doctorNote(h?.doctor),
+    },
+  ]
+})
+
+// routes.ts 코드 블록 — 라이브 원문을 줄 단위로 나누고 주석만 가볍게 색을 준다.
+// v-html 없이(텍스트 보간만) 안전하게 그린다. 의존성 없는 최소 하이라이트.
+interface CodeLine {
+  readonly code: string
+  readonly comment: string
+}
+function splitComment(line: string): CodeLine {
+  const m = line.match(/\s\/\/.*$/)
+  if (m && m.index !== undefined) return { code: line.slice(0, m.index), comment: line.slice(m.index) }
+  if (line.trimStart().startsWith('//')) return { code: '', comment: line }
+  return { code: line, comment: '' }
+}
+const routesPath = computed(() => health.value?.routes?.path ?? 'apps/web/routes.ts')
+const routeLines = computed<CodeLine[]>(() => {
+  const src = health.value?.routes?.source
+  if (!src) return []
+  return src.replace(/\n+$/, '').split('\n').map(splitComment)
+})
 </script>
 
 <template>
-  <main class="home">
-    <h1>{{ props.title }}</h1>
-    <p>Gaon 프레임웍이 방금 이 앱을 만들었습니다.</p>
-    <p>
-      문서: <a :href="props.docs" target="_blank">{{ props.docs }}</a>
+  <div class="landing">
+    <section class="hero">
+      <p class="eyebrow">{{ props.title }}</p>
+      <h1>가온에 올라탔습니다.</h1>
+      <p class="lede">
+        이 화면은 <code>apps/web/pages/Home/Index.vue</code> 입니다.
+        <code>routes.ts</code> 의 <code>r.get('/', 'home#index')</code> 가 여기로 연결했습니다.
+      </p>
+      <p class="lede sub">
+        아래 카드는 지금 이 서버의 <strong>실제 상태</strong>입니다 —
+        하드코딩이 아니라 <code>/_gaon/health</code> 를 읽어 그립니다.
+        <a :href="props.docs" target="_blank" rel="noreferrer">{{ props.docs }}</a>
+      </p>
+    </section>
+
+    <section class="cards" aria-label="프레임웍 상태">
+      <article v-for="c in cards" :key="c.key" class="card" :class="`is-${c.status}`">
+        <header class="card-top">
+          <span class="dot" :class="`dot-${c.status}`" aria-hidden="true"></span>
+          <span class="card-title">{{ c.title }}</span>
+        </header>
+        <p class="card-headline">{{ c.headline }}</p>
+        <ul class="card-lines">
+          <li v-for="(ln, i) in c.lines" :key="i">{{ ln }}</li>
+        </ul>
+      </article>
+    </section>
+
+    <p v-if="loading" class="hint">상태 확인 중…</p>
+    <p v-else-if="!available" class="hint">
+      라이브 상태는 <code>gaon dev</code> 개발 서버에서만 보입니다(운영 빌드엔 진단 엔드포인트가 없습니다).
     </p>
-    <hr />
-    <h2>다음 단계</h2>
-    <ol>
-      <li><code>gaon g auth</code> — 인증 스캐폴드 생성 (회원가입·로그인·세션)</li>
-      <li><code>gaon g model Post</code> — 모델 스캐폴드 (스키마 + 모델 · E-4)</li>
-      <li><code>gaon g controller posts</code> — 컨트롤러 스캐폴드</li>
-      <li><code>gaon g page Posts/Index</code> — Vue 페이지 (Inertia SPA)</li>
-      <li><code>gaon dev</code> — Docker 자동 기동 · 타입 브리지 · watch</li>
-    </ol>
-  </main>
+
+    <section class="next">
+      <h2>다음 단계</h2>
+      <ul class="steps">
+        <li v-for="s in steps" :key="s.label" :class="{ done: s.done }">
+          <span class="check" aria-hidden="true">{{ s.done ? '✓' : '○' }}</span>
+          <div class="step-body">
+            <div class="step-head">
+              <span class="step-label">{{ s.label }}</span>
+              <code class="step-cmd">{{ s.cmd }}</code>
+            </div>
+            <span class="step-note">{{ s.note }}</span>
+          </div>
+        </li>
+      </ul>
+    </section>
+
+    <section v-if="routeLines.length" class="code">
+      <div class="code-head">{{ routesPath }}</div>
+      <pre class="code-body"><code><span v-for="(ln, i) in routeLines" :key="i" class="code-line"><span class="c-code">{{ ln.code }}</span><span class="c-comment">{{ ln.comment }}</span>{{ '\n' }}</span></code></pre>
+    </section>
+  </div>
 </template>
 
 <style scoped>
-.home {
-  max-width: 640px;
-  margin: 4rem auto;
-  padding: 0 1rem;
-  font-family: system-ui, -apple-system, sans-serif;
+.landing {
+  max-width: 880px;
+  margin: 0 auto;
+  padding: 3rem 1.25rem 4rem;
+  color: #1b1f24;
   line-height: 1.6;
 }
+
+.hero {
+  margin-bottom: 2.5rem;
+}
+.eyebrow {
+  margin: 0 0 0.4rem;
+  font-size: 0.8rem;
+  font-weight: 600;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: #7c5cff;
+}
+.hero h1 {
+  margin: 0 0 0.9rem;
+  font-size: clamp(2rem, 5vw, 2.9rem);
+  line-height: 1.15;
+  letter-spacing: -0.02em;
+}
+.lede {
+  margin: 0.35rem 0;
+  color: #3a424c;
+  font-size: 1.02rem;
+}
+.lede.sub {
+  color: #57606a;
+  font-size: 0.95rem;
+}
+.lede a {
+  color: #4f8cff;
+}
+code {
+  font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, monospace;
+  font-size: 0.86em;
+  background: #f2f4f7;
+  padding: 0.1rem 0.35rem;
+  border-radius: 5px;
+}
+
+.cards {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+  gap: 1rem;
+  margin-bottom: 1rem;
+}
+.card {
+  border: 1px solid #e4e7eb;
+  border-radius: 12px;
+  padding: 1.1rem 1.15rem;
+  background: #fff;
+  box-shadow: 0 1px 2px rgba(16, 22, 26, 0.04);
+}
+.card-top {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 0.6rem;
+}
+.card-title {
+  font-size: 0.74rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  color: #6a737d;
+}
+.dot {
+  width: 9px;
+  height: 9px;
+  border-radius: 50%;
+  background: #c2c8cf;
+}
+.dot-ok {
+  background: #2da44e;
+  box-shadow: 0 0 0 3px rgba(45, 164, 78, 0.15);
+}
+.dot-warn {
+  background: #d4a72c;
+  box-shadow: 0 0 0 3px rgba(212, 167, 44, 0.15);
+}
+.dot-error {
+  background: #cf222e;
+  box-shadow: 0 0 0 3px rgba(207, 34, 46, 0.15);
+}
+.card-headline {
+  margin: 0 0 0.5rem;
+  font-size: 1.35rem;
+  font-weight: 700;
+  letter-spacing: -0.01em;
+  font-variant-numeric: tabular-nums;
+}
+.card-lines {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  font-size: 0.82rem;
+  color: #57606a;
+}
+.card-lines li {
+  padding: 0.08rem 0;
+  overflow-wrap: anywhere;
+}
+
+.hint {
+  margin: 0.25rem 0 1.5rem;
+  font-size: 0.85rem;
+  color: #6a737d;
+}
+
+.next {
+  margin: 2.5rem 0;
+}
+.next h2 {
+  font-size: 1.15rem;
+  margin: 0 0 1rem;
+}
+.steps {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.35rem;
+}
+.steps li {
+  display: flex;
+  gap: 0.75rem;
+  align-items: flex-start;
+  padding: 0.65rem 0.85rem;
+  border: 1px solid #eaecef;
+  border-radius: 10px;
+  background: #fbfcfd;
+}
+.steps li.done {
+  border-color: #cbe7d3;
+  background: #f3faf5;
+}
+.check {
+  color: #b0b7bf;
+  font-weight: 700;
+  line-height: 1.5;
+}
+.steps li.done .check {
+  color: #2da44e;
+}
+.step-body {
+  flex: 1;
+  min-width: 0;
+}
+.step-head {
+  display: flex;
+  align-items: center;
+  gap: 0.6rem;
+  flex-wrap: wrap;
+}
+.step-label {
+  font-weight: 600;
+}
+.step-cmd {
+  background: #0d1117;
+  color: #e6edf3;
+}
+.step-note {
+  display: block;
+  font-size: 0.8rem;
+  color: #6a737d;
+  margin-top: 0.15rem;
+}
+
+.code {
+  border: 1px solid #e4e7eb;
+  border-radius: 12px;
+  overflow: hidden;
+}
+.code-head {
+  padding: 0.55rem 1rem;
+  background: #f6f8fa;
+  border-bottom: 1px solid #e4e7eb;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 0.78rem;
+  color: #57606a;
+}
+.code-body {
+  margin: 0;
+  padding: 1rem 1.15rem;
+  overflow-x: auto;
+  background: #0d1117;
+  color: #c9d1d9;
+  font-size: 0.82rem;
+  line-height: 1.65;
+}
+.code-body code {
+  background: none;
+  padding: 0;
+  font-size: inherit;
+  color: inherit;
+}
+.c-comment {
+  color: #8b949e;
+}
 </style>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/cli",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Gaon CLI 구현: 제너레이터·스캐폴딩·로드맵 출력 (M1 스텁)",
   "type": "module",
   "license": "MIT",
@@ -27,11 +27,11 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "typescript": "^5.9.0",
     "vite": "^7.0.0",
-    "@gaonjs/async": "0.3.1",
-    "@gaonjs/config": "0.4.0",
-    "@gaonjs/web": "0.6.0",
-    "@gaonjs/data": "0.8.4",
+    "@gaonjs/async": "0.4.0",
+    "@gaonjs/web": "0.6.1",
+    "@gaonjs/config": "0.4.1",
     "@gaonjs/core": "0.2.0",
+    "@gaonjs/data": "0.8.4",
     "@gaonjs/mail": "0.1.1"
   },
   "scripts": {