@enfyra/mcp-server 0.1.42 → 0.1.44

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 and `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_*` tools for high-contract components such as drawers, modals, page shell headers/actions, permission gates, empty states, and resource lists, 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,yRAAyR;QACzR,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,mcAAmc;QACnc,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

@@ -1,10 +1,65 @@
+export declare function buildExtensionDrawerSnippet(input: any): {
+    action: string;
+    component: string;
+    snippet: string;
+    normalizedBodyChanges: string[];
+    warnings: string[];
+    contract: string[];
+};
+export declare function buildExtensionModalSnippet(input: any): {
+    action: string;
+    component: string;
+    snippet: string;
+    normalizedBodyChanges: string[];
+    warnings: string[];
+    contract: string[];
+};
+export declare function buildExtensionPageShellSnippet(input: any): {
+    action: string;
+    snippet: string;
+    contract: string[];
+};
+export declare function buildExtensionPermissionGateSnippet(input: any): {
+    action: string;
+    component: string;
+    snippet: string;
+    normalizedBodyChanges: string[];
+    warnings: string[];
+    contract: string[];
+};
+export declare function buildExtensionEmptyStateSnippet(input: any): {
+    action: string;
+    component: string;
+    snippet: string;
+    contract: string[];
+};
+export declare function buildExtensionResourceListSnippet(input: any): {
+    action: string;
+    components: string[];
+    snippet: string;
+    contract: string[];
+};
+export declare function reviewExtensionUiContract(code: any): {
+    action: string;
+    valid: boolean;
+    issueCount: number;
+    issues: {
+        severity: "error" | "warning";
+        rule: string;
+        message: string;
+        suggestion: string;
+    }[];
+    nextSteps: string[];
+};
 export declare function validateExtensionCodeLocally(code: any): {
     componentCasing: string;
+    fieldWidth: string;
 };
 export declare function validateExtensionCode(apiUrl: any, code: any, name: any): Promise<{
     valid: boolean;
     localChecks: {
         componentCasing: string;
+        fieldWidth: string;
     };
     extensionId: any;
     compiledLength: any;

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

@@ -19,6 +19,11 @@ const AUTO_INJECTED_EXTENSION_COMPONENT_TAGS = [
     'UFormField',
     'UIcon',
     'UInput',
+    'UInputMenu',
+    'UInputNumber',
+    'UInputTags',
+    'UInputTime',
+    'UInputDate',
     'UModal',
     'USelect',
     'USelectMenu',
@@ -30,6 +35,18 @@ const AUTO_INJECTED_EXTENSION_COMPONENT_TAGS = [
     'Widget',
 ];
 const AUTO_INJECTED_EXTENSION_COMPONENT_BY_LOWERCASE = new Map(AUTO_INJECTED_EXTENSION_COMPONENT_TAGS.map((tag) => [tag.toLowerCase(), tag]));
+const FULL_WIDTH_EXTENSION_FIELD_TAGS = [
+    'UInput',
+    'UTextarea',
+    'USelect',
+    'USelectMenu',
+    'UInputMenu',
+    'UInputNumber',
+    'UInputTags',
+    'UInputTime',
+    'UInputDate',
+];
+const FULL_WIDTH_EXTENSION_FIELD_PATTERN = new RegExp(`<(${FULL_WIDTH_EXTENSION_FIELD_TAGS.join('|')})(\\s[^<>]*?)(\\/?)>`, 'g');
 function unwrapData(result) {
     return Array.isArray(result?.data) ? result.data : [];
 }
@@ -299,6 +316,378 @@ async function findHandler(apiUrl, routeId, methodId) {
 function jsonText(payload) {
     return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
 }
+function escapeSingleQuoted(value) {
+    return String(value ?? '').replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+function quoteJsString(value) {
+    return `'${escapeSingleQuoted(value)}'`;
+}
+function normalizeVueBodySnippet(body) {
+    let code = String(body || '').trim();
+    const changes = [];
+    code = code.replace(FULL_WIDTH_EXTENSION_FIELD_PATTERN, (full, tag, attrs, slash) => {
+        if (/\bdata-compact\b/.test(attrs) || /\bdata-inline\b/.test(attrs))
+            return full;
+        if (/\bclass=/.test(attrs)) {
+            const nextAttrs = attrs.replace(/class="([^"]*)"/, (classMatch, classes) => {
+                if (String(classes).split(/\s+/).includes('w-full'))
+                    return classMatch;
+                changes.push(`Added w-full to ${tag}.`);
+                return `class="${classes} w-full"`;
+            });
+            if (nextAttrs !== attrs)
+                return `<${tag}${nextAttrs}${slash}>`;
+            return full;
+        }
+        changes.push(`Added class="w-full" to ${tag}.`);
+        return `<${tag} class="w-full"${attrs}${slash}>`;
+    });
+    code = code.replace(/<button(\s[^>]*)?>/g, (full, attrs = '') => {
+        if (/\btype=/.test(attrs))
+            return full;
+        changes.push('Added type="button" to a native button.');
+        return `<button type="button"${attrs}>`;
+    });
+    return { code, changes: Array.from(new Set(changes)) };
+}
+function findMissingFullWidthFieldControls(code) {
+    const violations = [];
+    for (const template of readTemplateBlocks(code)) {
+        let match;
+        FULL_WIDTH_EXTENSION_FIELD_PATTERN.lastIndex = 0;
+        while ((match = FULL_WIDTH_EXTENSION_FIELD_PATTERN.exec(template))) {
+            const [snippet, tag, attrs] = match;
+            if (/\bdata-compact\b/.test(attrs) || /\bdata-inline\b/.test(attrs))
+                continue;
+            const classMatch = attrs.match(/\bclass="([^"]*)"/);
+            if (!classMatch || !classMatch[1].split(/\s+/).includes('w-full')) {
+                violations.push({ tag, snippet: snippet.length > 160 ? `${snippet.slice(0, 157)}...` : snippet });
+            }
+        }
+    }
+    return violations;
+}
+function indentLines(code, spaces = 2) {
+    const pad = ' '.repeat(spaces);
+    return String(code || '')
+        .split('\n')
+        .map((line) => (line.trim() ? `${pad}${line}` : line))
+        .join('\n');
+}
+function buildFooterActionObject(action) {
+    if (!action)
+        return null;
+    if (typeof action === 'string')
+        return action;
+    const entries = [];
+    if (action.labelExpression)
+        entries.push(`label: ${action.labelExpression}`);
+    else if (action.label)
+        entries.push(`label: ${quoteJsString(action.label)}`);
+    if (action.icon)
+        entries.push(`icon: ${quoteJsString(action.icon)}`);
+    if (action.loading)
+        entries.push(`loading: ${action.loading}`);
+    if (action.disabled)
+        entries.push(`disabled: ${action.disabled}`);
+    if (action.color)
+        entries.push(`color: ${quoteJsString(action.color)}`);
+    if (action.variant)
+        entries.push(`variant: ${quoteJsString(action.variant)}`);
+    if (action.tone)
+        entries.push(`tone: ${quoteJsString(action.tone)}`);
+    if (action.onClick)
+        entries.push(`onClick: ${action.onClick}`);
+    return `{ ${entries.join(', ')} }`;
+}
+function titleMarkup(title, titleExpression) {
+    if (titleExpression)
+        return `{{ ${titleExpression} }}`;
+    return String(title || 'Untitled');
+}
+export function buildExtensionDrawerSnippet(input) {
+    const normalized = normalizeVueBodySnippet(input.body || '');
+    const titleContent = titleMarkup(input.title, input.titleExpression);
+    const model = input.model || 'drawerOpen';
+    const attrs = [
+        `v-model="${model}"`,
+        `direction="${input.direction || 'right'}"`,
+    ];
+    if (input.nested)
+        attrs.push('nested');
+    if (input.handleOnly)
+        attrs.push('handle-only');
+    const cancelAction = input.cancelAction === false
+        ? null
+        : buildFooterActionObject(input.cancelAction || { label: 'Cancel', onClick: `() => (${model} = false)` });
+    const primaryAction = buildFooterActionObject(input.primaryAction);
+    const dangerAction = buildFooterActionObject(input.dangerAction);
+    if (cancelAction)
+        attrs.push(`:cancel-action="${cancelAction}"`);
+    if (primaryAction)
+        attrs.push(`:primary-action="${primaryAction}"`);
+    if (dangerAction)
+        attrs.push(`:danger-action="${dangerAction}"`);
+    if (input.footerHint)
+        attrs.push(`footer-hint="${escapeSingleQuoted(input.footerHint).replace(/"/g, '&quot;')}"`);
+    const snippet = [
+        '<CommonDrawer',
+        ...attrs.map((attr) => `  ${attr}`),
+        '>',
+        '  <template #header>',
+        `    <h2 class="text-lg font-semibold eapp-text-primary">${titleContent}</h2>`,
+        '  </template>',
+        '',
+        '  <template #body>',
+        indentLines(normalized.code, 4),
+        '  </template>',
+        '</CommonDrawer>',
+    ].join('\n');
+    const warnings = [];
+    if (!primaryAction)
+        warnings.push('Editing/create drawers usually need primaryAction for Save/Create.');
+    return {
+        action: 'extension_drawer_built',
+        component: 'CommonDrawer',
+        snippet,
+        normalizedBodyChanges: normalized.changes,
+        warnings,
+        contract: [
+            'Use #header and #body slots; do not use a title prop.',
+            'Use primaryAction for Save/Create and dangerAction for destructive edit actions.',
+            'Body form controls are normalized to class="w-full" unless intentionally compact.',
+            'Native buttons in the body are normalized to type="button".',
+        ],
+    };
+}
+export function buildExtensionModalSnippet(input) {
+    const normalized = normalizeVueBodySnippet(input.body || '');
+    const titleContent = titleMarkup(input.title, input.titleExpression);
+    const model = input.model || 'modalOpen';
+    const tag = input.alias === 'UModal' ? 'UModal' : 'CommonModal';
+    const attrs = [`v-model:open="${model}"`];
+    const cancelAction = input.cancelAction === false
+        ? null
+        : buildFooterActionObject(input.cancelAction || { label: 'Cancel', onClick: `() => (${model} = false)` });
+    const primaryAction = buildFooterActionObject(input.primaryAction);
+    const dangerAction = buildFooterActionObject(input.dangerAction);
+    if (cancelAction)
+        attrs.push(`:cancel-action="${cancelAction}"`);
+    if (primaryAction)
+        attrs.push(`:primary-action="${primaryAction}"`);
+    if (dangerAction)
+        attrs.push(`:danger-action="${dangerAction}"`);
+    if (input.footerHint)
+        attrs.push(`footer-hint="${escapeSingleQuoted(input.footerHint).replace(/"/g, '&quot;')}"`);
+    const snippet = [
+        `<${tag}`,
+        ...attrs.map((attr) => `  ${attr}`),
+        '>',
+        '  <template #header>',
+        `    <h2 class="text-lg font-semibold eapp-text-primary">${titleContent}</h2>`,
+        '  </template>',
+        '',
+        '  <template #body>',
+        indentLines(normalized.code, 4),
+        '  </template>',
+        `</${tag}>`,
+    ].join('\n');
+    const warnings = [];
+    if (!primaryAction && !dangerAction)
+        warnings.push('Mutation or confirmation modals usually need primaryAction or dangerAction for the final action.');
+    return {
+        action: 'extension_modal_built',
+        component: tag,
+        snippet,
+        normalizedBodyChanges: normalized.changes,
+        warnings,
+        contract: [
+            'Use v-model:open and #header/#body slots; do not use a title prop.',
+            'Use primaryAction for ordinary final actions and dangerAction for destructive confirmation.',
+            'Body form controls are normalized to class="w-full" unless intentionally compact.',
+            'Native buttons in the body are normalized to type="button".',
+        ],
+    };
+}
+function jsObjectLiteral(entries) {
+    return `{ ${entries.filter(Boolean).join(', ')} }`;
+}
+function buildHeaderActionLiteral(action) {
+    const entries = [
+        action.id ? `id: ${quoteJsString(action.id)}` : null,
+        action.label ? `label: ${quoteJsString(action.label)}` : null,
+        action.icon ? `icon: ${quoteJsString(action.icon)}` : null,
+        `color: ${quoteJsString(action.color || 'neutral')}`,
+        `variant: ${quoteJsString(action.variant || 'outline')}`,
+        action.loading ? `loading: ${action.loading}` : null,
+        action.disabled ? `disabled: ${action.disabled}` : null,
+        action.to ? `to: ${quoteJsString(action.to)}` : null,
+        action.onClick ? `onClick: ${action.onClick}` : null,
+        typeof action.order === 'number' ? `order: ${action.order}` : null,
+        action.side ? `side: ${quoteJsString(action.side)}` : null,
+    ];
+    return jsObjectLiteral(entries);
+}
+export function buildExtensionPageShellSnippet(input) {
+    const title = input.titleExpression || quoteJsString(input.title || 'Untitled');
+    const headerEntries = [
+        `title: ${title}`,
+        input.description ? `description: ${quoteJsString(input.description)}` : null,
+        input.leadingIcon ? `leadingIcon: ${quoteJsString(input.leadingIcon)}` : null,
+        `gradient: ${quoteJsString(input.gradient || 'none')}`,
+        `variant: ${quoteJsString(input.variant || 'minimal')}`,
+    ];
+    const actions = Array.isArray(input.headerActions) ? input.headerActions : [];
+    const lines = [
+        'const { registerPageHeader } = usePageHeaderRegistry();',
+        `registerPageHeader(${jsObjectLiteral(headerEntries)});`,
+    ];
+    if (actions.length) {
+        lines.push('const { register: registerHeaderActions } = useHeaderActionRegistry();');
+        lines.push(`registerHeaderActions([\n${actions.map((action) => `  ${buildHeaderActionLiteral(action)}`).join(',\n')}\n]);`);
+    }
+    return {
+        action: 'extension_page_shell_built',
+        snippet: lines.join('\n'),
+        contract: [
+            'Use usePageHeaderRegistry so the app shell renders the page header.',
+            'Use useHeaderActionRegistry for toolbar actions instead of rendering duplicate page headers or local top bars.',
+            'Use primary solid only for the main scope action; secondary actions default to neutral outline.',
+        ],
+    };
+}
+export function buildExtensionPermissionGateSnippet(input) {
+    const normalized = normalizeVueBodySnippet(input.body || '<slot />');
+    let condition;
+    if (input.condition) {
+        condition = input.condition;
+    }
+    else if (input.route) {
+        const methods = Array.isArray(input.methods) && input.methods.length ? input.methods : ['GET'];
+        condition = `{ or: [{ route: ${quoteJsString(input.route)}, methods: [${methods.map(quoteJsString).join(', ')}] }] }`;
+    }
+    else {
+        condition = 'null';
+    }
+    const snippet = [
+        `<PermissionGate :condition="${condition}">`,
+        indentLines(normalized.code, 2),
+        '</PermissionGate>',
+    ].join('\n');
+    return {
+        action: 'extension_permission_gate_built',
+        component: 'PermissionGate',
+        snippet,
+        normalizedBodyChanges: normalized.changes,
+        warnings: condition === 'null' ? ['No condition/route was provided. PermissionGate with null condition permits the slot.'] : [],
+        contract: [
+            'PermissionGate is only operator UX; backend route permissions and owner checks remain authoritative.',
+            'PermissionGate renders its slot directly and should not be used as a layout wrapper.',
+        ],
+    };
+}
+export function buildExtensionEmptyStateSnippet(input) {
+    const action = input.action
+        ? `\n  :action="${buildFooterActionObject(input.action)}"`
+        : '';
+    return {
+        action: 'extension_empty_state_built',
+        component: 'CommonEmptyState',
+        snippet: `<CommonEmptyState\n  title="${String(input.title || 'No items found').replace(/"/g, '&quot;')}"\n  description="${String(input.description || '').replace(/"/g, '&quot;')}"\n  icon="${input.icon || 'lucide:inbox'}"\n  size="${input.size || 'sm'}"\n  variant="${input.variant || 'naked'}"${action}\n/>`,
+        contract: [
+            'Use CommonEmptyState for app-matched empty states.',
+            'Use variant="naked" inside framed panels/lists and outline/subtle for standalone framed empty surfaces.',
+        ],
+    };
+}
+export function buildExtensionResourceListSnippet(input) {
+    const itemsExpression = input.itemsExpression || 'items';
+    const itemName = input.itemName || 'item';
+    const keyExpression = input.keyExpression || `${itemName}.id`;
+    const titleExpression = input.titleExpression || `${itemName}.title || ${quoteJsString('Untitled')}`;
+    const descriptionExpression = input.descriptionExpression || `${itemName}.description`;
+    const iconExpression = input.iconExpression || quoteJsString(input.icon || 'lucide:file-text');
+    const onClick = input.onClick ? `\n      :on-click="() => ${input.onClick}"` : '';
+    const stats = input.statsExpression ? `\n      :stats="${input.statsExpression}"` : '';
+    const actions = input.actionsExpression ? `\n      :actions="${input.actionsExpression}"` : '';
+    const topBadge = input.topBadgeExpression ? `\n      :top-badge="${input.topBadgeExpression}"` : '';
+    const snippet = [
+        '<CommonResourceListFrame',
+        `  :loading="${input.loadingExpression || 'pending'}"`,
+        `  :has-items="${itemsExpression}.length > 0"`,
+        `  :total="${input.totalExpression || `${itemsExpression}.length`}"`,
+        `  :items-per-page="${input.itemsPerPageExpression || '0'}"`,
+        `  empty-title="${String(input.emptyTitle || 'No items found').replace(/"/g, '&quot;')}"`,
+        `  empty-description="${String(input.emptyDescription || '').replace(/"/g, '&quot;')}"`,
+        `  empty-icon="${input.emptyIcon || 'lucide:inbox'}"`,
+        '>',
+        `  <CommonResourceListItem`,
+        `    v-for="${itemName} in ${itemsExpression}"`,
+        `    :key="${keyExpression}"`,
+        `    :title="${titleExpression}"`,
+        `    :description="${descriptionExpression}"`,
+        `    :icon="${iconExpression}"`,
+        '    icon-color="primary"',
+        `${stats}${actions}${topBadge}${onClick}`,
+        '  />',
+        '</CommonResourceListFrame>',
+    ].join('\n');
+    return {
+        action: 'extension_resource_list_built',
+        components: ['CommonResourceListFrame', 'CommonResourceListItem'],
+        snippet,
+        contract: [
+            'Use CommonResourceListFrame and CommonResourceListItem for operational lists instead of ad hoc cards.',
+            'Keep first-load skeleton, empty state, and pagination owned by the frame.',
+            'Use explicit bounded list data and natural pagination/search outside this snippet when the domain list can grow.',
+        ],
+    };
+}
+export function reviewExtensionUiContract(code) {
+    const source = String(code || '');
+    const issues = [];
+    const push = (severity, rule, message, suggestion) => issues.push({ severity, rule, message, suggestion });
+    if (/<CommonDrawer\b[^>]*(?:\s:title=|\stitle=)/.test(source)) {
+        push('error', 'common-drawer-slots', 'CommonDrawer should not use title/:title props in generated extensions.', 'Use #header with a heading, and #body for content.');
+    }
+    if (/<(?:CommonModal|UModal)\b[^>]*(?:\s:title=|\stitle=)/.test(source)) {
+        push('error', 'common-modal-slots', 'CommonModal/UModal should not use title/:title props in generated extensions.', 'Use #header with a heading, and #body for content.');
+    }
+    if (/<CommonDrawer\b/.test(source) && !/primary-action=/.test(source)) {
+        push('warning', 'drawer-primary-action', 'CommonDrawer has no primaryAction.', 'Editing/create drawers should wire Save/Create through primaryAction.');
+    }
+    if (/<CommonDrawer\b/.test(source) && !/cancel-action=/.test(source)) {
+        push('warning', 'drawer-cancel-action', 'CommonDrawer has no cancelAction.', 'Use cancelAction for the ordinary Cancel footer button unless the workflow intentionally has no cancel.');
+    }
+    if (/<(?:CommonModal|UModal)\b/.test(source) && /delete|remove|confirm|cannot be undone/i.test(source) && !/danger-action=/.test(source)) {
+        push('warning', 'modal-danger-action', 'Destructive/confirmation modal has no dangerAction.', 'Wire the final destructive action through dangerAction.');
+    }
+    const fieldPattern = /<(UInput|UTextarea|USelectMenu|USelect)(\s[^<>]*?)\/?>/g;
+    let fieldMatch;
+    while ((fieldMatch = fieldPattern.exec(source))) {
+        const [, tag, attrs] = fieldMatch;
+        const classMatch = attrs.match(/\bclass="([^"]*)"/);
+        if (!classMatch || !classMatch[1].split(/\s+/).includes('w-full')) {
+            push('warning', 'modal-drawer-field-width', `${tag} is missing class="w-full".`, 'Use class="w-full" for form controls inside modal/drawer body forms unless intentionally inline.');
+        }
+    }
+    const buttonPattern = /<button(\s[^>]*)?>/g;
+    let buttonMatch;
+    while ((buttonMatch = buttonPattern.exec(source))) {
+        if (!/\btype=/.test(buttonMatch[1] || '')) {
+            push('warning', 'native-button-type', 'Native button is missing type="button".', 'Add type="button" unless the button intentionally submits a form.');
+        }
+    }
+    return {
+        action: 'extension_ui_contract_reviewed',
+        valid: issues.every((issue) => issue.severity !== 'error'),
+        issueCount: issues.length,
+        issues,
+        nextSteps: issues.length
+            ? ['Use build_extension_drawer or build_extension_modal for replacement snippets, then apply with patch_extension_code/update_extension_code.']
+            : ['Snippet matches the checked modal/drawer contract rules. Still validate the final SFC before saving.'],
+    };
+}
 function getExtensionThemeContract() {
     return {
         action: 'extension_theme_contract',
@@ -364,6 +753,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.',
             'Inside CommonDrawer/CommonModal body forms, UInput, UTextarea, USelect, USelectMenu, and similar field controls must use class="w-full" unless the control is intentionally inline or compact.',
+            'Extension validation rejects UInput, UTextarea, USelect, USelectMenu, UInputMenu, UInputNumber, UInputTags, UInputTime, and UInputDate without class="w-full" unless marked data-compact or data-inline.',
             'Dynamic extensions resolve UModal to the app CommonModal. Do not pass ui.content: "eapp-surface-card" or "surface-card" to UModal/CommonModal; modal content uses the app modal surface and caller ui.content should only append z-index, width, or max-width classes.',
             'CommonModal and CommonDrawer own action-only footers through cancelAction, primaryAction, dangerAction, leadingActions, and footerHint. Pass footer button intent through those props instead of custom footer slots. cancelAction defaults to neutral outline; use dangerAction for irreversible destructive work and tone: "primary" for Keep editing in discard dialogs.',
             'Use custom #footer content only when the footer contains real custom layout or non-button content. Every modal/drawer button should use type="button" unless it intentionally submits a form.',
@@ -644,7 +1034,12 @@ export function validateExtensionCodeLocally(code) {
         const first = violations[0];
         throw new Error(`Invalid extension component casing: use <${first.expected}> instead of <${first.tag}>. Enfyra/Nuxt UI auto-injected components must keep PascalCase in extension templates; lowercase tags render as unresolved DOM elements.`);
     }
-    return { componentCasing: 'passed' };
+    const missingFullWidthFields = findMissingFullWidthFieldControls(code);
+    if (missingFullWidthFields.length) {
+        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' };
 }
 export async function validateExtensionCode(apiUrl, code, name) {
     const localChecks = validateExtensionCodeLocally(code);
@@ -1845,6 +2240,30 @@ async function runExtensionWorkflow(apiUrl, opts) {
     };
 }
 export function registerPlatformOperationTools(server, ENFYRA_API_URL) {
+    const extensionFooterActionSchema = z.object({
+        label: z.string().optional().describe('Static action label. Use labelExpression instead for dynamic labels.'),
+        labelExpression: z.string().optional().describe('Raw Vue expression for a dynamic label, e.g. mode === "create" ? "Create" : "Save".'),
+        icon: z.string().optional().describe('Optional icon name such as lucide:save or lucide:trash-2.'),
+        loading: z.string().optional().describe('Raw Vue expression/ref name for loading state, e.g. saving.'),
+        disabled: z.string().optional().describe('Raw Vue expression/ref name for disabled state, e.g. saving || !canSubmit.'),
+        color: z.string().optional().describe('Optional component-supported color. Usually omit and let the managed action choose intent.'),
+        variant: z.string().optional().describe('Optional component-supported variant. Usually omit and let the managed action choose intent.'),
+        tone: z.string().optional().describe('Optional action tone when supported by the shell component.'),
+        onClick: z.string().describe('Raw Vue expression or function reference for the click handler, e.g. saveNote or () => (open = false).'),
+    });
+    const extensionHeaderActionSchema = z.object({
+        id: z.string().describe('Stable action id.'),
+        label: z.string().optional().describe('Action label.'),
+        icon: z.string().optional().describe('Icon name such as lucide:plus or lucide:refresh-cw.'),
+        color: z.string().optional().default('neutral').describe('Nuxt UI color. Use primary only for the single main scope action; otherwise neutral.'),
+        variant: z.string().optional().default('outline').describe('Nuxt UI variant. Use solid for the main scope action; otherwise outline/ghost.'),
+        loading: z.string().optional().describe('Raw Vue expression/ref name for loading state.'),
+        disabled: z.string().optional().describe('Raw Vue expression/ref name for disabled state.'),
+        to: z.string().optional().describe('Route path for visible navigation actions.'),
+        onClick: z.string().optional().describe('Raw Vue expression or function reference for click behavior.'),
+        order: z.number().optional().describe('Sort order in the shell header action area.'),
+        side: z.enum(['left', 'right']).optional().describe('Optional shell side.'),
+    });
     server.tool('validate_dynamic_script', [
         'Validate Enfyra dynamic script code before saving it to any script-backed metadata record.',
         'Use this before create/update of handlers, hooks, flow steps, websocket scripts, GraphQL scripts, or bootstrap scripts when the user is iterating on code.',
@@ -1918,6 +2337,99 @@ export function registerPlatformOperationTools(server, ENFYRA_API_URL) {
         'Call this whenever you need the exact eapp-* class name or the Nuxt UI color mapping for shell, system page, or dynamic extension UI.',
         'Source of truth: documents/app/theme-color-contract.md.',
     ].join(' '), {}, async () => jsonText(getThemeClassReference()));
+    server.tool('build_extension_drawer', [
+        'Generate a contract-safe CommonDrawer Vue snippet for Enfyra admin extensions.',
+        'Use this before writing or patching drawer/editing workflows so the model does not have to remember CommonDrawer slots, footer action props, full-width fields, or button type rules.',
+        'The tool returns code only; apply it with patch_extension_code or update_extension_code and then validate/save normally.',
+    ].join(' '), {
+        model: z.string().optional().default('drawerOpen').describe('Vue state variable used with v-model.'),
+        title: z.string().optional().describe('Static drawer title.'),
+        titleExpression: z.string().optional().describe('Raw Vue expression for a dynamic title.'),
+        direction: z.enum(['right', 'left', 'top', 'bottom']).optional().default('right').describe('Drawer direction.'),
+        nested: z.boolean().optional().default(false).describe('Set true when rendering a drawer inside another modal/drawer.'),
+        handleOnly: z.boolean().optional().default(false).describe('Set true only when the drawer should use handle-only behavior.'),
+        body: z.string().describe('Vue template body content for #body. UInput/UTextarea/select controls are normalized to w-full; native buttons get type="button".'),
+        cancelAction: z.union([extensionFooterActionSchema, z.literal(false)]).optional().describe('Cancel action object. Omit for a default Cancel that closes the model; false disables cancelAction.'),
+        primaryAction: extensionFooterActionSchema.optional().describe('Primary action. Editing/create drawers should wire Save/Create here.'),
+        dangerAction: extensionFooterActionSchema.optional().describe('Danger action. Destructive edit drawers should wire Delete here.'),
+        footerHint: z.string().optional().describe('Optional footer hint text when supported by CommonDrawer.'),
+    }, async (input) => jsonText(buildExtensionDrawerSnippet(input)));
+    server.tool('build_extension_modal', [
+        'Generate a contract-safe CommonModal/UModal Vue snippet for Enfyra admin extensions.',
+        'Use this before writing or patching confirmation/edit modals so the model does not have to remember v-model:open, slots, final action props, full-width fields, or button type rules.',
+        'The tool returns code only; apply it with patch_extension_code or update_extension_code and then validate/save normally.',
+    ].join(' '), {
+        model: z.string().optional().default('modalOpen').describe('Vue state variable used with v-model:open.'),
+        title: z.string().optional().describe('Static modal title.'),
+        titleExpression: z.string().optional().describe('Raw Vue expression for a dynamic title.'),
+        alias: z.enum(['CommonModal', 'UModal']).optional().default('CommonModal').describe('Use UModal only when preserving an existing UModal tag is useful; dynamic extensions resolve it to CommonModal.'),
+        body: z.string().describe('Vue template body content for #body. UInput/UTextarea/select controls are normalized to w-full; native buttons get type="button".'),
+        cancelAction: z.union([extensionFooterActionSchema, z.literal(false)]).optional().describe('Cancel action object. Omit for a default Cancel that closes the model; false disables cancelAction.'),
+        primaryAction: extensionFooterActionSchema.optional().describe('Primary final action for non-destructive submit/confirm flows.'),
+        dangerAction: extensionFooterActionSchema.optional().describe('Danger final action for destructive confirmation flows.'),
+        footerHint: z.string().optional().describe('Optional footer hint text when supported by CommonModal.'),
+    }, async (input) => jsonText(buildExtensionModalSnippet(input)));
+    server.tool('review_extension_ui_contract', [
+        'Review an Enfyra extension Vue snippet for common modal/drawer contract mistakes.',
+        'Use this before patching or saving generated extension UI when CommonDrawer, CommonModal, UModal, UInput, UTextarea, USelect, or native buttons are involved.',
+        'This is a static contract review, not a compiler validation; still validate the final SFC before saving.',
+    ].join(' '), {
+        code: z.string().describe('Vue SFC or template snippet to review.'),
+    }, async ({ code }) => jsonText(reviewExtensionUiContract(code)));
+    server.tool('build_extension_page_shell', [
+        'Generate page-header and shell-header-action script setup code for Enfyra page extensions.',
+        'Use this so generated page extensions register shell chrome through usePageHeaderRegistry/useHeaderActionRegistry instead of rendering duplicate local headers.',
+    ].join(' '), {
+        title: z.string().optional().describe('Static page title.'),
+        titleExpression: z.string().optional().describe('Raw Vue expression for a dynamic title.'),
+        description: z.string().optional().describe('Optional page description.'),
+        leadingIcon: z.string().optional().describe('Optional page header icon.'),
+        gradient: z.enum(['none', 'purple', 'blue', 'cyan']).optional().default('none').describe('Generated operational extensions should usually use none.'),
+        variant: z.enum(['default', 'minimal', 'stats-focus']).optional().default('minimal').describe('Page header variant.'),
+        headerActions: z.array(extensionHeaderActionSchema).optional().describe('Optional shell header actions registered through useHeaderActionRegistry.'),
+    }, async (input) => jsonText(buildExtensionPageShellSnippet(input)));
+    server.tool('build_extension_permission_gate', [
+        'Generate a PermissionGate wrapper snippet for Enfyra admin extension UI.',
+        'Use this when a visible button/block/list needs operator UX gating; backend route permissions and owner checks still remain authoritative.',
+    ].join(' '), {
+        route: z.string().optional().describe('API route path to gate against, e.g. /notes.'),
+        methods: z.array(z.string()).optional().describe('HTTP methods for the route condition. Defaults to GET when route is provided.'),
+        condition: z.string().optional().describe('Raw Vue permission condition expression. Overrides route/methods when provided.'),
+        body: z.string().describe('Vue template content to render inside PermissionGate. Field controls are normalized to w-full.'),
+    }, async (input) => jsonText(buildExtensionPermissionGateSnippet(input)));
+    server.tool('build_extension_empty_state', [
+        'Generate a CommonEmptyState snippet for Enfyra admin extensions.',
+        'Use this for app-matched empty/error/no-results states instead of hand-rolled blank panels.',
+    ].join(' '), {
+        title: z.string().optional().describe('Empty state title.'),
+        description: z.string().optional().describe('Empty state description.'),
+        icon: z.string().optional().describe('Icon name. Defaults to lucide:inbox.'),
+        size: z.enum(['sm', 'md', 'lg']).optional().default('sm').describe('Empty state size.'),
+        variant: z.enum(['outline', 'naked', 'soft', 'subtle', 'solid']).optional().default('naked').describe('Use naked inside existing panels/lists.'),
+        action: extensionFooterActionSchema.optional().describe('Optional primary empty-state action.'),
+    }, async (input) => jsonText(buildExtensionEmptyStateSnippet(input)));
+    server.tool('build_extension_resource_list', [
+        'Generate a CommonResourceListFrame/CommonResourceListItem snippet for Enfyra admin extensions.',
+        'Use this for operational list pages so loading, empty state, pagination placement, row chrome, icons, stats, and row actions follow the app contract.',
+    ].join(' '), {
+        itemsExpression: z.string().optional().default('items').describe('Vue expression for the row array, e.g. notes.'),
+        itemName: z.string().optional().default('item').describe('Loop variable name.'),
+        keyExpression: z.string().optional().describe('Vue expression for :key. Defaults to item.id.'),
+        titleExpression: z.string().optional().describe('Vue expression for item title. Defaults to item.title || "Untitled".'),
+        descriptionExpression: z.string().optional().describe('Vue expression for item description. Defaults to item.description.'),
+        icon: z.string().optional().describe('Static row icon when iconExpression is omitted.'),
+        iconExpression: z.string().optional().describe('Vue expression for row icon.'),
+        loadingExpression: z.string().optional().default('pending').describe('Vue expression for frame loading.'),
+        totalExpression: z.string().optional().describe('Vue expression for total rows.'),
+        itemsPerPageExpression: z.string().optional().describe('Vue expression for items per page; use 0 to hide pagination.'),
+        statsExpression: z.string().optional().describe('Vue expression returning ResourceListStat[] for each row.'),
+        actionsExpression: z.string().optional().describe('Vue expression returning ResourceListAction[] for each row.'),
+        topBadgeExpression: z.string().optional().describe('Vue expression returning a ResourceListTopBadge for each row.'),
+        onClick: z.string().optional().describe('Raw Vue expression called for row click, e.g. openEdit(item).'),
+        emptyTitle: z.string().optional().describe('Empty title.'),
+        emptyDescription: z.string().optional().describe('Empty description.'),
+        emptyIcon: z.string().optional().describe('Empty icon.'),
+    }, async (input) => jsonText(buildExtensionResourceListSnippet(input)));
     server.tool('extension_workflow', [
         'Step-by-step workflow for creating or updating Enfyra admin page, global, or widget extensions.',
         'Use this when an LLM is building extension UI, menu shell notifications, account panel entries, or page/menu wiring and should follow live nextSteps instead of guessing raw enfyra_extension mutations.',