@gaonjs/cli 0.64.0 → 0.65.2

package/dist/commands/check.js

@@ -32,8 +32,8 @@ import { generateTablesDts } from '@gaonjs/data';
 import { generateRoutesDts } from '@gaonjs/web';
 import { computeDoctorResult } from '../doctor.js';
 import { regenerateGaonOnce, resolveDevLayout } from '../dev.js';
-import { analyzeProjectI18n, resolveLocalesDir } from '../i18n-config.js';
-import { loadLocales } from '@gaonjs/i18n';
+import { analyzeProjectI18n } from '../i18n-config.js';
+import { assertNoOwnerCollision, loadProjectLocales, mergeScopes, projectLanguages, } from '@gaonjs/i18n';
 import { registerTsResolve } from '../tsResolve.js';
 import { listFrontendApps, verifyAppDist } from '../dev/build.js';
 import { generateMessagesDts } from '../messages-gen.js';
@@ -250,33 +250,49 @@ function verifyI18nCatalogs(cwd) {
     const cfg = analyzeProjectI18n(cwd);
     if (!cfg.declared)
         return undefined;
-    const dir = cfg.dir ?? 'locales';
-    const abs = resolveLocalesDir(cwd, cfg.dir);
-    const resources = existsSync(abs) ? loadLocales(abs) : {};
-    if (Object.keys(resources).length === 0) {
-        return (`i18n 이 설정됐지만 로케일 카탈로그가 비어 있습니다: ${abs}\n` +
-            `  → ${dir}/${cfg.fallbackLng ?? '<fallbackLng>'}/frontend.json (화면 문구) 또는 ` +
-            `${dir}/${cfg.fallbackLng ?? '<fallbackLng>'}/backend.json (서버 전용 문구)을 만드세요 — 결정 454.\n` +
-            `  → 단일 파일 레이아웃(${dir}/${cfg.fallbackLng ?? '<fallbackLng>'}.json)도 계속 지원합니다(서버 전용으로 취급).\n` +
-            `  → gaon.config.ts 의 i18n.dir 이 실제 카탈로그 폴더를 가리키는지 확인하세요.\n` +
+    // 결정 459: 판정 대상이 2소유자로 늘었다 — 로더가 그대로 두 소유자를 읽는다
+    // (`domain/locales/*/frontend.json` 이면 여기서 O8 throw 가 나고 그 메시지가 곧 수리 안내).
+    let project;
+    try {
+        project = loadProjectLocales(cwd);
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+    const langs = projectLanguages(project);
+    if (langs.length === 0) {
+        const base = cfg.fallbackLng ?? '<fallbackLng>';
+        return (`i18n 이 설정됐지만 로케일 카탈로그가 하나도 없습니다: ${cwd} (결정 459)\n` +
+            `  → 화면 문구: apps/<앱>/locales/${base}/frontend.json (앱마다 필수)\n` +
+            `  → 도메인 공통 서버 문구(메일·잡·검증): domain/locales/${base}/backend.json\n` +
+            `  → 그 앱 컨트롤러 전용 서버 문구: apps/<앱>/locales/${base}/backend.json (선택)\n` +
+            `  → 루트 locales/ 는 더 이상 읽지 않습니다 — gaon doctor --fix 로 이관하세요.\n` +
             `  (이 상태로는 gaon serve 가 부팅에서 실패합니다 — 결정 353)`);
     }
     const wanted = [...(cfg.fallbackLng ? [cfg.fallbackLng] : []), ...(cfg.supportedLngs ?? [])];
-    const missing = wanted.filter((lng, i, arr) => arr.indexOf(lng) === i && !resources[lng]);
+    const missing = wanted.filter((lng, i, arr) => arr.indexOf(lng) === i && !langs.includes(lng));
     if (missing.length > 0) {
-        return (`i18n 설정이 지목한 로케일의 카탈로그가 없습니다: ${missing.join(', ')}\n` +
-            `  → ${dir}/ 에 ${missing.map((l) => `${l}/frontend.json`).join(' · ')} (또는 ${missing
-                .map((l) => `${l}/backend.json`)
-                .join(' · ')})을 추가하거나,\n` +
-            `  → 단일 파일 레이아웃이면 ${missing.map((l) => `${l}.json`).join(' · ')} 을 추가하거나,\n` +
+        return (`i18n 설정이 지목한 로케일의 카탈로그가 없습니다: ${missing.join(', ')} (결정 459)\n` +
+            `  → 각 앱에 ${missing.map((l) => `apps/<앱>/locales/${l}/frontend.json`).join(' · ')} 을 추가하거나,\n` +
+            `  → 도메인 공통 문구면 ${missing.map((l) => `domain/locales/${l}/backend.json`).join(' · ')} 을 추가하거나,\n` +
             `  → gaon.config.ts 의 fallbackLng/supportedLngs 에서 해당 로케일을 제거하세요.\n` +
             `  (이 상태로는 gaon serve 가 부팅에서 실패합니다 — 결정 353)`);
     }
+    // 결정 459 O2: 소유자 간 키 충돌은 부팅 fail-loud 다 — 같은 사유를 check 에서 먼저 낸다.
+    try {
+        const apps = {};
+        for (const [name, scoped] of Object.entries(project.apps))
+            apps[name] = mergeScopes(scoped);
+        assertNoOwnerCollision(mergeScopes(project.domain), apps);
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : String(err);
+    }
     return undefined;
 }
 async function regenerateGaon(cwd) {
     const layout = resolveDevLayout(cwd);
-    if (!layout.schemaDir && layout.apps.length === 0 && !layout.localesDir) {
+    if (!layout.schemaDir && layout.apps.length === 0 && layout.localeDirs.length === 0) {
         // 카탈로그가 통째로 없어도 config 가 i18n 을 켰으면 부팅이 죽는다 — 그 경우만 잡는다.
         const problem = verifyI18nCatalogs(cwd);
         if (problem)

package/dist/commands/g.d.ts

@@ -26,6 +26,7 @@ export declare function parseGenerateArgs(argv: readonly string[]): {
 /** 타입에 따라 스캐폴드 파일 목록을 만든다. */
 export declare function planScaffold(type: GenerateType, name: string, app: string, opts?: {
     instance?: boolean;
+    fallbackLng?: string;
 }): ScaffoldFile[];
 /** `gaon g <type> <name>` 실행. exitCode 를 반환한다(0=성공, 1=실패). */
 export declare function runGenerateCommand(type: GenerateType, name: string, opts?: GenerateOptions): number;

package/dist/commands/g.js

@@ -18,6 +18,7 @@ import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { appScaffoldFiles, channelScaffoldFiles, controllerScaffold, inflectModel, jobScaffold, jobTestScaffold, modelScaffoldFiles, pageScaffold, writeScaffold, } from '../scaffold/index.js';
 import { appWiringFiles, readProjectName } from '../scaffold/app-wiring.js';
+import { analyzeProjectI18n } from '../i18n-config.js';
 /** argv 에서 옵션을 뽑는다(간단 파서 · runCli 관례와 일치). */
 export function parseGenerateArgs(argv) {
     const type = argv[0];
@@ -70,7 +71,9 @@ export function planScaffold(type, name, app, opts = {}) {
     }
     // app 은 이름 자체가 앱 폴더명이 되므로 '/' 는 허용하지 않는다(app.ts 재검증).
     if (type === 'app') {
-        return appScaffoldFiles(name);
+        // 결정 459: i18n 을 쓰는 프로젝트면 그 앱의 frontend 카탈로그도 함께 만든다
+        // (화면 문구의 소유자가 앱이므로 앱마다 필수다).
+        return appScaffoldFiles(name, { fallbackLng: opts.fallbackLng });
     }
     if (name.includes('/')) {
         throw new Error(`${type} 이름에 '/' 는 사용할 수 없습니다: ${name}`);
@@ -94,7 +97,13 @@ export function runGenerateCommand(type, name, opts = {}) {
     const app = opts.app ?? 'web';
     let files;
     try {
-        files = planScaffold(type, name, app, { instance: opts.instance });
+        // 결정 459: 기준 로케일은 gaon.config.ts 의 i18n.fallbackLng(정적 분석 · 결정 352).
+        // i18n 미선언 프로젝트면 undefined → 카탈로그를 만들지 않는다.
+        const i18nCfg = analyzeProjectI18n(cwd);
+        files = planScaffold(type, name, app, {
+            instance: opts.instance,
+            fallbackLng: i18nCfg.declared ? (i18nCfg.fallbackLng ?? 'en') : undefined,
+        });
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);

package/dist/commands/gen.js

@@ -26,7 +26,7 @@ import { registerTsResolve } from '../tsResolve.js';
  */
 export async function regenerateProjectGaon(cwd) {
     const layout = resolveDevLayout(cwd);
-    if (!layout.schemaDir && layout.apps.length === 0 && !layout.localesDir) {
+    if (!layout.schemaDir && layout.apps.length === 0 && layout.localeDirs.length === 0) {
         return { tables: false, apps: [], messages: false, env: false, skipped: true };
     }
     registerTsResolve();

package/dist/dev.d.ts

@@ -4,7 +4,7 @@ export interface DevApp {
     readonly appDir: string;
     /** apps/<app>/.gaon/routes.d.ts */
     readonly routesOut: string;
-    /** apps/<app>/locales (앱 전용 frontend 카탈로그 · 결정 454). */
+    /** apps/<app>/locales (그 앱의 스코프 카탈로그 · 결정 454 · 459). */
     readonly localesDir: string;
     /** apps/<app>/.gaon/messages.catalog.ts (클라 카탈로그 값 모듈 · 결정 454). */
     readonly catalogOut: string;
@@ -16,13 +16,18 @@ export interface MessagesAppRef {
     readonly catalogOut: string;
 }
 export interface DevLayout {
+    /** 프로젝트 루트 — 메시지 축 입력(두 소유자 카탈로그를 관례로 찾는다 · 결정 459). */
+    readonly root: string;
     /** domain/schema (없으면 undefined — tables 워치 생략). */
     readonly schemaDir?: string;
     /** .gaon/tables.d.ts */
     readonly tablesOut: string;
     readonly apps: readonly DevApp[];
-    /** locales/ (없으면 undefined — messages 축 생략 · 결정 158 · W2). */
-    readonly localesDir?: string;
+    /**
+     * 워치할 카탈로그 폴더들 — `domain/locales` + `apps/<앱>/locales` 중 **존재하는 것**.
+     * 비면 messages 축 생략(결정 158 · W2 · 결정 459 로 루트 단일 폴더에서 N개로).
+     */
+    readonly localeDirs: readonly string[];
     /** 기준 로케일 = config i18n.fallbackLng (정적 분석 · 결정 352 · 못 읽으면 undefined). */
     readonly messagesBaseLng?: string;
     /** .gaon/messages.d.ts */
@@ -39,10 +44,11 @@ export interface DevDeps {
     regenerateTables(schemaDir: string, out: string): Promise<unknown>;
     regenerateRoutes(appDir: string, out: string): Promise<unknown>;
     /**
-     * locales/ → .gaon/messages.d.ts (결정 158 · W2 · 기준 로케일 = 결정 352) + 앱별
+     * 프로젝트 카탈로그 → .gaon/messages.d.ts (결정 158 · W2 · 기준 로케일 = 결정 352) + 앱별
      * messages.catalog.ts (결정 454 · apps 를 넘긴 호출자만). i18n 축을 쓰는 호출자만 준다.
+     * 첫 인자는 **프로젝트 루트**다(결정 459 — 카탈로그 위치는 관례 고정).
      */
-    regenerateMessages?(localesDir: string, out: string, baseLng?: string, apps?: readonly MessagesAppRef[]): unknown;
+    regenerateMessages?(root: string, out: string, baseLng?: string, apps?: readonly MessagesAppRef[]): unknown;
     /** `.env` → .gaon/env.d.ts (결정 198 · F-9 ②). env 축을 쓰는 호출자만 준다. */
     regenerateEnv?(envFile: string, out: string): unknown;
     watch(dir: string, opts: WatchOptions): WatchHandle;
@@ -73,8 +79,8 @@ export declare function startDev(deps: DevDeps): Promise<DevHandle>;
 export interface RegenDeps {
     regenerateTables(schemaDir: string, out: string): Promise<unknown>;
     regenerateRoutes(appDir: string, out: string): Promise<unknown>;
-    /** locales/ → .gaon/messages.d.ts + 앱별 messages.catalog.ts (결정 158 · 352 · 454). */
-    regenerateMessages?(localesDir: string, out: string, baseLng?: string, apps?: readonly MessagesAppRef[]): unknown;
+    /** 프로젝트 루트 → .gaon/messages.d.ts + 앱별 messages.catalog.ts (결정 158 · 352 · 454 · 459). */
+    regenerateMessages?(root: string, out: string, baseLng?: string, apps?: readonly MessagesAppRef[]): unknown;
     /** `.env` → .gaon/env.d.ts (결정 198 · F-9 ②). env 축을 쓰는 호출자만 준다. */
     regenerateEnv?(envFile: string, out: string): unknown;
 }

package/dist/dev.js

@@ -13,7 +13,8 @@
  */
 import { readdirSync, existsSync } from 'node:fs';
 import { join, resolve } from 'node:path';
-import { analyzeProjectI18n, resolveLocalesDir } from './i18n-config.js';
+import { domainLocalesDir } from '@gaonjs/i18n';
+import { analyzeProjectI18n } from './i18n-config.js';
 /** locales/*.json 변경(메시지 카탈로그) — messages.d.ts 재생성 트리거. */
 const isMessagesChange = (f) => !f.includes('.gaon') && f.endsWith('.json');
 const isSchemaChange = (f) => f.endsWith('.ts') && !f.endsWith('.d.ts') && !f.endsWith('.test.ts') && !f.includes('.gaon');
@@ -38,9 +39,9 @@ export async function startDev(deps) {
         await deps.regenerateRoutes(app.appDir, app.routesOut);
         deps.log({ kind: 'regen', target: 'routes', app: app.name });
     }
-    // 결정 158(W2): locales/ → messages.d.ts.
-    if (layout.localesDir && deps.regenerateMessages) {
-        await deps.regenerateMessages(layout.localesDir, layout.messagesOut, layout.messagesBaseLng, messagesAppsOf(layout));
+    // 결정 158(W2): 프로젝트 카탈로그 → messages.d.ts.
+    if (layout.localeDirs.length > 0 && deps.regenerateMessages) {
+        await deps.regenerateMessages(layout.root, layout.messagesOut, layout.messagesBaseLng, messagesAppsOf(layout));
         deps.log({ kind: 'regen', target: 'messages' });
     }
     // 결정 198(F-9 ②): 프론트 앱이 있으면 .env → env.d.ts(VITE_* 타입 브리지). `.env` 부재는
@@ -73,18 +74,20 @@ export async function startDev(deps) {
             onError: deps.onError,
         }));
     }
-    // 4) locales 워치 → messages.d.ts 재생성(결정 158 · W2).
-    if (layout.localesDir && deps.regenerateMessages) {
-        const localesDir = layout.localesDir;
+    // 4) 카탈로그 워치 → messages.d.ts 재생성(결정 158 · W2). 결정 459: 소유자가 둘이라
+    //    폴더가 N개다 — 어느 쪽이 바뀌든 같은 재생성 1회를 돈다(산출은 루트 단일 + 앱별 값 모듈).
+    if (layout.localeDirs.length > 0 && deps.regenerateMessages) {
         const regenerateMessages = deps.regenerateMessages;
-        handles.push(deps.watch(localesDir, {
-            filter: isMessagesChange,
-            onChange: async () => {
-                await regenerateMessages(localesDir, layout.messagesOut, layout.messagesBaseLng, messagesAppsOf(layout));
-                deps.log({ kind: 'regen', target: 'messages' });
-            },
-            onError: deps.onError,
-        }));
+        for (const localesDir of layout.localeDirs) {
+            handles.push(deps.watch(localesDir, {
+                filter: isMessagesChange,
+                onChange: async () => {
+                    await regenerateMessages(layout.root, layout.messagesOut, layout.messagesBaseLng, messagesAppsOf(layout));
+                    deps.log({ kind: 'regen', target: 'messages' });
+                },
+                onError: deps.onError,
+            }));
+        }
     }
     deps.log({ kind: 'ready', schema: !!layout.schemaDir, apps: layout.apps.map((a) => a.name) });
     return {
@@ -108,11 +111,11 @@ export async function regenerateGaonOnce(layout, deps) {
     for (const app of layout.apps) {
         await deps.regenerateRoutes(app.appDir, app.routesOut);
     }
-    // 결정 158(W2): locales/ 가 있으면 messages.d.ts 도 재생성한다(i18n 키 타입 브리지).
+    // 결정 158(W2): 카탈로그가 있으면 messages.d.ts 도 재생성한다(i18n 키 타입 브리지).
     let messages = false;
-    if (layout.localesDir && deps.regenerateMessages) {
+    if (layout.localeDirs.length > 0 && deps.regenerateMessages) {
         messages =
-            (await deps.regenerateMessages(layout.localesDir, layout.messagesOut, layout.messagesBaseLng, messagesAppsOf(layout))) === true;
+            (await deps.regenerateMessages(layout.root, layout.messagesOut, layout.messagesBaseLng, messagesAppsOf(layout))) === true;
     }
     // 결정 198(F-9 ②): 프론트 앱이 있으면 .env → env.d.ts. `.env` 부재는 throw(수리 안내).
     let env = false;
@@ -152,15 +155,20 @@ export function resolveDevLayout(cwd) {
             });
         }
     }
-    // 결정 352: 카탈로그 위치·기준 로케일은 gaon.config.ts 의 i18n 블록을 따른다
-    // (정적 분석 · 하드코딩 'locales' 는 dir 커스텀 프로젝트에서 타입 축을 무소음으로 껐다).
+    // 결정 352: 기준 로케일은 gaon.config.ts 의 i18n.fallbackLng 를 따른다(정적 분석).
+    // 결정 459: **위치는 관례 고정**이라 더 이상 config(i18n.dir)를 보지 않는다 —
+    // domain/locales + 앱별 locales 중 존재하는 폴더가 곧 워치 대상이다.
     const i18nCfg = analyzeProjectI18n(root);
-    const localesDirPath = resolveLocalesDir(root, i18nCfg.dir);
+    const localeDirs = [
+        domainLocalesDir(root),
+        ...apps.map((a) => a.localesDir),
+    ].filter((d) => existsSync(d));
     return {
+        root,
         schemaDir: existsSync(schemaDirPath) ? schemaDirPath : undefined,
         tablesOut: join(root, '.gaon', 'tables.d.ts'),
         apps: apps.sort((a, b) => a.name.localeCompare(b.name)),
-        localesDir: existsSync(localesDirPath) ? localesDirPath : undefined,
+        localeDirs,
         messagesBaseLng: i18nCfg.fallbackLng,
         messagesOut: join(root, '.gaon', 'messages.d.ts'),
         hasFrontendApps,

package/dist/doctor/fixers/i18n-layout.d.ts

@@ -1,7 +1,7 @@
 import type { DoctorCheck } from '../types.js';
 import type { FixerPlan } from './types.js';
 /**
- * i18n-layout 위반(레거시 단일 파일)을 폴더 레이아웃으로 옮기는 계획을 만든다.
- * 내용은 그대로다 — 키 이름도 바뀌지 않는다(결정 454 R4).
+ * i18n-layout 위반을 새 배치로 옮기는 계획을 만든다. 내용·키는 바뀌지 않는다
+ * (④ 의 병합만 앱 기존 키 위에 없는 키를 더한다).
  */
 export declare function fixI18nLayout(issues: readonly DoctorCheck[], cwd: string): Promise<readonly FixerPlan[]>;

package/dist/doctor/fixers/i18n-layout.js

@@ -1,40 +1,134 @@
-// @gaonjs/cli · doctor fixer · 레거시 단일 파일 카탈로그 → 폴더 레이아웃 이관 (결정 454)
+// @gaonjs/cli · doctor fixer · 옛 카탈로그 배치 → 결정 459 배치 이관
 //
-// `locales/<로케일>.json` → `locales/<로케일>/backend.json` **이동만** 한다(rename 계획).
+// 이관 4종(검출은 doctor/i18n-layout.ts):
+//   ① locales/<로케일>/backend.json → domain/locales/<로케일>/backend.json   rename
+//   ② locales/<로케일>.json         → domain/locales/<로케일>/backend.json   rename
+//   ③ apps/<앱>/locales/<로케일>.json → apps/<앱>/locales/<로케일>/frontend.json  rename
+//   ④ locales/<로케일>/frontend.json → **전 앱** frontend.json 에 병합 + 원본 제거
 //
-// **왜 전량 backend 인가(안전 방향 자동화)**: 자동 분류가 오판하면 서버 전용 문구를
-// frontend 로 보내 클라 번들·CDN 캐시에 노출된다 — 되돌리기 어려운 방향의 사고다.
-// 되돌리기 쉬운 방향(전량 backend = 클라에서 안 보임)으로만 자동화하고, 화면 문구를
-// frontend.json 으로 옮기는 판단은 사람이 한다(doctor 경고가 그 다음 단계를 안내).
+// **왜 ④ 만 복제인가(자동화의 안전 방향)**: 공용 화면 문구 중 어떤 키를 어느 앱이
+// 실제로 쓰는지는 정적으로 판정할 수 없다(동적 키 `t(변수)` 가 섞이면 오판이 곧 화면
+// 누락이다). 그래서 fixer 는 **전 앱 복제만** 하고, 잉여 키 정리는 사람이 한다 —
+// 되돌리기 쉬운 방향이다(결정 454 fixer 가 "전량 backend" 를 고른 것과 같은 논리).
+//
+// **병합 우선순위**: 앱에 이미 있는 키가 이긴다. 공용 사본이 앱 전용 문안을 덮으면
+// 이관이 곧 회귀가 된다(같은 키를 앱이 다르게 쓰고 있었다면 그쪽이 최신 의도다).
 import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
 import { join } from 'node:path';
+/** 중첩 객체 깊은 병합 — `base` 가 이긴다(앱 기존 키 보존). */
+function deepMerge(base, extra) {
+    const isTree = (x) => x !== null && typeof x === 'object' && !Array.isArray(x);
+    const out = { ...base };
+    for (const [k, v] of Object.entries(extra)) {
+        if (!(k in out)) {
+            out[k] = v;
+            continue;
+        }
+        const cur = out[k];
+        if (isTree(cur) && isTree(v))
+            out[k] = deepMerge(cur, v);
+        // 리프 충돌은 base(앱)를 유지한다 — 덮어쓰지 않는다.
+    }
+    return out;
+}
+async function readJson(path) {
+    try {
+        return JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 카탈로그 JSON 직렬화(2칸 들여쓰기 + 개행 · 저장소 관례). */
+function stringify(tree) {
+    return `${JSON.stringify(tree, null, 2)}\n`;
+}
 /**
- * i18n-layout 위반(레거시 단일 파일)을 폴더 레이아웃으로 옮기는 계획을 만든다.
- * 내용은 그대로다 — 키 이름도 바뀌지 않는다(결정 454 R4).
+ * i18n-layout 위반을 새 배치로 옮기는 계획을 만든다. 내용·키는 바뀌지 않는다
+ * (④ 의 병합만 앱 기존 키 위에 없는 키를 더한다).
  */
 export async function fixI18nLayout(issues, cwd) {
     const plans = [];
     for (const issue of issues) {
-        const to = issue.detail?.to;
-        if (typeof to !== 'string' || issue.file === undefined)
+        const kind = issue.detail?.kind;
+        if (issue.file === undefined)
+            continue;
+        // ①②③ — 1:1 이동(내용 무변경).
+        if (kind === 'root-backend' || kind === 'root-legacy' || kind === 'app-legacy') {
+            const to = issue.detail?.to;
+            if (typeof to !== 'string')
+                continue;
+            let before;
+            try {
+                before = await readFile(join(cwd, issue.file), 'utf8');
+            }
+            catch {
+                continue; // 그 사이 파일이 사라졌으면 계획에서 제외(부분 적용 방지).
+            }
+            plans.push({
+                kind: 'rename',
+                file: issue.file,
+                to,
+                before,
+                summary: `카탈로그를 새 배치로 이동: ${issue.file} → ${to} (결정 459)\n` +
+                    `  내용·키는 그대로다.` +
+                    (kind === 'app-legacy'
+                        ? ' 앱 카탈로그는 화면 문구 전용이었으므로 frontend 로 간다.'
+                        : ' 미분류·공용 서버 문구는 도메인 backend 로 간다(클라 노출 없음).'),
+                refEdits: [], // JSON 카탈로그는 소스가 import 하지 않는다(경로 참조 갱신 없음).
+            });
             continue;
-        let before;
-        try {
-            before = await readFile(join(cwd, issue.file), 'utf8');
         }
-        catch {
-            continue; // 그 사이 파일이 사라졌으면 계획에서 제외(상위가 부분 적용을 감당하지 않게).
+        // ④ — 전 앱 복제 후 원본 제거.
+        if (kind === 'root-frontend') {
+            const targets = issue.detail?.to;
+            const locale = issue.detail?.locale;
+            if (!Array.isArray(targets) || targets.length === 0 || typeof locale !== 'string')
+                continue;
+            const sourcePath = join(cwd, issue.file);
+            let before;
+            let tree;
+            try {
+                before = await readFile(sourcePath, 'utf8');
+                tree = JSON.parse(before);
+            }
+            catch {
+                continue;
+            }
+            for (const target of targets) {
+                if (typeof target !== 'string')
+                    continue;
+                const abs = join(cwd, target);
+                const existing = existsSync(abs) ? await readJson(abs) : undefined;
+                // 앱 기존 키가 이긴다 — 공용 사본이 앱 전용 문안을 덮지 않는다.
+                const merged = stringify(deepMerge(existing ?? {}, tree));
+                const prior = existing === undefined ? '' : await readFile(abs, 'utf8');
+                if (prior === merged)
+                    continue; // 이미 반영됨(멱등).
+                plans.push({
+                    kind: 'rewrite',
+                    file: target,
+                    before: prior,
+                    after: merged,
+                    summary: `공용 화면 문구를 앱 카탈로그로 복제: ${issue.file} → ${target} (결정 459)\n` +
+                        `  화면 문구의 소유자는 그 앱이다 — 공용 스코프가 폐지돼 앱마다 사본을 둔다.\n` +
+                        `  앱에 이미 있던 키는 그대로 유지된다(공용 사본이 덮지 않는다).\n` +
+                        `  → 이 앱이 실제로 쓰지 않는 키는 사람이 지운다(전 앱 복제는 안전한 방향의 자동화).`,
+                });
+            }
+            plans.push({
+                kind: 'remove',
+                file: issue.file,
+                before,
+                summary: `폐지된 공용 카탈로그 제거: ${issue.file} (결정 459)\n` +
+                    `  위 복제가 끝난 뒤 지운다 — 남겨 두면 아무도 읽지 않는 폴더가 되어\n` +
+                    `  "고쳤는데 화면이 안 바뀐다" 를 만든다. 원본은 .bak 로 백업된다.`,
+            });
+            continue;
         }
-        plans.push({
-            kind: 'rename',
-            file: issue.file,
-            to,
-            before,
-            summary: `카탈로그를 폴더 레이아웃으로 이동: ${issue.file} → ${to} (결정 454)\n` +
-                `  내용·키는 그대로다. 이 상태에서는 **서버 전용**(클라로 나가지 않음)이다.\n` +
-                `  → 화면에 보이는 문구만 같은 폴더의 frontend.json 으로 옮긴 뒤 gaon gen 을 실행하세요.`,
-            refEdits: [], // JSON 카탈로그는 소스가 import 하지 않는다(경로 참조 갱신 없음).
-        });
+        // ③(domain-frontend)·④(config-dir)는 자동 수정하지 않는다 — 어느 앱이 그 문구를
+        // 소유하는지(전자)·설정 의도(후자)는 사람의 판단이라 doctor 메시지가 안내만 한다.
     }
     return plans;
 }

package/dist/doctor/fixers/index.d.ts

@@ -15,7 +15,7 @@ export declare const FIXERS: Partial<Record<DoctorRule, Fixer>>;
  * 규칙별 fix 지원 여부 카탈로그. 리포트가 사용자에게 무엇이 자동 · 무엇이
  * 수동 · 이유는 무엇인지 표시하는 데 쓴다(진단 = 수리 안내서 · §7.5.3).
  *
- * **정직성 규약(결정 241)**: 이 배열은 `ALL_RULES` 31종을 **빠짐없이** 담는다 —
+ * **정직성 규약(결정 241)**: 이 배열은 `ALL_RULES` 전종을 **빠짐없이** 담는다 —
  * fixer 가 없는 규칙도 `hasFixer:false` + 구체적 수동 안내로 명시한다. 항목이
  * 빠지면 --fix 리포트가 그 규칙 위반에 대해 일반 문구("수동 수정 필요")만 내
  * 사용자가 왜 자동이 안 되는지 알 수 없다. 전수성은 테스트가 고정한다

package/dist/doctor/fixers/index.js

@@ -31,7 +31,7 @@ export const FIXERS = {
  * 규칙별 fix 지원 여부 카탈로그. 리포트가 사용자에게 무엇이 자동 · 무엇이
  * 수동 · 이유는 무엇인지 표시하는 데 쓴다(진단 = 수리 안내서 · §7.5.3).
  *
- * **정직성 규약(결정 241)**: 이 배열은 `ALL_RULES` 31종을 **빠짐없이** 담는다 —
+ * **정직성 규약(결정 241)**: 이 배열은 `ALL_RULES` 전종을 **빠짐없이** 담는다 —
  * fixer 가 없는 규칙도 `hasFixer:false` + 구체적 수동 안내로 명시한다. 항목이
  * 빠지면 --fix 리포트가 그 규칙 위반에 대해 일반 문구("수동 수정 필요")만 내
  * 사용자가 왜 자동이 안 되는지 알 수 없다. 전수성은 테스트가 고정한다
@@ -41,12 +41,17 @@ export const FIXER_CAPABILITIES = [
     {
         rule: 'i18n-layout',
         hasFixer: true,
-        note: '자동 · locales/<로케일>.json → locales/<로케일>/backend.json 이동(결정 454). 화면 문구를 frontend.json 으로 나누는 것은 노출 방향이라 사람이 판단한다.',
+        note: '자동 · 옛 배치 → 결정 459 배치 이관(루트 backend·레거시 단일 파일 → domain/locales, 앱 평면 파일 → apps/<앱>/locales/<로케일>/frontend.json, 루트 공용 frontend → 전 앱 복제 후 원본 제거). domain/locales 의 frontend.json 과 i18n.dir 잔재는 사람이 판단(어느 앱이 소유하는지·설정 의도).',
     },
     {
         rule: 'i18n-app-scope',
         hasFixer: false,
-        note: '수동 · 그 키를 이 앱 카탈로그(apps/<앱>/locales/<로케일>.json) 또는 공용 locales/<로케일>/frontend.json 에 추가(어느 앱 문구인지는 설계 판단).',
+        note: '수동 · 그 키를 apps/<앱>/locales/<로케일>/frontend.json 에 추가(어느 앱 문구인지는 설계 판단 · shared/ 가 쓰는 키는 모든 앱에).',
+    },
+    {
+        rule: 'i18n-server-scope',
+        hasFixer: false,
+        note: '수동 · 문구를 domain/locales/<로케일>/backend.json 으로 올리거나 그 호출을 도메인 밖으로 옮긴다(소유자 판단은 설계 결정).',
     },
     {
         rule: 'response-mixing',
@@ -98,6 +103,11 @@ export const FIXER_CAPABILITIES = [
         hasFixer: false,
         note: '수동 · AGENTS 색인(§0)과 agents/ 실 파일을 일치시킵니다(결정 40).',
     },
+    {
+        rule: 'redundant-index',
+        hasFixer: false,
+        note: "수동 · '.index()' 제거 자체는 안전하지만, 원래 의도가 이 컬럼을 선두로 하는 복합 인덱스나 부분 인덱스(.index({ where })) 였을 수 있어 테이블 레벨로 옮길지 지울지는 사람이 판단합니다(결정 460).",
+    },
     {
         rule: 'column-casing',
         hasFixer: false,

package/dist/doctor/fixers/types.d.ts

@@ -39,8 +39,23 @@ export interface RefEdit {
     readonly before: string;
     readonly after: string;
 }
-/** fixer 가 낸 계획 — 내용 재작성 또는 파일 이름 변경. */
-export type FixerPlan = RewriteFixerPlan | RenameFixerPlan;
+/**
+ * 파일 제거 계획(결정 459) — 옮길 곳이 **여러 개**라 rename 으로 표현할 수 없는 이관의
+ * 마지막 단계다(루트 공용 frontend 는 전 앱으로 복제되므로 1:1 이동이 아니다).
+ * 원본은 지우기 전에 `<파일>.bak-<타임스탬프>` 로 백업되므로 되돌릴 수 있다.
+ * 복제(rewrite) 계획들 **뒤에** 오도록 fixer 가 순서를 보장한다.
+ */
+export interface RemoveFixerPlan {
+    readonly kind: 'remove';
+    /** 지울 경로(프로젝트 상대). */
+    readonly file: string;
+    /** 지우기 전 원본(백업 · rollback 참조용). */
+    readonly before: string;
+    /** 사람용 요약(어디로 옮겼기에 지우는지). */
+    readonly summary: string;
+}
+/** fixer 가 낸 계획 — 내용 재작성 · 파일 이동 · 파일 제거. */
+export type FixerPlan = RewriteFixerPlan | RenameFixerPlan | RemoveFixerPlan;
 /**
  * 규칙 검사가 낸 DoctorCheck 를 받아 파일별 수정 계획을 낸다. 파일 I/O 는
  * 여기서 하지 않는다(테스트 편의 · 순수 함수). 아무 것도 못 고치면 빈

package/dist/doctor/i18n-app-scope.d.ts

@@ -1,8 +1,11 @@
 import type { RuleReport } from './types.js';
+export declare const T_CALL: RegExp;
 /**
  * 주석을 공백으로 지운다(문자열 리터럴 안의 `//`·`/*` 는 보존). 스캐폴드·문서 주석이
  * 예시로 적은 `t('키')` 를 실 호출로 오인해 **오탐 에러**를 내던 것을 막는다(브라우저 e2e
  * 게이트가 실제로 잡았다). 길이를 보존해 라인 번호 계산이 어긋나지 않는다.
  */
 export declare function stripComments(src: string): string;
+/** 소스 파일을 재귀 수집한다(생성물·의존성 제외). i18n-server-scope 와 공유. */
+export declare function walkSources(dir: string, exts?: readonly string[], out?: string[]): string[];
 export declare function checkI18nAppScope(cwd: string): Promise<RuleReport>;