@7365admin1/layer-common 4.81.1-staging.467 → 4.81.1-staging.468

package/assets/css/robot-hero.css

@@ -784,6 +784,9 @@
 .hero-faultbar__code { font-family: var(--hero-font); font-weight: 800; color: var(--hero-accent); font-size: 18px; }
 .hero-faultbar__msg { font-weight: 600; }
 .hero-faultbar__since { opacity: 0.65; font-size: 12px; }
+.hero-faultbar__clear { margin-top: 8px; font-size: 13px; }
+.hero-faultbar__clear-title { font-weight: 700; }
+.hero-faultbar__clear ol { margin: 4px 0 0; padding-left: 20px; }
 .hero-faultbar__badge { font-size: 11px; padding: 2px 8px; background: var(--hero-accent); color: #fff; font-weight: 600; }
 
 .hero-facts {

package/components/Robot/Detail.vue

@@ -36,11 +36,12 @@
   <div v-if="fault" class="hero-faultbar" role="alert">
     <span class="hero-faultbar__code">{{ fault.code }}</span>
     <div>
-      <div class="hero-faultbar__msg">{{ fault.message || fault.code }}</div>
+      <div class="hero-faultbar__msg">{{ faultWordsWithoutCode(fault) }}</div>
       <div class="hero-faultbar__since">
         Since {{ faultSince }} · notified once
         <template v-for="ph in faultPhotos(fault)" :key="ph.label"> · <a :href="ph.url" target="_blank" rel="noopener noreferrer">{{ ph.label }}</a></template>
       </div>
+      <RobotFaultClearSteps :steps="clearSteps" />
     </div>
     <v-btn v-if="canResolve" variant="outlined" size="small" :loading="resolving" @click="resolveFault">Mark resolved</v-btn>
     <span class="hero-faultbar__badge">{{ faultBadge(fault) }}</span>
@@ -339,6 +340,8 @@ import {
   positionGapText,
   positionText,
   robotAbilities,
+  robotClearFaultSteps,
+  faultWordsWithoutCode,
   robotErrorMessage,
   robotFacts,
   cleaningReadings,
@@ -447,6 +450,8 @@ const statusLabel = computed(() => robotStatus(statusMode.value, robotType.value
 
 const fault = computed(() => (live.value?.ok ? live.value.fault ?? null : record.value?.fault ?? null));
 const faultSince = computed(() => sinceText(fault.value?.since, now.value));
+// The maker's manual steps (Ounitech today), only while a fault shows.
+const clearSteps = computed(() => robotClearFaultSteps({ fault: fault.value, profile: live.value?.ok ? live.value.profile : null }));
 
 // Only what THIS robot reports (hide, never grey); what its maker keeps back is said once, in the card.
 const facts = computed(() => robotFacts({ record: record.value, live: live.value as any, now: now.value, hideUnreported: true }));

package/components/Robot/FaultClearSteps.vue

@@ -0,0 +1,11 @@
+<template>
+  <div v-if="steps.length" class="hero-faultbar__clear">
+    <div class="hero-faultbar__clear-title">How to clear this fault</div>
+    <ol><li v-for="s in steps" :key="s">{{ s }}</li></ol>
+  </div>
+</template>
+
+<script setup lang="ts">
+/** The maker's manual steps to clear a fault on the robot (`robotClearFaultSteps`). */
+defineProps<{ steps: string[] }>();
+</script>

package/package.json

@@ -2,7 +2,7 @@
   "name": "@7365admin1/layer-common",
   "license": "MIT",
   "type": "module",
-  "version": "4.81.1-staging.467",
+  "version": "4.81.1-staging.468",
   "author": "7365admin1",
   "main": "./nuxt.config.ts",
   "//files": "What a consumer extending this layer actually loads. Without this npm ships the whole working tree - the changesets, the CI workflows, the render harness in tools/ and any scratch directory that happened to exist at publish time. Nuxt resolves a layer by directory, so every runtime directory below has to stay listed; adding a new top-level runtime directory means adding it here too.",

package/utils/robot-display.ts

@@ -162,6 +162,27 @@ export function robotFaultText(state: { fault?: { message?: unknown; code?: unkn
   return text ? `Fault: ${text}` : null;
 }
 
+/**
+ * The maker's steps to clear a fault on the robot itself (core `profile.clearFault`,
+ * from its manual), shown only while the robot reports a fault. None = nothing shown.
+ */
+export function robotClearFaultSteps(state: {
+  fault?: unknown;
+  profile?: { clearFault?: unknown } | null;
+} | null | undefined): string[] {
+  const steps = state?.profile?.clearFault;
+  if (!state?.fault || !Array.isArray(steps)) return [];
+  return steps.filter((s): s is string => typeof s === "string" && !!s.trim()).map((s) => s.trim());
+}
+
+/** A fault's words without its code repeated in front ("306 · ..."), for a place that already shows the code. */
+export function faultWordsWithoutCode(fault: { code?: unknown; message?: unknown } | null | undefined): string {
+  const code = typeof fault?.code === "string" ? fault.code.trim() : "";
+  const message = typeof fault?.message === "string" ? fault.message.trim() : "";
+  const prefix = `${code} · `;
+  return code && message.startsWith(prefix) ? message.slice(prefix.length) : message || code;
+}
+
 /**
  * A small square around a clicked pixel, as the polygon a spot command takes.
  *
@@ -1838,10 +1859,12 @@ export function commandOutcome(
   if (elapsedMs < COMMAND_WATCH_MS) return null;
   const fault = typeof reading.fault?.message === "string" ? reading.fault.message : "";
   // The fault was already there when this command was sent: it is not this command's result.
+  // Core's fault words may end in a sentence ("... then send the task again."): no doubled period.
+  const faultWords = fault.replace(/\.\s*$/, "");
   if (fault && fault === input.faultBefore) {
-    return { ok: false, done: true, text: `${who} is still stopped by an earlier fault (${fault}). Clear it on the robot or in its maker's app, then try again.` };
+    return { ok: false, done: true, text: `${who} is still stopped by an earlier fault (${faultWords}). Clear it on the robot or in its maker's app, then try again.` };
   }
-  const reason = reading.online === false ? "it stopped reporting" : fault || (said && !RESTING.test(said) ? said : "");
+  const reason = reading.online === false ? "it stopped reporting" : faultWords || (said && !RESTING.test(said) ? said : "");
   return {
     ok: false,
     done: true,