@operato/twin-kernel 0.0.5 → 0.0.6

package/dist/contract.d.ts

@@ -92,28 +92,34 @@ export interface Attention {
     kind: string;
     severity: AttentionSeverity;
     state?: AttentionState;
-    title: string;
-    detail?: string;
     anchor: {
         nodeId?: string;
         moverId?: string;
         orderId?: string;
     };
     since?: number;
-    rationale?: string;
+    /**
+     * 표현용 원시 파라미터(언어 중립). 커널은 사람이 읽는 문장을 만들지 않는다 — kind + params 만 방출하고
+     * title/detail/rationale 는 표현계층(클라 i18next 템플릿)이 kind 로 키를 골라 params 를 보간해 렌더.
+     * 예: bottleneck → { nodeId, occupancy, capacity, ratioPct, saturated }.
+     */
+    params?: Record<string, string | number>;
     recommendedActions?: RecommendedAction[];
     suggestedAction?: {
+        code: string;
         command: string;
         args?: unknown;
-        label: string;
     };
 }
-/** 조치방향 — command 있으면 원클릭 실행, 없으면 권고 텍스트. */
+/**
+ * 조치방향 — code=안정 조치 키(언어 중립). command 있으면 원클릭 실행, 없으면 권고.
+ * 라벨·힌트(사람 언어)는 표현계층이 code 로 렌더(커널은 문장 미보유). command 보유 조치는 code=command 문자열,
+ * 권고만(hint only)이던 조치는 'advice.*' 코드.
+ */
 export interface RecommendedAction {
-    label: string;
+    code: string;
     command?: string;
     args?: unknown;
-    hint?: string;
 }
 export interface StateSnapshot {
     revision: number;
@@ -135,6 +141,12 @@ export interface Command<T = unknown> {
 export interface CommandAck {
     commandId: string;
     accepted: boolean;
+    /**
+     * 거절 사유 — 언어 중립. errorCode(안정 코드) + errorParams(원시값)로 방출하고 사람 언어는
+     * 표현계층(클라 i18next)이 렌더한다(무방언·다국어, attention 과 동형). error 는 개발자/로그용 영어 폴백.
+     */
+    errorCode?: string;
+    errorParams?: Record<string, string | number>;
     error?: string;
 }
 /**

package/dist/domain-catalog.js

@@ -3,9 +3,10 @@ import { YMS_TYPES } from "./yms-profile.js";
 import { MES_TYPES } from "./mes-profile.js";
 const nodeKeys = (types) => types.filter(t => t.role === 'node').map(t => t.key);
 export const DOMAIN_CATALOG = {
-    wms: { system: 'wms', label: 'WMS (물류창고)', types: WMS_TYPES, nodeTypes: nodeKeys(WMS_TYPES) },
-    yms: { system: 'yms', label: 'YMS (야드)', types: YMS_TYPES, nodeTypes: nodeKeys(YMS_TYPES) },
-    mes: { system: 'mes', label: 'MES (제조)', types: MES_TYPES, nodeTypes: nodeKeys(MES_TYPES) }
+    // label 은 언어 중립 i18n 키(twin.system.<code>) — 사람 언어는 표현계층이 렌더(L2).
+    wms: { system: 'wms', label: 'twin.system.wms', types: WMS_TYPES, nodeTypes: nodeKeys(WMS_TYPES) },
+    yms: { system: 'yms', label: 'twin.system.yms', types: YMS_TYPES, nodeTypes: nodeKeys(YMS_TYPES) },
+    mes: { system: 'mes', label: 'twin.system.mes', types: MES_TYPES, nodeTypes: nodeKeys(MES_TYPES) }
 };
 export const DOMAIN_SYSTEMS = ['wms', 'yms', 'mes'];
 /** 타입 키 → 능력 프로파일(커널 SSOT). 호스트가 라이브 페이로드에 투영, 컴포넌트가 능력을 렌더. */

package/dist/flow-engine.js

@@ -29,19 +29,20 @@ function mulberry32(seed) {
  * sim/live 가 같은 임계값·규칙을 쓴다. good/scrap 미제공(관측 상태에 없음)이면 scrap-high 는 자연 스킵(metric 층 갭).
  */
 export function deriveAttentions(view, acked) {
+    // 언어 중립: kind + params(원시값) + 조치 code 만 방출. 사람이 읽는 title/detail/rationale/라벨은
+    // 표현계층(클라 i18next)이 kind/code 로 렌더한다(무방언·다국어 — design/plans/i18n.md L3).
     const out = [];
     for (const m of view.movers) {
         if (m.status === 'down') {
-            const where = m.location ?? '해당 공정';
             out.push({
-                id: `breakdown:${m.id}`, kind: 'breakdown', severity: 'critical', title: `설비 고장 · ${m.id}`,
+                id: `breakdown:${m.id}`, kind: 'breakdown', severity: 'critical',
                 anchor: { moverId: m.id, nodeId: m.location },
-                rationale: `설비 정지 — ${where}의 작업이 중단되어 하류 정체·처리량 감소로 이어집니다.`,
+                params: { moverId: m.id, ...(m.location ? { nodeId: m.location } : {}) },
                 recommendedActions: [
-                    { label: '수리 지시', command: CMD.resourceRepair, args: { resourceId: m.id }, hint: '설비를 즉시 복구해 가동 재개' },
-                    { label: '계획 정지 유지', command: CMD.resourceHold, args: { resourceId: m.id }, hint: '수리 전까지 배정에서 제외' }
+                    { code: 'act.repair', command: CMD.resourceRepair, args: { resourceId: m.id } },
+                    { code: 'act.hold-until-repair', command: CMD.resourceHold, args: { resourceId: m.id } }
                 ],
-                suggestedAction: { command: CMD.resourceRepair, args: { resourceId: m.id }, label: '수리' }
+                suggestedAction: { code: 'act.repair', command: CMD.resourceRepair, args: { resourceId: m.id } }
             });
         }
     }
@@ -52,13 +53,10 @@ export function deriveAttentions(view, acked) {
                 const saturated = r >= 1;
                 out.push({
                     id: `bottleneck:${n.id}`, kind: 'bottleneck', severity: saturated ? 'high' : 'medium',
-                    title: `${saturated ? '병목' : '혼잡'} · ${n.id} 점유 ${n.occupancy}/${n.capacity}`,
                     anchor: { nodeId: n.id },
-                    rationale: `${n.id} 점유 ${Math.round(r * 100)}% — 상류 대기가 쌓여 리드타임이 늘고 처리량이 제한됩니다.`,
-                    recommendedActions: [
-                        { label: '자원 추가 검토', hint: '무버·처리 능력을 보강해 병목 완화' },
-                        { label: '하류 우선 처리', hint: '적체 해소를 위해 배출 우선순위 조정' }
-                    ]
+                    params: { nodeId: n.id, occupancy: n.occupancy ?? 0, capacity: n.capacity ?? 0, ratioPct: Math.round(r * 100), saturated: saturated ? 1 : 0 },
+                    recommendedActions: [{ code: 'advice.add-resource' }, { code: 'advice.downstream-priority' }]
+                    // 권고만(command 없음) — 표현계층이 advice.* 코드로 렌더
                 });
             }
         }
@@ -70,25 +68,24 @@ export function deriveAttentions(view, acked) {
             if (rate >= 0.15)
                 out.push({
                     id: `scrap:${m.id}`, kind: 'scrap-high', severity: rate >= 0.3 ? 'high' : 'medium',
-                    title: `불량률 ${Math.round(rate * 100)}% · ${m.id}`, detail: `양품 ${m.goodCount} / 불량 ${m.scrapCount}`,
                     anchor: { moverId: m.id, nodeId: m.location },
-                    rationale: `불량률 ${Math.round(rate * 100)}% — 재작업·수율 손실이 누적됩니다. 설비 상태·셋업 편차를 점검하세요.`,
+                    params: { moverId: m.id, goodCount: m.goodCount ?? 0, scrapCount: m.scrapCount ?? 0, ratePct: Math.round(rate * 100) },
                     recommendedActions: [
-                        { label: '설비 점검 정지', command: CMD.resourceHold, args: { resourceId: m.id }, hint: '점검을 위해 배정에서 제외' },
-                        { label: '계측 리셋', command: CMD.resourceResetMetrics, args: { resourceId: m.id }, hint: '교정 후 수율 재측정' }
+                        { code: 'act.hold-for-inspection', command: CMD.resourceHold, args: { resourceId: m.id } },
+                        { code: 'act.reset-metrics', command: CMD.resourceResetMetrics, args: { resourceId: m.id } }
                     ],
-                    suggestedAction: { command: CMD.resourceHold, args: { resourceId: m.id }, label: '점검 정지' }
+                    suggestedAction: { code: 'act.hold-for-inspection', command: CMD.resourceHold, args: { resourceId: m.id } }
                 });
         }
     }
     for (const o of view.orders) {
         if (o.held)
             out.push({
-                id: `hold:${o.id}`, kind: 'hold', severity: 'medium', title: `오더 보류 · ${o.id}`,
+                id: `hold:${o.id}`, kind: 'hold', severity: 'medium',
                 anchor: { orderId: o.id },
-                rationale: `오더 진행이 멈춤 — 납기 지연 위험. 보류 사유 해소 후 재개하세요.`,
-                recommendedActions: [{ label: '재개', command: CMD.orderResume, args: { orderId: o.id }, hint: '보류를 풀고 흐름 재개' }],
-                suggestedAction: { command: CMD.orderResume, args: { orderId: o.id }, label: '재개' }
+                params: { orderId: o.id },
+                recommendedActions: [{ code: 'act.resume-order', command: CMD.orderResume, args: { orderId: o.id } }],
+                suggestedAction: { code: 'act.resume-order', command: CMD.orderResume, args: { orderId: o.id } }
             });
     }
     if (acked)
@@ -221,14 +218,15 @@ export class FlowEngine {
     _acked = new Set(); // 확인(ack)된 주목 신호 id — 조건 지속돼도 acknowledged 로 표시(재발 시 재활성)
     dispatch(cmd) {
         const ok = () => ({ commandId: cmd.commandId, accepted: true });
-        const fail = (error) => ({ commandId: cmd.commandId, accepted: false, error });
+        // 거절 사유 = 언어 중립 코드 + 원시 파라미터. error 는 영어 폴백(로그·개발자용).
+        const fail = (errorCode, errorParams) => ({ commandId: cmd.commandId, accepted: false, errorCode, errorParams, error: errorCode });
         switch (cmd.type) {
             case CMD.orderHold:
             case CMD.orderResume: {
                 const orderId = cmd.args?.orderId;
                 const order = orderId ? this.orders.get(orderId) : undefined;
                 if (!order)
-                    return fail(`order 없음: ${orderId}`);
+                    return fail('order-not-found', { orderId: orderId ?? '' });
                 order.held = cmd.type === CMD.orderHold;
                 this.emitOrder(order);
                 return ok();
@@ -244,7 +242,7 @@ export class FlowEngine {
             case CMD.resourceResume: {
                 const m = this.movers.get(cmd.args?.resourceId ?? '');
                 if (!m)
-                    return fail('resource 없음');
+                    return fail('resource-not-found');
                 m.held = cmd.type === CMD.resourceHold; // 계획 정지 → 배정 스킵
                 this.emitMover(m);
                 return ok();
@@ -253,7 +251,7 @@ export class FlowEngine {
                 const a = cmd.args;
                 const m = this.movers.get(a?.resourceId ?? '');
                 if (!m)
-                    return fail('resource 없음');
+                    return fail('resource-not-found');
                 if (m.status !== 'down') {
                     m.status = 'down'; // 비계획 고장 주입 — 기존 고장 machinery(processFailures)가 downMs 누적·수리 처리
                     m.repairUntilMs = this.clockMs + (Number(a?.durationMs) || m.mttrMs || 60_000);
@@ -264,7 +262,7 @@ export class FlowEngine {
             case CMD.resourceRepair: {
                 const m = this.movers.get(cmd.args?.resourceId ?? '');
                 if (!m)
-                    return fail('resource 없음');
+                    return fail('resource-not-found');
                 if (m.status === 'down') {
                     m.status = m.taskId ? 'busy' : 'idle'; // 진행중 task 있으면 재개(고장모델 수리 로직과 동형)
                     m.repairUntilMs = undefined;
@@ -277,7 +275,7 @@ export class FlowEngine {
             case CMD.resourceResetMetrics: {
                 const m = this.movers.get(cmd.args?.resourceId ?? '');
                 if (!m)
-                    return fail('resource 없음');
+                    return fail('resource-not-found');
                 m.runMs = 0;
                 m.setupMs = 0;
                 m.downMs = 0;
@@ -293,9 +291,9 @@ export class FlowEngine {
                 // 새 무버는 즉시 배정 대상(다음 tick). 유일 id 생성(충돌 회피). 좌표/persistence 는 호스트 몫(커널=위상만).
                 const a = cmd.args;
                 if (!a?.kind)
-                    return fail('kind 필요');
+                    return fail('kind-required');
                 if (!a?.homeNode || !this.nodes.has(a.homeNode))
-                    return fail(`homeNode 없음: ${a?.homeNode}`);
+                    return fail('home-node-not-found', { homeNode: a?.homeNode ?? '' });
                 const count = Math.max(1, Math.min(50, Number(a.count) || 1));
                 let seq = this.movers.size;
                 for (let i = 0; i < count; i++) {
@@ -315,7 +313,7 @@ export class FlowEngine {
     }
     /** 도메인 커맨드 처리(order.release 등). 기본은 거절 — 도메인이 override. */
     handleCommand(cmd) {
-        return { commandId: cmd.commandId, accepted: false, error: `알 수 없는 커맨드: ${cmd.type}` };
+        return { commandId: cmd.commandId, accepted: false, errorCode: 'unknown-command', errorParams: { type: cmd.type }, error: `unknown-command: ${cmd.type}` };
     }
     scenario = {
         load: (def) => {

package/dist/kernel.js

@@ -72,7 +72,7 @@ export class WmsKernel extends FlowEngine {
             const a = cmd.args;
             const lines = a?.lines ?? (a?.gtin ? [{ gtin: a.gtin, qty: a.qty ?? 1 }] : []);
             if (lines.length === 0)
-                return { commandId: cmd.commandId, accepted: false, error: 'order.release: gtin 또는 lines 필요' };
+                return { commandId: cmd.commandId, accepted: false, errorCode: 'order-release-needs-lines', error: 'order.release: gtin or lines required' };
             this.createSalesOrder(lines);
             return { commandId: cmd.commandId, accepted: true };
         }

package/dist/mes-kernel.js

@@ -65,10 +65,10 @@ export class MesKernel extends FlowEngine {
         if (cmd.type === MES_CMD.changeover) {
             const a = cmd.args;
             if (!a?.resourceId || !a?.gtin)
-                return { commandId: cmd.commandId, accepted: false, error: 'mes.changeover: resourceId·gtin 필요' };
+                return { commandId: cmd.commandId, accepted: false, errorCode: 'changeover-needs-args', error: 'mes.changeover: resourceId and gtin required' };
             const m = this.movers.get(a.resourceId);
             if (!m)
-                return { commandId: cmd.commandId, accepted: false, error: `resource 없음: ${a.resourceId}` };
+                return { commandId: cmd.commandId, accepted: false, errorCode: 'resource-not-found', errorParams: { resourceId: a.resourceId }, error: `resource-not-found: ${a.resourceId}` };
             if (m.lastChangeoverKey !== a.gtin) {
                 m.setupMs += SETUP_MS; // 셋업 = OEE 가용성 손실
                 m.lastChangeoverKey = a.gtin;

package/dist/mes-profile.js

@@ -17,18 +17,19 @@ export const MES_NODE_TYPES = ['raw-store', 'cut-station', 'weld-station', 'pain
  * 트윈 타입 서술(ADR-0018 확장) — 노드 키는 MES_NODE_TYPES 단일 출처에서 파생 + 무버(자원) 타입 추가.
  * MES=ISA-95 앵커: 스테이션=WorkCenter, 저장소=bizLocation. 무버(가공설비)=Equipment/자산(GIAI). key 는 flow resourceType 과 일치.
  */
-const MES_NODE_META = {
-    'raw-store': { label: '자재 창고', cls: { epcis: 'bizLocation' } },
-    'cut-station': { label: '프레임 절단', cls: { isa95: 'WorkCenter', epcis: 'bizLocation' } },
-    'weld-station': { label: '용접', cls: { isa95: 'WorkCenter', epcis: 'bizLocation' } },
-    'paint-booth': { label: '도장', cls: { isa95: 'WorkCenter', epcis: 'bizLocation' } },
-    'assembly-line': { label: '조립·의장', cls: { isa95: 'WorkCenter', epcis: 'bizLocation' } },
-    'fg-store': { label: '완성차 보관', cls: { epcis: 'bizLocation' } }
+// label 은 언어 중립 i18n 키(twin.type.<key>) — cls(표준 클래스)만 노드별 메타로 유지. 사람 언어는 표현계층(L2).
+const MES_NODE_CLS = {
+    'raw-store': { epcis: 'bizLocation' },
+    'cut-station': { isa95: 'WorkCenter', epcis: 'bizLocation' },
+    'weld-station': { isa95: 'WorkCenter', epcis: 'bizLocation' },
+    'paint-booth': { isa95: 'WorkCenter', epcis: 'bizLocation' },
+    'assembly-line': { isa95: 'WorkCenter', epcis: 'bizLocation' },
+    'fg-store': { epcis: 'bizLocation' }
 };
 export const MES_TYPES = [
-    ...MES_NODE_TYPES.map((k) => ({ key: k, role: 'node', label: MES_NODE_META[k]?.label ?? k, standardClass: MES_NODE_META[k]?.cls ?? {}, identity: { scheme: 'gs1:SGLN' }, capabilities: ['storable'] })),
-    { key: 'cutter', role: 'mover', label: '절단 설비', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] },
-    { key: 'welder', role: 'mover', label: '용접 로봇', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] },
-    { key: 'painter', role: 'mover', label: '도장 로봇', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] },
-    { key: 'assembler', role: 'mover', label: '조립 설비', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] }
+    ...MES_NODE_TYPES.map((k) => ({ key: k, role: 'node', label: `twin.type.${k}`, standardClass: MES_NODE_CLS[k] ?? {}, identity: { scheme: 'gs1:SGLN' }, capabilities: ['storable'] })),
+    { key: 'cutter', role: 'mover', label: 'twin.type.cutter', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] },
+    { key: 'welder', role: 'mover', label: 'twin.type.welder', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] },
+    { key: 'painter', role: 'mover', label: 'twin.type.painter', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] },
+    { key: 'assembler', role: 'mover', label: 'twin.type.assembler', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] }
 ];

package/dist/wms-profile.js

@@ -22,8 +22,8 @@ export const WMS_NODE_TYPES = ['dock', 'storage', 'staging', 'dock-ship'];
  * 트윈 타입 서술(ADR-0018 확장) — 노드 키는 WMS_NODE_TYPES 단일 출처에서 파생 + 무버 타입 추가.
  * WMS=EPCIS 도메인: 로케이션=bizLocation(SGLN), 무버(지게차)=추적 오브젝트/자산(GIAI). 능력은 씬 소유라 미포함.
  */
-const WMS_NODE_LABELS = { dock: '입고 도크', storage: '보관 위치', staging: '스테이징', 'dock-ship': '출고 도크' };
+// label 은 언어 중립 i18n 키(twin.type.<key>) — 사람 언어는 표현계층이 렌더(design/plans/i18n.md L2).
 export const WMS_TYPES = [
-    ...WMS_NODE_TYPES.map((k) => ({ key: k, role: 'node', label: WMS_NODE_LABELS[k] ?? k, standardClass: { epcis: 'bizLocation' }, identity: { scheme: 'gs1:SGLN' }, capabilities: ['storable'] })),
-    { key: 'forklift', role: 'mover', label: '지게차', standardClass: { epcis: 'object', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['mobile', 'operable'] }
+    ...WMS_NODE_TYPES.map((k) => ({ key: k, role: 'node', label: `twin.type.${k}`, standardClass: { epcis: 'bizLocation' }, identity: { scheme: 'gs1:SGLN' }, capabilities: ['storable'] })),
+    { key: 'forklift', role: 'mover', label: 'twin.type.forklift', standardClass: { epcis: 'object', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['mobile', 'operable'] }
 ];

package/dist/yms-profile.js

@@ -18,8 +18,7 @@ export const YMS_NODE_TYPES = ['gate', 'yard-slot', 'dock-door', 'staging'];
  * 트윈 타입 서술(ADR-0018 확장) — 노드 키는 YMS_NODE_TYPES 단일 출처에서 파생 + 무버 타입 추가.
  * YMS=EPCIS zone: 로케이션/존=bizLocation(SGLN), 무버(야드 트랙터)=오브젝트/자산(GIAI).
  */
-const YMS_NODE_LABELS = { gate: '게이트', 'yard-slot': '야드 슬롯', 'dock-door': '도크 도어', staging: '스테이징' };
 export const YMS_TYPES = [
-    ...YMS_NODE_TYPES.map((k) => ({ key: k, role: 'node', label: YMS_NODE_LABELS[k] ?? k, standardClass: { epcis: 'bizLocation' }, identity: { scheme: 'gs1:SGLN' }, capabilities: ['storable'] })),
-    { key: 'hostler', role: 'mover', label: '야드 트랙터', standardClass: { epcis: 'object', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['mobile', 'operable'] }
+    ...YMS_NODE_TYPES.map((k) => ({ key: k, role: 'node', label: `twin.type.${k}`, standardClass: { epcis: 'bizLocation' }, identity: { scheme: 'gs1:SGLN' }, capabilities: ['storable'] })),
+    { key: 'hostler', role: 'mover', label: 'twin.type.hostler', standardClass: { epcis: 'object', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['mobile', 'operable'] }
 ];

package/dist-cjs/index.cjs

@@ -531,10 +531,9 @@ var BTT = {
   so: "urn:epcglobal:cbv:btt:so"
 };
 var WMS_NODE_TYPES = ["dock", "storage", "staging", "dock-ship"];
-var WMS_NODE_LABELS = { dock: "\uC785\uACE0 \uB3C4\uD06C", storage: "\uBCF4\uAD00 \uC704\uCE58", staging: "\uC2A4\uD14C\uC774\uC9D5", "dock-ship": "\uCD9C\uACE0 \uB3C4\uD06C" };
 var WMS_TYPES = [
-  ...WMS_NODE_TYPES.map((k) => ({ key: k, role: "node", label: WMS_NODE_LABELS[k] ?? k, standardClass: { epcis: "bizLocation" }, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
-  { key: "forklift", role: "mover", label: "\uC9C0\uAC8C\uCC28", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
+  ...WMS_NODE_TYPES.map((k) => ({ key: k, role: "node", label: `twin.type.${k}`, standardClass: { epcis: "bizLocation" }, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
+  { key: "forklift", role: "mover", label: "twin.type.forklift", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
 ];
 
 // src/capability.ts
@@ -602,10 +601,9 @@ function graiUri(companyPrefix, assetType, serial) {
   return `urn:epc:id:grai:${companyPrefix}.${assetType}.${String(serial).padStart(6, "0")}`;
 }
 var YMS_NODE_TYPES = ["gate", "yard-slot", "dock-door", "staging"];
-var YMS_NODE_LABELS = { gate: "\uAC8C\uC774\uD2B8", "yard-slot": "\uC57C\uB4DC \uC2AC\uB86F", "dock-door": "\uB3C4\uD06C \uB3C4\uC5B4", staging: "\uC2A4\uD14C\uC774\uC9D5" };
 var YMS_TYPES = [
-  ...YMS_NODE_TYPES.map((k) => ({ key: k, role: "node", label: YMS_NODE_LABELS[k] ?? k, standardClass: { epcis: "bizLocation" }, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
-  { key: "hostler", role: "mover", label: "\uC57C\uB4DC \uD2B8\uB799\uD130", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
+  ...YMS_NODE_TYPES.map((k) => ({ key: k, role: "node", label: `twin.type.${k}`, standardClass: { epcis: "bizLocation" }, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
+  { key: "hostler", role: "mover", label: "twin.type.hostler", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
 ];
 
 // src/mes-profile.ts
@@ -622,28 +620,29 @@ function sgtinUri(companyPrefix, itemRef, serial) {
   return `urn:epc:id:sgtin:${companyPrefix}.${itemRef}.${serial}`;
 }
 var MES_NODE_TYPES = ["raw-store", "cut-station", "weld-station", "paint-booth", "assembly-line", "fg-store"];
-var MES_NODE_META = {
-  "raw-store": { label: "\uC790\uC7AC \uCC3D\uACE0", cls: { epcis: "bizLocation" } },
-  "cut-station": { label: "\uD504\uB808\uC784 \uC808\uB2E8", cls: { isa95: "WorkCenter", epcis: "bizLocation" } },
-  "weld-station": { label: "\uC6A9\uC811", cls: { isa95: "WorkCenter", epcis: "bizLocation" } },
-  "paint-booth": { label: "\uB3C4\uC7A5", cls: { isa95: "WorkCenter", epcis: "bizLocation" } },
-  "assembly-line": { label: "\uC870\uB9BD\xB7\uC758\uC7A5", cls: { isa95: "WorkCenter", epcis: "bizLocation" } },
-  "fg-store": { label: "\uC644\uC131\uCC28 \uBCF4\uAD00", cls: { epcis: "bizLocation" } }
+var MES_NODE_CLS = {
+  "raw-store": { epcis: "bizLocation" },
+  "cut-station": { isa95: "WorkCenter", epcis: "bizLocation" },
+  "weld-station": { isa95: "WorkCenter", epcis: "bizLocation" },
+  "paint-booth": { isa95: "WorkCenter", epcis: "bizLocation" },
+  "assembly-line": { isa95: "WorkCenter", epcis: "bizLocation" },
+  "fg-store": { epcis: "bizLocation" }
 };
 var MES_TYPES = [
-  ...MES_NODE_TYPES.map((k) => ({ key: k, role: "node", label: MES_NODE_META[k]?.label ?? k, standardClass: MES_NODE_META[k]?.cls ?? {}, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
-  { key: "cutter", role: "mover", label: "\uC808\uB2E8 \uC124\uBE44", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
-  { key: "welder", role: "mover", label: "\uC6A9\uC811 \uB85C\uBD07", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
-  { key: "painter", role: "mover", label: "\uB3C4\uC7A5 \uB85C\uBD07", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
-  { key: "assembler", role: "mover", label: "\uC870\uB9BD \uC124\uBE44", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] }
+  ...MES_NODE_TYPES.map((k) => ({ key: k, role: "node", label: `twin.type.${k}`, standardClass: MES_NODE_CLS[k] ?? {}, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
+  { key: "cutter", role: "mover", label: "twin.type.cutter", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
+  { key: "welder", role: "mover", label: "twin.type.welder", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
+  { key: "painter", role: "mover", label: "twin.type.painter", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
+  { key: "assembler", role: "mover", label: "twin.type.assembler", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] }
 ];
 
 // src/domain-catalog.ts
 var nodeKeys = (types) => types.filter((t) => t.role === "node").map((t) => t.key);
 var DOMAIN_CATALOG = {
-  wms: { system: "wms", label: "WMS (\uBB3C\uB958\uCC3D\uACE0)", types: WMS_TYPES, nodeTypes: nodeKeys(WMS_TYPES) },
-  yms: { system: "yms", label: "YMS (\uC57C\uB4DC)", types: YMS_TYPES, nodeTypes: nodeKeys(YMS_TYPES) },
-  mes: { system: "mes", label: "MES (\uC81C\uC870)", types: MES_TYPES, nodeTypes: nodeKeys(MES_TYPES) }
+  // label 은 언어 중립 i18n 키(twin.system.<code>) — 사람 언어는 표현계층이 렌더(L2).
+  wms: { system: "wms", label: "twin.system.wms", types: WMS_TYPES, nodeTypes: nodeKeys(WMS_TYPES) },
+  yms: { system: "yms", label: "twin.system.yms", types: YMS_TYPES, nodeTypes: nodeKeys(YMS_TYPES) },
+  mes: { system: "mes", label: "twin.system.mes", types: MES_TYPES, nodeTypes: nodeKeys(MES_TYPES) }
 };
 var DOMAIN_SYSTEMS = ["wms", "yms", "mes"];
 function capabilitiesForType(system, typeKey) {
@@ -801,19 +800,17 @@ function deriveAttentions(view, acked) {
   const out = [];
   for (const m of view.movers) {
     if (m.status === "down") {
-      const where = m.location ?? "\uD574\uB2F9 \uACF5\uC815";
       out.push({
         id: `breakdown:${m.id}`,
         kind: "breakdown",
         severity: "critical",
-        title: `\uC124\uBE44 \uACE0\uC7A5 \xB7 ${m.id}`,
         anchor: { moverId: m.id, nodeId: m.location },
-        rationale: `\uC124\uBE44 \uC815\uC9C0 \u2014 ${where}\uC758 \uC791\uC5C5\uC774 \uC911\uB2E8\uB418\uC5B4 \uD558\uB958 \uC815\uCCB4\xB7\uCC98\uB9AC\uB7C9 \uAC10\uC18C\uB85C \uC774\uC5B4\uC9D1\uB2C8\uB2E4.`,
+        params: { moverId: m.id, ...m.location ? { nodeId: m.location } : {} },
         recommendedActions: [
-          { label: "\uC218\uB9AC \uC9C0\uC2DC", command: CMD.resourceRepair, args: { resourceId: m.id }, hint: "\uC124\uBE44\uB97C \uC989\uC2DC \uBCF5\uAD6C\uD574 \uAC00\uB3D9 \uC7AC\uAC1C" },
-          { label: "\uACC4\uD68D \uC815\uC9C0 \uC720\uC9C0", command: CMD.resourceHold, args: { resourceId: m.id }, hint: "\uC218\uB9AC \uC804\uAE4C\uC9C0 \uBC30\uC815\uC5D0\uC11C \uC81C\uC678" }
+          { code: "act.repair", command: CMD.resourceRepair, args: { resourceId: m.id } },
+          { code: "act.hold-until-repair", command: CMD.resourceHold, args: { resourceId: m.id } }
         ],
-        suggestedAction: { command: CMD.resourceRepair, args: { resourceId: m.id }, label: "\uC218\uB9AC" }
+        suggestedAction: { code: "act.repair", command: CMD.resourceRepair, args: { resourceId: m.id } }
       });
     }
   }
@@ -826,13 +823,10 @@ function deriveAttentions(view, acked) {
           id: `bottleneck:${n.id}`,
           kind: "bottleneck",
           severity: saturated ? "high" : "medium",
-          title: `${saturated ? "\uBCD1\uBAA9" : "\uD63C\uC7A1"} \xB7 ${n.id} \uC810\uC720 ${n.occupancy}/${n.capacity}`,
           anchor: { nodeId: n.id },
-          rationale: `${n.id} \uC810\uC720 ${Math.round(r * 100)}% \u2014 \uC0C1\uB958 \uB300\uAE30\uAC00 \uC313\uC5EC \uB9AC\uB4DC\uD0C0\uC784\uC774 \uB298\uACE0 \uCC98\uB9AC\uB7C9\uC774 \uC81C\uD55C\uB429\uB2C8\uB2E4.`,
-          recommendedActions: [
-            { label: "\uC790\uC6D0 \uCD94\uAC00 \uAC80\uD1A0", hint: "\uBB34\uBC84\xB7\uCC98\uB9AC \uB2A5\uB825\uC744 \uBCF4\uAC15\uD574 \uBCD1\uBAA9 \uC644\uD654" },
-            { label: "\uD558\uB958 \uC6B0\uC120 \uCC98\uB9AC", hint: "\uC801\uCCB4 \uD574\uC18C\uB97C \uC704\uD574 \uBC30\uCD9C \uC6B0\uC120\uC21C\uC704 \uC870\uC815" }
-          ]
+          params: { nodeId: n.id, occupancy: n.occupancy ?? 0, capacity: n.capacity ?? 0, ratioPct: Math.round(r * 100), saturated: saturated ? 1 : 0 },
+          recommendedActions: [{ code: "advice.add-resource" }, { code: "advice.downstream-priority" }]
+          // 권고만(command 없음) — 표현계층이 advice.* 코드로 렌더
         });
       }
     }
@@ -845,15 +839,13 @@ function deriveAttentions(view, acked) {
         id: `scrap:${m.id}`,
         kind: "scrap-high",
         severity: rate >= 0.3 ? "high" : "medium",
-        title: `\uBD88\uB7C9\uB960 ${Math.round(rate * 100)}% \xB7 ${m.id}`,
-        detail: `\uC591\uD488 ${m.goodCount} / \uBD88\uB7C9 ${m.scrapCount}`,
         anchor: { moverId: m.id, nodeId: m.location },
-        rationale: `\uBD88\uB7C9\uB960 ${Math.round(rate * 100)}% \u2014 \uC7AC\uC791\uC5C5\xB7\uC218\uC728 \uC190\uC2E4\uC774 \uB204\uC801\uB429\uB2C8\uB2E4. \uC124\uBE44 \uC0C1\uD0DC\xB7\uC14B\uC5C5 \uD3B8\uCC28\uB97C \uC810\uAC80\uD558\uC138\uC694.`,
+        params: { moverId: m.id, goodCount: m.goodCount ?? 0, scrapCount: m.scrapCount ?? 0, ratePct: Math.round(rate * 100) },
         recommendedActions: [
-          { label: "\uC124\uBE44 \uC810\uAC80 \uC815\uC9C0", command: CMD.resourceHold, args: { resourceId: m.id }, hint: "\uC810\uAC80\uC744 \uC704\uD574 \uBC30\uC815\uC5D0\uC11C \uC81C\uC678" },
-          { label: "\uACC4\uCE21 \uB9AC\uC14B", command: CMD.resourceResetMetrics, args: { resourceId: m.id }, hint: "\uAD50\uC815 \uD6C4 \uC218\uC728 \uC7AC\uCE21\uC815" }
+          { code: "act.hold-for-inspection", command: CMD.resourceHold, args: { resourceId: m.id } },
+          { code: "act.reset-metrics", command: CMD.resourceResetMetrics, args: { resourceId: m.id } }
         ],
-        suggestedAction: { command: CMD.resourceHold, args: { resourceId: m.id }, label: "\uC810\uAC80 \uC815\uC9C0" }
+        suggestedAction: { code: "act.hold-for-inspection", command: CMD.resourceHold, args: { resourceId: m.id } }
       });
     }
   }
@@ -862,11 +854,10 @@ function deriveAttentions(view, acked) {
       id: `hold:${o.id}`,
       kind: "hold",
       severity: "medium",
-      title: `\uC624\uB354 \uBCF4\uB958 \xB7 ${o.id}`,
       anchor: { orderId: o.id },
-      rationale: `\uC624\uB354 \uC9C4\uD589\uC774 \uBA48\uCDA4 \u2014 \uB0A9\uAE30 \uC9C0\uC5F0 \uC704\uD5D8. \uBCF4\uB958 \uC0AC\uC720 \uD574\uC18C \uD6C4 \uC7AC\uAC1C\uD558\uC138\uC694.`,
-      recommendedActions: [{ label: "\uC7AC\uAC1C", command: CMD.orderResume, args: { orderId: o.id }, hint: "\uBCF4\uB958\uB97C \uD480\uACE0 \uD750\uB984 \uC7AC\uAC1C" }],
-      suggestedAction: { command: CMD.orderResume, args: { orderId: o.id }, label: "\uC7AC\uAC1C" }
+      params: { orderId: o.id },
+      recommendedActions: [{ code: "act.resume-order", command: CMD.orderResume, args: { orderId: o.id } }],
+      suggestedAction: { code: "act.resume-order", command: CMD.orderResume, args: { orderId: o.id } }
     });
   }
   if (acked) {
@@ -997,13 +988,13 @@ var FlowEngine = class {
   // 확인(ack)된 주목 신호 id — 조건 지속돼도 acknowledged 로 표시(재발 시 재활성)
   dispatch(cmd) {
     const ok = () => ({ commandId: cmd.commandId, accepted: true });
-    const fail = (error) => ({ commandId: cmd.commandId, accepted: false, error });
+    const fail = (errorCode, errorParams) => ({ commandId: cmd.commandId, accepted: false, errorCode, errorParams, error: errorCode });
     switch (cmd.type) {
       case CMD.orderHold:
       case CMD.orderResume: {
         const orderId = cmd.args?.orderId;
         const order = orderId ? this.orders.get(orderId) : void 0;
-        if (!order) return fail(`order \uC5C6\uC74C: ${orderId}`);
+        if (!order) return fail("order-not-found", { orderId: orderId ?? "" });
         order.held = cmd.type === CMD.orderHold;
         this.emitOrder(order);
         return ok();
@@ -1017,7 +1008,7 @@ var FlowEngine = class {
       case CMD.resourceHold:
       case CMD.resourceResume: {
         const m = this.movers.get(cmd.args?.resourceId ?? "");
-        if (!m) return fail("resource \uC5C6\uC74C");
+        if (!m) return fail("resource-not-found");
         m.held = cmd.type === CMD.resourceHold;
         this.emitMover(m);
         return ok();
@@ -1025,7 +1016,7 @@ var FlowEngine = class {
       case CMD.resourceDown: {
         const a = cmd.args;
         const m = this.movers.get(a?.resourceId ?? "");
-        if (!m) return fail("resource \uC5C6\uC74C");
+        if (!m) return fail("resource-not-found");
         if (m.status !== "down") {
           m.status = "down";
           m.repairUntilMs = this.clockMs + (Number(a?.durationMs) || m.mttrMs || 6e4);
@@ -1035,7 +1026,7 @@ var FlowEngine = class {
       }
       case CMD.resourceRepair: {
         const m = this.movers.get(cmd.args?.resourceId ?? "");
-        if (!m) return fail("resource \uC5C6\uC74C");
+        if (!m) return fail("resource-not-found");
         if (m.status === "down") {
           m.status = m.taskId ? "busy" : "idle";
           m.repairUntilMs = void 0;
@@ -1046,7 +1037,7 @@ var FlowEngine = class {
       }
       case CMD.resourceResetMetrics: {
         const m = this.movers.get(cmd.args?.resourceId ?? "");
-        if (!m) return fail("resource \uC5C6\uC74C");
+        if (!m) return fail("resource-not-found");
         m.runMs = 0;
         m.setupMs = 0;
         m.downMs = 0;
@@ -1059,8 +1050,8 @@ var FlowEngine = class {
       }
       case CMD.resourceAdd: {
         const a = cmd.args;
-        if (!a?.kind) return fail("kind \uD544\uC694");
-        if (!a?.homeNode || !this.nodes.has(a.homeNode)) return fail(`homeNode \uC5C6\uC74C: ${a?.homeNode}`);
+        if (!a?.kind) return fail("kind-required");
+        if (!a?.homeNode || !this.nodes.has(a.homeNode)) return fail("home-node-not-found", { homeNode: a?.homeNode ?? "" });
         const count = Math.max(1, Math.min(50, Number(a.count) || 1));
         let seq = this.movers.size;
         for (let i = 0; i < count; i++) {
@@ -1078,7 +1069,7 @@ var FlowEngine = class {
   }
   /** 도메인 커맨드 처리(order.release 등). 기본은 거절 — 도메인이 override. */
   handleCommand(cmd) {
-    return { commandId: cmd.commandId, accepted: false, error: `\uC54C \uC218 \uC5C6\uB294 \uCEE4\uB9E8\uB4DC: ${cmd.type}` };
+    return { commandId: cmd.commandId, accepted: false, errorCode: "unknown-command", errorParams: { type: cmd.type }, error: `unknown-command: ${cmd.type}` };
   }
   scenario = {
     load: (def) => {
@@ -1455,7 +1446,7 @@ var WmsKernel = class extends FlowEngine {
     if (cmd.type === CMD.orderRelease) {
       const a = cmd.args;
       const lines = a?.lines ?? (a?.gtin ? [{ gtin: a.gtin, qty: a.qty ?? 1 }] : []);
-      if (lines.length === 0) return { commandId: cmd.commandId, accepted: false, error: "order.release: gtin \uB610\uB294 lines \uD544\uC694" };
+      if (lines.length === 0) return { commandId: cmd.commandId, accepted: false, errorCode: "order-release-needs-lines", error: "order.release: gtin or lines required" };
       this.createSalesOrder(lines);
       return { commandId: cmd.commandId, accepted: true };
     }
@@ -1755,9 +1746,9 @@ var MesKernel = class extends FlowEngine {
   handleCommand(cmd) {
     if (cmd.type === MES_CMD.changeover) {
       const a = cmd.args;
-      if (!a?.resourceId || !a?.gtin) return { commandId: cmd.commandId, accepted: false, error: "mes.changeover: resourceId\xB7gtin \uD544\uC694" };
+      if (!a?.resourceId || !a?.gtin) return { commandId: cmd.commandId, accepted: false, errorCode: "changeover-needs-args", error: "mes.changeover: resourceId and gtin required" };
       const m = this.movers.get(a.resourceId);
-      if (!m) return { commandId: cmd.commandId, accepted: false, error: `resource \uC5C6\uC74C: ${a.resourceId}` };
+      if (!m) return { commandId: cmd.commandId, accepted: false, errorCode: "resource-not-found", errorParams: { resourceId: a.resourceId }, error: `resource-not-found: ${a.resourceId}` };
       if (m.lastChangeoverKey !== a.gtin) {
         m.setupMs += SETUP_MS;
         m.lastChangeoverKey = a.gtin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {