ADR-013 Phase 4: relocate 4 self-contained plugin frontends

Relocate applications, geenforce, knowledgebase, and machines - each owns only
its own views dir, so a clean move to plugins/<name>/frontend/ (views/ +
routes.js, core imports rewritten to @/). geenforce's entryForm.js helper + its
vitest spec move with it (ManifestEditor imports it as a sibling).

Machinery fixes this batch surfaced:
- routes.gen.js codegen uses namespace imports (import * as p_x). A route file
  without a `toplevel` export is undefined on the namespace instead of a strict-
  ESM missing-binding build error.
- vitest gains a `pretest` stage so plugin-frontend specs (now under
  plugins/<name>/frontend/) run from their staged copy in src/.plugins-staged/.

Verified live: GE-Enforce (the most complex, uses the entryForm sibling helper)
renders fully from its staged frontend. Build + 58 vitest + naming green.

frontend/package.json

@@ -10,6 +10,7 @@
     "prebuild": "npm run stage",
     "build": "vite build",
     "preview": "vite preview",
+    "pretest": "npm run stage",
     "test": "vitest run",
     "test:watch": "vitest"
   },

frontend/vitest.config.js

@@ -14,6 +14,8 @@ export default defineConfig({
   test: {
     environment: 'jsdom',
     globals: true,
+    // Core specs plus plugin-frontend specs, which the pretest stage copies
+    // into src/.plugins-staged/ (under root, so this glob finds them).
     include: ['src/**/*.spec.js'],
   },
 })

plugins/applications/frontend/routes.js

@@ -5,23 +5,23 @@ export default [
   {
     path: 'applications',
     name: 'applications',
-    component: () => import('../../views/applications/ApplicationsList.vue')
+    component: () => import('./views/ApplicationsList.vue')
   },
   {
     path: 'applications/new',
     name: 'application-new',
-    component: () => import('../../views/applications/ApplicationForm.vue'),
+    component: () => import('./views/ApplicationForm.vue'),
     meta: { requiresAuth: true }
   },
   {
     path: 'applications/:id',
     name: 'application-detail',
-    component: () => import('../../views/applications/ApplicationDetail.vue')
+    component: () => import('./views/ApplicationDetail.vue')
   },
   {
     path: 'applications/:id/edit',
     name: 'application-edit',
-    component: () => import('../../views/applications/ApplicationForm.vue'),
+    component: () => import('./views/ApplicationForm.vue'),
     meta: { requiresAuth: true }
   }
 ]

plugins/applications/frontend/views/ApplicationDetail.vue

@@ -156,8 +156,8 @@
 <script setup>
 import { ref, onMounted } from 'vue'
 import { useRoute } from 'vue-router'
-import { applicationsApi } from '../../api'
-import { getContactEmailDomain } from '../../utils/siteSettings'
+import { applicationsApi } from '@/api'
+import { getContactEmailDomain } from '@/utils/siteSettings'
 
 const route = useRoute()
 

plugins/applications/frontend/views/ApplicationForm.vue

@@ -154,8 +154,8 @@
 <script setup>
 import { ref, onMounted, computed } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
-import { applicationsApi, supportteamsApi } from '../../api'
-import { apiError } from '../../utils/apiError'
+import { applicationsApi, supportteamsApi } from '@/api'
+import { apiError } from '@/utils/apiError'
 
 const route = useRoute()
 const router = useRouter()

plugins/applications/frontend/views/ApplicationsList.vue

@@ -99,8 +99,8 @@
 
 <script setup>
 import { ref, onMounted } from 'vue'
-import { applicationsApi } from '../../api'
-import PaginationBar from '../../components/PaginationBar.vue'
+import { applicationsApi } from '@/api'
+import PaginationBar from '@/components/PaginationBar.vue'
 import { useListQuery } from '@/composables/listQuery'
 
 const applications = ref([])

plugins/geenforce/frontend/routes.js

