@enfyra/mcp-server 0.0.112 → 0.0.115

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/mcp-server",
-  "version": "0.0.112",
+  "version": "0.0.115",
   "description": "MCP server for Enfyra - manage Enfyra instances from MCP-compatible coding tools",
   "type": "module",
   "license": "MIT",

package/src/lib/mcp-examples.js

@@ -1531,7 +1531,7 @@ ensure_page_extension({
   name: "ReportsPage",
   description: "Reports dashboard",
   menuId: "<created-menu-id>",
-  code: "<template><section class=\\"min-h-full w-full space-y-4\\"><div class=\\"grid gap-4 md:grid-cols-2 xl:grid-cols-3\\"><article class=\\"surface-card p-4\\"><p class=\\"text-sm font-medium text-[var(--text-tertiary)]\\">Total</p><p class=\\"mt-2 text-2xl font-semibold text-[var(--text-primary)]\\">0</p></article></div></section></template><script setup>const { registerPageHeader } = usePageHeaderRegistry(); const { register: registerHeaderActions } = useHeaderActionRegistry(); registerPageHeader({ title: 'Reports', description: 'Operational report overview.', leadingIcon: 'lucide:bar-chart-3', gradient: 'cyan', variant: 'minimal' }); registerHeaderActions([{ id: 'refresh-reports', label: 'Refresh', icon: 'lucide:refresh-cw', color: 'primary', variant: 'solid', onClick: () => {}, order: 0 }])</script>",
+  code: "<template><section class=\\"min-h-full w-full space-y-4\\"><div class=\\"grid gap-4 md:grid-cols-2 xl:grid-cols-3\\"><article class=\\"surface-card p-4\\"><div class=\\"flex items-start justify-between gap-3\\"><div><p class=\\"text-sm font-medium text-[var(--text-tertiary)]\\">Total</p><p class=\\"mt-2 text-2xl font-semibold text-[var(--text-primary)]\\">0</p></div><span class=\\"eapp-identity-soft rounded-[var(--radius-control)] p-2\\"><span class=\\"eapp-identity-text\\">◆</span></span></div><div class=\\"mt-3 h-1.5 overflow-hidden rounded-[var(--radius-pill)] bg-[var(--surface-muted)]\\"><div class=\\"eapp-identity-solid h-full w-1/2\\"></div></div></article><article class=\\"eapp-identity-surface rounded-[var(--radius-panel)] border p-4\\"><p class=\\"text-sm font-semibold text-[var(--text-primary)]\\">Selected report</p><p class=\\"mt-1 text-sm text-[var(--text-tertiary)]\\">Only selected/current identity blocks use identity surface.</p></article></div></section></template><script setup>const { registerPageHeader } = usePageHeaderRegistry(); const { register: registerHeaderActions } = useHeaderActionRegistry(); registerPageHeader({ title: 'Reports', description: 'Operational report overview.', leadingIcon: 'lucide:bar-chart-3', gradient: 'none', variant: 'minimal' }); registerHeaderActions([{ id: 'refresh-reports', label: 'Refresh', icon: 'lucide:refresh-cw', color: 'neutral', variant: 'outline', onClick: () => {}, order: 80 }])</script>",
   isEnabled: true
 })`,
         notes: [
@@ -1547,7 +1547,10 @@ ensure_page_extension({
           'Page extensions should be full-bleed by default and responsive from the first version.',
           'The extension root is already inside Enfyra admin page main; do not add root-level page padding.',
           'Use existing eApp theme variables for panels, rows, badges, borders, controls, radius, and text. Pair border/divide utilities with border-[var(--border-default)] or divide-[var(--border-default)] so light and dark themes stay consistent.',
-          'Treat primary color as runtime-configurable: use UButton color="primary", var(--brand-*), --action-primary-*, and --badge-primary-* instead of hardcoded violet/purple/cyan.',
+          'Treat primary color as runtime-configurable by the app color picker. For Nuxt UI components, choose color="primary" by semantic intent. For custom extension UI, decide whether each element is neutral surface, runtime-primary identity, or status: regular panels/KPI cards/list rows use surface-card/surface-muted or --card-* tokens, while selected/current identity blocks, primary tiles, progress fills, primary icons, and primary CTA fills use eapp-identity-surface, eapp-identity-soft, eapp-identity-solid, or eapp-identity-text so the color picker controls them.',
+          'Pattern examples: KPI/metric cards should be surface-card with a small eapp-identity-soft icon tile; selected/current entity cards may use eapp-identity-surface; progress bars use bg-[var(--surface-muted)] tracks plus eapp-identity-solid fills; list rows use neutral surfaces/dividers and only small chips inside; primary scope actions use UButton color="primary" variant="solid"; secondary actions use neutral variants.',
+          'Status colors belong only in UBadge/token-backed badges, small icons, or short status text. Do not color large panels, alert-like success blocks, KPI cards, list containers, or attention/reconciliation blocks green/yellow/red because of state; keep the block neutral and place the status badge/icon inside.',
+          'Use PageHeader gradient: "none" for generated operational pages unless the user explicitly asks for a decorative page accent; do not hardcode cyan/violet/purple/blue/green gradients.',
           'For general card grids inside the shell, use md:grid-cols-2 xl:grid-cols-3 instead of lg:grid-cols-3 because the desktop sidebar leaves tablet-width content at 1024px.',
           'Do not use Nuxt UI neutral semantic classes such as bg-default, text-muted, text-dimmed, border-default, or divide-default inside extension code; use eApp tokens/classes.',
           'Do not pass ui.content: "surface-card" to UModal/CommonModal; modal content uses the app modal surface and caller content classes should only append z-index or width.',
@@ -1571,6 +1574,9 @@ const reportStatusWidgetCode = \`
       </div>
       <UButton type="button" color="neutral" variant="outline" @click.stop.prevent="emit('refresh')">Refresh</UButton>
     </div>
+    <div class="mt-3 h-1.5 overflow-hidden rounded-[var(--radius-pill)] bg-[var(--surface-muted)]">
+      <div class="eapp-identity-solid h-full" :style="{ width: progressWidth }"></div>
+    </div>
     <UButton v-if="hasLatest" type="button" class="mt-3" color="primary" variant="solid" @click.stop.prevent="openLatest">Open latest</UButton>
   </section>
 </template>
@@ -1584,6 +1590,7 @@ const props = defineProps({
 const emit = defineEmits(['refresh'])
 const hasLatest = computed(() => props.rows.length > 0)
 const latestLabel = computed(() => hasLatest.value ? 'Latest: ' + (props.rows[0]?.title || props.rows[0]?.id || 'Untitled') : 'No reports yet')
+const progressWidth = computed(() => hasLatest.value ? '100%' : '0%')
 function openLatest() {
   if (typeof props.openDetails === 'function' && props.rows[0]) props.openDetails(props.rows[0])
 }
@@ -1601,7 +1608,7 @@ ensure_widget_extension({
 ensure_page_extension({
   name: "ReportsPage",
   menuId: "<reports-menu-id>",
-  code: "<template><section class=\\"min-h-full w-full space-y-4\\"><Widget :id=\\"<report-status-widget-id>\\" :total=\\"totalReports\\" :rows=\\"reportRows\\" :open-details=\\"openReportDetails\\" @refresh=\\"refresh\\" /><Widget :id=\\"<report-table-widget-id>\\" :rows=\\"reportRows\\" @refresh=\\"refresh\\" /></section></template><script setup>const { registerPageHeader } = usePageHeaderRegistry(); registerPageHeader({ title: 'Reports', description: 'Operational report overview.', leadingIcon: 'lucide:bar-chart-3', gradient: 'cyan', variant: 'minimal' }); const totalReports = ref(0); const reportRows = ref([]); function refresh() {} function openReportDetails(row) { navigateTo('/data/report?filter=' + encodeURIComponent(JSON.stringify({ id: { _eq: row.id } }))) }</script>",
+  code: "<template><section class=\\"min-h-full w-full space-y-4\\"><Widget :id=\\"<report-status-widget-id>\\" :total=\\"totalReports\\" :rows=\\"reportRows\\" :open-details=\\"openReportDetails\\" @refresh=\\"refresh\\" /><Widget :id=\\"<report-table-widget-id>\\" :rows=\\"reportRows\\" @refresh=\\"refresh\\" /></section></template><script setup>const { registerPageHeader } = usePageHeaderRegistry(); registerPageHeader({ title: 'Reports', description: 'Operational report overview.', leadingIcon: 'lucide:bar-chart-3', gradient: 'none', variant: 'minimal' }); const totalReports = ref(0); const reportRows = ref([]); function refresh() {} function openReportDetails(row) { navigateTo('/data/report?filter=' + encodeURIComponent(JSON.stringify({ id: { _eq: row.id } }))) }</script>",
   isEnabled: true
 })`,
         notes: [
@@ -1742,7 +1749,7 @@ registerPageHeader({
   title: 'Report detail',
   description: 'Review status, schedule, and delivery history.',
   leadingIcon: 'lucide:file-text',
-  gradient: 'cyan',
+  gradient: 'none',
   variant: 'minimal'
 })
 
@@ -1770,8 +1777,8 @@ registerHeaderActions([
     id: 'refresh-report',
     label: 'Refresh',
     icon: 'lucide:refresh-cw',
-    color: 'primary',
-    variant: 'solid',
+    color: 'neutral',
+    variant: 'outline',
     order: 2,
     onClick: refresh
   }
@@ -1779,9 +1786,10 @@ registerHeaderActions([
 </script>`,
         notes: [
           'Use PageHeader for the title strip; do not render a duplicate header inside extension body.',
+          'Use gradient: "none" for generated operational pages; hardcoded named gradients are decorative and should be explicit user intent.',
           'Back/navigation actions should be neutral ghost so they read as navigation, not a primary operation.',
           'Visible secondary operations should be neutral outline; soft is only for low-emphasis chrome actions.',
-          'The main page action should be primary solid.',
+          'The main page mutation action should be primary solid; refresh is neutral outline unless refresh is the actual primary workflow.',
           'Do not choose soft only because it looks acceptable in dark mode; light mode must remain clear too.',
         ],
       },

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

@@ -302,13 +302,18 @@ function getExtensionThemeContract() {
     ],
     theme: [
       'Use existing eApp theme variables/classes, not hardcoded light or dark colors. The app theme source of truth is CSS variables, including --brand-*, --surface-*, --card-*, --control-*, --action-*, --badge-*, --radius-*, --border-*, and --text-*.',
-      'Primary color is runtime-configurable and first-class. Use UButton color="primary", var(--brand-*), --action-primary-*, --state-primary-*, and --badge-primary-* instead of hardcoded violet/purple/cyan values.',
+      'Primary color is runtime-configurable through the app color picker and must affect extension identity UI. For Nuxt UI components, choose color="primary" by semantic intent and let the app map it through the primary contract; do not choose a concrete palette. For custom extension UI, first choose whether the element is neutral surface, runtime-primary identity, or status. Regular panels, KPI cards, list rows, and large content blocks should use surface-card/surface-muted or --card-* tokens. Entity identity, selected/current state, active progress, primary tiles, primary icons, and primary CTA fills should use eapp-identity-surface, eapp-identity-soft, eapp-identity-solid, eapp-identity-text, or UButton/UBadge color="primary" so the color picker controls them.',
+      'Use eapp-identity-surface only for larger entity/feature blocks, selected/current cards, tiles, or cards that should read like normal app cards with a very subtle active-primary tint; it is not a saturated selected-state fill and must not be applied broadly to every KPI/list wrapper. Add eapp-identity-surface-hover when that block is clickable. Use eapp-identity-soft for compact selected entity chips, pills, small icon tiles, and identity callouts; add eapp-identity-soft-hover when compact surfaces are clickable; use eapp-identity-solid only for primary identity fills; use eapp-identity-text for identity icons or inline text. The eapp-accent-* aliases are still available for the same runtime-primary intent, but eapp-identity-* is preferred when the UI element represents an entity or feature identity.',
+      'Nuxt UI secondary is still a valid semantic color when the product intentionally wants a secondary action or state. Do not use color="secondary", from-secondary-*, bg-secondary-*, text-secondary-*, or cyan/purple/green palette utilities merely to approximate an entity accent; use eapp-identity-* and let the app decide the color.',
+      'Do not make custom extension blocks with Tailwind palette utilities or raw primary utilities such as text-primary, bg-primary/10, border-primary, ring-primary/20, from-cyan-*, text-violet-*, bg-green-*, bg-emerald-*, text-green-*, border-green-*, or dark:bg-zinc-950. The app owns how eapp-identity-* and eapp-accent-* map to the active color picker value.',
+      'Use UButton color="primary" only for the single main action for the current scope. Refresh, back, navigation, filters, and secondary actions should be neutral variants unless they are the main mutation.',
+      'PageHeader gradient must be "none" for generated operational extensions unless the user explicitly asks for a decorative page accent. Do not hardcode cyan, violet, purple, blue, or green PageHeader gradients to force color variety.',
       'Do not inject global CSS, create theme guards, redefine the app palette, or solve one extension by overriding the whole app shell.',
       'For panels/cards, prefer surface-card, surface-card-hover, surface-muted, or explicit token classes such as bg-[var(--card-bg)] border-[var(--card-border)] shadow-[var(--card-shadow)]. Use text-[var(--text-primary|secondary|tertiary)] for copy.',
       'Never use Nuxt UI neutral semantic classes such as bg-default, bg-muted, border-default, divide-default, text-muted, text-dimmed, or hardcoded dark palettes such as dark:bg-zinc-950, bg-slate-*, text-gray-*, border-black, or black.',
       'Never use bare border/divide-y for panels or rows: pair them with border-[var(--border-default)] or divide-[var(--border-default)].',
       'Use radius tokens or mapped rounded utilities consistently: --radius-card for cards, --radius-panel for nested panels, --radius-control for buttons/inputs, --radius-subcontrol for compact inner controls, and --radius-pill for pills.',
-      'Status colors must remain readable in both themes. Use badge tokens such as --badge-success-soft-*, --badge-warning-soft-*, --badge-danger-soft-*, --badge-info-soft-*, --badge-neutral-soft-*, and --badge-primary-soft-* instead of neon translucent colors.',
+      'Status colors must remain readable in both themes and must stay scoped to badges, small icons, or short status text. Use UBadge or badge tokens for non-primary statuses such as --badge-success-soft-*, --badge-warning-soft-*, --badge-danger-soft-*, --badge-info-soft-*, and --badge-neutral-soft-* instead of neon translucent colors. Do not color large panels, alert-like success blocks, KPI cards, list containers, or reconciliation/attention blocks green/yellow/red because the status is good/warning/error; use neutral app surfaces for the block and place a small status badge/icon inside.',
       'Keep dark and light contrast comparable. Do not make dark mode more neon or lower-contrast than light mode; prefer muted soft backgrounds with clear text and visible borders.',
     ],
     components: [
@@ -335,7 +340,39 @@ function getExtensionThemeContract() {
       'UI checks are only guidance; handlers/hooks must independently enforce owner/root-admin authorization.',
       'Use the most specific business route or MCP tool. Do not write directly to raw tables when a domain route exists.',
     ],
-    compactExample: '<template><section class="min-h-full w-full space-y-4"><div class="surface-card"><div class="border-b border-[var(--border-default)] px-4 py-3"><h2 class="text-base font-semibold text-[var(--text-primary)]">Title</h2><p class="text-sm text-[var(--text-tertiary)]">Short operational context.</p></div><div class="divide-y divide-[var(--border-default)]"><button class="flex w-full cursor-pointer items-center justify-between px-4 py-3 text-left transition-colors hover:bg-[var(--surface-muted)] disabled:cursor-not-allowed disabled:opacity-60"><span class="text-sm font-medium text-[var(--text-primary)]">Row</span><span class="rounded-[var(--radius-pill)] bg-[var(--badge-primary-soft-bg)] px-2 py-0.5 text-xs font-semibold text-[var(--badge-primary-soft-text)] ring-1 ring-inset ring-[var(--badge-primary-soft-border)]">Open</span></button></div></div></section></template>',
+    patternExamples: [
+      {
+        useWhen: 'Ordinary KPI, metric, or summary card where the whole card is not selected/current identity.',
+        use: 'Neutral card surface; put runtime-primary only on a small identity icon tile, progress fill, or main CTA inside the card.',
+        snippet: '<article class="surface-card p-4"><div class="flex items-start justify-between gap-3"><div><p class="text-sm text-[var(--text-tertiary)]">Metric</p><p class="mt-2 text-2xl font-semibold text-[var(--text-primary)]">{{ value }}</p></div><span class="eapp-identity-soft rounded-[var(--radius-control)] p-2"><UIcon name="lucide:square-stack" class="size-5 eapp-identity-text" /></span></div></article>',
+      },
+      {
+        useWhen: 'Selected/current entity, active plan, chosen package, or the single block that represents the active identity.',
+        use: 'eapp-identity-surface for the selected/current block, with eapp-identity-soft/text for compact icon parts.',
+        snippet: '<article class="eapp-identity-surface eapp-identity-surface-hover rounded-[var(--radius-panel)] border p-4"><div class="flex items-center gap-3"><span class="eapp-identity-soft rounded-[var(--radius-control)] p-2"><UIcon name="lucide:box" class="size-5 eapp-identity-text" /></span><div><p class="font-semibold text-[var(--text-primary)]">{{ name }}</p><p class="text-sm text-[var(--text-tertiary)]">Currently selected</p></div></div></article>',
+      },
+      {
+        useWhen: 'Progress, active tab indicator, selected segment fill, or primary visual meter.',
+        use: 'Neutral track plus eapp-identity-solid fill so the app color picker controls the fill.',
+        snippet: '<div class="h-1.5 overflow-hidden rounded-[var(--radius-pill)] bg-[var(--surface-muted)]"><div class="eapp-identity-solid h-full" :style="{ width: progressWidth }"></div></div>',
+      },
+      {
+        useWhen: 'Success, warning, error, info, healthy, running, failed, pending, or attention status.',
+        use: 'UBadge/status badge tokens and optionally a small icon only. Keep large alert/panel/card backgrounds neutral unless the whole block is an identity block.',
+        snippet: '<section class="surface-card p-4"><div class="flex items-center justify-between gap-3"><p class="font-semibold text-[var(--text-primary)]">Reconciliation</p><UBadge color="success" variant="soft">Healthy</UBadge></div><p class="mt-1 text-sm text-[var(--text-tertiary)]">Latest report found no mismatches.</p></section>',
+      },
+      {
+        useWhen: 'List rows, table-like records, history rows, and secondary navigation rows.',
+        use: 'Neutral row surface, tokenized dividers, hover surface-muted, with small status/identity chips inside.',
+        snippet: '<div class="surface-card divide-y divide-[var(--border-default)]"><button class="flex w-full items-center justify-between px-4 py-3 text-left hover:bg-[var(--surface-muted)]"><span class="text-sm font-medium text-[var(--text-primary)]">{{ row.name }}</span><UBadge color="neutral" variant="soft">{{ row.state }}</UBadge></button></div>',
+      },
+      {
+        useWhen: 'Primary action for the current scope, such as create/save/apply/open-current.',
+        use: 'UButton color="primary" variant="solid"; secondary actions stay neutral.',
+        snippet: '<div class="flex justify-end gap-2"><UButton color="neutral" variant="outline">Cancel</UButton><UButton color="primary" variant="solid" icon="lucide:save">Save</UButton></div>',
+      },
+    ],
+    compactExample: '<template><section class="min-h-full w-full space-y-4"><article class="surface-card p-4"><div class="flex items-start justify-between gap-3"><div><p class="text-sm text-[var(--text-tertiary)]">Neutral KPI</p><p class="mt-2 text-2xl font-semibold text-[var(--text-primary)]">24</p></div><span class="eapp-identity-soft rounded-[var(--radius-control)] p-2"><UIcon name="lucide:square-stack" class="size-5 eapp-identity-text" /></span></div><div class="mt-3 h-1.5 overflow-hidden rounded-[var(--radius-pill)] bg-[var(--surface-muted)]"><div class="eapp-identity-solid h-full w-1/2"></div></div></article><section class="surface-card p-4"><div class="flex items-center justify-between gap-3"><p class="font-semibold text-[var(--text-primary)]">Status block stays neutral</p><UBadge color="success" variant="soft">Healthy</UBadge></div></section></section></template>',
   };
 }