umtri-mcp 1.5.0 → 1.5.2

package/core/policy.js

@@ -44,6 +44,18 @@ const LAYER_LIMB_LABELS = [
   '모델', '서비스', '컨트롤러', '컴포넌트', '핸들러',
 ];
 
+// front trunk의 공통 limb에 들어가야 할 것들 — 따로 limb로 서면 공통이 여러 갈래로 흩어진다
+// (Coolus '공용 요소', TennisRepublic store-app '디자인 시스템'). 라벨에 포함되면 잡는다.
+const FRONT_COMMON_CONTENT = [
+  '디자인 시스템', '디자인 토큰', '공용 컴포넌트', '공통 컴포넌트', '공용 요소', '공통 요소',
+  '공용 ui', '공통 ui',
+  'design system', 'design tokens', 'shared components', 'common components', 'ui system', 'ui kit',
+];
+// 셸·레이아웃은 기능 이름에도 흔히 들어가서("매장 레이아웃 편집") 라벨 전체가 그 말일 때만 잡는다.
+const FRONT_COMMON_EXACT = ['앱 셸', '앱 틀', '레이아웃', '셸', 'app shell', 'shell', 'layout'];
+// 공통 limb다운 이름 — common 표시만 빠진 경우를 알린다.
+const COMMON_NAMES = ['공통', '공용', 'common', 'shared'];
+
 // Promotion signals — when a twig's description contains these, it might belong at limb level.
 // Derived from sidebar/auth/ui-system limb promotions on 2026-05-21.
 const PROMOTION_KEYWORDS = [
@@ -175,6 +187,23 @@ export function limbUnderTrunkChecks({ type, label, parentType, parentKind, meta
     });
   }
 
+  if (metadata?.common !== true) {
+    const lower = trimmed.toLowerCase();
+    if (COMMON_NAMES.includes(lower)) {
+      out.push({
+        rule: 'common-content-outside-common',
+        severity: 'info',
+        message: `Limb "${label}" reads like the trunk's common limb but is not marked. Set metadata.common=true on it (one per trunk) so the rules can find it. See umtri://rules/trunk-kinds.`,
+      });
+    } else if (parentKind === 'front' && (FRONT_COMMON_EXACT.includes(lower) || FRONT_COMMON_CONTENT.some(k => lower.includes(k)))) {
+      out.push({
+        rule: 'common-content-outside-common',
+        severity: 'info',
+        message: `Limb "${label}" holds what a front trunk keeps in its one common limb (app shell, design system, shared components). Make it a twig under the common limb (metadata.common=true) instead of a separate limb. See umtri://rules/trunk-kinds.`,
+      });
+    }
+  }
+
   if (metadata?.common === true && siblingCommonCount > 0) {
     out.push({
       rule: 'common-limb-duplicate',
@@ -451,7 +480,9 @@ export function validateNode({ type, label, parentType, parentKind = null, sibli
     else warnings.push(h);
   }
 
-  let r = reservedDomainCheck(label);
+  // 테이블 leaf(metadata.table)의 라벨은 테이블의 논리명이다 — "버그" 테이블은 bugs 레코드가 아니라
+  // 그 레코드를 담는 테이블이라 예약어와 이름이 같아도 정당하다(umtri://rules/trunk-kinds).
+  let r = type === 'leaf' && metadata?.table ? null : reservedDomainCheck(label);
   // 유형이 정해진 trunk 바로 아래 limb는 도메인 이름이다 — Umtri 자신의 server·db에는 "버그" 도메인이
   // 있다. 그 코드 영역을 가리키는 거라면 정당하니 info로 낮추고 그 뜻을 말해 준다.
   if (r?.rule === 'reserved-domain' && type === 'limb' && parentType === 'trunk' && TRUNK_KINDS.includes(parentKind)) {

package/core/resources/trunk-kinds.md

@@ -14,7 +14,7 @@ label: the kind is what the MCP reads to check the limbs under it.
 | --- | --- | --- | --- | --- |
 | `front` | Something people use on a screen — app, web app, admin, static site | User-facing feature or flow (Reservations, My page). A public site splits by page | App shell (layout, routing, boot), design system, shared components | Screens, components |
 | `server` | A service that takes requests — API, webhooks, jobs | Domain / resource. Non-domain consumers (external integrations, inbound webhooks) get their own limb | Request handling — authentication, authorization, errors, boot | Endpoint groups (`metadata.endpoints`) |
-| `database` | A data store — relational DB, document DB, cache | Domain, **with the same names as the server** | Tables shared by many domains (sessions, audit log) | Tables (`metadata.columns`), labelled by their logical name |
+| `database` | A data store — relational DB, document DB, cache | Domain, **with the same names as the server** | Tables shared by many domains (sessions, audit log) | Tables, labelled by their logical name, with `metadata.table` (the real name) and `metadata.columns` |
 | `library` | Shared code or a package that other trunks import | Capability or concept (Money, Signal pipeline) | Shared types and constants | Modules |
 | `device` | Physical hardware, an embedded screen, an enclosure | Physical part or screen region | Device-wide parts (power, communication) | Parts, screen elements |
 
@@ -82,6 +82,9 @@ exists there, reuse its exact label.
 | `limb-domain-suffix` | A limb directly under a trunk ends in a kind suffix (`API`, `응답`, `테이블`, `관리`, `Table(s)`, `Admin`, `Management`). Drop it and reuse the domain name. |
 | `limb-layer-axis` | A limb is named after a technical layer. Split by the trunk kind's axis instead. |
 | `common-limb-duplicate` | The trunk already has a limb with `metadata.common: true`. |
+| `common-content-outside-common` | A front limb is named like common content (design system, shared components, app shell, layout), or a limb is named `공통`/`Common`/`Shared` without `metadata.common: true`. Make it a twig of the common limb, or mark it. |
+
+A table leaf (`metadata.table` set) may share its name with a first-class record — a `Bugs` table is not a bug — so `reserved-domain` does not fire on it.
 
 ## Reshaping an existing tree
 

package/core/resources/vocabulary.md

@@ -176,6 +176,7 @@ If you see one of these in the response, read it before proceeding:
 | `limb-domain-suffix`          | Limb under a trunk ends in `API`/`응답`/`테이블`/`관리`… — name the domain alone. |
 | `limb-layer-axis`             | Limb is a technical layer (State, Utils, Routes, Middleware…).     |
 | `common-limb-duplicate`       | The trunk already has its one common limb (`metadata.common`).    |
+| `common-content-outside-common` | Front limb holds common content (design system, shell…) outside the common limb, or a `공통` limb isn't marked. |
 
 ## Further reading (read only when relevant)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umtri-mcp",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "MCP server for Umtri — give your AI coding agent a persistent map of your project's structure, dependencies, and bugs.",
   "mcpName": "io.umtri/umtri",
   "keywords": [