@@ -9,20 +9,20 @@
 export default [
   {
     path: 'geenforce',
-    component: () => import('../../views/geenforce/GeEnforceLayout.vue'),
+    component: () => import('./views/GeEnforceLayout.vue'),
     meta: { requiresAuth: true, requiresAdmin: true, plugin: 'geenforce' },
     children: [
       { path: '', redirect: '/geenforce/manifests' },
       {
         path: 'manifests',
         name: 'geenforce-manifests',
-        component: () => import('../../views/geenforce/ManifestEditor.vue'),
+        component: () => import('./views/ManifestEditor.vue'),
         meta: { requiresAuth: true, requiresAdmin: true, plugin: 'geenforce' }
       },
       {
         path: 'reports',
         name: 'geenforce-reports',
-        component: () => import('../../views/geenforce/EnforcementReports.vue'),
+        component: () => import('./views/EnforcementReports.vue'),
         meta: { requiresAuth: true, requiresAdmin: true, plugin: 'geenforce' }
       }
     ]

plugins/geenforce/frontend/views/EnforcementReports.vue

@@ -104,7 +104,7 @@
 
 <script setup>
 import { ref } from 'vue'
-import api from '../../api'
+import api from '@/api'
 
 const reports = ref([])
 const detail = ref(null)

plugins/geenforce/frontend/views/ManifestEditor.vue

@@ -570,7 +570,7 @@
 
 <script setup>
 import { ref, computed } from 'vue'
-import api from '../../api'
+import api from '@/api'
 // Pure entry-form logic lives in entryForm.js (unit-tested by entryForm.spec.js);
 // this component wires it to reactive state so the tests cover the shipped code.
 import {

plugins/knowledgebase/frontend/routes.js

@@ -5,25 +5,25 @@ export default [
   {
     path: 'knowledgebase',
     name: 'knowledgebase',
-    component: () => import('../../views/knowledgebase/KnowledgeBaseList.vue'),
+    component: () => import('./views/KnowledgeBaseList.vue'),
     meta: { plugin: 'knowledgebase' }
   },
   {
     path: 'knowledgebase/new',
     name: 'knowledgebase-new',
-    component: () => import('../../views/knowledgebase/KnowledgeBaseForm.vue'),
+    component: () => import('./views/KnowledgeBaseForm.vue'),
     meta: { requiresAuth: true, plugin: 'knowledgebase' }
   },
   {
     path: 'knowledgebase/:id',
     name: 'knowledgebase-detail',
-    component: () => import('../../views/knowledgebase/KnowledgeBaseDetail.vue'),
+    component: () => import('./views/KnowledgeBaseDetail.vue'),
     meta: { plugin: 'knowledgebase' }
   },
   {
     path: 'knowledgebase/:id/edit',
     name: 'knowledgebase-edit',
-    component: () => import('../../views/knowledgebase/KnowledgeBaseForm.vue'),
+    component: () => import('./views/KnowledgeBaseForm.vue'),
     meta: { requiresAuth: true, plugin: 'knowledgebase' }
   }
 ]

plugins/knowledgebase/frontend/views/KnowledgeBaseDetail.vue

@@ -79,7 +79,7 @@
 <script setup>
 import { ref, onMounted } from 'vue'
 import { useRoute } from 'vue-router'
-import { knowledgebaseApi } from '../../api'
+import { knowledgebaseApi } from '@/api'
 
 const route = useRoute()
 

plugins/knowledgebase/frontend/views/KnowledgeBaseForm.vue

@@ -82,8 +82,8 @@
 <script setup>
 import { ref, onMounted, computed } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
-import { knowledgebaseApi, applicationsApi } from '../../api'
-import { apiError } from '../../utils/apiError'
+import { knowledgebaseApi, applicationsApi } from '@/api'
+import { apiError } from '@/utils/apiError'
 
 const route = useRoute()
 const router = useRouter()

plugins/knowledgebase/frontend/views/KnowledgeBaseList.vue

@@ -109,8 +109,8 @@
 
 <script setup>
 import { ref, onMounted } from 'vue'
-import { knowledgebaseApi, applicationsApi } from '../../api'
-import PaginationBar from '../../components/PaginationBar.vue'
+import { knowledgebaseApi, applicationsApi } from '@/api'
+import PaginationBar from '@/components/PaginationBar.vue'
 import { useListQuery } from '@/composables/listQuery'
 
 const loading = ref(true)

plugins/machines/frontend/routes.js

@@ -5,25 +5,25 @@ export default [
   {
     path: 'machines',
     name: 'machines',
-    component: () => import('../../views/machines/MachinesList.vue'),
+    component: () => import('./views/MachinesList.vue'),
     meta: { plugin: 'machines' }
   },
   {
     path: 'machines/new',
     name: 'machine-new',
-    component: () => import('../../views/machines/MachineForm.vue'),
+    component: () => import('./views/MachineForm.vue'),
     meta: { requiresAuth: true, plugin: 'machines' }
   },
   {
     path: 'machines/:id',
     name: 'machine-detail',
-    component: () => import('../../views/machines/MachineDetail.vue'),
+    component: () => import('./views/MachineDetail.vue'),
     meta: { plugin: 'machines' }
   },
   {
     path: 'machines/:id/edit',
     name: 'machine-edit',
-    component: () => import('../../views/machines/MachineForm.vue'),
+    component: () => import('./views/MachineForm.vue'),
     meta: { requiresAuth: true, plugin: 'machines' }
   }
 ]

plugins/machines/frontend/views/MachineDetail.vue

@@ -234,13 +234,13 @@
 <script setup>
 import { ref, onMounted } from 'vue'
 import { useRoute } from 'vue-router'
-import { machinesApi } from '../../api'
-import LocationMapTooltip from '../../components/LocationMapTooltip.vue'
-import CustomFieldsSection from '../../components/CustomFieldsSection.vue'
-import PluginAssetPanels from '../../components/PluginAssetPanels.vue'
-import AssetRelationships from '../../components/AssetRelationships.vue'
-import { useWarrantyBadge } from '../../composables/warrantyBadge'
-import { useIdentifierFlags } from '../../composables/identifierSettings'
+import { machinesApi } from '@/api'
+import LocationMapTooltip from '@/components/LocationMapTooltip.vue'
+import CustomFieldsSection from '@/components/CustomFieldsSection.vue'
+import PluginAssetPanels from '@/components/PluginAssetPanels.vue'
+import AssetRelationships from '@/components/AssetRelationships.vue'
+import { useWarrantyBadge } from '@/composables/warrantyBadge'
+import { useIdentifierFlags } from '@/composables/identifierSettings'
 
 const route = useRoute()
 const { isEnabled } = useIdentifierFlags()

plugins/machines/frontend/views/MachineForm.vue

@@ -347,13 +347,13 @@
 <script setup>
 import { ref, onMounted, computed, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
-import { machinesApi, vendorsApi, locationsApi, modelsApi, businessunitsApi, computersApi, assetsApi, relationshipTypesApi } from '../../api'
-import ShopFloorMap from '../../components/ShopFloorMap.vue'
-import Modal from '../../components/Modal.vue'
-import CustomFieldsInputs from '../../components/CustomFieldsInputs.vue'
-import { currentTheme } from '../../stores/theme'
-import { useIdentifierFlags } from '../../composables/identifierSettings'
-import { apiError } from '../../utils/apiError'
+import { machinesApi, vendorsApi, locationsApi, modelsApi, businessunitsApi, computersApi, assetsApi, relationshipTypesApi } from '@/api'
+import ShopFloorMap from '@/components/ShopFloorMap.vue'
+import Modal from '@/components/Modal.vue'
+import CustomFieldsInputs from '@/components/CustomFieldsInputs.vue'
+import { currentTheme } from '@/stores/theme'
+import { useIdentifierFlags } from '@/composables/identifierSettings'
+import { apiError } from '@/utils/apiError'
 
 const { isEnabled } = useIdentifierFlags()
 

plugins/machines/frontend/views/MachinesList.vue

@@ -85,8 +85,8 @@
 <script setup>
 import { ref, onMounted } from 'vue'
 import { colorStyle } from "@/utils/colorStyle"
-import { machinesApi } from '../../api'
-import PaginationBar from '../../components/PaginationBar.vue'
+import { machinesApi } from '@/api'
+import PaginationBar from '@/components/PaginationBar.vue'
 import { useListQuery } from '@/composables/listQuery'
 
 const machines = ref([])

scripts/stage-frontend.mjs

@@ -45,11 +45,11 @@ const childParts = []
 const topParts = []
 for (const name of chosen) {
   const id = 'p_' + name.replace(/[^a-zA-Z0-9]/g, '_')
-  lines.push(
-    `import ${id}Default, { toplevel as ${id}Top } from `
-    + `'../.plugins-staged/${name}/routes.js'`)
-  childParts.push(`...(${id}Default || [])`)
-  topParts.push(`...(${id}Top || [])`)
+  // Namespace import so a route file without a `toplevel` export is not a
+  // (strict ESM) build error - the binding is just undefined on the namespace.
+  lines.push(`import * as ${id} from '../.plugins-staged/${name}/routes.js'`)
+  childParts.push(`...(${id}.default || [])`)
+  topParts.push(`...(${id}.toplevel || [])`)
 }
 lines.push('')
 lines.push(`export const stagedChildren = [${childParts.join(', ')}]`)