busroot-sdk 0.0.8-dev.2794844917 → 0.0.8-dev.2797946662

package/build/index.js

@@ -762,14 +762,14 @@ var require_base_station = __commonJS({
       idleCostPerMinute: zod_1.z.number().gte(0).lte(99999).nullish().describe("Idle Cost Per Minute: Cost per minute during idle time in account currency. Used for calculating scheduling losses, planned non-production losses, and downtime losses when SKU doesn't have a specific value."),
       // Downtime Settings
       downtimeDetectionMode: zod_1.z.nativeEnum(enums_1.DOWNTIME_DETECTION_MODE).default(enums_1.DOWNTIME_DETECTION_MODE.UTILISATION).nullish().describe("Downtime Detection Mode: How to detect when the station is down. Options: 'off' (no detection), 'production' (use production cycle data), 'utilisation' (use utilisation signals - most common), 'line_speed' (use line speed monitoring). Default: 'utilisation'"),
-      utilisationDowntimeThreshold: zod_1.z.number().int().gte(0).nullish().describe("Utilisation Downtime Threshold: Minimum period in minutes before registering downtime. Only stops longer than this threshold will be recorded. Defaults to 1 hour when not set; see DEFAULT_UTILISATION_DOWNTIME_THRESHOLD in cache-builder."),
+      utilisationDowntimeThreshold: zod_1.z.number().int().gte(0).nullish().describe("Utilisation Downtime Threshold: Minimum stop duration in milliseconds before registering downtime \u2014 only stops longer than this are recorded. Example: 120000 (2 minutes), 900000 (15 minutes). The admin UI presents this value in minutes. Defaults to 1 hour when not set; see DEFAULT_UTILISATION_DOWNTIME_THRESHOLD in cache-builder."),
       slowDurationThreshold: zod_1.z.number().int().gte(0).nullish().describe("Slow Duration Threshold: Duration threshold in milliseconds for detecting slow operation"),
       forceAllShiftTimeAsPlannedProduction: zod_1.z.boolean().nullish().describe("Force All Shift Time As Planned Production: Treat all shift time as planned production time"),
       // Productive Settings
       productiveStatusMode: zod_1.z.nativeEnum(enums_1.PRODUCTIVE_STATUS_MODE).default(enums_1.PRODUCTIVE_STATUS_MODE.PRODUCTIVE_SIGNAL).nullish().describe("Productive Status Mode: How to measure when the station is engaged in value-adding activity. Options: 'productive_signal' (use productive signal input), 'electrical_usage' (use electrical consumption), 'line_speed' (use line speed value). Default: 'productive_signal'"),
       electricalUsageStoppedThresholdKw: zod_1.z.number().gte(0).nullish().describe("Electrical Usage Stopped Threshold (kW): Minimum power consumption in kilowatts that indicates the station is active. Below this threshold, Busroot will regard the station as stopped/downtime. Example: 2.0, 1.0, 5.0"),
       lineSpeedStoppedThreshold: zod_1.z.number().gte(0).nullish().describe("Line Speed Stopped Threshold: Minimum speed value that indicates the station is running. Below this threshold, Busroot will regard the station as stopped/downtime. Example: 10, 5, 20"),
-      productiveHoldOnTime: zod_1.z.number().int().gte(0).lte(time_1.TimeIntervals["1d"].ms).nullish().describe("Productive Hold On Time: Time in minutes to consider station active after a productive signal. Each new signal restarts the hold-on timer."),
+      productiveHoldOnTime: zod_1.z.number().int().gte(0).lte(time_1.TimeIntervals["1d"].ms).nullish().describe("Productive Hold On Time: Time in milliseconds to keep considering the station active after a productive signal. Each new signal restarts the hold-on timer. Example: 300000 (5 minutes). The admin UI presents this value in minutes."),
       // Feature flags (allowManualProduction, allowQuickScheduleStart,
       // allowScheduleCutShort, allowRejectProduction, allowEditPartsPerCycle, schedulingOnly) are now
       // registry-managed tri-state `enable*` fields, added below via flagSchemaFieldsForLevel("station").
@@ -2472,7 +2472,7 @@ var require_shared = __commonJS({
       production_count: zod_1.z.number().optional().describe("Alias for production_count_good."),
       production_count_bad: zod_1.z.number().optional().describe("The cumulative number of bad production cycles complete."),
       bad_production_count: zod_1.z.number().optional().describe("Alias for production_count_bad."),
-      bad_production_reason: zod_1.z.string().optional().describe("Quality reason code for the bad production reported in this message. Must match a reason code of type 'quality' configured on the account; unknown or missing codes are recorded as bad production with no reason."),
+      bad_production_reason: zod_1.z.string().optional().describe("Quality reason code for the bad production reported in this message. Should match a reason code of type 'quality' configured on the account, but an unrecognised code is still recorded verbatim and displayed as the raw code; a missing code records the bad production with no reason ('Unknown')."),
       non_production_reason: zod_1.z.string().optional().describe("Declares that this station is currently in a period of non-production, and gives the reason code for it. The presence of this field is the assertion - there is no separate boolean and no end signal; the sender simply stops sending it. Each message re-asserts non-production for the one-minute window it lands in, so senders must publish at least once per minute for continuous coverage. Should match a reason code of type 'non-production' configured on the account; unknown codes are still honoured and displayed as the raw code."),
       productive: zod_1.z.number().optional().describe("An indication that this station is productive. Any number greater than 0 is considered true."),
       line_speed: zod_1.z.number().optional().describe("A number indicating the speed of the station. No units are assumed, so could be percentage or speed such as m/s."),
@@ -7796,6 +7796,7 @@ var require_reason4 = __commonJS({
     exports2.reasonByCode = reasonByCode;
     exports2.subtreeReasonCodes = subtreeReasonCodes;
     exports2.reasonBreadcrumb = reasonBreadcrumb;
+    exports2.withReasonCodeFallbackBreadcrumbs = withReasonCodeFallbackBreadcrumbs;
     exports2.withAncestorReasons = withAncestorReasons;
     var reason_1 = require_reason3();
     function flattenReasons(reasons, parentReasonCode, inheritedRequireNotes) {
@@ -7885,6 +7886,9 @@ var require_reason4 = __commonJS({
       }
       return chain;
     }
+    function withReasonCodeFallbackBreadcrumbs(items) {
+      return items.map((item) => item.reasonCode != null && !item.reasonBreadcrumb?.length ? { ...item, reasonBreadcrumb: [{ code: item.reasonCode, description: item.reasonCode }] } : item);
+    }
     function withAncestorReasons(visible, allReasons) {
       const present = new Map(visible.map((r) => [r.code, r]));
       const result = [...visible];
@@ -9154,12 +9158,13 @@ var require_oee2 = __commonJS({
             i = j;
           } while (j < stationWindows.length);
           if (duration) {
+            const fallbackDescription = s === exports2.UNKNOWN_DATA.key ? exports2.UNKNOWN_DATA.value : s;
             const breadcrumb = nonProductionCauseService != null ? nonProductionCauseService.getCauseBreadcrumb(s) : [];
-            const description = nonProductionCauseService != null ? breadcrumb.map((c) => c.description).join(" | ") || exports2.UNKNOWN_DATA.value : "";
+            const description = breadcrumb.map((c) => c.description).join(" | ") || fallbackDescription;
             results.push({
               code: s,
               description,
-              reasonBreadcrumb: breadcrumb.length > 0 ? breadcrumb : [{ code: s, description: description || exports2.UNKNOWN_DATA.value }],
+              reasonBreadcrumb: breadcrumb.length > 0 ? breadcrumb : [{ code: s, description: fallbackDescription }],
               duration,
               cost: 0,
               percent: 0,
@@ -9209,12 +9214,13 @@ var require_oee2 = __commonJS({
             i = j;
           } while (j < stationWindows.length);
           if (duration) {
+            const fallbackDescription = s === exports2.UNKNOWN_DATA.key ? exports2.UNKNOWN_DATA.value : s;
             const breadcrumb = reasonCauseService != null ? reasonCauseService.getCauseBreadcrumb(s) : [];
-            const description = reasonCauseService != null ? breadcrumb.map((c) => c.description).join(" | ") || exports2.UNKNOWN_DATA.value : "";
+            const description = breadcrumb.map((c) => c.description).join(" | ") || fallbackDescription;
             results.push({
               code: s,
               description,
-              reasonBreadcrumb: breadcrumb.length > 0 ? breadcrumb : [{ code: s, description: description || exports2.UNKNOWN_DATA.value }],
+              reasonBreadcrumb: breadcrumb.length > 0 ? breadcrumb : [{ code: s, description: fallbackDescription }],
               duration,
               cost: issueDowntimeCost,
               energy: energyDowntime,
@@ -10247,14 +10253,14 @@ var require_station4 = __commonJS({
       if (station.lastStationWindow != null) {
         if ((station.lastStationWindow.shiftMs || 0) === 0) {
           state = exports2.StationStates.out_of_shift;
-        } else if (!station.lastStationWindow.isAlive) {
-          state = exports2.StationStates.disconnected;
         } else if ((station.lastStationWindow.downtimeMs || 0) > 0) {
           state = exports2.StationStates.stopped;
         } else if (station.activeSchedule?.nonProductionReasonCode != null) {
           state = exports2.StationStates.non_production;
         } else if ((0, station_windows_1.signalNonProductionReasonCode)(station.lastStationWindow) != null) {
           state = exports2.StationStates.non_production;
+        } else if (!station.lastStationWindow.isAlive) {
+          state = exports2.StationStates.disconnected;
         } else if (station.activeSchedule?.skuCode != null) {
           state = exports2.StationStates.running;
         } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busroot-sdk",
-  "version": "0.0.8-dev.2794844917",
+  "version": "0.0.8-dev.2797946662",
   "description": "An SDK for accessing Busroot from output.industries",
   "homepage": "https://www.output.industries",
   "main": "./build/index.js",