@enfyra/mcp-server 0.1.47 → 0.1.48

package/dist/lib/mcp-instructions.js

@@ -22,7 +22,7 @@ export function buildMcpServerInstructions(apiBaseUrl, options = {}) {
         '- For target sanity checks, call `get_enfyra_api_context`; do not load broad metadata only to confirm the API base.',
         '- When the goal is clear but the tool path is not, call `discover_enfyra_workflows` with intent/risk/surface. Use `detail: "plan"` before writes, follow `primaryPath`, and treat `avoidTools` as hard negative-routing boundaries.',
         '- Discover before deciding, then inspect narrowly. Use `inspect_table`, `inspect_route`, `inspect_feature`, `search_admin_extensions`, or `search_runtime_zone` for the exact table/route/feature/runtime artifact. Run broad discovery tools sequentially, not in parallel.',
-        '- Load examples only when needed with `get_enfyra_examples`. For OAuth use `get_enfyra_examples({ category: "oauth-setup" })`. For extension UI, call `get_extension_theme_contract` before writing or reviewing UI, use `build_extension_ui` after the extension acknowledgement for high-contract components such as drawers, modals, page shell headers/actions, permission gates, empty states, resource lists, FormEditor, Widget, menu/account panel registries, tabs, upload modals, and review, and call `get_theme_class_reference` only when exact classes are needed.',
+        '- Load examples only when needed with `get_enfyra_examples`. For OAuth use `get_enfyra_examples({ category: "oauth-setup" })`. For extension UI, call `get_extension_theme_contract` before writing or reviewing UI, use `build_extension_ui` after the extension acknowledgement for high-contract components and theme decisions such as drawers, modals, page shell headers/actions, permission gates, empty states, resource lists, FormEditor, Widget, menu/account panel registries, tabs, upload modals, theme classes/review, and full review, and call `get_theme_class_reference` only when exact classes are needed.',
         '- Prefer the most specific business operation tool over raw metadata CRUD.',
         '- Before any write, call `get_enfyra_required_knowledge({ scope })` with the right scope and pass returned ack keys into write tools. Choose scope by task domain:',
         '  • `schema` — table, column, relation, record CRUD, route permission, guard, field permission, column rule, cache reload, GraphQL enablement, log debug.',

package/dist/lib/mcp-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-instructions.js","sourceRoot":"","sources":["../../src/lib/mcp-instructions.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,UAAU;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzD,OAAO;QACL,cAAc,EAAE,GAAG,IAAI,UAAU;QACjC,gBAAgB,EAAE,GAAG,IAAI,iBAAiB;KAC3C,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,0BAA0B,CAAC,UAAU,EAAE,UAAiC,EAAE;IACxF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1E,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI,CAAC;IAEvD,OAAO;QACL,eAAe;QACf,EAAE;QACF,gCAAgC,IAAI,KAAK;QACzC,wBAAwB,cAAc,YAAY,gBAAgB,KAAK;QACvE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,EAAE;QACF,qBAAqB;QACrB,qJAAqJ;QACrJ,qHAAqH;QACrH,qOAAqO;QACrO,8QAA8Q;QAC9Q,kjBAAkjB;QACljB,4EAA4E;QAC5E,oKAAoK;QACpK,2JAA2J;QAC3J,uJAAuJ;QACvJ,8IAA8I;QAC9I,yDAAyD;QACzD,4EAA4E;QAC5E,sMAAsM;QACtM,mLAAmL;QACnL,8LAA8L;QAC9L,EAAE;QACF,0BAA0B;QAC1B,uHAAuH;QACvH,sLAAsL;QACtL,gLAAgL;QAChL,iLAAiL;QACjL,yLAAyL;QACzL,kKAAkK;QAClK,0HAA0H;QAC1H,4LAA4L;QAC5L,EAAE;QACF,+BAA+B;QAC/B,4HAA4H;QAC5H,4GAA4G;QAC5G,mIAAmI;QACnI,kJAAkJ;QAClJ,oNAAoN;QACpN,iKAAiK;QACjK,gIAAgI;QAChI,EAAE;QACF,+BAA+B;QAC/B,iIAAiI;QACjI,uJAAuJ;QACvJ,yOAAyO;QACzO,+JAA+J;QAC/J,iMAAiM;QACjM,wSAAwS;QACxS,qLAAqL;QACrL,kPAAkP;QAClP,+PAA+P;QAC/P,EAAE;QACF,4BAA4B;QAC5B,0MAA0M;QAC1M,oHAAoH;QACpH,kIAAkI;QAClI,8MAA8M;QAC9M,kNAAkN;QAClN,wLAAwL;QACxL,EAAE;QACF,uIAAuI;KACxI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"mcp-instructions.js","sourceRoot":"","sources":["../../src/lib/mcp-instructions.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,UAAU;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzD,OAAO;QACL,cAAc,EAAE,GAAG,IAAI,UAAU;QACjC,gBAAgB,EAAE,GAAG,IAAI,iBAAiB;KAC3C,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,0BAA0B,CAAC,UAAU,EAAE,UAAiC,EAAE;IACxF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1E,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI,CAAC;IAEvD,OAAO;QACL,eAAe;QACf,EAAE;QACF,gCAAgC,IAAI,KAAK;QACzC,wBAAwB,cAAc,YAAY,gBAAgB,KAAK;QACvE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,EAAE;QACF,qBAAqB;QACrB,qJAAqJ;QACrJ,qHAAqH;QACrH,qOAAqO;QACrO,8QAA8Q;QAC9Q,imBAAimB;QACjmB,4EAA4E;QAC5E,oKAAoK;QACpK,2JAA2J;QAC3J,uJAAuJ;QACvJ,8IAA8I;QAC9I,yDAAyD;QACzD,4EAA4E;QAC5E,sMAAsM;QACtM,mLAAmL;QACnL,8LAA8L;QAC9L,EAAE;QACF,0BAA0B;QAC1B,uHAAuH;QACvH,sLAAsL;QACtL,gLAAgL;QAChL,iLAAiL;QACjL,yLAAyL;QACzL,kKAAkK;QAClK,0HAA0H;QAC1H,4LAA4L;QAC5L,EAAE;QACF,+BAA+B;QAC/B,4HAA4H;QAC5H,4GAA4G;QAC5G,mIAAmI;QACnI,kJAAkJ;QAClJ,oNAAoN;QACpN,iKAAiK;QACjK,gIAAgI;QAChI,EAAE;QACF,+BAA+B;QAC/B,iIAAiI;QACjI,uJAAuJ;QACvJ,yOAAyO;QACzO,+JAA+J;QAC/J,iMAAiM;QACjM,wSAAwS;QACxS,qLAAqL;QACrL,kPAAkP;QAClP,+PAA+P;QAC/P,EAAE;QACF,4BAA4B;QAC5B,0MAA0M;QAC1M,oHAAoH;QACpH,kIAAkI;QAClI,8MAA8M;QAC9M,kNAAkN;QAClN,wLAAwL;QACxL,EAAE;QACF,uIAAuI;KACxI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/lib/platform-operation-tools.d.ts

@@ -88,16 +88,30 @@ export declare function reviewExtensionUiContract(code: any): {
     }[];
     nextSteps: string[];
 };
+export declare function reviewExtensionThemeContract(code: any): {
+    action: string;
+    valid: boolean;
+    issueCount: number;
+    issues: {
+        severity: "error" | "warning";
+        rule: string;
+        message: string;
+        suggestion: string;
+    }[];
+    nextSteps: string[];
+};
 export declare function buildExtensionUiSnippet(kind: string, input?: AnyRecord): any;
 export declare function validateExtensionCodeLocally(code: any): {
     componentCasing: string;
     fieldWidth: string;
+    themeContract: string;
 };
 export declare function validateExtensionCode(apiUrl: any, code: any, name: any): Promise<{
     valid: boolean;
     localChecks: {
         componentCasing: string;
         fieldWidth: string;
+        themeContract: string;
     };
     extensionId: any;
     compiledLength: any;

package/dist/lib/platform-operation-tools.js

@@ -881,6 +881,174 @@ export function reviewExtensionUiContract(code) {
             : ['Snippet matches the checked modal/drawer contract rules. Still validate the final SFC before saving.'],
     };
 }
+const THEME_CLASS_INTENTS = {
+    neutral_surface: {
+        classes: 'eapp-surface-card eapp-radius-panel border eapp-divider',
+        use: 'Ordinary cards, panels, KPI containers, list containers, detail blocks, and status blocks that should stay neutral.',
+    },
+    muted_surface: {
+        classes: 'eapp-surface-muted eapp-radius-panel',
+        use: 'Recessed areas, tracks, secondary panels, or subdued containers.',
+    },
+    flat_surface: {
+        classes: 'eapp-surface-flat',
+        use: 'Flush content areas that should follow the app surface without card chrome.',
+    },
+    hover_row: {
+        classes: 'eapp-surface-hover eapp-divider',
+        use: 'Clickable rows inside lists or tables.',
+    },
+    primary_identity: {
+        classes: 'eapp-primary-surface eapp-radius-panel border',
+        use: 'A selected/current entity, active plan, active package, or the single larger block representing current identity.',
+    },
+    primary_soft_icon_tile: {
+        classes: 'eapp-primary-soft eapp-icon-tile',
+        childClasses: 'eapp-primary-text',
+        use: 'Compact runtime-primary icon tiles, selected chips, and small identity accents.',
+    },
+    primary_progress: {
+        trackClasses: 'eapp-surface-muted eapp-radius-pill',
+        fillClasses: 'eapp-primary-solid',
+        use: 'Progress or meter fill controlled by the runtime primary color.',
+    },
+    status_success: {
+        classes: 'eapp-status-success-soft eapp-status-success-text eapp-status-success-border',
+        nuxtUi: { color: 'success', variant: 'soft' },
+        use: 'Small success/healthy badges, chips, or icons only.',
+    },
+    status_warning: {
+        classes: 'eapp-status-warning-soft eapp-status-warning-text eapp-status-warning-border',
+        nuxtUi: { color: 'warning', variant: 'soft' },
+        use: 'Small warning/attention badges, chips, or icons only.',
+    },
+    status_danger: {
+        classes: 'eapp-status-danger-soft eapp-status-danger-text eapp-status-danger-border',
+        nuxtUi: { color: 'error', variant: 'soft' },
+        use: 'Small danger/error/destructive badges, chips, or icons only.',
+    },
+    status_info: {
+        classes: 'eapp-status-info-soft eapp-status-info-text eapp-status-info-border',
+        nuxtUi: { color: 'info', variant: 'soft' },
+        use: 'Small informational badges, chips, or icons only.',
+    },
+    primary_action: {
+        nuxtUi: { color: 'primary', variant: 'solid' },
+        use: 'The single main action for the current scope.',
+    },
+    secondary_action: {
+        nuxtUi: { color: 'neutral', variant: 'outline' },
+        use: 'Visible secondary actions, refresh, filters, cancel, and navigation alternatives.',
+    },
+    ghost_navigation_action: {
+        nuxtUi: { color: 'neutral', variant: 'ghost' },
+        use: 'Back/navigation/icon actions that should not compete with the primary action.',
+    },
+    danger_action: {
+        nuxtUi: { color: 'error', variant: 'solid' },
+        use: 'Final destructive actions such as Delete or Remove.',
+    },
+    divider: {
+        classes: 'eapp-divider',
+        listClasses: 'eapp-divide-y',
+        use: 'Borders and row separators in extension UI.',
+    },
+    text: {
+        primary: 'eapp-text-primary',
+        secondary: 'eapp-text-secondary',
+        tertiary: 'eapp-text-tertiary',
+        quaternary: 'eapp-text-quaternary',
+        use: 'Copy hierarchy in extension UI.',
+    },
+};
+function buildExtensionThemeClasses(input = {}) {
+    const intent = String(input.intent || '').trim();
+    if (!intent || !(intent in THEME_CLASS_INTENTS)) {
+        return {
+            action: 'extension_theme_classes_listed',
+            validIntents: Object.keys(THEME_CLASS_INTENTS),
+            note: 'Call again with one intent to get the exact classes/props for that theme contract.',
+        };
+    }
+    const contract = THEME_CLASS_INTENTS[intent];
+    return {
+        action: 'extension_theme_classes_built',
+        intent,
+        contract,
+        hardRules: [
+            'Do not use raw CSS variable utilities such as text-[var(...)], bg-[var(...)], or border-[var(...)] in extension templates.',
+            'Do not use hardcoded Tailwind palettes such as bg-violet-*, text-cyan-*, bg-green-*, dark:bg-zinc-*, or hex/rgb/hsl colors.',
+            'Use status classes only for compact badges/icons/short text; keep large panels neutral.',
+        ],
+    };
+}
+function collectExtensionThemeIssues(code) {
+    const source = String(code || '');
+    const issues = [];
+    const push = (severity, rule, message, suggestion) => issues.push({ severity, rule, message, suggestion });
+    const concretePalettes = [
+        'slate', 'gray', 'zinc', 'neutral', 'stone',
+        'red', 'orange', 'amber', 'yellow', 'lime', 'green', 'emerald', 'teal', 'cyan', 'sky', 'blue', 'indigo',
+        'violet', 'purple', 'fuchsia', 'pink', 'rose',
+    ].join('|');
+    const paletteClassPattern = new RegExp(`(?:^|[\\s"'])(?:dark:)?(?:bg|text|border|ring|divide|from|via|to)-(${concretePalettes})-(?:\\d{2,3}|950)(?:\\/\\d+)?`, 'i');
+    const rawCssVarPattern = /\b(?:bg|text|border|ring|divide|from|via|to)-\[\s*var\(--/i;
+    const neutralSemanticClassPattern = /\b(?:bg-default|bg-muted|border-default|divide-default|text-muted|text-dimmed)\b/;
+    const concreteNuxtUiColors = [
+        'slate', 'gray', 'zinc', 'stone',
+        'red', 'orange', 'amber', 'yellow', 'lime', 'green', 'emerald', 'teal', 'cyan', 'sky', 'blue', 'indigo',
+        'violet', 'purple', 'fuchsia', 'pink', 'rose',
+    ].join('|');
+    const concreteNuxtColorPattern = new RegExp(`\\bcolor\\s*=\\s*["'](${concreteNuxtUiColors})["']`, 'i');
+    if (rawCssVarPattern.test(source)) {
+        push('error', 'raw-css-var-utility', 'Raw CSS variable utility classes are not allowed in generated extension templates.', 'Use eapp-* class tokens or Nuxt UI semantic color props by intent.');
+    }
+    if (paletteClassPattern.test(source)) {
+        push('error', 'hardcoded-tailwind-palette', 'Hardcoded Tailwind palette classes are not allowed in themeable extension UI.', 'Use eapp-surface-*, eapp-primary-*, eapp-status-*, or Nuxt UI semantic colors.');
+    }
+    if (neutralSemanticClassPattern.test(source)) {
+        push('error', 'nuxt-neutral-class', 'Nuxt UI neutral shortcut classes are not part of the extension theme contract.', 'Use eapp-surface-* and eapp-text-* classes instead.');
+    }
+    if (concreteNuxtColorPattern.test(source)) {
+        push('error', 'concrete-nuxt-color', 'Concrete Nuxt UI palette colors are not allowed in generated extension UI.', 'Use color="primary|neutral|success|warning|error|info" by semantic intent.');
+    }
+    if (/#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})\b/i.test(source) || /\b(?:rgba?|hsla?|oklch|lab|lch)\s*\(/i.test(source)) {
+        push('error', 'hardcoded-color-value', 'Hardcoded color values are not allowed in extension UI.', 'Use the Enfyra theme class contract instead of hex/rgb/hsl/oklch/lab/lch values.');
+    }
+    if (/\bstyle\s*=\s*["'][^"']*(?:color|background(?:-color)?|border-color)\s*:/i.test(source)) {
+        push('error', 'inline-color-style', 'Inline color styles bypass the app theme contract.', 'Use eapp-* classes or Nuxt UI semantic props instead of inline color/background/border-color.');
+    }
+    if (/\bgradient\s*:\s*['"](?!none['"])[^'"]+['"]/.test(source) || /\bgradient\s*=\s*['"](?!none['"])[^'"]+['"]/.test(source)) {
+        push('error', 'page-header-gradient', 'Generated operational extension pages must use PageHeader gradient "none" unless the user explicitly requests decoration.', 'Set gradient: "none" in usePageHeaderRegistry or omit decorative gradients.');
+    }
+    if (/<(?:article|section|div)\b[^>]*class=["'][^"']*(?:eapp-status-(?:success|warning|danger|info)-soft|bg-(?:success|warning|error|info)(?:\b|\/))/i.test(source)) {
+        push('warning', 'large-status-surface', 'Status color appears on a large container.', 'Keep large panels neutral and put status color on a compact UBadge/icon/short text inside.');
+    }
+    const primaryActionCount = (source.match(/\bcolor\s*=\s*["']primary["']/g) || []).length;
+    if (primaryActionCount > 2) {
+        push('warning', 'primary-overuse', 'Many primary-colored controls were found.', 'Use primary only for the main action or identity accent; use neutral variants for secondary actions.');
+    }
+    const primarySurfaceCount = (source.match(/\beapp-primary-surface\b/g) || []).length;
+    if (primarySurfaceCount > 3) {
+        push('warning', 'primary-surface-overuse', 'eapp-primary-surface appears many times.', 'Use eapp-primary-surface only for selected/current identity blocks, not every card in a list/grid.');
+    }
+    if (/<(?:article|section|div)\b[^>]*class=["'][^"']*\bborder\b(?![^"']*\beapp-divider\b)/i.test(source)) {
+        push('warning', 'bare-border-token', 'A bordered panel is missing eapp-divider.', 'Pair intentional borders with eapp-divider so borders follow the app theme contract.');
+    }
+    return issues;
+}
+export function reviewExtensionThemeContract(code) {
+    const issues = collectExtensionThemeIssues(code);
+    return {
+        action: 'extension_theme_contract_reviewed',
+        valid: issues.every((issue) => issue.severity !== 'error'),
+        issueCount: issues.length,
+        issues,
+        nextSteps: issues.length
+            ? ['Use build_extension_ui kind=theme_classes to choose classes/props by intent, then patch/update the extension.']
+            : ['Snippet matches the checked theme contract rules. Still validate the final SFC before saving.'],
+    };
+}
 export function buildExtensionUiSnippet(kind, input = {}) {
     let result;
     switch (kind) {
@@ -920,11 +1088,28 @@ export function buildExtensionUiSnippet(kind, input = {}) {
         case 'upload_modal':
             result = buildExtensionUploadModalSnippet(input);
             break;
+        case 'theme_classes':
+            result = buildExtensionThemeClasses(input);
+            break;
+        case 'theme_review':
+            if (!input?.code) {
+                throw new Error('build_extension_ui kind=theme_review requires input.code.');
+            }
+            result = reviewExtensionThemeContract(input.code);
+            break;
         case 'review':
             if (!input?.code) {
                 throw new Error('build_extension_ui kind=review requires input.code.');
             }
-            result = reviewExtensionUiContract(input.code);
+            const uiReview = reviewExtensionUiContract(input.code);
+            const themeReview = reviewExtensionThemeContract(input.code);
+            result = {
+                action: 'extension_ui_and_theme_contract_reviewed',
+                valid: uiReview.valid && themeReview.valid,
+                issueCount: uiReview.issueCount + themeReview.issueCount,
+                ui: uiReview,
+                theme: themeReview,
+            };
             break;
         default:
             throw new Error(`Unsupported extension UI builder kind: ${kind}`);
@@ -1000,7 +1185,7 @@ function getExtensionThemeContract() {
             'Buttons should have stable geometry: hover may change color, border, or shadow but must not move the button or resize its content. Disabled buttons keep disabled cursor/visual state.',
             'Inputs and textareas should not add hover movement or decorative hover states; focus, invalid, disabled, and loading states must be explicit.',
             'For drawers, modals, page shell headers/actions, permission gates, empty states, resource lists, form editors, widgets, menu/account panel registries, tabs, and upload modals, call build_extension_ui with the matching kind after extension acknowledgement before patching raw Vue.',
-            'Use build_extension_ui kind=review before saving generated snippets that include high-contract UI or native buttons.',
+            'Use build_extension_ui kind=theme_classes for theme classes by intent, and kind=theme_review or kind=review before saving generated snippets that include high-contract UI, theme classes, or native buttons.',
             'Extension validation rejects UInput, UTextarea, USelect, USelectMenu, UInputMenu, UInputNumber, UInputTags, UInputTime, and UInputDate without class="w-full" unless marked data-compact or data-inline.',
             'Use UBadge or token-backed badge spans for status. Keep badges legible in both themes with tokenized background, text, and border.',
         ],
@@ -1275,7 +1460,12 @@ export function validateExtensionCodeLocally(code) {
         const first = missingFullWidthFields[0];
         throw new Error(`Invalid extension field width: <${first.tag}> must include class="w-full" in Enfyra extensions unless it is intentionally compact with data-compact or data-inline. First offending snippet: ${first.snippet}`);
     }
-    return { componentCasing: 'passed', fieldWidth: 'passed' };
+    const themeReview = reviewExtensionThemeContract(code);
+    const firstThemeError = themeReview.issues.find((issue) => issue.severity === 'error');
+    if (firstThemeError) {
+        throw new Error(`Invalid extension theme contract: ${firstThemeError.message} Rule: ${firstThemeError.rule}. ${firstThemeError.suggestion}`);
+    }
+    return { componentCasing: 'passed', fieldWidth: 'passed', themeContract: 'passed' };
 }
 export async function validateExtensionCode(apiUrl, code, name) {
     const localChecks = validateExtensionCodeLocally(code);
@@ -2464,8 +2654,8 @@ async function runExtensionWorkflow(apiUrl, opts) {
             'Call get_extension_theme_contract before generating or reviewing extension UI.',
             'useApi returns refs { data, error, pending, status } plus execute/refresh; it does not auto-run. Pass query/body/filter/deep/aggregate as objects or computed objects, not JSON strings.',
             'useNotify exposes success/error/warning/info(title, description?) async helpers; do not pass Nuxt toast object payloads to it.',
-            'For high-contract UI, call build_extension_ui after extension acknowledgement before patching raw Vue: drawer, modal, page shell, permission gate, empty state, resource list, form editor, widget, menu notification, account panel item, tabs, upload modal, or review.',
-            'Use build_extension_ui kind=review before saving generated snippets that include drawers, modals, fields, lists, tabs, upload modals, shell registry code, or native buttons.',
+            'For high-contract UI, call build_extension_ui after extension acknowledgement before patching raw Vue: drawer, modal, page shell, permission gate, empty state, resource list, form editor, widget, menu notification, account panel item, tabs, upload modal, theme classes, theme review, or full review.',
+            'Use build_extension_ui kind=theme_classes for theme classes by intent, and kind=theme_review or kind=review before saving generated snippets that include drawers, modals, fields, lists, tabs, upload modals, shell registry code, theme classes, or native buttons.',
             'Extension validation rejects common field controls without class="w-full" unless intentionally marked data-compact or data-inline.',
             'PermissionGate renders the permitted slot directly and is UX-only; backend permissions and owner checks remain authoritative.',
             'For menu/account-panel notifications, use counts only when the signal source already owns an exact count; otherwise use a dot/chip for new attention.',
@@ -2575,7 +2765,7 @@ export function registerPlatformOperationTools(server, ENFYRA_API_URL) {
     server.tool('build_extension_ui', [
         'Lazy gateway for Enfyra admin extension UI builders.',
         'Use this after get_enfyra_required_knowledge(scope="extension") when a high-contract extension UI snippet is needed.',
-        'It keeps guided startup small by dispatching drawer, modal, page_shell, permission_gate, empty_state, resource_list, form_editor, widget, menu_notification, account_panel_item, tabs, upload_modal, or review internally instead of exposing every builder tool up front.',
+        'It keeps guided startup small by dispatching drawer, modal, page_shell, permission_gate, empty_state, resource_list, form_editor, widget, menu_notification, account_panel_item, tabs, upload_modal, theme_classes, theme_review, or review internally instead of exposing every builder tool up front.',
     ].join(' '), {
         kind: z.enum([
             'drawer',
@@ -2590,9 +2780,11 @@ export function registerPlatformOperationTools(server, ENFYRA_API_URL) {
             'account_panel_item',
             'tabs',
             'upload_modal',
+            'theme_classes',
+            'theme_review',
             'review',
         ]).describe('Which extension UI contract builder/reviewer to run.'),
-        input: z.record(z.any()).optional().default({}).describe('Builder input object. For kind=review, pass { code }.'),
+        input: z.record(z.any()).optional().default({}).describe('Builder input object. For kind=theme_classes, pass { intent }. For kind=theme_review/review, pass { code }.'),
         extensionKnowledgeAckKey: extensionKnowledgeAckParam(z),
     }, async ({ kind, input, extensionKnowledgeAckKey }) => {
         assertExtensionKnowledgeAck(extensionKnowledgeAckKey);