busroot-sdk 0.0.8-dev.2888081848 → 0.0.8-dev.2892482846

package/build/index.js

@@ -1578,8 +1578,8 @@ var require_base_account = __commonJS({
       uploadTransforms: zod_1.z.string().nullish().describe("Upload transformation configuration (system managed)"),
       durationFormat: zod_1.z.enum(times_1.SUPPORTED_DURATION).nullish().describe("Duration display format (e.g., 'months', 'days', 'hours', 'minutes')"),
       appUrls: zod_1.z.string().nullish().describe("Custom application URLs (system managed)"),
-      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: If set, only these reason codes are available at this level. Applied before excludeReasonCodes."),
-      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: These reason codes are removed at this level. Applied after includeReasonCodes."),
+      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: Adds these reasons, each with all of its child reasons (including ones added later), at this level and below. Once any level sets this, only included reasons are available beneath it. Applied before excludeReasonCodes."),
+      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: Removes these reasons, each with all of its child reasons (including ones added later), at this level and below. A lower level can include a child back. Applied after includeReasonCodes."),
       // Legacy: scoping moved from individual Tasks to Task lists. Kept so stored manifests still
       // parse; nothing reads them and no write path sets them. Use the Task list fields below.
       includeTaskCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Task Codes: Legacy, no longer applied. Superseded by includeTaskListCodes."),
@@ -1637,8 +1637,8 @@ var require_base_station_group = __commonJS({
       shiftPatternCode: zod_1.z.string().nullish().describe("Shift Pattern: The ID of the shift pattern this group follows"),
       // Feature flags (allowScheduleStationFlexibility, allowQuickScheduleStart) are now registry-managed
       // tri-state `enable*` fields, added below via flagSchemaFieldsForLevel("stationGroup").
-      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: If set, only these reason codes are available at this level. Applied before excludeReasonCodes."),
-      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: These reason codes are removed at this level. Applied after includeReasonCodes."),
+      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: Adds these reasons, each with all of its child reasons (including ones added later), at this level and below. Once any level sets this, only included reasons are available beneath it. Applied before excludeReasonCodes."),
+      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: Removes these reasons, each with all of its child reasons (including ones added later), at this level and below. A lower level can include a child back. Applied after includeReasonCodes."),
       // Legacy: scoping moved from individual Tasks to Task lists. Kept so stored manifests still
       // parse; nothing reads them and no write path sets them. Use the Task list fields below.
       includeTaskCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Task Codes: Legacy, no longer applied. Superseded by includeTaskListCodes."),
@@ -2021,8 +2021,8 @@ var require_base_station = __commonJS({
       unitsPerMinute: zod_1.z.number().int().gt(0).nullish().describe("Units Per Minute: Expected production rate in units per minute. Example: 2, 4, 10"),
       unitsPerHour: zod_1.z.number().int().gt(0).nullish().describe("Units Per Hour: Expected production rate in units per hour. Example: 120, 240, 600"),
       lineSpeedTarget: zod_1.z.number().gt(0).lte(99999).nullish().describe("Line Speed Target: Target operating speed for the station. Example: 100, 120, 50"),
-      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: If set, only these reason codes are available at this level. Applied before excludeReasonCodes."),
-      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: These reason codes are removed at this level. Applied after includeReasonCodes."),
+      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: Adds these reasons, each with all of its child reasons (including ones added later), at this level and below. Once any level sets this, only included reasons are available beneath it. Applied before excludeReasonCodes."),
+      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: Removes these reasons, each with all of its child reasons (including ones added later), at this level and below. A lower level can include a child back. Applied after includeReasonCodes."),
       // Legacy: scoping moved from individual Tasks to Task lists. Kept so stored manifests still
       // parse; nothing reads them and no write path sets them. Use the Task list fields below.
       includeTaskCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Task Codes: Legacy, no longer applied. Superseded by includeTaskListCodes."),
@@ -2058,8 +2058,8 @@ var require_plant = __commonJS({
       timezone: zod_1.z.string().describe("IANA timezone database name (e.g., 'America/New_York', 'Europe/London', 'Asia/Tokyo'). See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones"),
       dayStartHour: zod_1.z.number().int().gte(0).lt(24).describe("Hour when the production day starts in 24-hour format (0-23). Example: 6 = 6:00 AM, 0 = midnight"),
       weekStartDay: zod_1.z.number().int().gte(0).lte(6).default(0).describe("Day the production week starts. 0 = Monday (default, ISO standard), 1 = Tuesday, 2 = Wednesday, 3 = Thursday, 4 = Friday, 5 = Saturday, 6 = Sunday"),
-      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: If set, only these reason codes are available at this level. Applied before excludeReasonCodes."),
-      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: These reason codes are removed at this level. Applied after includeReasonCodes."),
+      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: Adds these reasons, each with all of its child reasons (including ones added later), at this level and below. Once any level sets this, only included reasons are available beneath it. Applied before excludeReasonCodes."),
+      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: Removes these reasons, each with all of its child reasons (including ones added later), at this level and below. A lower level can include a child back. Applied after includeReasonCodes."),
       // Legacy: scoping moved from individual Tasks to Task lists. Kept so stored manifests still
       // parse; nothing reads them and no write path sets them. Use the Task list fields below.
       includeTaskCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Task Codes: Legacy, no longer applied. Superseded by includeTaskListCodes."),
@@ -2963,7 +2963,7 @@ var require_station_allowed_list = __commonJS({
   "../../packages/common/build/utils/station-allowed-list.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.getValidSkus = exports2.getValidReasons = exports2.requiredTaskRefs = exports2.requiredTaskListCodes = exports2.resolveTaskListCodes = exports2.resolveReasonCodes = exports2.flattenReasonCodes = void 0;
+    exports2.getValidSkus = exports2.getValidReasons = exports2.requiredTaskRefs = exports2.requiredTaskListCodes = exports2.resolveTaskListCodes = exports2.resolveReasonCodes = exports2.reasonAncestorMap = exports2.reasonSubtreeMap = exports2.flattenReasonCodes = void 0;
     var flattenReasonCodes = (reasons) => {
       const codes = [];
       for (const reason of reasons) {
@@ -2975,25 +2975,49 @@ var require_station_allowed_list = __commonJS({
       return codes;
     };
     exports2.flattenReasonCodes = flattenReasonCodes;
-    var resolveReasonCodes = (allCodes, ...levels) => {
+    var reasonSubtreeMap = (reasons) => {
+      const subtrees = /* @__PURE__ */ new Map();
+      const walk = (reason) => {
+        const codes = [reason.code, ...(reason.reasons ?? []).flatMap(walk)];
+        subtrees.set(reason.code, codes);
+        return codes;
+      };
+      reasons.forEach(walk);
+      return subtrees;
+    };
+    exports2.reasonSubtreeMap = reasonSubtreeMap;
+    var reasonAncestorMap = (reasons) => {
+      const ancestors = /* @__PURE__ */ new Map();
+      const walk = (reason, chain) => {
+        ancestors.set(reason.code, chain);
+        for (const child of reason.reasons ?? []) {
+          walk(child, [reason.code, ...chain]);
+        }
+      };
+      reasons.forEach((reason) => walk(reason, []));
+      return ancestors;
+    };
+    exports2.reasonAncestorMap = reasonAncestorMap;
+    var resolveReasonCodes = (reasons, ...levels) => {
+      const subtrees = (0, exports2.reasonSubtreeMap)(reasons);
+      const expand = (listed) => listed.flatMap((code) => subtrees.get(code) ?? []);
       const hasAnyInclude = levels.some((level) => level?.includeReasonCodes?.length);
-      const allCodesSet = new Set(allCodes);
-      let codes = hasAnyInclude ? [] : [...allCodes];
+      let codes = hasAnyInclude ? [] : (0, exports2.flattenReasonCodes)(reasons);
       for (const level of levels) {
         if (!level) {
           continue;
         }
         if (level.includeReasonCodes?.length) {
-          const toAdd = level.includeReasonCodes.filter((code) => allCodesSet.has(code));
           const existing = new Set(codes);
-          for (const code of toAdd) {
+          for (const code of expand(level.includeReasonCodes)) {
             if (!existing.has(code)) {
+              existing.add(code);
               codes.push(code);
             }
           }
         }
         if (level.excludeReasonCodes?.length) {
-          const excludeSet = new Set(level.excludeReasonCodes);
+          const excludeSet = new Set(expand(level.excludeReasonCodes));
           codes = codes.filter((code) => !excludeSet.has(code));
         }
       }
@@ -3245,8 +3269,7 @@ var require_station2 = __commonJS({
                 shiftPattern = (0, shift_1.toShiftPatternViewModel)({ title: manifestShiftPattern.title, code: manifestShiftPattern.code }, manifestShiftPattern.shifts);
               }
             }
-            const allReasonCodes = manifest.account.reasons ? (0, station_allowed_list_1.flattenReasonCodes)(manifest.account.reasons) : [];
-            const stationResolvedReasonCodes = (0, station_allowed_list_1.resolveReasonCodes)(allReasonCodes, manifest.account, plant, group, station);
+            const stationResolvedReasonCodes = (0, station_allowed_list_1.resolveReasonCodes)(manifest.account.reasons ?? [], manifest.account, plant, group, station);
             const tasksByCode = new Map((manifest.account.tasks ?? []).map((task) => [task.code, task]));
             const requiredTasks = (0, feature_flags_1.resolveFlag)(manifest, "enableTasks") ? (0, station_allowed_list_1.requiredTaskRefs)(manifest, station.code).flatMap((ref) => {
               const task = tasksByCode.get(ref.taskCode);
@@ -3459,8 +3482,8 @@ var require_plant2 = __commonJS({
       ...(0, feature_flags_1.flagSchemaFieldsForLevel)("plant"),
       includeTaskListCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Task List Codes: The Task lists available at this level. No level setting this means no Task lists are available."),
       excludeTaskListCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Task List Codes: These Task list codes are removed at this level."),
-      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: If set, only these reason codes are available at this level. Applied before excludeReasonCodes."),
-      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: These reason codes are removed at this level. Applied after includeReasonCodes."),
+      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: Adds these reasons, each with all of its child reasons (including ones added later), at this level and below. Once any level sets this, only included reasons are available beneath it. Applied before excludeReasonCodes."),
+      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: Removes these reasons, each with all of its child reasons (including ones added later), at this level and below. A lower level can include a child back. Applied after includeReasonCodes."),
       totalEnergyStationCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Total Energy Station Codes: When set, this plant's energy (kWh, cost, CO2) is the sum of these stations' energy instead of the additive sum over member stations.")
     });
     exports2.ArchivePlantPostRequest = zod_1.z.object({
@@ -3653,8 +3676,8 @@ var require_station_group2 = __commonJS({
       ...(0, feature_flags_1.flagSchemaFieldsForLevel)("stationGroup"),
       includeTaskListCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Task List Codes: The Task lists available at this level. No level setting this means no Task lists are available."),
       excludeTaskListCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Task List Codes: These Task list codes are removed at this level."),
-      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: If set, only these reason codes are available at this level. Applied before excludeReasonCodes."),
-      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: These reason codes are removed at this level. Applied after includeReasonCodes."),
+      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: Adds these reasons, each with all of its child reasons (including ones added later), at this level and below. Once any level sets this, only included reasons are available beneath it. Applied before excludeReasonCodes."),
+      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: Removes these reasons, each with all of its child reasons (including ones added later), at this level and below. A lower level can include a child back. Applied after includeReasonCodes."),
       totalEnergyStationCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Total Energy Station Codes: When set, this group's energy (kWh, cost, CO2) is the sum of these stations' energy instead of the additive sum over member stations.")
     });
     exports2.StationGroupPostRequest = StationGroupSchema;
@@ -6590,8 +6613,8 @@ var require_account2 = __commonJS({
       }, "Invalid yaml").describe("Upload Transforms: This field accepts a JSONata expression (in YAML format) to define how table columns are mapped and transformed."),
       maxProductionCountPerSchedule: zod_1.z.number().int().gt(0).lte(9999999).nullish().describe("Maximum Production Count per Schedule: Sets the maximum limit of production units for a single schedule to prevent large errors."),
       durationFormat: zod_1.z.enum(times_1.SUPPORTED_DURATION).default("months").describe("Duration Format: Select the format to display durations, for example a downtime period or length of a schedule."),
-      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: If set, only these reason codes are available at this level. Applied before excludeReasonCodes."),
-      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: These reason codes are removed at this level. Applied after includeReasonCodes."),
+      includeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Reason Codes: Adds these reasons, each with all of its child reasons (including ones added later), at this level and below. Once any level sets this, only included reasons are available beneath it. Applied before excludeReasonCodes."),
+      excludeReasonCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Reason Codes: Removes these reasons, each with all of its child reasons (including ones added later), at this level and below. A lower level can include a child back. Applied after includeReasonCodes."),
       includeTaskListCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Include Task List Codes: The Task lists available at this level. No level setting this means no Task lists are available."),
       excludeTaskListCodes: zod_1.z.array(zod_1.z.string()).nullish().describe("Exclude Task List Codes: These Task list codes are removed at this level. Applied after includeTaskListCodes.")
     });
@@ -11262,7 +11285,7 @@ var methodDefinitions = {
     "Create or update a Task list. The list carries the trigger every Task in it follows and is what the include/exclude cascade assigns to stations; create it before the Tasks that belong to it."
   ),
   "taskList.start": import_zod.z.function().args(TaskListStartParams).returns(import_zod.z.promise(import_zod.z.array(import_task_completion.TaskCompletionViewModel))).describe(
-    "Start a Task list at a station now, making every Task in it pending, as the tablet's Start this List button does. Works for a list of any trigger; the Tasks are recorded as On Demand with no deadline. A Task already pending keeps its row, so starting twice is harmless. The list must be assigned to the station. Returns one pending Task completion per Task, in list order."
+    "Start a Task list at a station now, making every Task in it pending, as the tablet's Start List button does. Works for a list of any trigger; the Tasks are recorded as On Demand with no deadline. A Task already pending keeps its row, so starting twice is harmless. The list must be assigned to the station. Returns one pending Task completion per Task, in list order."
   ),
   "task.createUpdate": import_zod.z.function().args(TaskCreateUpdateParams).returns(import_zod.z.promise(import_task.TaskSchema)).describe("Create or update a Task. It must belong to at least one existing Task list, with its display order in each."),
   "task.start": import_zod.z.function().args(TaskStartParams).returns(import_zod.z.promise(import_task_completion.TaskCompletionViewModel)).describe(

package/package.json

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