sh-ui-cli 0.75.0 → 0.77.0

package/bin/sh-ui.mjs

@@ -35,7 +35,7 @@ const usage = `사용법:
                                    (--apply 로 실제 적용)
   sh-ui mcp                        MCP 서버(stdio) 시작 — IDE-내 AI용
   sh-ui mcp init --client <name>   IDE MCP 설정 파일에 sh-ui 엔트리 자동 추가
-                                   (claude-code | cursor | claude-desktop)
+                                   (claude-code | cursor | claude-desktop | codex)
   옵션:
     --skip-install                 (add, rename-app) 외부 패키지 자동 설치 생략
     --diff                         (add) 파일을 쓰지 않고 변경 내역만 출력

package/data/changelog/versions.json

@@ -2,6 +2,45 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.77.0",
+      "date": "2026-05-11",
+      "title": "minor — `--arch mes` 프리셋 — 백오피스용 페이지 격리 구조",
+      "type": "minor",
+      "highlights": [
+        "**`sh-ui-cli create ... --arch mes` 신규 지원** — 스마트팩토리 MES·ERP·관리자 도구처럼 페이지 간 상호작용이 적은 CRUD-heavy 앱을 위한 페이지 격리 프리셋. FSD 의 6 레이어가 과한 백오피스 시나리오 전용.",
+        "**페이지 격리 구조** — 각 `src/pages/<name>/` 가 자기완결 슬롯 (index.tsx + components/ + api.ts + hooks.ts + schema.ts + columns.ts). `app/<route>/page.tsx` 는 `export { default } from '@/pages/<name>'` 한 줄 위임. 페이지 끼리는 import 금지 (eslint boundaries 강제).",
+        "**`src/pages/sign-in/` 스텁 동봉** — 슬롯 레이아웃을 보여주는 빈 페이지 (동작 X, 폴더 모양만). 새 페이지 추가 = 이 폴더 복사 → 이름 교체.",
+        "**tsconfig** — catch-all `@/*` → `./src/*`. 모든 import 가 `@/pages/...`, `@/components/...`, `@/lib/...` 처럼 짧고 일관.",
+        "monorepo (`apps/<name>` + `packages/ui/...`) 에서도 `--arch mes` 동작. nextjs-standalone / nextjs-app 두 템플릿 모두 mes overlay 포함."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.77.0"
+    },
+    {
+      "version": "0.76.1",
+      "date": "2026-05-11",
+      "title": "patch — Switch ON 상태 thumb 가시성 (다크모드)",
+      "type": "patch",
+      "highlights": [
+        "**Switch — checked thumb 가 `--primary-foreground` 로 전환** — 다크모드는 `--primary` 가 거의 흰색(`#FAFAFA`)인데 thumb 가 하드코딩 `white` 라 ON 상태에서 thumb 와 트랙이 같은 색으로 묻혀 위치를 알 수 없던 문제 수정.",
+        "변종 4종 동기화 — `styles.css` / `styles.module.css` / `index.tailwind.tsx` / docs 복사본.",
+        "라이트/다크 양쪽 모두 트랙과 thumb 가 항상 반전 대비를 유지."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.76.1"
+    },
+    {
+      "version": "0.76.0",
+      "date": "2026-05-11",
+      "title": "minor — `sh-ui mcp init` 가 codex CLI 도 자동 등록",
+      "type": "minor",
+      "highlights": [
+        "**`sh-ui mcp init --client codex` 신규 지원** — `~/.codex/config.toml` 의 `[mcp_servers.sh-ui]` 섹션을 자동 upsert. 이제 codex 사용자도 한 번에 sh-ui MCP 등록.",
+        "**TOML 텍스트 기반 머지** — 다른 섹션·주석·공백을 그대로 보존. `[mcp_servers.sh-ui]` 와 그 하위(`.env` 등)만 교체 후 새 블록을 append. 멱등 보장(연속 호출 결과 동일).",
+        "**inline-table 정의는 명시적 에러** — 기존 `[mcp_servers]` 부모 섹션 안에 `sh-ui = { ... }` 형태로 정의돼 있으면 자동 갱신 대신 명확한 메시지로 수동 정리 안내. 사용자 config 손상 방지.",
+        "claude-code / cursor / claude-desktop 동작은 변화 없음."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.76.0"
+    },
     {
       "version": "0.75.0",
       "date": "2026-05-11",

package/data/registry/react/components/switch/index.tailwind.tsx

@@ -18,7 +18,7 @@ const switchRoot = cva(
 );
 
 const switchThumb = cva(
-  "block rounded-full bg-white shadow-[var(--shadow-sm)] transition-transform duration-150 ease-out motion-reduce:transition-none forced-colors:[background:ButtonText] forced-colors:data-[checked]:[background:HighlightText] forced-colors:data-[disabled]:[background:GrayText]",
+  "block rounded-full bg-white data-[checked]:bg-primary-foreground shadow-[var(--shadow-sm)] transition-transform duration-150 ease-out motion-reduce:transition-none forced-colors:[background:ButtonText] forced-colors:data-[checked]:[background:HighlightText] forced-colors:data-[disabled]:[background:GrayText]",
   {
     variants: {
       size: {

package/data/registry/react/components/switch/styles.css

@@ -74,6 +74,12 @@
   transform: translateX(1.125rem);
 }
 
+/* checked 상태에서 thumb 와 트랙(--primary)이 같은 색으로 보이지 않도록
+   --primary-foreground 로 전환 (다크모드: primary=near-white → thumb=dark). */
+.sh-ui-switch[data-checked] .sh-ui-switch__thumb {
+  background: var(--primary-foreground);
+}
+
 /* reduced motion */
 @media (prefers-reduced-motion: reduce) {
   .sh-ui-switch,

package/data/registry/react/components/switch/styles.module.css

@@ -74,6 +74,12 @@
   transform: translateX(1.125rem);
 }
 
