@gaonjs/cli 0.64.0 → 0.65.2

package/dist/doctor/locale-parity.js

@@ -9,18 +9,17 @@
 // 경고(error 아님): 부분 누락은 fallback 으로 화면이 깨지진 않는 소프트 결함이라
 // 빌드를 세우지 않는다. --json 은 detail.locale·detail.missing 으로 구조화한다.
 //
-// 결정 456: **앱 스코프 카탈로그(`apps/<앱>/locales/<로케일>.json`)까지 훑는다.**
-// 결정 454 가 앱 전용 화면 문구의 정본 배치로 이 경로를 지정했고 `agents/i18n.md`
-// 정본 예시가 "같은 키를 나란히(locale-parity)" 라고 **약속**하는데, 검사는 루트
-// `locales/` 만 보고 있었다(auction 샘플 실측 — 앱 카탈로그에서 키를 지워도 무소음).
-// `i18n-app-scope` 도 대신 못 잡는다: 그 검사의 키 집합은 **전 로케일 합집합**이라
-// en 에만 있는 키도 "있는 키" 로 세기 때문이다(축이 다르다 — 앱 경계 침범 검출).
-// 비교는 **앱 내부에서만** 한다 — 앱 카탈로그와 루트를 교차 비교하면 앱 전용 키가
-// 전부 "루트에 없음" 으로 뜨는 오탐이 된다(앱 카탈로그는 루트의 초과분이 정상).
-import { existsSync, readdirSync } from 'node:fs';
+// 결정 456: **앱 스코프 카탈로그까지 훑는다.** `i18n-app-scope` 는 대신 못 잡는다:
+// 그 검사의 키 집합은 **전 로케일 합집합**이라 en 에만 있는 키도 "있는 키" 로 세기
+// 때문이다(축이 다르다 — 앱 경계 침범 검출).
+//
+// 결정 459: 소유자가 domain / 앱 N개로 재편되면서 비교 단위가 **3종**이 된다:
+//   ① domain-backend 로케일 간  ② 앱별 frontend 로케일 간  ③ 앱별 backend 로케일 간
+// **스코프·소유자를 가로지르는 비교는 하지 않는다** — 앱 전용 키가 전량 "도메인에 없음"
+// 으로 뜨는 오탐이 되고(결정 456 이 이미 기각한 축), frontend↔backend 는 애초에 다른 축이다.
 import { join, relative } from 'node:path';
-import { loadAppLocales, loadScopedLocales, flattenKeys } from '@gaonjs/i18n';
-import { analyzeProjectI18n, resolveLocalesDir } from '../i18n-config.js';
+import { loadProjectLocales, flattenKeys } from '@gaonjs/i18n';
+import { analyzeProjectI18n } from '../i18n-config.js';
 // 경고 한 줄이 폭주하지 않게 나열 상한 — 넘으면 "…외 N개" 로 접는다(detail 에는 전량).
 const MAX_KEYS_SHOWN = 20;
 // i18next 복수형 접미사(결정 181 · generator.ts 와 동일 규약). 로케일마다 필요한 접미사만
