@gaonjs/cli 0.4.0 → 0.5.0

package/dist/commands/new.js

@@ -0,0 +1,274 @@
+// @gaonjs/cli · `gaon new <name>` — 프로젝트 스캐폴드 (M9-F).
+//
+// v0.15 §13.5 M9 완료 기준 "설치 후 첫 화면까지 60초" 를 만족시키기 위한
+// One Way. `gaon new demo` → cd demo → `gaon serve` → http://localhost:3000
+// 응답 이 전체 흐름의 목표. 60초 안에 이 왕복이 끝나야 한다.
+//
+// 관례(§2 · errata E-1 · E-3 · E-4 · E-5):
+//   · 폴더 배치: apps/<앱>/ + domain/ + shared/ (앱 밖에 domain)
+//   · 프론트: Vue + Inertia SPA (`gaonjs/vue`)
+//   · 인프라: docker-compose.yaml 5종(pg · redis · nats · mailpit · minio)
+//   · 컴포저블·레이아웃: E-5(apps/<앱>/composables + shared/composables, 대칭
+//     구조 · layouts/Default.vue 존재 시 자동 적용)
+//   · 자동 import 금지 — 모든 import 는 명시적으로(E-5 §2.4).
+//
+// 옵션은 최소로: --skip-install · --skip-git · --json · --package-manager.
+// The One Way — pnpm workspace monorepo · Vue · Inertia SPA · 5종 인프라.
+//
+// 이 파일은 파일 생성·설치·git init 만 담당하고, argv 파싱과 배선은
+// index.ts 가 통합한다(M9-F 는 편집 X — M1 이 통합 커밋).
+import { existsSync, mkdirSync, readdirSync, writeFileSync, } from 'node:fs';
+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';
+/** 이름 유효성 — npm 패키지명 규칙(단순 부분)만 검사. */
+function validateProjectName(name) {
+    if (!name)
+        throw new Error('프로젝트 이름이 비어 있습니다.');
+    if (name.includes('/') || name.includes('\\')) {
+        throw new Error(`프로젝트 이름에 '/' 또는 '\\\\' 는 사용할 수 없습니다: ${name}`);
+    }
+    if (name.includes('..')) {
+        throw new Error(`프로젝트 이름에 '..' 는 사용할 수 없습니다: ${name}`);
+    }
+    if (!/^[a-z0-9][a-z0-9_-]*$/i.test(name)) {
+        throw new Error(`프로젝트 이름은 영문/숫자/-/_ 로 시작해 같은 문자만 씁니다: ${name}\n` +
+            `  → 예: gaon new my-app · gaon new demo`);
+    }
+}
+/** 파사드(gaonjs) 패키지의 실 버전을 찾는다 — package.json 을 위로 훑는다. */
+function detectGaonjsVersion() {
+    // 가장 안전한 방법: 이 파일 위치를 기준으로 packages/gaonjs/package.json 을
+    // 상향 탐색. 개발 트리(src)와 배포 트리(dist) 모두에서 동작한다.
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 8; i++) {
+        const candidate = join(dir, '..', 'gaonjs', 'package.json');
+        if (existsSync(candidate)) {
+            try {
+                const raw = readFileSync(candidate, 'utf8');
+                const pkg = JSON.parse(raw);
+                if (typeof pkg.version === 'string')
+                    return `^${pkg.version}`;
+            }
+            catch {
+                /* fall through */
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // 발견 못 하면 최근 스텁 배포 라인의 안전 하한.
+    return '^0.5.0';
+}
+/** 대상 폴더가 비어 있는지(생성 대상으로 안전한지) 확인. */
+function isEmptyOrMissing(dir) {
+    if (!existsSync(dir))
+        return true;
+    try {
+        const entries = readdirSync(dir);
+        return entries.length === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** 파일 전체를 디스크에 쓴다. 이미 있으면 예외. */
+function writeAll(root, files) {
+    let count = 0;
+    for (const f of files) {
+        const abs = join(root, f.path);
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, f.contents, 'utf8');
+        count += 1;
+    }
+    return count;
+}
+/** 패키지 매니저 install 명령을 동기 실행. 반환값에 종료 코드·시간 포함.
+ *  json 모드에서는 stdout 을 완전 격리해 JSON 라인이 pnpm progress 로
+ *  오염되지 않도록 한다 — 파이프라인 파서 안전 정합. */
+function runInstall(root, pm, json) {
+    const args = ['install'];
+    const t0 = Date.now();
+    // stdio: json 모드에서는 stdout 을 ignore(우리 JSON 을 오염시키지 않게),
+    //        stderr 는 사용자에게 원인 진단이 필요할 수 있어 inherit.
+    //        human 모드에서는 모든 스트림을 inherit(사용자가 progress 를 본다).
+    const res = spawnSync(pm, args, {
+        cwd: root,
+        stdio: json ? ['ignore', 'ignore', 'inherit'] : 'inherit',
+        env: process.env,
+    });
+    const ms = Date.now() - t0;
+    if (res.error) {
+        process.stderr.write(`  ✗ ${pm} 을 찾지 못했습니다. → ${pm} 을 설치하거나 --skip-install 로 건너뛰세요.\n`);
+        return { code: -1, ms };
+    }
+    return { code: res.status, ms };
+}
+/** git init + 첫 커밋. git 이 없으면 조용히 스킵(로컬에 git 없이도 스캐폴드는 성공). */
+function runGitInit(root) {
+    const opts = { cwd: root, stdio: 'ignore', env: process.env };
+    const init = spawnSync('git', ['init', '--initial-branch=main'], opts);
+    if (init.error || init.status !== 0)
+        return { initialized: false, firstCommit: false };
+    spawnSync('git', ['add', '-A'], opts);
+    // 첫 커밋 — 사용자 git config 가 없어도 실패하지 않도록 -c 로 임시 identity 주입.
+    const commit = spawnSync('git', [
+        '-c',
+        'user.email=gaon@gaonjs.dev',
+        '-c',
+        'user.name=Gaon',
+        'commit',
+        '-m',
+        'chore: gaon new — initial scaffold',
+        '--no-gpg-sign',
+    ], opts);
+    return { initialized: true, firstCommit: commit.status === 0 };
+}
+/**
+ * `gaon new <name>` 실행. 파일 생성 → pnpm install → git init 순서.
+ * 각 단계는 옵션으로 스킵 가능. 반환값은 프로세스 종료 코드(0=성공).
+ */
+export async function runNewCommand(name, opts = {}) {
+    const t0 = Date.now();
+    const cwd = opts.cwd ?? process.cwd();
+    const pm = opts.packageManager ?? 'pnpm';
+    const json = opts.json ?? false;
+    const emitError = (msg, totalMs) => {
+        if (json) {
+            const result = {
+                ok: false,
+                project: name,
+                path: resolve(cwd, name),
+                filesCreated: 0,
+                install: { ran: false, skipped: true, packageManager: pm, durationMs: 0, exitCode: null },
+                git: { ran: false, skipped: true, initialized: false, firstCommit: false },
+                totalMs,
+                error: msg,
+            };
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        }
+        else {
+            process.stderr.write(`  ✗ gaon new: ${msg}\n`);
+        }
+        return 1;
+    };
+    try {
+        validateProjectName(name);
+    }
+    catch (err) {
+        return emitError(err instanceof Error ? err.message : String(err), Date.now() - t0);
+    }
+    const root = resolve(cwd, name);
+    if (!isEmptyOrMissing(root)) {
+        return emitError(`대상 폴더가 비어 있지 않습니다: ${root}\n` +
+            `  → 다른 이름을 쓰거나 폴더를 비운 뒤 다시 실행하세요.`, Date.now() - t0);
+    }
+    // 파일 생성 — 실패 시 부분 생성물이 남지 않도록 폴더를 정리하지는 않는다
+    // (사용자가 원인 파악 후 rm -rf 로 지우도록). 정상 흐름에서는 문제 없음.
+    const gaonjsVersion = opts.gaonjsVersion ?? detectGaonjsVersion();
+    const files = renderProjectFiles({ projectName: name, gaonjsVersion });
+    let filesCreated = 0;
+    try {
+        mkdirSync(root, { recursive: true });
+        filesCreated = writeAll(root, files);
+    }
+    catch (err) {
+        return emitError(`파일 생성 실패: ${err instanceof Error ? err.message : String(err)}`, Date.now() - t0);
+    }
+    // pnpm install (또는 npm/yarn) — 스킵 시 안내만.
+    const installReport = {
+        ran: false,
+        skipped: opts.skipInstall === true,
+        packageManager: pm,
+        durationMs: 0,
+        exitCode: null,
+    };
+    if (!opts.skipInstall) {
+        if (!json)
+            process.stdout.write(`\n  · 의존성 설치 (${pm} install) ...\n`);
+        const { code, ms } = runInstall(root, pm, json);
+        installReport.ran = true;
+        installReport.durationMs = ms;
+        installReport.exitCode = code;
+        if (code !== 0) {
+            // install 실패는 스캐폴드 자체 실패로 취급하지 않는다 — 파일은 이미
+            // 만들어졌으므로 사용자가 원인(레지스트리·네트워크) 확인 후 재시도 가능.
+            // 종료 코드는 실패로 반환(자동화 파이프라인 정합).
+            const total = Date.now() - t0;
+            if (json) {
+                const result = {
+                    ok: false,
+                    project: name,
+                    path: root,
+                    filesCreated,
+                    install: installReport,
+                    git: { ran: false, skipped: true, initialized: false, firstCommit: false },
+                    totalMs: total,
+                    error: `${pm} install 실패 (exit ${code})`,
+                };
+                process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+            }
+            else {
+                process.stderr.write(`  ✗ ${pm} install 이 실패했습니다 (exit ${code}).\n` +
+                    `  → 네트워크·레지스트리 상태를 확인한 뒤 ${root} 에서 다시 ${pm} install 을 실행하세요.\n`);
+            }
+            return 1;
+        }
+    }
+    // git init + 첫 커밋 — 스킵 시 그대로 넘어감.
+    const gitReport = { ran: false, skipped: opts.skipGit === true, initialized: false, firstCommit: false };
+    if (!opts.skipGit) {
+        if (!json)
+            process.stdout.write(`  · git 저장소 초기화 (git init + 첫 커밋) ...\n`);
+        const g = runGitInit(root);
+        gitReport.ran = true;
+        gitReport.initialized = g.initialized;
+        gitReport.firstCommit = g.firstCommit;
+    }
+    const totalMs = Date.now() - t0;
+    if (json) {
+        const result = {
+            ok: true,
+            project: name,
+            path: root,
+            filesCreated,
+            install: installReport,
+            git: gitReport,
+            totalMs,
+        };
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        return 0;
+    }
+    // 사람 모드 요약 — 다음 단계를 § 방향과 함께 안내(§7.5.3 원칙 정합).
+    const lines = [''];
+    lines.push(`  gaon new ${name} — 스캐폴드 완료 (${filesCreated}개 파일 · ${totalMs}ms)`);
+    lines.push('');
+    lines.push(`   폴더: ${root}`);
+    if (installReport.ran) {
+        lines.push(`   ${pm} install: ${installReport.exitCode === 0 ? '성공' : '실패'} (${installReport.durationMs}ms)`);
+    }
+    else {
+        lines.push(`   ${pm} install: 스킵 (--skip-install)`);
+    }
+    if (gitReport.ran) {
+        lines.push(`   git init: ${gitReport.initialized ? '완료' : '실패'} · 첫 커밋: ${gitReport.firstCommit ? '완료' : '실패(수동)'}`);
+    }
+    else {
+        lines.push(`   git init: 스킵 (--skip-git)`);
+    }
+    lines.push('');
+    lines.push('  다음 단계:');
+    lines.push(`   1) cd ${name}`);
+    lines.push('   2) cp .env.example .env       # 환경 변수 편집');
+    lines.push('   3) gaon dev                    # Docker + 타입 브리지 + serve 통합');
+    lines.push('   4) http://localhost:3000       # 홈 페이지 확인 (60초 실측 · v0.15 §13.5 M9)');
+    lines.push('');
+    lines.push('  문서: https://gaonjs.dev');
+    lines.push('');
+    process.stdout.write(lines.join('\n') + '\n');
+    return 0;
+}

package/dist/commands/test.d.ts

@@ -0,0 +1,11 @@
+export type TestScope = 'unit' | 'integration' | 'all';
+export interface TestCommandOptions {
+    readonly cwd?: string;
+    readonly json?: boolean;
+    readonly scope?: TestScope;
+}
+/**
+ * `gaon test` 진입점. args 는 사용자가 넘긴 잔여 인자(필터 문자열 등).
+ * pnpm test 는 pnpm 관례상 `pnpm test -- <args>` 로 넘겨야 vitest 까지 도달.
+ */
+export declare function runTestCommand(args?: readonly string[], opts?: TestCommandOptions): Promise<number>;

package/dist/commands/test.js

@@ -0,0 +1,119 @@
+/**
+ * @gaonjs/cli · `gaon test` — vitest wrapper (M9-G · v0.15 §13.5)
+ *
+ * The One Way — 하나의 명령이 vitest 를 얇게 감싼다. 사용자는
+ * `gaon test` 로 전체를, `gaon test posts` 로 필터를, `gaon test --unit`
+ * 으로 단위만 실행한다. 나머지는 전부 vitest 에 그대로 위임 — 우리가
+ * 관례를 재발명하지 않는다.
+ *
+ * 스코프 필터(§9 실 인프라 관례):
+ *   --unit         *.test.ts (통합 제외)
+ *   --integration  *.integration.test.ts 만
+ *   (기본)         둘 다 실행
+ *
+ * 실행 경로 우선순위:
+ *   1) 사용자 package.json 의 `test` 스크립트가 있으면 `pnpm test -- <args>`
+ *   2) 로컬 node_modules/.bin/vitest 가 있으면 직접 spawn(`run` 모드)
+ *   3) 둘 다 없으면 exit 127 + 설치 안내
+ *
+ * §9 실 인프라 · 목업 X — 실 vitest 프로세스를 spawn 한다.
+ * exit code · signal 은 vitest 그대로 propagate.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** 사용자 프로젝트에 `test` 스크립트가 있는지. */
+function hasTestScript(cwd) {
+    const pkgPath = join(cwd, 'package.json');
+    if (!existsSync(pkgPath))
+        return false;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        return typeof pkg.scripts?.test === 'string' && pkg.scripts.test.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 스코프 → vitest CLI 인자로 매핑. vitest 는 위치 인자를 파일 패턴으로
+ * 해석한다(맨 뒤에 붙는 값이 include 필터). --include 플래그는 vitest
+ * CLI 에 없다 — 그래서 unit 은 --exclude 로, integration 은 위치 인자
+ * 패턴으로 처리한다.
+ */
+function scopeArgs(scope) {
+    if (scope === 'unit') {
+        // 통합 테스트 제외 — vitest 의 --exclude 로 스킵.
+        return ['--exclude', '**/*.integration.test.ts'];
+    }
+    if (scope === 'integration') {
+        // integration 만 — 위치 인자 필터(파일 경로 substring 매칭).
+        return ['integration.test'];
+    }
+    return [];
+}
+/**
+ * `gaon test` 진입점. args 는 사용자가 넘긴 잔여 인자(필터 문자열 등).
+ * pnpm test 는 pnpm 관례상 `pnpm test -- <args>` 로 넘겨야 vitest 까지 도달.
+ */
+export async function runTestCommand(args = [], opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const scope = opts.scope ?? 'all';
+    const json = opts.json ?? false;
+    const scopeExtras = scopeArgs(scope);
+    const passthrough = [...scopeExtras, ...args];
+    let cmd;
+    let spawnArgs;
+    if (hasTestScript(cwd)) {
+        cmd = 'pnpm';
+        // pnpm test -- <extras> — `--` 로 뒤 인자를 스크립트에 전달.
+        spawnArgs = ['test', ...(passthrough.length ? ['--', ...passthrough] : [])];
+    }
+    else {
+        const vitestBin = join(cwd, 'node_modules', '.bin', 'vitest');
+        if (!existsSync(vitestBin)) {
+            const msg = `vitest 가 설치돼 있지 않고 package.json 에 "test" 스크립트도 없습니다.\n` +
+                `→ pnpm add -D vitest 후 다시 실행하거나, package.json 에 "test": "vitest run" 을 추가하세요.`;
+            if (json) {
+                process.stdout.write(JSON.stringify({ ok: false, error: msg }) + '\n');
+            }
+            else {
+                process.stderr.write(`  ✗ ${msg}\n`);
+            }
+            return 127;
+        }
+        cmd = vitestBin;
+        spawnArgs = ['run', ...passthrough];
+    }
+    if (json) {
+        process.stdout.write(JSON.stringify({ kind: 'starting', cmd, args: spawnArgs, scope }) + '\n');
+    }
+    else {
+        process.stdout.write(`  gaon test · ${cmd} ${spawnArgs.join(' ')} (scope=${scope})\n`);
+    }
+    const exitCode = await new Promise((resolvePromise) => {
+        const child = spawn(cmd, spawnArgs, {
+            cwd,
+            env: process.env,
+            // vitest 컬러 출력·리포터를 그대로 보여주기 위해 stdio 를 상속한다.
+            stdio: 'inherit',
+        });
+        child.on('error', (err) => {
+            process.stderr.write(`  ✗ gaon test spawn 실패: ${String(err)}\n`);
+            resolvePromise(127);
+        });
+        child.on('close', (code, signal) => {
+            if (signal) {
+                // SIGINT 등으로 종료된 경우 — 130(SIGINT) 관례.
+                resolvePromise(signal === 'SIGINT' ? 130 : 1);
+            }
+            else {
+                resolvePromise(code ?? 1);
+            }
+        });
+    });
+    if (json) {
+        process.stdout.write(JSON.stringify({ kind: 'exited', exitCode }) + '\n');
+    }
+    return exitCode;
+}

package/dist/doctor/no-auto-import.d.ts

@@ -0,0 +1,10 @@
+import type { DoctorCheck, RuleReport } from './types.js';
+/**
+ * config 파일 하나의 소스에서 자동 import 플러그인 import 를 잡는다
+ * (단위 테스트 진입점).
+ */
+export declare function inspectConfigForAutoImport(file: string, source: string, cwd: string): DoctorCheck[];
+/** package.json 안의 deps 4종을 훑어 자동 import 플러그인 유무를 낸다. */
+export declare function inspectPackageJson(file: string, source: string, cwd: string): DoctorCheck[];
+/** 프로젝트 루트를 훑어 자동 import 설정·의존을 잡는다. */
+export declare function checkNoAutoImport(cwd: string): Promise<RuleReport>;

package/dist/doctor/no-auto-import.js

@@ -0,0 +1,158 @@
+// @gaonjs/cli · doctor · 자동 import 감지 (M9-E 확장 · errata E-5 §2.4)
+//
+// Nuxt 식 자동 import(컴포넌트·컴포저블을 import 문 없이 사용)는 넣지
+// 않는다. 출처가 코드에 보이지 않는 마법은 AI 가 "이 심볼이 어디서
+// 왔는지"를 추측하게 만들어 v0.15 §1.2 (관례로 추측을 없앤다) 와 정면
+// 충돌한다. 모든 컴포넌트·컴포저블은 명시적으로 import 한다.
+//
+// 검사 대상 (E-5 §2.4 · v0.15 §1.2):
+//  1) 프로젝트 루트의 대표 config 파일 안의 import 선언에서
+//     'unplugin-auto-import' · 'unplugin-vue-components' · 'unimport'
+//     발견 시 error.
+//  2) package.json 의 dependencies · devDependencies · peerDependencies
+//     · optionalDependencies 에 위 3종이 있으면 error.
+//
+// 방법: config 는 TS AST 로 import 선언만 훑고 · package.json 은 JSON
+// 파싱 + 라인 검색(에러 메시지에 라인을 붙이기 위해 원문에서 재검색).
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import ts from 'typescript';
+/** 금지 플러그인 목록 — 자동 import 를 도입하는 대표 3종. */
+const FORBIDDEN_PLUGINS = [
+    'unplugin-auto-import',
+    'unplugin-vue-components',
+    'unimport',
+];
+/**
+ * 검사할 config 파일. Vite/Nuxt/Vue-CLI 관례 파일명을 모두 훑는다.
+ * 존재하지 않는 파일은 스킵.
+ */
+const CONFIG_FILES = [
+    'vite.config.ts',
+    'vite.config.js',
+    'vite.config.mjs',
+    'nuxt.config.ts',
+    'nuxt.config.js',
+    'vue.config.js',
+    'vue.config.ts',
+];
+/**
+ * config 파일 하나의 소스에서 자동 import 플러그인 import 를 잡는다
+ * (단위 테스트 진입점).
+ */
+export function inspectConfigForAutoImport(file, source, cwd) {
+    const issues = [];
+    const rel = relative(cwd, file);
+    const sf = ts.createSourceFile(file, source, ts.ScriptTarget.ES2022, true);
+    const visit = (node) => {
+        if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
+            const spec = node.moduleSpecifier.text;
+            const plugin = matchForbidden(spec);
+            if (plugin) {
+                const { line } = sf.getLineAndCharacterOfPosition(node.getStart(sf));
+                issues.push({
+                    rule: 'no-auto-import',
+                    level: 'error',
+                    file: rel,
+                    line: line + 1,
+                    message: `${rel} (line ${line + 1})\n` +
+                        `  '${plugin}' 발견 · v0.15 §1.2 (관례로 추측 없앤다) 정합 X\n` +
+                        `→ 자동 import 플러그인 제거 · 명시 import 사용`,
+                    detail: { plugin, source: 'config-import', module: spec },
+                });
+            }
+        }
+        // require('unplugin-...') 형태(CJS config)도 잡는다.
+        if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === 'require') {
+            const arg = node.arguments[0];
+            if (arg && ts.isStringLiteral(arg)) {
+                const plugin = matchForbidden(arg.text);
+                if (plugin) {
+                    const { line } = sf.getLineAndCharacterOfPosition(node.getStart(sf));
+                    issues.push({
+                        rule: 'no-auto-import',
+                        level: 'error',
+                        file: rel,
+                        line: line + 1,
+                        message: `${rel} (line ${line + 1})\n` +
+                            `  '${plugin}' 발견 · v0.15 §1.2 (관례로 추측 없앤다) 정합 X\n` +
+                            `→ 자동 import 플러그인 제거 · 명시 import 사용`,
+                        detail: { plugin, source: 'config-require', module: arg.text },
+                    });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sf);
+    return issues;
+}
+/** 지정한 모듈 이름이 금지 목록에 걸리면 해당 플러그인 이름을 낸다. */
+function matchForbidden(spec) {
+    return FORBIDDEN_PLUGINS.find((p) => spec === p || spec.startsWith(p + '/'));
+}
+/** package.json 안의 deps 4종을 훑어 자동 import 플러그인 유무를 낸다. */
+export function inspectPackageJson(file, source, cwd) {
+    const issues = [];
+    const rel = relative(cwd, file);
+    let pkg;
+    try {
+        pkg = JSON.parse(source);
+    }
+    catch {
+        // JSON 파싱 실패 시 이 규칙은 아무 것도 하지 않는다 — 다른 규칙 도구가
+        // 잡을 문제(예: gaon check 의 tsconfig 파싱)이지 자동 import 검사의 몫이 아님.
+        return [];
+    }
+    const allDeps = {
+        ...(pkg.dependencies ?? {}),
+        ...(pkg.devDependencies ?? {}),
+        ...(pkg.peerDependencies ?? {}),
+        ...(pkg.optionalDependencies ?? {}),
+    };
+    for (const plugin of FORBIDDEN_PLUGINS) {
+        if (!(plugin in allDeps))
+            continue;
+        const line = findLineForKey(source, plugin);
+        const loc = line ? ` (line ${line})` : '';
+        issues.push({
+            rule: 'no-auto-import',
+            level: 'error',
+            file: rel,
+            line: line,
+            message: `${rel}${loc}\n` +
+                `  package.json 에 '${plugin}' 발견 · v0.15 §1.2 (관례로 추측 없앤다) 정합 X\n` +
+                `→ 자동 import 플러그인 제거 · 명시 import 사용 · 'pnpm remove ${plugin}' 후 vite/nuxt config 도 정리`,
+            detail: { plugin, source: 'package-json' },
+        });
+    }
+    return issues;
+}
+/** package.json 원문에서 `"<key>"` 가 처음 나오는 1-기반 라인 번호. */
+function findLineForKey(source, key) {
+    const lines = source.split(/\r?\n/);
+    const needle = `"${key}"`;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].includes(needle))
+            return i + 1;
+    }
+    return undefined;
+}
+/** 프로젝트 루트를 훑어 자동 import 설정·의존을 잡는다. */
+export async function checkNoAutoImport(cwd) {
+    const issues = [];
+    for (const cfg of CONFIG_FILES) {
+        const full = join(cwd, cfg);
+        if (!existsSync(full))
+            continue;
+        const src = await readFile(full, 'utf8');
+        issues.push(...inspectConfigForAutoImport(full, src, cwd));
+    }
+    const pkgPath = join(cwd, 'package.json');
+    if (existsSync(pkgPath)) {
+        const src = await readFile(pkgPath, 'utf8');
+        issues.push(...inspectPackageJson(pkgPath, src, cwd));
+    }
+    return { rule: 'no-auto-import', issues };
+}

package/dist/doctor/shared-composable-purity.d.ts

@@ -0,0 +1,8 @@
+import type { DoctorCheck, RuleReport } from './types.js';
+/**
+ * 단일 shared 컴포저블 소스를 검사해 순수성 위반 목록을 낸다
+ * (단위 테스트 진입점).
+ */
+export declare function inspectSharedComposable(file: string, source: string, cwd: string): DoctorCheck[];
+/** shared/composables/ 를 훑어 순수성 위반을 모두 낸다. */
+export declare function checkSharedComposablePurity(cwd: string): Promise<RuleReport>;