@gaonjs/cli 0.35.0 → 0.36.0

package/dist/commands/check.d.ts

@@ -49,6 +49,15 @@ export interface CheckReport {
     readonly regen: CheckRegen;
     readonly steps: readonly CheckStepResult[];
 }
+/**
+ * 결정 170: 프로젝트가 선언한 패키지 매니저를 감지한다. `gaon new` 는
+ * package.json 의 `packageManager` 필드(corepack 핀 · 결정 169)에 선택 pm 을
+ * 기록하므로, `gaon check` 가 사용자 스크립트(예 build)를 돌릴 때 그 pm 으로
+ * 실행해야 한다 — pnpm 하드코딩은 npm/yarn 로 스캐폴드한 프로젝트에서 pnpm 이
+ * "This project is configured to use npm" 로 실행을 거부해 build 단계가 깨진다.
+ * 우선순위: packageManager 필드 → 락파일 → pnpm(기본).
+ */
+export declare function detectPackageManager(cwd: string): 'pnpm' | 'npm' | 'yarn';
 /**
  * `gaon check` 진입점. 검사 전에 .gaon 을 재생성(규칙 3)한 뒤 각 단계를
  * 순서대로 실행하고, 하나라도 실패하면 exit 1. --only 지정 시 그 단계만

package/dist/commands/check.js

@@ -2,15 +2,15 @@
  * @gaonjs/cli · `gaon check` — 통합 검증 (M9-G · v0.15 §13.5)
  *
  * 배포 · CI · AI 에이전트가 한 번에 신뢰할 수 있는 검사 묶음. 사용자의
- * package.json 관례를 그대로 재사용한다 — `pnpm typecheck` · `pnpm vue-tsc`
- * · `pnpm build`. 스크립트가 없으면 폴백으로 로컬 바이너리를 직접 부른다
- * (`node_modules/.bin/tsc --noEmit` · `node_modules/.bin/vue-tsc --noEmit`
- * · `pnpm -r build` → `npm run build`).
+ * package.json 스크립트를 그대로 재사용하되, **프로젝트 선언 pm** 으로 돌린다
+ * (결정 170 · `<pm> run <name>` — pnpm/npm/yarn). 스크립트가 없으면 폴백으로
+ * 로컬 바이너리를 직접 부른다(`node_modules/.bin/tsc --noEmit` ·
+ * `node_modules/.bin/vue-tsc --noEmit`).
  *
  * The One Way — 하나의 명령이 4 검사를 순서대로 돌린다(결정 157 · doctor 기본 포함):
- *   1) typecheck (pnpm typecheck 또는 tsc --noEmit)
- *   2) vue-tsc   (pnpm vue-tsc 또는 vue-tsc --noEmit)
- *   3) build     (pnpm build)
+ *   1) typecheck (<pm> run typecheck 또는 tsc --noEmit)
+ *   2) vue-tsc   (<pm> run vue-tsc 또는 vue-tsc --noEmit)
+ *   3) build     (<pm> run build)
  *   4) doctor    (기본 포함 · 규칙 5 등 doctor 규칙 · --no-doctor 로 뺌 · 코어 재사용)
  *
  * 옵션 최소:
@@ -54,6 +54,35 @@ function hasScript(cwd, name) {
 function binExists(cwd, name) {
     return existsSync(join(cwd, 'node_modules', '.bin', name));
 }
+/**
+ * 결정 170: 프로젝트가 선언한 패키지 매니저를 감지한다. `gaon new` 는
+ * package.json 의 `packageManager` 필드(corepack 핀 · 결정 169)에 선택 pm 을
+ * 기록하므로, `gaon check` 가 사용자 스크립트(예 build)를 돌릴 때 그 pm 으로
+ * 실행해야 한다 — pnpm 하드코딩은 npm/yarn 로 스캐폴드한 프로젝트에서 pnpm 이
+ * "This project is configured to use npm" 로 실행을 거부해 build 단계가 깨진다.
+ * 우선순위: packageManager 필드 → 락파일 → pnpm(기본).
+ */
+export function detectPackageManager(cwd) {
+    const pkgPath = join(cwd, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+            const pm = pkg.packageManager?.split('@')[0];
+            if (pm === 'pnpm' || pm === 'npm' || pm === 'yarn')
+                return pm;
+        }
+        catch {
+            // 파싱 실패는 락파일/기본으로 폴백
+        }
+    }
+    if (existsSync(join(cwd, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (existsSync(join(cwd, 'yarn.lock')))
+        return 'yarn';
+    if (existsSync(join(cwd, 'package-lock.json')))
+        return 'npm';
+    return 'pnpm';
+}
 /**
  * 단일 서브 프로세스를 spawn 해서 stdout+stderr 를 모으고 exit 코드를
  * 돌려준다. 실행 실패(파일 없음)는 exit 127 로 매핑.
@@ -77,7 +106,9 @@ async function runStep(step, cwd) {
     // 1) 사용자 스크립트가 정의돼 있으면 그걸 쓴다(한 곳에서 관리).
     const scriptName = step;
     if (hasScript(cwd, scriptName)) {
-        const cmd = 'pnpm';
+        // 결정 170: pnpm 하드코딩 대신 프로젝트 선언 pm 으로 실행(npm/yarn 스캐폴드
+        // 대응). `<pm> run <name>` 는 pnpm·npm·yarn(classic) 셋 다 동일하게 동작한다.
+        const cmd = detectPackageManager(cwd);
         const args = ['run', scriptName];
         const { exitCode, output } = await runSubprocess(cwd, cmd, args);
         // 결정 146(12차 W2): build 가 성공했으면 **등록된 앱마다** dist/<앱>/index.html 과

package/dist/commands/new.d.ts

@@ -8,7 +8,13 @@ export interface NewCommandOptions {
     readonly skipInstall?: boolean;
     /** git init · 첫 커밋 스킵(테스트·기존 git 저장소에 삽입). */
     readonly skipGit?: boolean;
-    /** 패키지 매니저. 기본 pnpm(모노레포 관례 정합). */
+    /**
+     * 초기 `install` 을 돌릴 패키지 매니저(`--package-manager <pm>` · 별칭 `--pm`).
+     * 기본 pnpm(모노레포 관례 정합). blessed 툴체인(Dockerfile·pnpm-workspace)은
+     * The One Way 로 pnpm 을 유지하지만, package.json 의 `packageManager` 필드는
+     * 선택한 pm 에 맞춰 적는다 — 항상 pnpm 을 적으면 `--pm yarn` 시 yarn 1.22
+     * corepack enforcement 가 install 을 거부한다(결정 169 · 167 개정).
+     */
     readonly packageManager?: 'pnpm' | 'npm' | 'yarn';
     /**
      * (테스트 훅) 템플릿의 gaonjs 의존성 버전. 미지정 시 파사드(gaonjs)

package/dist/commands/new.js

@@ -22,7 +22,7 @@ import { dirname, join, resolve } from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { readFileSync } from 'node:fs';
-import { renderProjectFiles } from '../templates/index.js';
+import { renderProjectFiles, PACKAGE_MANAGER_PINS, } from '../templates/index.js';
 import { writeUiKitScaffold } from '../uikit.js';
 import { regenerateProjectGaon } from './gen.js';
 /** 이름 유효성 — npm 패키지명 규칙(단순 부분)만 검사. */
@@ -172,7 +172,13 @@ export async function runNewCommand(name, opts = {}) {
     // 파일 생성 — 실패 시 부분 생성물이 남지 않도록 폴더를 정리하지는 않는다
     // (사용자가 원인 파악 후 rm -rf 로 지우도록). 정상 흐름에서는 문제 없음.
     const gaonjsVersion = opts.gaonjsVersion ?? detectGaonjsVersion();
-    const files = renderProjectFiles({ projectName: name, gaonjsVersion });
+    // 결정 169: packageManager 필드 = 선택한 pm 의 corepack 핀. 항상 pnpm 을
+    // 적던 옛 관례는 --pm yarn 시 yarn 1.22 corepack 이 install 을 거부시켰다.
+    const files = renderProjectFiles({
+        projectName: name,
+        gaonjsVersion,
+        packageManager: PACKAGE_MANAGER_PINS[pm],
+    });
     let filesCreated = 0;
     try {
         mkdirSync(root, { recursive: true });

package/dist/doctor.d.ts

@@ -24,6 +24,15 @@ export { usesLayoutBreakpoint, checkPageLayoutBreakpoint, } from './doctor/page-
 export { usesLinkButtonNesting, checkLinkButtonNesting, } from './doctor/link-button-nesting.js';
 export { renderHuman, renderJson } from './doctor/reporter.js';
 export { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, } from './doctor/setup.js';
+/**
+ * 실행할 검사 이름. 지정 없음(undefined) = 23개 모두.
+ */
+/**
+ * doctor 정적 검사 25종의 정본 목록(§2.2). `--check=` 필터의 인정 집합도
+ * 이 배열을 단일 출처로 삼는다(parseDoctorChecks) — 새 규칙 추가 시 여기만
+ * 늘리면 실행·필터·타입이 함께 정합된다(손유지 중복 리스트 표류 방지).
+ */
+export declare const ALL_RULES: readonly DoctorRule[];
 export interface DoctorCommandOptions {
     readonly cwd?: string;
     readonly json?: boolean;

package/dist/doctor.js

@@ -94,7 +94,12 @@ export { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, }
 /**
  * 실행할 검사 이름. 지정 없음(undefined) = 23개 모두.
  */
-const ALL_RULES = [
+/**
+ * doctor 정적 검사 25종의 정본 목록(§2.2). `--check=` 필터의 인정 집합도
+ * 이 배열을 단일 출처로 삼는다(parseDoctorChecks) — 새 규칙 추가 시 여기만
+ * 늘리면 실행·필터·타입이 함께 정합된다(손유지 중복 리스트 표류 방지).
+ */
+export const ALL_RULES = [
     'response-mixing',
     'n-plus-one',
     'dependency-direction',

package/dist/index.d.ts

@@ -53,5 +53,22 @@ export interface RunOptions {
  * 지정 없음(undefined) = 5 검사 모두 실행. 알 수 없는 이름은 무시(안전).
  */
 export declare function parseDoctorChecks(argv: readonly string[]): DoctorRule[] | undefined;
+/** `gaon new` argv 파싱 결과. name 부재·pm 오타를 호출부가 분기 처리한다. */
+export interface ParsedNewArgs {
+    /** 프로젝트 이름(첫 위치 인자). 부재 시 undefined. */
+    readonly name?: string;
+    /** 검증 통과한 패키지 매니저. 미지정 시 undefined(호출부가 pnpm 기본). */
+    readonly packageManager?: "pnpm" | "npm" | "yarn";
+    /** pm 값이 주어졌으나 pnpm·npm·yarn 이 아닐 때 그 원문(에러 안내용). */
+    readonly unknownPm?: string;
+}
+/**
+ * `gaon new <name>` 의 인자를 파싱한다.
+ * 패키지 매니저 플래그: `--package-manager <pm>`(정본) · `--pm <pm>`(별칭) ·
+ * 둘 다 `=` 형(`--package-manager=npm`)도 허용. 값을 취하는 플래그이므로
+ * 이름 위치 인자를 고를 때 그 값을 건너뛴다 — `gaon new --pm npm demo` 의
+ * npm 이 프로젝트 이름으로 오인되지 않도록(결정 167 · O-1 근본 fix).
+ */
+export declare function parseNewArgs(rest: readonly string[]): ParsedNewArgs;
 /** CLI 진입점. argv 는 실행 인자(process.argv.slice(2))를 받는다. */
 export declare function runCli(argv: readonly string[], opts?: RunOptions): void;

package/dist/index.js

@@ -26,7 +26,7 @@ import { runServeCommand } from "./serve.js";
 import { runWorkCommand } from "./work.js";
 import { runJobsCommand } from "./jobs.js";
 import { runDbCommand } from "./commands/db.js";
-import { runDoctorCommand } from "./doctor.js";
+import { runDoctorCommand, ALL_RULES } from "./doctor.js";
 import { runMcpCommand } from "./commands/mcp.js";
 export { startDev, resolveDevLayout, regenerateGaonOnce, } from "./dev.js";
 export { runDevCommand } from "./commands/dev.js";
@@ -95,7 +95,7 @@ function renderHelp(version = VERSION) {
         "",
         "  사용법:",
         "    gaon               로드맵과 개발 상태를 출력",
-        "    gaon new <name>    새 프로젝트 스캐폴드 (파일 → 설치 → git · --skip-install · --skip-git · --pm <이름>)",
+        "    gaon new <name>    새 프로젝트 스캐폴드 (파일 → 설치 → git · --skip-install · --skip-git · --package-manager <pnpm|npm|yarn>)",
         "    gaon dev           개발 스택 통합 (Docker · .gaon · serve · tsc/vue-tsc · 재시작 워처)",
         "    gaon dev --stop-docker  Ctrl+C 시 Docker Compose 도 down",
         "    gaon dev --no-watch|--no-tsc|--no-vue-tsc|--no-docker  개별 debug 옵션",
@@ -146,18 +146,10 @@ function renderHelp(version = VERSION) {
  * 지정 없음(undefined) = 5 검사 모두 실행. 알 수 없는 이름은 무시(안전).
  */
 export function parseDoctorChecks(argv) {
-    const known = [
-        "response-mixing",
-        "n-plus-one",
-        "dependency-direction",
-        "connections",
-        "migration-diff",
-        "shared-composable-purity",
-        "no-auto-import",
-        "csrf-wiring",
-        "async-offload",
-    ];
-    const isKnown = (s) => known.includes(s);
+    // 인정 집합은 doctor.ts 의 ALL_RULES(정본 25종)를 단일 출처로 쓴다 — 과거
+    // 손유지 9종 리스트가 뒤처져 --check=seal-security 같은 16종이 조용히 무시되고
+    // 전체 검사로 되돌아가던 표류를 근본 차단한다(결정 168).
+    const isKnown = (s) => ALL_RULES.includes(s);
     const out = [];
     for (const a of argv) {
         if (a.startsWith("--check=")) {
@@ -169,6 +161,41 @@ export function parseDoctorChecks(argv) {
     }
     return out.length ? out : undefined;
 }
+/**
+ * `gaon new <name>` 의 인자를 파싱한다.
+ * 패키지 매니저 플래그: `--package-manager <pm>`(정본) · `--pm <pm>`(별칭) ·
+ * 둘 다 `=` 형(`--package-manager=npm`)도 허용. 값을 취하는 플래그이므로
+ * 이름 위치 인자를 고를 때 그 값을 건너뛴다 — `gaon new --pm npm demo` 의
+ * npm 이 프로젝트 이름으로 오인되지 않도록(결정 167 · O-1 근본 fix).
+ */
+export function parseNewArgs(rest) {
+    let name;
+    let pmRaw;
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i];
+        if (a === "--package-manager" || a === "--pm") {
+            pmRaw = rest[++i];
+            continue;
+        }
+        const eqPrefix = a.startsWith("--package-manager=")
+            ? "--package-manager="
+            : a.startsWith("--pm=")
+                ? "--pm="
+                : undefined;
+        if (eqPrefix !== undefined) {
+            pmRaw = a.slice(eqPrefix.length);
+            continue;
+        }
+        if (a.startsWith("--"))
+            continue;
+        if (name === undefined)
+            name = a;
+    }
+    if (pmRaw === "pnpm" || pmRaw === "npm" || pmRaw === "yarn") {
+        return { name, packageManager: pmRaw };
+    }
+    return { name, unknownPm: pmRaw === undefined || pmRaw === "" ? undefined : pmRaw };
+}
 /** CLI 진입점. argv 는 실행 인자(process.argv.slice(2))를 받는다. */
 export function runCli(argv, opts = {}) {
     const version = opts.version ?? VERSION;
@@ -460,19 +487,23 @@ export function runCli(argv, opts = {}) {
     // `gaon new <name>` — 프로젝트 스캐폴드(M9-F). 파일 생성 → 의존성 설치 → git init.
     if (argv[0] === "new") {
         const rest = argv.slice(1);
-        let name;
-        for (const a of rest) {
-            if (!a.startsWith("--") && name === undefined)
-                name = a;
-        }
-        if (!name) {
+        const parsed = parseNewArgs(rest);
+        if (!parsed.name) {
             process.stderr.write("  ✗ gaon new: 프로젝트 이름이 없습니다.\n  → 예: gaon new demo\n");
             process.exitCode = 1;
             return;
         }
-        const pmIdx = rest.indexOf("--pm");
-        const pmRaw = pmIdx >= 0 ? rest[pmIdx + 1] : undefined;
-        const packageManager = pmRaw === "pnpm" || pmRaw === "npm" || pmRaw === "yarn" ? pmRaw : undefined;
+        // 알 수 없는 pm 값은 조용히 pnpm 으로 되돌리지 않고 사용자에게 알린다
+        // (에러가 곧 수리 안내서 · §7.5.3). 이전엔 무시돼 --package-manager npm 이
+        // pnpm 으로 설치되던 O-1 표류를 근본 차단한다(결정 167).
+        if (parsed.unknownPm !== undefined) {
+            process.stderr.write(`  ✗ gaon new: 알 수 없는 패키지 매니저 '${parsed.unknownPm}'.\n` +
+                `  → --package-manager 는 pnpm · npm · yarn 만 지원합니다(기본 pnpm).\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const name = parsed.name;
+        const packageManager = parsed.packageManager;
         void runNewCommand(name, {
             json: argv.includes("--json"),
             skipInstall: argv.includes("--skip-install"),

package/dist/templates/index.d.ts

@@ -7,7 +7,24 @@ export interface ProjectFile {
 export interface ProjectTemplateTokens {
     readonly projectName: string;
     readonly gaonjsVersion: string;
+    /**
+     * package.json 의 `packageManager` 필드(corepack 핀 · 예 `pnpm@10.27.0`).
+     * 미지정 시 blessed 기본 pnpm. 선택한 pm 에 맞춰 채운다(결정 169).
+     */
+    readonly packageManager?: string;
 }
+/**
+ * pm 별 `packageManager` 핀(corepack 형식 `<pm>@<x.y.z>`). 선택한 pm 을
+ * 그대로 적어 corepack enforcement 가 install 을 막지 않게 한다(결정 169 ·
+ * 12차 실사용 yarn 파손). 정본 버전 근거:
+ *  · pnpm@10.27.0 — blessed 툴체인(Dockerfile corepack·CI)과 정합.
+ *  · yarn@1.22.22 — yarn **classic** 최종 안정판. berry(2·4.x)는 `.yarnrc.yml`
+ *    없이 기본 PnP 라 node_modules 를 읽는 vite·gaon serve 를 깨므로 배제.
+ *  · npm@10.9.9 — engines.node≥22(Node 22 LTS) 동봉 npm 라인의 tip.
+ */
+export declare const PACKAGE_MANAGER_PINS: Readonly<Record<'pnpm' | 'npm' | 'yarn', string>>;
+/** blessed 기본(pm 미선택 시). */
+export declare const DEFAULT_PACKAGE_MANAGER: string;
 /** 템플릿 문자열의 {{TOKEN}} 을 치환한다. 알 수 없는 토큰은 그대로 둔다. */
 export declare function renderTemplate(raw: string, tokens: ProjectTemplateTokens): string;
 /** 템플릿 폴더를 재귀 스캔해 파일 목록을 만든다(POSIX 경로 · 정렬). */

package/dist/templates/index.js

@@ -12,11 +12,28 @@ import { readFileSync, readdirSync } from 'node:fs';
 import { dirname, join, posix, relative, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
 const TEMPLATE_DIR = join(dirname(fileURLToPath(import.meta.url)), 'project');
+/**
+ * pm 별 `packageManager` 핀(corepack 형식 `<pm>@<x.y.z>`). 선택한 pm 을
+ * 그대로 적어 corepack enforcement 가 install 을 막지 않게 한다(결정 169 ·
+ * 12차 실사용 yarn 파손). 정본 버전 근거:
+ *  · pnpm@10.27.0 — blessed 툴체인(Dockerfile corepack·CI)과 정합.
+ *  · yarn@1.22.22 — yarn **classic** 최종 안정판. berry(2·4.x)는 `.yarnrc.yml`
+ *    없이 기본 PnP 라 node_modules 를 읽는 vite·gaon serve 를 깨므로 배제.
+ *  · npm@10.9.9 — engines.node≥22(Node 22 LTS) 동봉 npm 라인의 tip.
+ */
+export const PACKAGE_MANAGER_PINS = {
+    pnpm: 'pnpm@10.27.0',
+    npm: 'npm@10.9.9',
+    yarn: 'yarn@1.22.22',
+};
+/** blessed 기본(pm 미선택 시). */
+export const DEFAULT_PACKAGE_MANAGER = PACKAGE_MANAGER_PINS.pnpm;
 /** 템플릿 문자열의 {{TOKEN}} 을 치환한다. 알 수 없는 토큰은 그대로 둔다. */
 export function renderTemplate(raw, tokens) {
     return raw
         .replaceAll('{{PROJECT_NAME}}', tokens.projectName)
-        .replaceAll('{{GAONJS_VERSION}}', tokens.gaonjsVersion);
+        .replaceAll('{{GAONJS_VERSION}}', tokens.gaonjsVersion)
+        .replaceAll('{{PACKAGE_MANAGER}}', tokens.packageManager ?? DEFAULT_PACKAGE_MANAGER);
 }
 /** 템플릿 폴더를 재귀 스캔해 파일 목록을 만든다(POSIX 경로 · 정렬). */
 export function listTemplateFiles(root = TEMPLATE_DIR) {

package/dist/templates/index.ts

@@ -23,15 +23,39 @@ export interface ProjectFile {
 export interface ProjectTemplateTokens {
   readonly projectName: string
   readonly gaonjsVersion: string
+  /**
+   * package.json 의 `packageManager` 필드(corepack 핀 · 예 `pnpm@10.27.0`).
+   * 미지정 시 blessed 기본 pnpm. 선택한 pm 에 맞춰 채운다(결정 169).
+   */
+  readonly packageManager?: string
 }
 
 const TEMPLATE_DIR = join(dirname(fileURLToPath(import.meta.url)), 'project')
 
+/**
+ * pm 별 `packageManager` 핀(corepack 형식 `<pm>@<x.y.z>`). 선택한 pm 을
+ * 그대로 적어 corepack enforcement 가 install 을 막지 않게 한다(결정 169 ·
+ * 12차 실사용 yarn 파손). 정본 버전 근거:
+ *  · pnpm@10.27.0 — blessed 툴체인(Dockerfile corepack·CI)과 정합.
+ *  · yarn@1.22.22 — yarn **classic** 최종 안정판. berry(2·4.x)는 `.yarnrc.yml`
+ *    없이 기본 PnP 라 node_modules 를 읽는 vite·gaon serve 를 깨므로 배제.
+ *  · npm@10.9.9 — engines.node≥22(Node 22 LTS) 동봉 npm 라인의 tip.
+ */
+export const PACKAGE_MANAGER_PINS: Readonly<Record<'pnpm' | 'npm' | 'yarn', string>> = {
+  pnpm: 'pnpm@10.27.0',
+  npm: 'npm@10.9.9',
+  yarn: 'yarn@1.22.22',
+}
+
+/** blessed 기본(pm 미선택 시). */
+export const DEFAULT_PACKAGE_MANAGER = PACKAGE_MANAGER_PINS.pnpm
+
 /** 템플릿 문자열의 {{TOKEN}} 을 치환한다. 알 수 없는 토큰은 그대로 둔다. */
 export function renderTemplate(raw: string, tokens: ProjectTemplateTokens): string {
   return raw
     .replaceAll('{{PROJECT_NAME}}', tokens.projectName)
     .replaceAll('{{GAONJS_VERSION}}', tokens.gaonjsVersion)
+    .replaceAll('{{PACKAGE_MANAGER}}', tokens.packageManager ?? DEFAULT_PACKAGE_MANAGER)
 }
 
 /** 템플릿 폴더를 재귀 스캔해 파일 목록을 만든다(POSIX 경로 · 정렬). */

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

@@ -195,7 +195,7 @@ Gaon 의 제1 설계 목표는 **"AI 가 개발을 가장 잘하는 프레임웍
 ```bash
 gaon check        # .gaon 재생성 → typecheck + vue-tsc + build + doctor (기본 포함 · --no-doctor 로 뺌 · 결정 157)
 gaon test         # vitest — DB·NATS 는 실 인프라 (agents/testing.md)
-gaon doctor       # 정적 검사 24종 (§2.2)
+gaon doctor       # 정적 검사 25종 (§2.2)
 ```
 
 ### 4.1 CLI 명령 (전 명령 `--json` 지원)

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

@@ -85,7 +85,7 @@ Gaon 프레임웍 문서: https://gaonjs.dev
 
 ```bash
 gaon check                        # .gaon 재생성 → 타입검사+build+doctor (CI 한 번에 · --no-doctor 로 doctor 뺌)
-gaon doctor                       # 정적 검사 24종 (상세 AGENTS §2.2)
+gaon doctor                       # 정적 검사 25종 (상세 AGENTS §2.2)
 npm test                          # Vitest · DB 테스트는 실 Docker 필수 (§9)
 ```
 

package/dist/templates/project/package.json.tpl

@@ -3,7 +3,7 @@
   "version": "0.1.0",
   "private": true,
   "type": "module",
-  "packageManager": "pnpm@10.27.0",
+  "packageManager": "{{PACKAGE_MANAGER}}",
   "engines": {
     "node": ">=22"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/cli",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "description": "Gaon CLI 구현: 제너레이터·스캐폴딩·로드맵 출력 (M1 스텁)",
   "type": "module",
   "license": "MIT",
@@ -27,13 +27,13 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "typescript": "^5.9.0",
     "vite": "^7.0.0",
-    "@gaonjs/config": "0.14.1",
-    "@gaonjs/data": "0.16.0",
     "@gaonjs/async": "0.11.0",
-    "@gaonjs/i18n": "0.2.0",
     "@gaonjs/mail": "0.2.0",
     "@gaonjs/core": "0.2.1",
-    "@gaonjs/web": "0.17.0"
+    "@gaonjs/config": "0.14.1",
+    "@gaonjs/i18n": "0.2.0",
+    "@gaonjs/web": "0.17.0",
+    "@gaonjs/data": "0.16.0"
   },
   "scripts": {
     "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json && node -e \"require('fs').cpSync('src/templates','dist/templates',{recursive:true})\""

package/dist/templates/auth/app.ts.tpl

@@ -1,29 +0,0 @@
-// 웹 앱 팩토리 — gaon g auth 스캐폴드. createWebApp 으로 세션·인증을 배선한다.
-import { createApp, type AppSessionOptions } from 'gaonjs/web'
-import appRoutes from './routes.js'
-import session from './controllers/session.js'
-import registration from './controllers/registration.js'
-import dashboard from './controllers/dashboard.js'
-import { loadUser } from './auth.js'
-
-export interface WebAppDeps {
-  /** 세션 설정 — { redisUrl, secret } (또는 redis 인스턴스). */
-  readonly session: AppSessionOptions
-  /** 서명 쿠키/CSRF 용 비밀. */
-  readonly cookieSecret?: string
-}
-
-export function createWebApp(deps: WebAppDeps) {
-  return createApp({
-    apps: [
-      {
-        name: '{{APP_NAME}}',
-        routes: appRoutes,
-        controllers: { session, registration, dashboard },
-        session: deps.session,
-        auth: { loadUser, loginRedirect: '/session/new' },
-      },
-    ],
-    cookieSecret: deps.cookieSecret,
-  })
-}

package/dist/templates/auth/server.ts.tpl

@@ -1,14 +0,0 @@
-// 서버 진입점 — gaon g auth 스캐폴드. `node dist/server.js` 로 실행.
-import { createWebApp } from './apps/{{APP_NAME}}/app.js'
-
-const app = await createWebApp({
-  session: {
-    redisUrl: process.env.REDIS_URL ?? 'redis://127.0.0.1:6379',
-    secret: process.env.SESSION_SECRET ?? 'change-me-to-a-32+char-random-secret!!',
-  },
-  cookieSecret: process.env.COOKIE_SECRET,
-})
-
-const port = Number(process.env.PORT ?? 3000)
-await app.listen({ port, host: '0.0.0.0' })
-console.log(`web 앱이 http://localhost:${port} 에서 실행 중입니다.`)