+/* checked 상태에서 thumb 와 트랙(--primary)이 같은 색으로 보이지 않도록
+   --primary-foreground 로 전환 (다크모드: primary=near-white → thumb=dark). */
+.switch[data-checked] .switch__thumb {
+  background: var(--primary-foreground);
+}
+
 /* reduced motion */
 @media (prefers-reduced-motion: reduce) {
   .switch,

package/data/registry/react/tokens-used.json

@@ -1,6 +1,6 @@
 {
   "$description": "컴포넌트별 토큰 의존성 (var(--*) 추출). build-registry-tokens.mjs 가 자동 생성.",
-  "$generated": "2026-05-09T05:12:23.351Z",
+  "$generated": "2026-05-11T07:02:18.245Z",
   "components": {
     "button": {
       "plain": [
@@ -1556,6 +1556,7 @@
         "--border-width-strong",
         "--opacity-disabled",
         "--primary",
+        "--primary-foreground",
         "--primary-hover",
         "--ring",
         "--shadow-sm"
@@ -1571,6 +1572,7 @@
         "--border-width-strong",
         "--opacity-disabled",
         "--primary",
+        "--primary-foreground",
         "--primary-hover",
         "--ring",
         "--shadow-sm"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh-ui-cli",
-  "version": "0.75.0",
+  "version": "0.77.0",
   "description": "sh-ui CLI — 프로젝트 스캐폴드(create) + 컴포넌트 추가(add/list/remove) + IDE-내 AI용 MCP 서버",
   "license": "MIT",
   "repository": {
@@ -27,10 +27,10 @@
   "dependencies": {
     "@inquirer/prompts": "^7.0.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "fs-extra": "^11.2.0",
+    "fs-extra": "^11.3.5",
     "vitest": "^3.2.4"
   },
   "publishConfig": {

package/src/create/architectures/index.js

@@ -1,8 +1,9 @@
 import { fsdArch } from './fsd.js';
 import { flatArch } from './flat.js';
+import { mesArch } from './mes.js';
 import { validateArchitectures } from './archSchema.js';
 
-export const allArchitectures = [fsdArch, flatArch];
+export const allArchitectures = [fsdArch, flatArch, mesArch];
 
 // 모듈 로드 시점에 모든 arch 디스크립터를 schema 로 검증.
 // 누락된 키, 잘못된 형태가 있으면 즉시 에러.

package/src/create/architectures/mes.js

@@ -0,0 +1,53 @@
+/**
+ * MES (Backoffice) 아키텍처 디스크립터.
+ *
+ * 스마트팩토리 MES·ERP·관리자 도구처럼 **페이지 간 상호작용이 거의 없고**
+ * 페이지마다 자기 컬럼/스키마/다이얼로그를 다시 정의하는 CRUD-heavy 앱을 위한
+ * 페이지 격리 구조.
+ *
+ * 핵심 컨벤션:
+ *   - `app/<route>/page.tsx` 는 한 줄짜리 위임 (`export { default } from "@/pages/<name>"`)
+ *   - 페이지 본체는 `src/pages/<name>/` 에 자기완결로 거주 — index.tsx, components/,
+ *     api.ts, hooks.ts, schema.ts, columns.ts.
+ *   - 두 페이지 이상에서 같은 코드가 보이기 시작하면 그때 `src/components/` `src/hooks/`
+ *     `src/lib/` 로 승격. **두 번째 쓰임이 나타나기 전엔 공용 만들지 않기.**
+ *
+ * tsconfig 의 `paths` 는 FSD 처럼 catch-all `@/*` 를 쓰되 매핑 대상이 `./src/*` —
+ * 즉 모든 import 가 `@/pages/...`, `@/components/...`, `@/lib/...` 처럼 `src/` 루트
+ * 기준으로 짧게 정리된다.
+ */
+export const mesArch = {
+  name: 'mes',
+  label: 'MES (Backoffice)',
+  description:
+    '페이지 격리 구조 (src/pages/<name>/ 자기완결). 페이지 간 상호작용이 적은 CRUD-heavy 관리자 도구·MES 류에 적합.',
+  platforms: ['next'],
+
+  paths: {
+    layouts:    'src/components/layouts',
+    providers:  'src/components/providers',
+    api:        'src/lib/api',
+    config:     'src/lib/config',
+    hooks:      'src/hooks',
+    utils:      'src/lib/utils',
+    ui:         'src/components/common',
+    test:       'src/lib/test',
+  },
+
+  aliases: {
+    layouts:    '@/components/layouts',
+    providers:  '@/components/providers',
+    api:        '@/lib/api',
+    config:     '@/lib/config',
+    hooks:      '@/hooks',
+    utils:      '@/lib/utils',
+    ui:         '@/components/common',
+    test:       '@/lib/test',
+  },
+
+  // Catch-all `@/*` → `./src/*`. FSD 와 같은 결의 명명이지만 src/ 루트가 바뀜.
+  // `@/pages/customers`, `@/components/...`, `@/lib/api/...` 모두 자연스럽게 풀린다.
+  tsconfigPaths: {
+    '@/*': ['./src/*'],
+  },
+};

package/src/mcp-init.mjs

@@ -4,20 +4,25 @@
 //   claude-code     — project: <cwd>/.mcp.json,           user: ~/.claude.json
 //   cursor          — project: <cwd>/.cursor/mcp.json,    user: ~/.cursor/mcp.json
 //   claude-desktop  — user 만 (OS 별 경로 자동 분기)
+//   codex           — user 만 (~/.codex/config.toml — TOML 포맷)
 //
 // 주의: Claude Code 의 user-scope 설정은 `~/.claude/mcp.json` 같은 별도
 // 파일이 아니라 사용자 settings 전체가 들어가는 단일 JSON `~/.claude.json`
 // 이다. 이 파일에는 mcpServers 외에도 projects·history 등 다른 키가 같이
-// 들어 있으므로, 머지 시 다른 키를 절대 건드리지 않아야 한다.
+// 들어 있으므로, 머지 시 다른 키를 절대 건드리지 않아야 한다. codex 의
+// config.toml 도 같은 원칙 — 다른 섹션은 건드리지 않고 `[mcp_servers.sh-ui]`
+// 만 upsert 한다.
 //
-// 동작: 기존 JSON 의 mcpServers.sh-ui 를 머지(있으면 덮어쓰기), 디렉토리 자동 생성.
+// 동작: JSON 클라이언트는 mcpServers.sh-ui 머지(있으면 덮어쓰기). codex 는
+// `[mcp_servers.sh-ui]` 섹션 텍스트를 통째로 교체(존재하지 않으면 append).
+// 디렉토리는 자동 생성.
 
 import { readFile, writeFile, mkdir } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { dirname, resolve, relative } from "node:path";
 import { homedir, platform as osPlatform } from "node:os";
 
-const CLIENTS = ["claude-code", "cursor", "claude-desktop"];
+const CLIENTS = ["claude-code", "cursor", "claude-desktop", "codex"];
 
 /**
  * `npx -y <cliName> mcp` 형태의 MCP 엔트리 빌더.
@@ -68,12 +73,138 @@ function resolveConfigPath(client, scope, cwd) {
     // linux + 기타
     return resolve(home, ".config", "Claude", "claude_desktop_config.json");
   }
+  if (client === "codex") {
+    if (scope !== "user") {
+      throw new Error(
+        "codex 는 user 스코프만 지원합니다. --scope user 또는 --scope 생략.",
+      );
+    }
+    return resolve(home, ".codex", "config.toml");
+  }
   throw new Error(`알 수 없는 클라이언트: ${client}. 허용: ${CLIENTS.join(", ")}`);
 }
 
-/** 클라이언트별 기본 스코프. claude-desktop 은 user 강제. */
+/** 클라이언트별 기본 스코프. claude-desktop·codex 는 user 강제. */
 function defaultScope(client) {
-  return client === "claude-desktop" ? "user" : "project";
+  return client === "claude-desktop" || client === "codex" ? "user" : "project";
+}
+
+/**
+ * codex `~/.codex/config.toml` 의 `[mcp_servers.<name>]` 섹션 upsert.
+ *
+ * 텍스트 기반 — 다른 섹션·주석·공백을 보존하기 위해 TOML 파서를 안 쓴다.
+ * `[mcp_servers.<name>]` 와 그 하위 (`[mcp_servers.<name>.env]` 등) 모두
+ * 제거 후, 새 블록을 파일 끝에 append.
+ *
+ * 한계: 사용자가 inline-table 형태(`[mcp_servers]` 부모 섹션 안에
+ * `sh-ui = { command = ... }`)로 정의해두면 그건 감지·정리하지 못한다.
+ * 그 경우 새 섹션과 충돌하므로 detect → 명시적 에러.
+ */
+export function upsertCodexMcpServer(raw, name, entry) {
+  detectInlineMcpServer(raw, name);
+  const had = hasCodexMcpServerSection(raw, name);
+
+  const lines = raw.split("\n");
+  const out = [];
+  let i = 0;
+  while (i < lines.length) {
+    if (isOurSectionHeader(lines[i], name)) {
+      // 섹션 본문 끝(다음 헤더 직전 또는 EOF)까지 skip
+      i++;
+      while (i < lines.length && !isAnySectionHeader(lines[i])) i++;
+      // 새 블록을 끝에 붙일 거라, 우리가 지운 섹션 직전의 빈 줄은 정리
+      while (out.length && out[out.length - 1].trim() === "") out.pop();
+    } else {
+      out.push(lines[i]);
+      i++;
+    }
+  }
+
+  let head = out.join("\n").replace(/\s+$/, "");
+  const block = renderCodexBlock(name, entry);
+  const next = head === "" ? block + "\n" : head + "\n\n" + block + "\n";
+  return { text: next, had };
+}
+
+function isAnySectionHeader(line) {
+  return /^\s*\[[^\]]+\]\s*$/.test(line);
+}
+
+function isOurSectionHeader(line, name) {
+  const m = line.match(/^\s*\[([^\]]+)\]\s*$/);
+  if (!m) return false;
+  const path = m[1].trim();
+  const bare = `mcp_servers.${name}`;
+  const quoted = `mcp_servers."${name}"`;
+  return (
+    path === bare ||
+    path === quoted ||
+    path.startsWith(bare + ".") ||
+    path.startsWith(quoted + ".")
+  );
+}
+
+function hasCodexMcpServerSection(raw, name) {
+  return raw.split("\n").some((line) => {
+    const m = line.match(/^\s*\[([^\]]+)\]\s*$/);
+    if (!m) return false;
+    const path = m[1].trim();
+    return path === `mcp_servers.${name}` || path === `mcp_servers."${name}"`;
+  });
+}
+
+/** `[mcp_servers]` 부모 섹션 안에 `<name> =` 로 inline 정의돼 있으면 에러. */
+function detectInlineMcpServer(raw, name) {
+  const lines = raw.split("\n");
+  let inMcpServers = false;
+  for (const line of lines) {
+    const headerMatch = line.match(/^\s*\[([^\]]+)\]\s*$/);
+    if (headerMatch) {
+      inMcpServers = headerMatch[1].trim() === "mcp_servers";
+      continue;
+    }
+    if (!inMcpServers) continue;
+    const keyRegex = new RegExp(`^\\s*(?:${escapeReg(name)}|"${escapeReg(name)}")\\s*=`);
+    if (keyRegex.test(line)) {
+      throw new Error(
+        `기존 config.toml 의 [mcp_servers] 섹션 안에 '${name}' 가 inline-table 로 정의돼 있습니다.\n` +
+          `자동 갱신을 지원하지 않으니, 해당 줄을 직접 제거한 뒤 다시 실행하세요.`,
+      );
+    }
+  }
+}
+
+function escapeReg(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+function renderCodexBlock(name, entry) {
+  const header = `[mcp_servers.${tomlBareOrQuoted(name)}]`;
+  const lines = [header];
+  lines.push(`command = ${tomlBasicString(entry.command)}`);
+  lines.push(`args = ${tomlInlineArray(entry.args)}`);
+  if (entry.env && Object.keys(entry.env).length > 0) {
+    lines.push("");
+    lines.push(`[mcp_servers.${tomlBareOrQuoted(name)}.env]`);
+    for (const [k, v] of Object.entries(entry.env)) {
+      lines.push(`${tomlBareOrQuoted(k)} = ${tomlBasicString(v)}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+function tomlBareOrQuoted(key) {
+  return /^[A-Za-z0-9_-]+$/.test(key) ? key : tomlBasicString(key);
+}
+
+function tomlBasicString(s) {
+  // TOML basic string 은 JSON string 과 escape 규칙이 호환 (\" \\ \n \t \r \b \f \uXXXX).
+  // ASCII 위주 값(npx, sh-ui-cli, mcp 등)에 한해 안전.
+  return JSON.stringify(String(s));
+}
+
+function tomlInlineArray(arr) {
+  return `[${arr.map(tomlBasicString).join(", ")}]`;
 }
 
 /** JSON 읽기 (없으면 빈 객체). 깨진 JSON 은 명시적 에러. */
@@ -116,28 +247,38 @@ export async function mcpInit({ cwd, args }) {
   }
 
   const configPath = resolveConfigPath(client, scope, cwd);
-  const config = await readJsonOrEmpty(configPath);
+  const entry = await buildShUiEntry();
 
-  if (!config.mcpServers || typeof config.mcpServers !== "object") {
-    config.mcpServers = {};
+  let had;
+  if (client === "codex") {
+    const raw = existsSync(configPath) ? await readFile(configPath, "utf8") : "";
+    const { text, had: existed } = upsertCodexMcpServer(raw, "sh-ui", entry);
+    had = existed;
+    await mkdir(dirname(configPath), { recursive: true });
+    await writeFile(configPath, text, "utf8");
+  } else {
+    const config = await readJsonOrEmpty(configPath);
+    if (!config.mcpServers || typeof config.mcpServers !== "object") {
+      config.mcpServers = {};
+    }
+    had = Boolean(config.mcpServers["sh-ui"]);
+    config.mcpServers["sh-ui"] = entry;
+    await mkdir(dirname(configPath), { recursive: true });
+    await writeFile(configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
   }
 
-  const before = config.mcpServers["sh-ui"];
-  config.mcpServers["sh-ui"] = await buildShUiEntry();
-
-  await mkdir(dirname(configPath), { recursive: true });
-  await writeFile(configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
-
   const rel = relative(cwd, configPath);
   const display = rel.startsWith("..") ? configPath : rel;
-  const verb = before ? "갱신" : "추가";
+  const verb = had ? "갱신" : "추가";
   console.log(`✓ sh-ui MCP 엔트리 ${verb} → ${display}`);
   console.log(`  client: ${client} (scope: ${scope})`);
-  if (client === "claude-code" || client === "cursor") {
-    console.log(`\n다음 단계: ${client === "claude-code" ? "Claude Code" : "Cursor"} 를 재시작하면 sh-ui 툴이 활성화됩니다.`);
-  } else {
-    console.log(`\n다음 단계: Claude Desktop 을 종료 후 재시작하면 sh-ui 툴이 활성화됩니다.`);
-  }
+  const restartTarget = {
+    "claude-code": "Claude Code",
+    cursor: "Cursor",
+    "claude-desktop": "Claude Desktop",
+    codex: "codex CLI 세션",
+  }[client];
+  console.log(`\n다음 단계: ${restartTarget} 를 재시작하면 sh-ui 툴이 활성화됩니다.`);
 }
 
 /** --key=value / --key value 파싱 */

package/templates/monorepo/packages/eslint-config/mes.js

@@ -0,0 +1,82 @@
+import boundaries from "eslint-plugin-boundaries"
+import checkFile from "eslint-plugin-check-file"
+
+/**
+ * MES (Backoffice) ESLint configuration.
+ *
+ * 페이지 격리 + 단방향 의존을 강제:
+ *
+ *   - `src/lib/*` — lib 끼리만 (UI/페이지 모름)
+ *   - `src/hooks/*` — hooks / lib 만
+ *   - `src/components/*` — components / hooks / lib 만
+ *   - `src/pages/*` — components / hooks / lib 만. **다른 페이지 import 금지** (격리)
+ *   - `app/` — pages / components / hooks / lib 모두 OK (한 줄 위임)
+ *
+ * @type {import("eslint").Linter.Config[]}
+ */
+export const mesConfig = [
+  // ── boundaries ──
+  {
+    plugins: { boundaries },
+    settings: {
+      "import/resolver": {
+        typescript: { alwaysTryTypes: true },
+      },
+      "boundaries/elements": [
+        { type: "lib", pattern: ["src/lib/*"], mode: "folder" },
+        { type: "hooks", pattern: ["src/hooks"], mode: "folder" },
+        { type: "components", pattern: ["src/components/*"], mode: "folder" },
+        { type: "pages", pattern: ["src/pages/*"], mode: "folder" },
+        { type: "app", pattern: ["app"], mode: "folder" },
+      ],
+      "boundaries/ignore": ["**/*.test.*", "**/*.spec.*"],
+    },
+    rules: {
+      "boundaries/element-types": [
+        "warn",
+        {
+          default: "disallow",
+          rules: [
+            { from: "app", allow: ["pages", "components", "hooks", "lib"] },
+            // pages 끼리는 import 금지 — 페이지 격리 원칙
+            { from: "pages", allow: ["components", "hooks", "lib"] },
+            { from: "components", allow: ["components", "hooks", "lib"] },
+            { from: "hooks", allow: ["hooks", "lib"] },
+            { from: "lib", allow: ["lib"] },
+          ],
+        },
+      ],
+    },
+  },
+
+  // ── check-file (MES 는 .tsx PASCAL, .ts CAMEL) ──
+  {
+    plugins: { "check-file": checkFile },
+    rules: {
+      "check-file/filename-naming-convention": [
+        "error",
+        {
+          "**/components/**/*.tsx": "PASCAL_CASE",
+          "**/pages/**/components/**/*.tsx": "PASCAL_CASE",
+          "**/lib/**/*.ts": "CAMEL_CASE",
+          "**/hooks/**/*.ts": "CAMEL_CASE",
+        },
+        { ignoreMiddleExtensions: true },
+      ],
+    },
+  },
+  {
+    files: [
+      "**/index.tsx", "**/index.ts",
+      "**/layout.tsx", "**/page.tsx",
+      "**/error.tsx", "**/not-found.tsx",
+      "**/routing.ts", "**/navigation.ts", "**/request.ts",
+      // MES 페이지 concern 파일들
+      "**/pages/**/api.ts", "**/pages/**/schema.ts",
+      "**/pages/**/columns.ts", "**/pages/**/hooks.ts",
+    ],
+    rules: {
+      "check-file/filename-naming-convention": "off",
+    },
+  },
+]

package/templates/monorepo/packages/eslint-config/package.json

@@ -8,7 +8,8 @@
     "./next-js": "./next.js",
     "./react-internal": "./react-internal.js",
     "./fsd": "./fsd.js",
-    "./flat": "./flat.js"
+    "./flat": "./flat.js",
+    "./mes": "./mes.js"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",

package/templates/nextjs-app/_arch/mes/app/api/proxy/[...path]/route.ts

@@ -0,0 +1,112 @@
+import { cookies } from 'next/headers';
+import { NextResponse, type NextRequest } from 'next/server';
+
+import {
+  captureApiError,
+  logApiError,
+} from '@/lib/api/observability';
+
+const API_URL = process.env.API_URL ?? 'http://localhost:8080/api';
+const ACCESS_TOKEN_COOKIE = 'accessToken';
+const LOCALE_COOKIE = 'NEXT_LOCALE';
+
+const proxyRequest = async (
+  request: NextRequest,
+  ctx: { params: Promise<{ path: string[] }> },
+  method: string,
+) => {
+  const { path } = await ctx.params;
+  const apiPath = path.join('/');
+  const url = new URL(`${API_URL}/${apiPath}`);
+
+  request.nextUrl.searchParams.forEach((value, key) => {
+    url.searchParams.set(key, value);
+  });
+
+  const cookieStore = await cookies();
+  const accessToken = cookieStore.get(ACCESS_TOKEN_COOKIE)?.value;
+  const locale =
+    cookieStore.get(LOCALE_COOKIE)?.value ??
+    request.headers.get('Accept-Language') ??
+    undefined;
+
+  const headers: Record<string, string> = {};
+  if (accessToken) headers.Authorization = `Bearer ${accessToken}`;
+  if (locale) headers['Accept-Language'] = locale;
+
+  let body: BodyInit | undefined;
+  if (method !== 'GET' && method !== 'HEAD') {
+    const contentType = request.headers.get('Content-Type');
+    if (contentType?.includes('multipart/form-data')) {
+      body = await request.formData();
+    } else {
+      headers['Content-Type'] = 'application/json';
+      body = await request.text();
+    }
+  }
+
+  let response: Response;
+  try {
+    response = await fetch(url.toString(), { method, headers, body });
+  } catch (error) {
+    console.error(`[PROXY] ${method} ${url.toString()} —`, error);
+    return NextResponse.json(
+      {
+        result: 'ERROR',
+        data: null,
+        error: {
+          code: 'NETWORK_ERROR',
+          message: 'Failed to reach upstream server.',
+        },
+      },
+      { status: 502 },
+    );
+  }
+
+  const data = await response.json();
+
+  if (!response.ok) {
+    logApiError('PROXY', {
+      url: url.toString(),
+      method,
+      status: response.status,
+      requestBody: typeof body === 'string' ? body : undefined,
+      responseBody: data,
+    });
+
+    captureApiError({
+      url: url.toString(),
+      apiPath,
+      method,
+      status: response.status,
+      responseBody: data,
+    });
+  }
+
+  return NextResponse.json(data, { status: response.status });
+};
+
+export const GET = (
+  req: NextRequest,
+  ctx: { params: Promise<{ path: string[] }> },
+) => proxyRequest(req, ctx, 'GET');
+
+export const POST = (
+  req: NextRequest,
+  ctx: { params: Promise<{ path: string[] }> },
+) => proxyRequest(req, ctx, 'POST');
+
+export const PUT = (
+  req: NextRequest,
+  ctx: { params: Promise<{ path: string[] }> },
+) => proxyRequest(req, ctx, 'PUT');
+
+export const PATCH = (
+  req: NextRequest,
+  ctx: { params: Promise<{ path: string[] }> },
+) => proxyRequest(req, ctx, 'PATCH');
+
+export const DELETE = (
+  req: NextRequest,
+  ctx: { params: Promise<{ path: string[] }> },
+) => proxyRequest(req, ctx, 'DELETE');

package/templates/nextjs-app/_arch/mes/app/layout.tsx

@@ -0,0 +1,16 @@
+import type { Metadata } from 'next';
+import '@workspace/ui-app-name/globals.css';
+import { RootLayout } from '@/components/layouts/RootLayout';
+
+export const metadata: Metadata = {
+  title: 'sh-ui app',
+  description: 'sh-ui 기반 앱 — metadata 를 변경하세요.',
+};
+
+export default function Layout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return <RootLayout>{children}</RootLayout>;
+}

package/templates/nextjs-app/_arch/mes/app/sign-in/page.tsx

@@ -0,0 +1 @@
+export { default } from '@/pages/sign-in';

package/templates/nextjs-app/_arch/mes/eslint.config.js

@@ -0,0 +1,10 @@
+import { nextJsConfig } from "@workspace/eslint-config/next-js"
+import { mesConfig } from "@workspace/eslint-config/mes"
+
+export default [
+  {
+    ignores: [".next/**", "dist/**", "node_modules/**"],
+  },
+  ...nextJsConfig,
+  ...mesConfig,
+]