@@ -36,66 +35,27 @@ function pluralBase(key) {
  * 비교 대상이 없어 건너뛴다(i18n 미사용·단일 로케일 프로젝트는 무소음).
  */
 export async function checkLocaleParity(cwd) {
-    // 결정 352: 카탈로그 위치는 config i18n.dir 을 따른다(정적 분석 · 하드코딩이던
-    // 'locales' 는 dir 커스텀 프로젝트에서 이 검사를 무소음으로 껐다).
-    const localesDir = resolveLocalesDir(cwd, analyzeProjectI18n(cwd).dir);
-    if (!existsSync(localesDir))
+    if (!analyzeProjectI18n(cwd).declared)
         return { rule: 'locale-parity', issues: [] };
-    // 결정 454: 스코프(backend·frontend)별로 따로 비교한다 — 같은 키를 로케일마다 다른
-    // 스코프에 두면(ko 는 frontend, ja 는 backend) 클라 카탈로그가 갈리므로, 병합본으로
-    // 비교하면 그 배치 불일치를 못 본다. 파일 경로도 스코프별로 정확히 짚는다.
-    const scoped = loadScopedLocales(localesDir);
-    const issues = [];
-    for (const scope of ['backend', 'frontend']) {
-        const resources = scoped[scope];
-        issues.push(...parityIssues(cwd, localesDir, resources, scoped.layout, scope));
-    }
-    issues.push(...appParityIssues(cwd));
-    return { rule: 'locale-parity', issues };
-}
-/** `apps/` 아래 앱 폴더 이름들(없으면 빈 배열). */
-function appNames(cwd) {
+    let project;
     try {
-        return readdirSync(join(cwd, 'apps'), { withFileTypes: true })
-            .filter((e) => e.isDirectory())
-            .map((e) => e.name)
-            .sort();
+        project = loadProjectLocales(cwd);
     }
     catch {
-        return [];
+        // 로더 fail-loud 는 i18n-layout·check 가 소유한다 — 여기선 침묵(중복 진단 금지).
+        return { rule: 'locale-parity', issues: [] };
     }
-}
-/**
- * 결정 456: 앱 스코프 카탈로그의 로케일 간 키 diff. 앱 **내부에서만** 비교한다
- * (앱 카탈로그는 루트 frontend 의 초과분이 정상이라 교차 비교는 전량 오탐).
- * 앱 카탈로그는 frontend 전용이므로(결정 454 R7) 스코프 분리는 없다.
- */
-function appParityIssues(cwd) {
     const issues = [];
-    for (const app of appNames(cwd)) {
-        const appLocalesDir = join(cwd, 'apps', app, 'locales');
-        if (!existsSync(appLocalesDir))
-            continue;
-        const resources = loadAppLocales(appLocalesDir);
-        for (const [lng, missing] of missingByLang(resources)) {
-            const rel = relative(cwd, join(appLocalesDir, `${lng}.json`));
-            const shown = missing.slice(0, MAX_KEYS_SHOWN);
-            const more = missing.length - shown.length;
-            const list = shown.map((k) => `'${k}'`).join(', ') + (more > 0 ? ` …외 ${more}개` : '');
-            issues.push({
-                rule: 'locale-parity',
-                level: 'warning',
-                file: rel,
-                message: `로케일 '${lng}' 에 같은 앱의 다른 로케일엔 있는 키 ${missing.length}개가 빠졌습니다: ${rel}\n` +
-                    `  누락 키: ${list}\n` +
-                    `→ ${rel} 에 이 키들을 채우고 gaon gen 을 실행하세요 — 없으면 '${lng}' 사용자 화면에\n` +
-                    `  키 문자열이 그대로 노출됩니다(결정 455 런타임 degrade). 앱 공용 문구면 대신\n` +
-                    `  locales/${lng}/frontend.json 으로 올리세요.`,
-                detail: { locale: lng, scope: `app:${app}`, app, missing },
-            });
+    // ① 도메인 — backend 만 정당하다(frontend 가 있으면 로더가 이미 throw).
+    issues.push(...parityIssues(cwd, join(cwd, 'domain', 'locales'), project.domain.backend, project.domain.layout, 'backend', 'domain'));
+    // ②③ 앱별 — frontend·backend 를 **각각** 그 앱 안에서만 비교한다.
+    for (const [app, scoped] of Object.entries(project.apps).sort(([a], [b]) => a.localeCompare(b))) {
+        const dir = join(cwd, 'apps', app, 'locales');
+        for (const scope of ['backend', 'frontend']) {
+            issues.push(...parityIssues(cwd, dir, scoped[scope], scoped.layout, scope, `app:${app}`));
         }
     }
-    return issues;
+    return { rule: 'locale-parity', issues };
 }
 /**
  * 로케일 간 키 diff — 로케일별 "다른 로케일엔 있는데 나에겐 없는 키" 를 낸다.
@@ -123,8 +83,8 @@ function missingByLang(resources) {
     }
     return out;
 }
-/** 한 스코프 안에서 로케일 간 키 diff 를 계산한다(레거시 단일 파일은 backend 스코프에 담긴다). */
-function parityIssues(cwd, localesDir, resources, layout, scope) {
+/** 한 소유자의 한 스코프 안에서 로케일 간 키 diff 를 계산한다(레거시 단일 파일 경로 포함). */
+function parityIssues(cwd, localesDir, resources, layout, scope, owner) {
     const issues = [];
     for (const [lng, missing] of missingByLang(resources)) {
         // 파일 경로는 레이아웃에 맞춘다 — 폴더 분리면 <lng>/<scope>.json, 레거시면 <lng>.json.
@@ -138,11 +98,12 @@ function parityIssues(cwd, localesDir, resources, layout, scope) {
             rule: 'locale-parity',
             level: 'warning',
             file: rel,
-            message: `로케일 '${lng}' 에 다른 로케일엔 있는 키 ${missing.length}개가 빠졌습니다: ${rel}\n` +
+            message: `로케일 '${lng}' 에 같은 스코프의 다른 로케일엔 있는 키 ${missing.length}개가 빠졌습니다: ${rel} (${owner})\n` +
                 `  누락 키: ${list}\n` +
                 `→ ${rel} 에 이 키들을 채우세요 — 없으면 '${lng}' 사용자에게 fallback(대개 다른 언어)\n` +
-                `  번역이 조용히 노출됩니다. messages.d.ts 는 기준 로케일 기준이라 컴파일로 못 잡습니다(결정 216).`,
-            detail: { locale: lng, scope, missing },
+                `  번역이 조용히 노출되거나(서버), 키 문자열이 그대로 뜹니다(클라 · 결정 455).\n` +
+                `  messages.d.ts 는 기준 로케일 기준이라 컴파일로 못 잡습니다(결정 216).`,
+            detail: { locale: lng, scope, owner, missing },
         });
     }
     return issues;

package/dist/doctor/redundant-index.d.ts

@@ -0,0 +1,7 @@
+import type { RuleReport } from './types.js';
+/**
+ * unique·PK 컬럼에 붙은 `.index()` 를 검사한다. domain/schema 가 없으면 통과.
+ * 스키마 로드 실패는 schema-relations 가 이미 안내하므로 여기서는 무소음으로
+ * 넘어간다(같은 원인에 대한 경고 중복 방지).
+ */
+export declare function checkRedundantIndex(cwd: string): Promise<RuleReport>;

package/dist/doctor/redundant-index.js

@@ -0,0 +1,67 @@
+// @gaonjs/cli · doctor · unique·PK 컬럼의 무시되는 `.index()` (결정 460)
+//
+// `t.string().unique().index()` 처럼 unique(또는 PK) 컬럼에 명시적 `.index()` 를
+// 붙이면 DDL 생성기(ddl.ts tableIndexSpecs)가 그 인덱스를 **건너뛴다** — UNIQUE
+// 제약·PK 가 이미 인덱스라 중복이기 때문이다. DDL 결과는 옳다. 문제는 그 skip 이
+// **조용했다**는 것: 개발자는 인덱스를 요청했는데 아무것도 생성되지 않고 아무
+// 신호도 없다(부분 인덱스 `.index({ where })`·인덱스 메서드 `.index({ using })`
+// 도 함께 증발한다 — 이쪽은 "중복이라 괜찮다" 도 아니다).
+//
+// 왜 빌더·타입에서 막지 않는가(결정 460 기각안): 수식어 체이닝은 "어떤 조합·
+// 순서든 컴파일된다"가 의도된 성질이고 type-tests(columnModifiers.test-d.ts)가
+// `.unique().index()` 를 포함한 전 수식어 체인을 그렇게 고정한다. 빌더 시그니처를
+// 좁히면 그 성질과 테스트가 깨지므로, 신호는 정적 검사로만 준다.
+//
+// 경고(warning)다 — DDL 은 이미 옳고 기존 스키마는 그대로 동작한다. 자동 수정은
+// 두지 않는다: `.index()` 제거는 안전하지만, 사용자가 원한 것이 **복합·부분
+// 인덱스**였을 수 있어(테이블 레벨로 옮겨야 한다) 무엇을 의도했는지는 사람이
+// 판단한다(fixers/index.ts capability note).
+//
+// 판정은 AST 가 아니라 **실제 ColumnMeta**(schema-relations 와 같은 로드 경로)로
+// 한다 — ddl.ts 가 보는 값과 같은 값을 봐야 "무시된다" 는 판정이 DDL 과 절대
+// 어긋나지 않는다(헬퍼로 조립한 컬럼·spread 도 그대로 잡힌다).
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { checkRedundantIndexes } from '@gaonjs/data';
+import { loadAllTables } from './schema-relations.js';
+/** 진단 message 앞머리(`<table>.<column> …`)에서 소유 테이블을 뽑는다(파일 부착용). */
+function ownerOf(message) {
+    const m = message.match(/^([A-Za-z0-9_]+)\./);
+    return m ? m[1] : '';
+}
+/** 진단 message 앞머리(`<table>.<column> …`)에서 컬럼명을 뽑는다(--json detail). */
+function columnOf(message) {
+    const m = message.match(/^[A-Za-z0-9_]+\.([A-Za-z0-9_]+)/);
+    return m ? m[1] : '';
+}
+/**
+ * unique·PK 컬럼에 붙은 `.index()` 를 검사한다. domain/schema 가 없으면 통과.
+ * 스키마 로드 실패는 schema-relations 가 이미 안내하므로 여기서는 무소음으로
+ * 넘어간다(같은 원인에 대한 경고 중복 방지).
+ */
+export async function checkRedundantIndex(cwd) {
+    const schemaDir = join(cwd, 'domain', 'schema');
+    if (!existsSync(schemaDir))
+        return { rule: 'redundant-index', issues: [] };
+    let tables;
+    try {
+        tables = await loadAllTables(cwd, schemaDir);
+    }
+    catch {
+        return { rule: 'redundant-index', issues: [] };
+    }
+    // data 패키지 구현을 그대로 호출한다(재구현 금지 · 결정 134 관례).
+    const diags = checkRedundantIndexes(tables.tables);
+    const issues = diags.map((d) => {
+        const owner = ownerOf(d.message);
+        const file = tables.fileOf.get(owner);
+        return {
+            rule: 'redundant-index',
+            level: d.level === 'error' ? 'error' : 'warning',
+            message: d.message,
+            ...(file ? { file } : {}),
+            detail: { code: d.code, table: owner, column: columnOf(d.message) },
+        };
+    });
+    return { rule: 'redundant-index', issues };
+}

package/dist/doctor/schema-relations.d.ts

@@ -1,4 +1,17 @@
+import { type TableDef } from '@gaonjs/data';
 import type { RuleReport } from './types.js';
+/**
+ * domain/schema/ 의 모든 TableDef 를 커넥션 구분 없이 로드하고, 각 테이블이
+ * 어느 소스 파일에서 왔는지 함께 기록한다(진단에 파일 위치를 붙이기 위함).
+ *
+ * redundant-index(결정 460)도 같은 로드 경로를 쓴다 — 스키마 로드는 한 곳에만
+ * 둔다(scanSchemaDir 호출 관례가 검사마다 갈라지면 tsResolve 등록·경로 정규화가
+ * 서로 어긋난다).
+ */
+export declare function loadAllTables(cwd: string, schemaDir: string): Promise<{
+    tables: TableDef[];
+    fileOf: Map<string, string>;
+}>;
 /**
  * 프로젝트 전체의 §4.5 관계 제약을 검사한다. domain/schema 가 없으면 통과.
  * 스키마 로드 실패(문법 오류 등)는 이 검사만 warning 으로 강등하고 안내한다 —

package/dist/doctor/schema-relations.js

@@ -31,8 +31,12 @@ function isTableDef(v) {
 /**
  * domain/schema/ 의 모든 TableDef 를 커넥션 구분 없이 로드하고, 각 테이블이
  * 어느 소스 파일에서 왔는지 함께 기록한다(진단에 파일 위치를 붙이기 위함).
+ *
+ * redundant-index(결정 460)도 같은 로드 경로를 쓴다 — 스키마 로드는 한 곳에만
+ * 둔다(scanSchemaDir 호출 관례가 검사마다 갈라지면 tsResolve 등록·경로 정규화가
+ * 서로 어긋난다).
  */
-async function loadAllTables(cwd, schemaDir) {
+export async function loadAllTables(cwd, schemaDir) {
     registerTsResolve();
     // outDir 은 import 지정자 계산에만 쓰이고 파일을 쓰지 않는다(resolve.ts 관례).
     const outDir = join(cwd, '.gaon');

package/dist/doctor/types.d.ts

@@ -1,4 +1,4 @@
-export type DoctorRule = 'response-mixing' | 'n-plus-one' | 'dependency-direction' | 'connections' | 'migration-diff' | 'shared-purity' | 'no-auto-import' | 'schema-filename' | 'agents-doc-index' | 'agents-docs-stale' | 'column-casing' | 'model-filename' | 'page-filename' | 'auth-wiring' | 'ui-kit-wiring' | 'route-registration' | 'static-collision' | 'method-override' | 'csrf-wiring' | 'internal-anchor' | 'pageprops-destructure' | 'async-offload' | 'page-layout-breakpoint' | 'link-button-nesting' | 'seal-security' | 'schema-relations' | 'no-import-meta-env' | 'locale-parity' | 'render-return' | 'channel-collision' | 'channel-instance-authorize' | 'dotenv-node-env' | 'page-fetch' | 'i18n-layout' | 'i18n-app-scope';
+export type DoctorRule = 'response-mixing' | 'n-plus-one' | 'dependency-direction' | 'connections' | 'migration-diff' | 'shared-purity' | 'no-auto-import' | 'schema-filename' | 'agents-doc-index' | 'agents-docs-stale' | 'column-casing' | 'model-filename' | 'page-filename' | 'auth-wiring' | 'ui-kit-wiring' | 'route-registration' | 'static-collision' | 'method-override' | 'csrf-wiring' | 'internal-anchor' | 'pageprops-destructure' | 'async-offload' | 'page-layout-breakpoint' | 'link-button-nesting' | 'seal-security' | 'schema-relations' | 'no-import-meta-env' | 'locale-parity' | 'render-return' | 'channel-collision' | 'channel-instance-authorize' | 'dotenv-node-env' | 'page-fetch' | 'i18n-layout' | 'i18n-app-scope' | 'i18n-server-scope' | 'redundant-index';
 export type DoctorLevel = 'passed' | 'warning' | 'error';
 export interface DoctorCheck {
     readonly rule: DoctorRule;

package/dist/doctor.d.ts

@@ -7,6 +7,7 @@ export { inspectControllerForNPlusOne, checkNPlusOne } from './doctor/n-plus-one
 export { extractRelativeImports, checkDependencyDirection } from './doctor/dependency-direction.js';
 export { extractConfigDbKeys, analyzeConfigDb, extractKeyUses, checkConnections, } from './doctor/connections.js';
 export { checkSchemaRelations } from './doctor/schema-relations.js';
+export { checkRedundantIndex } from './doctor/redundant-index.js';
 export { scanSchema, checkMigrationDiff } from './doctor/migration-diff.js';
 export { inspectSharedSource, checkSharedPurity, } from './doctor/shared-purity.js';
 export { inspectConfigForAutoImport, inspectPackageJson, checkNoAutoImport, } from './doctor/no-auto-import.js';
@@ -27,6 +28,7 @@ export { usesLinkButtonNesting, checkLinkButtonNesting, } from './doctor/link-bu
 export { checkLocaleParity } from './doctor/locale-parity.js';
 export { checkI18nLayout } from './doctor/i18n-layout.js';
 export { checkI18nAppScope } from './doctor/i18n-app-scope.js';
+export { checkI18nServerScope } from './doctor/i18n-server-scope.js';
 export { checkChannelCollision, reexportSpecifier } from './doctor/channel-collision.js';
 export { checkChannelInstanceAuthorize, declaresInstance, hasAuthorize, } from './doctor/channel-instance-authorize.js';
 export { renderHuman, renderJson } from './doctor/reporter.js';
@@ -35,7 +37,7 @@ export { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, }
  * 실행할 검사 이름. 지정 없음(undefined) = 31개 모두.
  */
 /**
- * doctor 정적 검사 35종의 정본 목록(§2.2). `--check=` 필터의 인정 집합도
+ * doctor 정적 검사 37종의 정본 목록(§2.2). `--check=` 필터의 인정 집합도
  * 이 배열을 단일 출처로 삼는다(parseDoctorChecks) — 새 규칙 추가 시 여기만
  * 늘리면 실행·필터·타입이 함께 정합된다(손유지 중복 리스트 표류 방지).
  */

package/dist/doctor.js

@@ -1,7 +1,7 @@
 /**
  * @gaonjs/cli · `gaon doctor` — 정적 검사 (M9-E · CLI DX 완성 · E-5 확장)
  *
- * 33 검사를 조립한다:
+ * 검사를 조립한다(수는 ALL_RULES 가 단일 출처 — CLI help·AGENTS §2.2 가 그걸 읽는다):
  *  1) response-mixing (errata E-3 §C · 라이브)
  *  2) n-plus-one (errata E-4 (e))
  *  3) dependency-direction (CLAUDE.md §5 · 4 규칙)
@@ -30,13 +30,16 @@
  * 25) schema-relations (§4.5 · 결정 134 · 커넥션 가로지르는 belongsTo·관계 · 대상 부재 error)
  * 26) no-import-meta-env (결정 198 · F-9 ② · `.vue` 의 import.meta.env = TS1470 → env 접근자 안내 error)
  * 27) locale-parity (결정 216 · 13차 W4 · 로케일 간 키 부분 누락 = fallback 조용 노출 경고)
- * 34) i18n-layout (결정 454 · 레거시 단일 파일 = 클라 t() 불가 안내 · --fix 로 폴더 이관)
- * 35) i18n-app-scope (결정 454 · 앱 카탈로그에 없는 클라 t() 키 = 런타임 키 노출)
  * 28) render-return (결정 340 · this.render/redirect/json 호출만 하고 return 누락 = 무신호 204 경고)
  * 29) channel-collision (§7 · 앱간 동명 채널 = 전역 subject·프레즌스 병합 error)
  * 30) channel-instance-authorize (결정 440 · authorize 없는 인스턴스 채널 = 임의 인스턴스 공개 입장 경고)
  * 31) dotenv-node-env (결정 430 · 공유 .env 의 NODE_ENV = 모드 누출 경고)
  * 32) page-fetch (결정 453 · 세션 앱 .vue 의 내부 경로 raw fetch = CSRF 미부착 403 경고)
+ * 33) i18n-layout (결정 454·459 · 옛 카탈로그 배치 = 안 읽히는 폴더 안내 · --fix 로 이관)
+ * 34) i18n-app-scope (결정 454·459 · 그 앱 카탈로그에 없는 클라 t() 키 = 런타임 키 노출 ·
+ *     shared/ 가 쓰는 키는 전 앱에 있어야 한다)
+ * 35) i18n-server-scope (결정 459 · 소유자 경계를 넘는 서버 t() 키 = 워커·크론에서 조용히 빔)
+ * 36) redundant-index (결정 460 · unique·PK 컬럼의 `.index()` = DDL 이 조용히 건너뜀 경고)
  *
  * 각 검사는 순수 함수(cwd → RuleReport). 상위 runDoctorCommand 가 조립해
  * DoctorResult 로 낸다. --json 은 자동화(CI)를 위해 반드시 파싱 가능한
@@ -45,9 +48,9 @@
  * 하위 호환: 기존 응답 혼용 API(`inspectControllerSource`·`runDoctor`)는
  * 그대로 export — 기존 테스트가 계속 동작한다.
  */
-import { rename, writeFile } from 'node:fs/promises';
+import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
-import { join, resolve } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
 import ts from 'typescript';
 import { checkResponseMixing } from './doctor/response-mixing.js';
 import { checkRenderReturn } from './doctor/render-return.js';
@@ -55,6 +58,7 @@ import { checkNPlusOne } from './doctor/n-plus-one.js';
 import { checkDependencyDirection } from './doctor/dependency-direction.js';
 import { checkConnections } from './doctor/connections.js';
 import { checkSchemaRelations } from './doctor/schema-relations.js';
+import { checkRedundantIndex } from './doctor/redundant-index.js';
 import { checkMigrationDiff } from './doctor/migration-diff.js';
 import { checkSharedPurity } from './doctor/shared-purity.js';
 import { checkNoAutoImport } from './doctor/no-auto-import.js';
@@ -80,6 +84,7 @@ import { checkNoImportMetaEnv } from './doctor/no-import-meta-env.js';
 import { checkLocaleParity } from './doctor/locale-parity.js';
 import { checkI18nLayout } from './doctor/i18n-layout.js';
 import { checkI18nAppScope } from './doctor/i18n-app-scope.js';
+import { checkI18nServerScope } from './doctor/i18n-server-scope.js';
 import { checkChannelCollision } from './doctor/channel-collision.js';
 import { checkChannelInstanceAuthorize } from './doctor/channel-instance-authorize.js';
 import { checkDotenvNodeEnv } from './doctor/dotenv-node-env.js';
@@ -94,6 +99,7 @@ export { inspectControllerForNPlusOne, checkNPlusOne } from './doctor/n-plus-one
 export { extractRelativeImports, checkDependencyDirection } from './doctor/dependency-direction.js';
 export { extractConfigDbKeys, analyzeConfigDb, extractKeyUses, checkConnections, } from './doctor/connections.js';
 export { checkSchemaRelations } from './doctor/schema-relations.js';
+export { checkRedundantIndex } from './doctor/redundant-index.js';
 export { scanSchema, checkMigrationDiff } from './doctor/migration-diff.js';
 export { inspectSharedSource, checkSharedPurity, } from './doctor/shared-purity.js';
 export { inspectConfigForAutoImport, inspectPackageJson, checkNoAutoImport, } from './doctor/no-auto-import.js';
@@ -114,6 +120,7 @@ export { usesLinkButtonNesting, checkLinkButtonNesting, } from './doctor/link-bu
 export { checkLocaleParity } from './doctor/locale-parity.js';
 export { checkI18nLayout } from './doctor/i18n-layout.js';
 export { checkI18nAppScope } from './doctor/i18n-app-scope.js';
+export { checkI18nServerScope } from './doctor/i18n-server-scope.js';
 export { checkChannelCollision, reexportSpecifier } from './doctor/channel-collision.js';
 export { checkChannelInstanceAuthorize, declaresInstance, hasAuthorize, } from './doctor/channel-instance-authorize.js';
 export { renderHuman, renderJson } from './doctor/reporter.js';
@@ -122,7 +129,7 @@ export { checkTypeScriptApi, detectProject, fatalNoProject, fatalTsApiMissing, }
  * 실행할 검사 이름. 지정 없음(undefined) = 31개 모두.
  */
 /**
- * doctor 정적 검사 35종의 정본 목록(§2.2). `--check=` 필터의 인정 집합도
+ * doctor 정적 검사 37종의 정본 목록(§2.2). `--check=` 필터의 인정 집합도
  * 이 배열을 단일 출처로 삼는다(parseDoctorChecks) — 새 규칙 추가 시 여기만
  * 늘리면 실행·필터·타입이 함께 정합된다(손유지 중복 리스트 표류 방지).
  */
@@ -162,6 +169,8 @@ export const ALL_RULES = [
     'page-fetch',
     'i18n-layout',
     'i18n-app-scope',
+    'i18n-server-scope',
+    'redundant-index',
 ];
 /**
  * `gaon help` 이 doctor 한 줄에 요약할 규칙별 문구(§2.2 상세는 AGENTS). 타입이
@@ -199,12 +208,14 @@ export const RULE_SUMMARIES = {
     'no-import-meta-env': 'import.meta.env',
     'locale-parity': '로케일 커버리지',
     'i18n-layout': 'i18n 카탈로그 레이아웃(단일 파일 → backend/frontend 분리 안내 · 결정 454)',
-    'i18n-app-scope': '앱 경계를 넘는 클라 번역 키(그 앱 카탈로그에 없는 t() 키 · 결정 454)',
+    'i18n-app-scope': '앱 경계를 넘는 클라 번역 키(그 앱 카탈로그에 없는 t() 키 · 결정 454·459)',
+    'i18n-server-scope': '소유자 경계를 넘는 서버 번역 키(도메인이 앱 키를 쓰면 워커에서 빔 · 결정 459)',
     'render-return': 'render return 누락',
     'channel-collision': '앱간 동명 채널',
     'channel-instance-authorize': '인스턴스 채널 authorize',
     'dotenv-node-env': '.env NODE_ENV',
     'page-fetch': '세션 앱 raw fetch',
+    'redundant-index': 'unique·PK 컬럼의 무시되는 .index()',
 };
 const CHECKERS = {
     'response-mixing': checkResponseMixing,
@@ -237,6 +248,8 @@ const CHECKERS = {
     'locale-parity': checkLocaleParity,
     'i18n-layout': checkI18nLayout,
     'i18n-app-scope': checkI18nAppScope,
+    'i18n-server-scope': checkI18nServerScope,
+    'redundant-index': checkRedundantIndex,
     'render-return': checkRenderReturn,
     'channel-collision': checkChannelCollision,
     'channel-instance-authorize': checkChannelInstanceAuthorize,
@@ -435,6 +448,9 @@ export async function runDoctorFix(reports, cwd, apply) {
                         await writeFile(join(cwd, ref.file), ref.after, 'utf8');
                         backups.push(bak);
                     }
+                    // 이관 대상은 새 폴더일 수 있다(예 locales/ko.json → domain/locales/ko/backend.json)
+                    // — 부모가 없으면 rename 이 ENOENT 로 죽는다(결정 459).
+                    await mkdir(dirname(join(cwd, plan.to)), { recursive: true });
                     await rename(join(cwd, plan.file), join(cwd, plan.to));
                     outcomes.push({
                         rule: report.rule,
@@ -445,17 +461,33 @@ export async function runDoctorFix(reports, cwd, apply) {
                     });
                     continue;
                 }
-                // 내용 재작성 — 원본 백업 먼저.
+                if (plan.kind === 'remove') {
+                    // 결정 459: 원본을 백업한 뒤 지운다(복제가 이미 끝난 이관의 마지막 단계).
+                    const backupRel = `${plan.file}.bak-${ts}`;
+                    await writeFile(join(cwd, backupRel), plan.before, 'utf8');
+                    await rm(join(cwd, plan.file), { force: true });
+                    outcomes.push({
+                        rule: report.rule,
+                        file: plan.file,
+                        summary: plan.summary,
+                        applied: true,
+                        backup: backupRel,
+                    });
+                    continue;
+                }
+                // 내용 재작성 — 원본 백업 먼저. 새 파일(before='')이면 부모 폴더를 만든다.
                 const abs = join(cwd, plan.file);
                 const backupRel = `${plan.file}.bak-${ts}`;
-                await writeFile(join(cwd, backupRel), plan.before, 'utf8');
+                await mkdir(dirname(abs), { recursive: true });
+                if (plan.before !== '')
+                    await writeFile(join(cwd, backupRel), plan.before, 'utf8');
                 await writeFile(abs, plan.after, 'utf8');
                 outcomes.push({
                     rule: report.rule,
                     file: plan.file,
                     summary: plan.summary,
                     applied: true,
-                    backup: backupRel,
+                    backup: plan.before === '' ? undefined : backupRel,
                 });
             }
             catch (err) {

package/dist/i18n-config.d.ts

@@ -1,7 +1,11 @@
 export interface ConfigI18nAnalysis {
     /** defineConfig 인자에 i18n 프로퍼티가 존재하는가. */
     readonly declared: boolean;
-    /** 정적 리터럴로 읽힌 dir(상대 경로 원문). 못 읽으면 undefined. */
+    /**
+     * 결정 459: `i18n.dir` 은 **제거된 설정**이다(카탈로그 위치는 관례 고정). 여기서는
+     * 더 이상 카탈로그를 찾는 데 쓰지 않고, **남아 있으면 doctor 가 error 로 잡기 위해서만**
+     * 읽는다(조용히 무시하면 "설정했는데 왜 안 먹지" 로 시간이 녹는다).
+     */
     readonly dir?: string;
     /** 정적 리터럴로 읽힌 fallbackLng. 못 읽으면 undefined. */
     readonly fallbackLng?: string;
@@ -18,15 +22,11 @@ export interface ConfigI18nAnalysis {
 export declare function analyzeConfigI18n(source: string): ConfigI18nAnalysis;
 /** cwd 의 gaon.config.ts 를 읽어 i18n 블록을 분석한다. 파일이 없으면 미선언. */
 export declare function analyzeProjectI18n(cwd: string): ConfigI18nAnalysis;
-/**
- * 결정 412: 카탈로그 디렉터리의 절대 경로. `dir` 이 절대 경로면 그대로 쓴다 —
- * wire(런타임)는 이미 그렇게 해석하는데 CLI 축만 무조건 join 해서
- * `join('/proj','/var/locales')` = `/proj/var/locales` 로 조용히 빗나갔다.
- */
-export declare function resolveLocalesDir(cwd: string, dir: string | undefined): string;
 /**
  * 결정 412: 정적으로 못 읽은 i18n 키를 한 줄 경고로 알린다(무신호 금지). 런타임은
- * 실값을, 타입 축·doctor 는 폴백을 쓰므로 messages.d.ts 가 엉뚱한 카탈로그를 보거나
- * 아예 안 생길 수 있다 — 어느 형태로 바꾸면 되는지까지 쓴다(§7.5.3).
+ * 실값을, 타입 축·doctor 는 폴백을 쓰므로 messages.d.ts 가 엉뚱한 기준 로케일을 볼 수
+ * 있다 — 어느 형태로 바꾸면 되는지까지 쓴다(§7.5.3).
+ * 결정 459: 카탈로그 **위치**는 관례 고정이라 `dir` 미해석은 더 이상 축을 갈라놓지 않는다
+ * (남아 있는 `dir` 자체는 doctor `i18n-layout` 이 error 로 잡는다) — fallbackLng 만 경고한다.
  */
 export declare function warnUnresolvedI18n(analysis: ConfigI18nAnalysis, write: (s: string) => void): void;

package/dist/i18n-config.js

@@ -133,26 +133,19 @@ export function analyzeProjectI18n(cwd) {
         return { declared: false, unresolved: [] };
     }
 }
-/**
- * 결정 412: 카탈로그 디렉터리의 절대 경로. `dir` 이 절대 경로면 그대로 쓴다 —
- * wire(런타임)는 이미 그렇게 해석하는데 CLI 축만 무조건 join 해서
- * `join('/proj','/var/locales')` = `/proj/var/locales` 로 조용히 빗나갔다.
- */
-export function resolveLocalesDir(cwd, dir) {
-    const d = dir ?? 'locales';
-    return d.startsWith('/') ? d : join(cwd, d);
-}
 /**
  * 결정 412: 정적으로 못 읽은 i18n 키를 한 줄 경고로 알린다(무신호 금지). 런타임은
- * 실값을, 타입 축·doctor 는 폴백을 쓰므로 messages.d.ts 가 엉뚱한 카탈로그를 보거나
- * 아예 안 생길 수 있다 — 어느 형태로 바꾸면 되는지까지 쓴다(§7.5.3).
+ * 실값을, 타입 축·doctor 는 폴백을 쓰므로 messages.d.ts 가 엉뚱한 기준 로케일을 볼 수
+ * 있다 — 어느 형태로 바꾸면 되는지까지 쓴다(§7.5.3).
+ * 결정 459: 카탈로그 **위치**는 관례 고정이라 `dir` 미해석은 더 이상 축을 갈라놓지 않는다
+ * (남아 있는 `dir` 자체는 doctor `i18n-layout` 이 error 로 잡는다) — fallbackLng 만 경고한다.
  */
 export function warnUnresolvedI18n(analysis, write) {
-    if (analysis.unresolved.length === 0)
+    if (!analysis.unresolved.includes('fallbackLng'))
         return;
-    write(`  ! gaon.config.ts 의 i18n ${analysis.unresolved.join('·')} 을(를) 정적으로 읽지 못했습니다 — ` +
-        `타입 축(.gaon/messages.d.ts)과 doctor 는 기본값(dir='locales' · 기준=정렬 첫 로케일)을 씁니다.\n` +
-        `    → 문자열 리터럴로 직접 쓰면 정확히 반영됩니다: i18n: { dir: 'locales', fallbackLng: 'ko' }\n`);
+    write(`  ! gaon.config.ts 의 i18n fallbackLng 를 정적으로 읽지 못했습니다 — ` +
+        `타입 축(.gaon/messages.d.ts)과 doctor 는 기본값(기준=정렬 첫 로케일)을 씁니다.\n` +
+        `    → 문자열 리터럴로 직접 쓰면 정확히 반영됩니다: i18n: { fallbackLng: 'ko' }\n`);
 }
 function isDefineConfig(e) {
     if (ts.isIdentifier(e) && e.text === 'defineConfig')

package/dist/messages-gen.d.ts

@@ -1,27 +1,27 @@
-import { type LocaleResources } from '@gaonjs/i18n';
+import { type ScopedLocaleResources } from '@gaonjs/i18n';
 /** 메시지 축이 카탈로그 모듈을 낼 앱(결정 454). dev 레이아웃이 만들어 넘긴다. */
 export interface MessagesApp {
     readonly name: string;
-    /** apps/<앱>/locales (앱 전용 frontend 카탈로그 · 없어도 된다). */
+    /** apps/<앱>/locales (그 앱의 스코프 카탈로그 · 없어도 된다). */
     readonly localesDir: string;
     /** apps/<앱>/.gaon/messages.catalog.ts */
     readonly catalogOut: string;
 }
 /**
- * locales/ 카탈로그에서 `.gaon/messages.d.ts`(두 갈래)와 앱별 카탈로그 값 모듈을 생성한다.
- * 카탈로그가 없거나 비면 생성하지 않는다(GaonMessages 를 비운 채로 둬 키가 string 폴백 —
- * i18n 을 안 쓰는 프로젝트가 never 로 깨지지 않게). 생성 여부를 돌려준다.
+ * 프로젝트 카탈로그(domain/locales · apps/*&#47;locales)에서 `.gaon/messages.d.ts`(두 갈래)와
+ * 앱별 카탈로그 값 모듈을 생성한다. 카탈로그가 없거나 비면 생성하지 않는다(GaonMessages 를
+ * 비운 채로 둬 키가 string 폴백 — i18n 을 안 쓰는 프로젝트가 never 로 깨지지 않게).
+ * 생성 여부를 돌려준다.
  */
-export declare function generateMessagesDts(localesDir: string, out: string, baseLng?: string, apps?: readonly MessagesApp[]): boolean;
+export declare function generateMessagesDts(root: string, out: string, baseLng?: string, apps?: readonly MessagesApp[]): boolean;
 interface CatalogInput {
-    readonly localesDir: string;
     readonly app: MessagesApp;
-    readonly appLocales: LocaleResources;
-    readonly frontendLangs: readonly string[];
+    /** 그 앱의 스코프 카탈로그(없으면 undefined = locales 폴더 부재). */
+    readonly appScoped: ScopedLocaleResources | undefined;
     readonly fallbackLng: string;
 }
 /**
- * 결정 454: 앱별 카탈로그 값 모듈을 쓴다. 로케일별 로더가 **공용 frontend + 앱 카탈로그**를
+ * 결정 454·459: 앱별 카탈로그 값 모듈을 쓴다. 로케일별 로더가 **그 앱의 frontend.json 하나**를
  * 동적 import 해 vite 가 로케일별 해시 청크(.js)로 쪼갠다 — `/assets/*` immutable 캐시 대상이며
  * `text/javascript` 라 seal 봉인 대상(application/json)에서 자연 면제된다.
  * 생성 여부를 돌려준다(프론트 카탈로그가 없으면 false + 스테일 제거).