Make a retired asset findable and restorable from the product

The retire dialog says "History and relationships are kept, and it can be
restored." The API always kept that promise - ?active=false lists retired rows,
PUT {"isactive": true} restores one - and no screen in the product could reach
either. A retired asset simply vanished: the lists filtered it out, global
search missed it, and its detail page still rendered Edit and Retire with
nothing anywhere saying it was retired.

Five list pages gained a "Show retired" toggle that passes active=false, and a
retired row now carries a badge. Five detail pages gained a banner saying the
record is retired and what that means, a Restore button, and the suppression of
Edit and Retire while it is retired - offering Retire on an already-retired
record was the part that made the state invisible.

Verified end to end in a browser: retire a machine, the detail page says so and
offers Restore, the list hides it until the toggle is ticked and badges it when
shown, and Restore puts it back (isactive true again on the API).

One thing this does NOT do: global search still does not reach a retired asset.
That is a separate surface with its own filter, and worth deciding on
deliberately rather than sliding in here - a search that returns retired
records by default would change every result page.

Scope: product

plugins/machines/frontend/views/MachineDetail.vue

@@ -9,14 +9,24 @@
         <router-link :to="`/print/asset-label/machine/${machine?.machine?.machineid}`" class="btn btn-secondary" v-if="machine" target="_blank">
           Print Label
         </router-link>
-        <router-link :to="`/machines/${machine?.machine?.machineid}/edit`" class="btn btn-primary" v-if="machine">
+        <router-link :to="`/machines/${machine?.machine?.machineid}/edit`" class="btn btn-primary" v-if="machine && !isRetired">
           Edit
         </router-link>
-        <button @click="confirmRetire" class="btn btn-danger" v-if="machine">Retire</button>
+        <button @click="confirmRetire" class="btn btn-danger" v-if="machine && !isRetired">Retire</button>
+        <!-- A retired record offered Edit and Retire exactly like a live one,
+             with nothing on the page saying it was retired. Restoring it was
+             possible through the API and nowhere in the product. -->
+        <button @click="restore" class="btn btn-primary" v-if="machine && isRetired">Restore</button>
         <router-link to="/machines" class="btn btn-secondary">Back to List</router-link>
       </div>
     </div>
 
+    <div v-if="machine && isRetired" class="retired-banner card">
+      <strong>This machine is retired.</strong>
+      It stays out of every list and report, and its history and relationships
+      are intact. Restore puts it back.
+    </div>
+
     <div v-if="loading" class="loading">Loading...</div>
 
     <template v-else-if="machine">
@@ -295,7 +305,7 @@ const { heroWarranty, warrantyDate } = useWarrantyBadge(() => machine.value?.ass
 
 // relationships render via the shared AssetRelationships card
 
-onMounted(async () => {
+async function loadMachine() {
   try {
     const response = await machinesApi.get(route.params.id)
     machine.value = response.data.data
@@ -305,7 +315,9 @@ onMounted(async () => {
   } finally {
     loading.value = false
   }
-})
+}
+
+onMounted(loadMachine)
 
 function getStatusClass(status) {
   if (!status) return 'badge-info'
@@ -324,6 +336,20 @@ function formatDate(dateStr) {
 // Retire, not delete: the server deactivates the asset, so the machine
 // leaves every list and report while its history and relationships stay put.
 // Reversible by an admin setting isactive back to true.
+const isRetired = computed(() => machine.value?.isactive === false)
+
+async function restore() {
+  const label = machine.value?.assetnumber || machine.value?.name || 'this machine'
+  try {
+    await machinesApi.update(machine.value?.machine?.machineid, { isactive: true })
+    toast.success(`Restored ${label}`)
+    await loadMachine()
+  } catch (error) {
+    console.error('Error restoring machine:', error)
+    toast.error(apiError(error, 'Failed to restore machine'))
+  }
+}
+
 async function confirmRetire() {
   const label = machine.value?.assetnumber || machine.value?.name || 'this machine'
   if (!confirm(`Retire ${label}?\n\nIt will no longer appear in ShopDB. `
@@ -340,6 +366,10 @@ async function confirmRetire() {
 </script>
 
 <style scoped>
+.retired-banner {
+  border-left: 3px solid var(--warning);
+  margin-bottom: 1rem;
+}
 .mono {
   font-family: 'SF Mono', 'Monaco', 'Consolas', monospace;
 }

plugins/machines/frontend/views/MachinesList.vue

@@ -15,6 +15,14 @@
         placeholder="Search machines..."
         @input="debouncedSearch"
       />
+      <!-- Retire is a soft delete and the confirm dialog promises the record
+           "can be restored". The API kept that promise all along (?active=false
+           lists them, PUT isactive restores) but nothing in the UI could reach
+           it, so a retired machine was simply gone. -->
+      <label class="checkbox-label">
+        <input type="checkbox" v-model="showRetired" @change="loadMachines" />
+        Show retired
+      </label>
     </div>
 
     <div class="card">
@@ -41,6 +49,7 @@
                   @click="item.machine?.machineid && $router.push(`/machines/${item.machine.machineid}`)">
                 <td>
                   {{ item.assetnumber }}<template v-if="item.dualpathpartner"> / {{ item.dualpathpartner.assetnumber }}</template>
+                  <span v-if="item.isactive === false" class="badge badge-secondary">retired</span>
                 </td>
                 <td>{{ item.name || '-' }}</td>
                 <td class="mono">{{ item.serialnumber || '-' }}</td>
@@ -122,6 +131,7 @@ function applySuggestion(word) {
   // search page documents. Load directly.
   loadMachines()
 }
+const showRetired = ref(false)
 const totalPages = ref(1)
 const perPage = ref(20)
 
@@ -139,6 +149,8 @@ async function loadMachines() {
       perpage: perPage.value
     }
     if (search.value) params.search = search.value
+    // active=false means "include retired", matching the API.
+    if (showRetired.value) params.active = 'false'
 
     const response = await machinesApi.list(params)
     machines.value = response.data.data || []