dabke 0.82.0 → 0.84.0

package/dist/cpsat/rules/target-peak-concurrent-assignments.js

@@ -0,0 +1,146 @@
+import * as z from "zod";
+import { defineRuleDescriptor } from "../rule-descriptor.js";
+import { targetPeakPriorityToPenalty } from "../utils.js";
+import { boolVariable, hardConstraint, intVariable, reportValidation, skipValidation, softConstraint, } from "./artifacts.js";
+import { buildConcurrentAssignmentSegments, collectConcurrentAssignmentIntervals, resolveConcurrentWindow, } from "./concurrent-intervals.js";
+import { entityScope, parseEntityScope, parseTimeScope, resolveActiveDaysFromScope, resolveMembersFromScope, ruleGroup, SoftPrioritySchema, timeScope, } from "./scope.types.js";
+export const TargetPeakConcurrentAssignmentsSchema = z
+    .object({
+    assignments: z.number().int().min(0),
+    priority: SoftPrioritySchema.default("HIGH"),
+})
+    .and(entityScope(["members", "roles", "skills"]))
+    .and(timeScope(["dateRange", "specificDates", "dayOfWeek", "recurring"]));
+/** @internal */
+export const TARGET_PEAK_CONCURRENT_ASSIGNMENTS_OBJECTIVE_STAGE_ID = "__dabke_target_peak_concurrent_assignments__";
+/**
+ * Low-level descriptor for the `target-peak-concurrent-assignments` rule.
+ *
+ * @remarks
+ * Softly targets the daily peak number of concurrent targeted assignments
+ * within the scoped day set. This is not a lower bound across the whole day.
+ * Use {@link import("../../schedule/coverage.js").cover} for whole-window
+ * minimum staffing, and pair this rule with
+ * {@link import("./max-concurrent-assignments.js").maxConcurrentAssignmentsRuleDescriptor}
+ * when the same value is also a hard capacity cap.
+ *
+ * @category Rules
+ */
+export const targetPeakConcurrentAssignmentsRuleDescriptor = defineRuleDescriptor({
+    name: "target-peak-concurrent-assignments",
+    schema: TargetPeakConcurrentAssignmentsSchema,
+    compile(config, ctx) {
+        const { assignments, priority } = config;
+        if (assignments === 0) {
+            return { rule: "target-peak-concurrent-assignments", artifacts: [] };
+        }
+        const entityScopeValue = parseEntityScope(config);
+        const timeScopeValue = parseTimeScope(config);
+        const targetMembers = resolveMembersFromScope(entityScopeValue, [...ctx.members]);
+        const activeDays = resolveActiveDaysFromScope(timeScopeValue, [...ctx.days]);
+        if (activeDays.length === 0) {
+            return { rule: "target-peak-concurrent-assignments", artifacts: [] };
+        }
+        const group = ruleGroup(`target-peak-concurrent-assignments:${assignments}`, `Target peak ${assignments} concurrent assignment${assignments === 1 ? "" : "s"}`, entityScopeValue, timeScopeValue);
+        const artifacts = activeDays.flatMap((day) => {
+            const dayContext = { days: [day.iso], memberIds: targetMembers.map((member) => member.id) };
+            const intervals = collectConcurrentAssignmentIntervals(day, targetMembers, ctx.shiftPatterns);
+            const window = resolveConcurrentWindow(intervals);
+            const segments = buildConcurrentAssignmentSegments(intervals, window.start, window.end);
+            const dayKey = `${group.key}:${day.iso}`;
+            const shortfallVar = `${dayKey}:shortfall`;
+            if (segments.length === 0) {
+                return [
+                    intVariable(shortfallVar, 0, assignments),
+                    hardConstraint({
+                        group,
+                        description: `Fix peak-target shortfall to ${assignments} on ${day.iso} because no eligible assignments exist`,
+                        context: dayContext,
+                        validation: skipValidation("scaffolding", "Peak-target shortfall is fixed when no eligible assignments can contribute to the daily peak."),
+                        terms: [{ var: shortfallVar, coeff: 1 }],
+                        comparator: "==",
+                        targetValue: assignments,
+                    }),
+                    softConstraint({
+                        stage: TARGET_PEAK_CONCURRENT_ASSIGNMENTS_OBJECTIVE_STAGE_ID,
+                        group,
+                        description: `Target peak ${assignments} concurrent assignment${assignments === 1 ? "" : "s"} on ${day.iso}`,
+                        context: dayContext,
+                        validation: reportValidation(),
+                        terms: [{ var: shortfallVar, coeff: 1 }],
+                        comparator: "<=",
+                        targetValue: 0,
+                        penalty: targetPeakPriorityToPenalty(priority),
+                        constraintId: `${dayKey}:shortfall`,
+                    }),
+                ];
+            }
+            const witnessVars = segments.map((segment) => ({
+                segmentStart: segment.start,
+                name: `${dayKey}:${segment.start}:witness`,
+            }));
+            const helperArtifacts = [
+                intVariable(shortfallVar, 0, assignments),
+                ...witnessVars.map(({ name }) => boolVariable(name)),
+                hardConstraint({
+                    group,
+                    description: `Select exactly one peak segment witness on ${day.iso}`,
+                    context: dayContext,
+                    validation: skipValidation("scaffolding", "Peak-target witness selection is an internal helper for day-level peak targeting."),
+                    terms: witnessVars.map(({ name }) => ({ var: name, coeff: 1 })),
+                    comparator: "==",
+                    targetValue: 1,
+                }),
+            ];
+            const linkageArtifacts = segments.map((segment) => {
+                const witnessVar = witnessVars.find((witness) => witness.segmentStart === segment.start)?.name;
+                if (!witnessVar) {
+                    throw new Error(`Missing peak-target witness variable for segment ${segment.start} on ${day.iso}`);
+                }
+                return hardConstraint({
+                    group,
+                    description: `Link peak-target shortfall to segment ${formatTimeRange(segment.start, segment.end)} on ${day.iso}`,
+                    context: dayContext,
+                    validation: skipValidation("scaffolding", "Peak-target segment linkage is an internal helper that selects the best segment on a day."),
+                    terms: [
+                        ...segment.varNames.map((varName) => ({ var: varName, coeff: 1 })),
+                        { var: witnessVar, coeff: -assignments },
+                        { var: shortfallVar, coeff: 1 },
+                    ],
+                    comparator: ">=",
+                    targetValue: 0,
+                });
+            });
+            const shortfallArtifact = softConstraint({
+                stage: TARGET_PEAK_CONCURRENT_ASSIGNMENTS_OBJECTIVE_STAGE_ID,
+                group,
+                description: `Target peak ${assignments} concurrent assignment${assignments === 1 ? "" : "s"} on ${day.iso}`,
+                context: dayContext,
+                validation: reportValidation(),
+                terms: [{ var: shortfallVar, coeff: 1 }],
+                comparator: "<=",
+                targetValue: 0,
+                penalty: targetPeakPriorityToPenalty(priority),
+                constraintId: `${dayKey}:shortfall`,
+            });
+            const dayArtifacts = [];
+            dayArtifacts.push(...helperArtifacts, ...linkageArtifacts, shortfallArtifact);
+            return dayArtifacts;
+        });
+        return {
+            rule: "target-peak-concurrent-assignments",
+            artifacts,
+        };
+    },
+});
+function formatTimeRange(startMinutes, endMinutes) {
+    return `${formatClockMinutes(startMinutes)}-${formatClockMinutes(endMinutes)}`;
+}
+function formatClockMinutes(totalMinutes) {
+    const minutesPerDay = 24 * 60;
+    const normalized = ((totalMinutes % minutesPerDay) + minutesPerDay) % minutesPerDay;
+    const hours = Math.floor(normalized / 60);
+    const minutes = normalized % 60;
+    return `${String(hours).padStart(2, "0")}:${String(minutes).padStart(2, "0")}`;
+}
+//# sourceMappingURL=target-peak-concurrent-assignments.js.map

package/dist/cpsat/rules/target-peak-concurrent-assignments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-peak-concurrent-assignments.js","sourceRoot":"","sources":["../../../src/cpsat/rules/target-peak-concurrent-assignments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,YAAY,EACZ,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iCAAiC,EACjC,oCAAoC,EACpC,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,uBAAuB,EACvB,SAAS,EACT,kBAAkB,EAClB,SAAS,GACV,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC;KACnD,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC;CAC7C,CAAC;KACD,GAAG,CAAC,WAAW,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;KAChD,GAAG,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;AAS5E,gBAAgB;AAChB,MAAM,CAAC,MAAM,qDAAqD,GAChE,8CAA8C,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,6CAA6C,GAAG,oBAAoB,CAAC;IAChF,IAAI,EAAE,oCAAoC;IAC1C,MAAM,EAAE,qCAAqC;IAC7C,OAAO,CAAC,MAAM,EAAE,GAAG;QACjB,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QACzC,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,IAAI,EAAE,oCAAoC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QACvE,CAAC;QAED,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,aAAa,GAAG,uBAAuB,CAAC,gBAAgB,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAClF,MAAM,UAAU,GAAG,0BAA0B,CAAC,cAAc,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAE7E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,IAAI,EAAE,oCAAoC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QACvE,CAAC;QAED,MAAM,KAAK,GAAG,SAAS,CACrB,sCAAsC,WAAW,EAAE,EACnD,eAAe,WAAW,yBAAyB,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,EACjF,gBAAgB,EAChB,cAAc,CACf,CAAC;QAEF,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAC3C,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5F,MAAM,SAAS,GAAG,oCAAoC,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;YAC9F,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,iCAAiC,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YACxF,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;YACzC,MAAM,YAAY,GAAG,GAAG,MAAM,YAAY,CAAC;YAE3C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;oBACL,WAAW,CAAC,YAAY,EAAE,CAAC,EAAE,WAAW,CAAC;oBACzC,cAAc,CAAC;wBACb,KAAK;wBACL,WAAW,EAAE,gCAAgC,WAAW,OAAO,GAAG,CAAC,GAAG,wCAAwC;wBAC9G,OAAO,EAAE,UAAU;wBACnB,UAAU,EAAE,cAAc,CACxB,aAAa,EACb,+FAA+F,CAChG;wBACD,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;wBACxC,UAAU,EAAE,IAAI;wBAChB,WAAW,EAAE,WAAW;qBACzB,CAAC;oBACF,cAAc,CAAC;wBACb,KAAK,EAAE,qDAAqD;wBAC5D,KAAK;wBACL,WAAW,EAAE,eAAe,WAAW,yBAAyB,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,GAAG,EAAE;wBAC5G,OAAO,EAAE,UAAU;wBACnB,UAAU,EAAE,gBAAgB,EAAE;wBAC9B,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;wBACxC,UAAU,EAAE,IAAI;wBAChB,WAAW,EAAE,CAAC;wBACd,OAAO,EAAE,2BAA2B,CAAC,QAAQ,CAAC;wBAC9C,YAAY,EAAE,GAAG,MAAM,YAAY;qBACpC,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC7C,YAAY,EAAE,OAAO,CAAC,KAAK;gBAC3B,IAAI,EAAE,GAAG,MAAM,IAAI,OAAO,CAAC,KAAK,UAAU;aAC3C,CAAC,CAAC,CAAC;YAEJ,MAAM,eAAe,GAAG;gBACtB,WAAW,CAAC,YAAY,EAAE,CAAC,EAAE,WAAW,CAAC;gBACzC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBACpD,cAAc,CAAC;oBACb,KAAK;oBACL,WAAW,EAAE,8CAA8C,GAAG,CAAC,GAAG,EAAE;oBACpE,OAAO,EAAE,UAAU;oBACnB,UAAU,EAAE,cAAc,CACxB,aAAa,EACb,mFAAmF,CACpF;oBACD,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC/D,UAAU,EAAE,IAAI;oBAChB,WAAW,EAAE,CAAC;iBACf,CAAC;aACH,CAAC;YAEF,MAAM,gBAAgB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBAChD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CACjC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,KAAK,OAAO,CAAC,KAAK,CACpD,EAAE,IAAI,CAAC;gBACR,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,MAAM,IAAI,KAAK,CACb,oDAAoD,OAAO,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,EAAE,CAClF,CAAC;gBACJ,CAAC;gBAED,OAAO,cAAc,CAAC;oBACpB,KAAK;oBACL,WAAW,EAAE,yCAAyC,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,GAAG,EAAE;oBACjH,OAAO,EAAE,UAAU;oBACnB,UAAU,EAAE,cAAc,CACxB,aAAa,EACb,2FAA2F,CAC5F;oBACD,KAAK,EAAE;wBACL,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;wBAClE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE;wBACxC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE;qBAChC;oBACD,UAAU,EAAE,IAAI;oBAChB,WAAW,EAAE,CAAC;iBACf,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,MAAM,iBAAiB,GAAG,cAAc,CAAC;gBACvC,KAAK,EAAE,qDAAqD;gBAC5D,KAAK;gBACL,WAAW,EAAE,eAAe,WAAW,yBAAyB,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,GAAG,EAAE;gBAC5G,OAAO,EAAE,UAAU;gBACnB,UAAU,EAAE,gBAAgB,EAAE;gBAC9B,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;gBACxC,UAAU,EAAE,IAAI;gBAChB,WAAW,EAAE,CAAC;gBACd,OAAO,EAAE,2BAA2B,CAAC,QAAQ,CAAC;gBAC9C,YAAY,EAAE,GAAG,MAAM,YAAY;aACpC,CAAC,CAAC;YAEH,MAAM,YAAY,GAId,EAAE,CAAC;YACP,YAAY,CAAC,IAAI,CAAC,GAAG,eAAe,EAAE,GAAG,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;YAC9E,OAAO,YAAY,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,oCAAoC;YAC1C,SAAS;SACV,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,eAAe,CAAC,YAAoB,EAAE,UAAkB;IAC/D,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAC,IAAI,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,kBAAkB,CAAC,YAAoB;IAC9C,MAAM,aAAa,GAAG,EAAE,GAAG,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,GAAG,aAAa,CAAC,GAAG,aAAa,CAAC,GAAG,aAAa,CAAC;IACpF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,UAAU,GAAG,EAAE,CAAC;IAChC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACjF,CAAC"}

package/dist/cpsat/rules/time-cost-surcharge.d.ts

@@ -1,6 +1,5 @@
 import * as z from "zod";
-import type { CompilationRule } from "../model-builder.js";
-declare const TimeCostSurchargeSchema: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
+export declare const TimeCostSurchargeSchema: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
     amountPerHour: z.ZodNumber;
     window: z.ZodObject<{
         from: z.ZodObject<{
@@ -13,17 +12,19 @@ declare const TimeCostSurchargeSchema: z.ZodIntersection<z.ZodIntersection<z.Zod
         }, z.core.$strip>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodType<import("./scope.types.js").EntityScopeType<"members" | "roles" | "skills">, unknown, z.core.$ZodTypeInternals<import("./scope.types.js").EntityScopeType<"members" | "roles" | "skills">, unknown>>>, z.ZodType<import("./scope.types.js").OptionalTimeScopeType<"dateRange" | "dayOfWeek" | "specificDates" | "recurring">, unknown, z.core.$ZodTypeInternals<import("./scope.types.js").OptionalTimeScopeType<"dateRange" | "dayOfWeek" | "specificDates" | "recurring">, unknown>>>;
-/** Configuration for {@link createTimeCostSurchargeRule}. */
+/** Configuration for {@link timeCostSurchargeRuleDescriptor}. */
 export type TimeCostSurchargeConfig = z.infer<typeof TimeCostSurchargeSchema>;
-/**
- * Creates a time-of-day surcharge rule (e.g., night differential).
- *
- * Adds a flat surcharge per hour for the portion of a shift that overlaps
- * a time-of-day window. Independent of the member's base rate.
- *
- * When `minimizeCost()` is not present, no solver terms are emitted,
- * but the `cost()` method still contributes to post-solve calculation.
- */
-export declare function createTimeCostSurchargeRule(config: TimeCostSurchargeConfig): CompilationRule;
-export {};
+export declare const timeCostSurchargeRuleDescriptor: import("../rule-descriptor.js").RuleDescriptor<"time-cost-surcharge", ({
+    amountPerHour: number;
+    window: {
+        from: {
+            hours: number;
+            minutes: number;
+        };
+        until: {
+            hours: number;
+            minutes: number;
+        };
+    };
+} & import("./scope.types.js").EntityScopeType<"members" | "roles" | "skills">) & import("./scope.types.js").OptionalTimeScopeType<"dateRange" | "dayOfWeek" | "specificDates" | "recurring">>;
 //# sourceMappingURL=time-cost-surcharge.d.ts.map

package/dist/cpsat/rules/time-cost-surcharge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-cost-surcharge.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/time-cost-surcharge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,qBAAqB,CAAC;AAoB7E,QAAA,MAAM,uBAAuB;;;;;;;;;;;;mfAS8C,CAAC;AAE5E,6DAA6D;AAC7D,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AA4C9E;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,uBAAuB,GAAG,eAAe,CAmF5F"}
+{"version":3,"file":"time-cost-surcharge.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/time-cost-surcharge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAoBzB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;mfASuC,CAAC;AAE5E,iEAAiE;AACjE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,+BAA+B;;;;;;;;;;;;8LAqG1C,CAAC"}

package/dist/cpsat/rules/time-cost-surcharge.js

@@ -1,12 +1,13 @@
 import * as z from "zod";
+import { defineRuleDescriptor } from "../rule-descriptor.js";
 import { COST_CATEGORY } from "../cost.js";
-import { timeOfDayToMinutes, normalizeEndMinutes, MINUTES_PER_DAY } from "../utils.js";
-import { entityScope, timeScope, parseEntityScope, parseTimeScope, resolveMembersFromScope, resolveActiveDaysFromScope, } from "./scope.types.js";
+import { MINUTES_PER_DAY, normalizeEndMinutes, timeOfDayToMinutes } from "../utils.js";
+import { entityScope, parseEntityScope, parseTimeScope, resolveActiveDaysFromScope, resolveMembersFromScope, timeScope, } from "./scope.types.js";
 const TimeOfDaySchema = z.object({
     hours: z.number().int().min(0).max(23),
     minutes: z.number().int().min(0).max(59),
 });
-const TimeCostSurchargeSchema = z
+export const TimeCostSurchargeSchema = z
     .object({
     amountPerHour: z.number().min(0),
     window: z.object({
@@ -16,110 +17,95 @@ const TimeCostSurchargeSchema = z
 })
     .and(entityScope(["members", "roles", "skills"]))
     .and(timeScope(["dateRange", "specificDates", "dayOfWeek", "recurring"]));
-/**
- * Computes the overlap in minutes between a shift and a time-of-day window.
- *
- * Handles overnight windows (e.g., 22:00-06:00) and overnight shifts.
- */
+export const timeCostSurchargeRuleDescriptor = defineRuleDescriptor({
+    name: "time-cost-surcharge",
+    schema: TimeCostSurchargeSchema,
+    compile(config) {
+        const { amountPerHour, window } = config;
+        const entityScopeValue = parseEntityScope(config);
+        const timeScopeValue = parseTimeScope(config);
+        const validation = {
+            strategy: "skip",
+            category: "no-meaningful-feedback",
+            rationale: amountPerHour <= 0
+                ? "A zero time surcharge does not change optimization or cost accounting."
+                : "Time cost surcharges only affect optimization when minimize-cost is active.",
+        };
+        const costArtifact = {
+            kind: "cost",
+            validation,
+            compileObjective(builder) {
+                if (!builder.costContext?.active || amountPerHour <= 0)
+                    return;
+                const targetMembers = resolveMembersFromScope(entityScopeValue, builder.members);
+                const activeDays = resolveActiveDaysFromScope(timeScopeValue, builder.days);
+                if (targetMembers.length === 0 || activeDays.length === 0)
+                    return;
+                const { normalizationFactor } = builder.costContext;
+                for (const member of targetMembers) {
+                    for (const pattern of builder.shiftPatterns) {
+                        if (!builder.canAssign(member, pattern))
+                            continue;
+                        const overlapMinutes = computeOverlapMinutes(pattern.startTime, pattern.endTime, window.from, window.until);
+                        if (overlapMinutes <= 0)
+                            continue;
+                        const surcharge = (amountPerHour * overlapMinutes) / 60;
+                        const normalizedPenalty = surcharge / normalizationFactor;
+                        for (const day of activeDays) {
+                            if (!builder.patternAvailableOnDay(pattern, day))
+                                continue;
+                            builder.addPenalty(builder.assignment(member.id, pattern.id, day), Math.max(1, normalizedPenalty));
+                        }
+                    }
+                }
+            },
+            calculateCost(assignments, costContext) {
+                if (amountPerHour <= 0)
+                    return { entries: [] };
+                const patternMap = new Map(costContext.shiftPatterns.map((pattern) => [pattern.id, pattern]));
+                const activeDays = new Set(resolveActiveDaysFromScope(timeScopeValue, [...costContext.days]).map((day) => day.iso));
+                const targetMemberIds = new Set(resolveMembersFromScope(entityScopeValue, [...costContext.members]).map((member) => member.id));
+                const entries = [];
+                for (const assignment of assignments) {
+                    if (!activeDays.has(assignment.day) || !targetMemberIds.has(assignment.memberId))
+                        continue;
+                    const pattern = patternMap.get(assignment.shiftPatternId);
+                    if (!pattern)
+                        continue;
+                    const overlapMinutes = computeOverlapMinutes(pattern.startTime, pattern.endTime, window.from, window.until);
+                    if (overlapMinutes <= 0)
+                        continue;
+                    entries.push({
+                        memberId: assignment.memberId,
+                        day: assignment.day,
+                        category: COST_CATEGORY.PREMIUM,
+                        amount: (amountPerHour * overlapMinutes) / 60,
+                    });
+                }
+                return { entries };
+            },
+        };
+        return {
+            rule: "time-cost-surcharge",
+            artifacts: [costArtifact],
+        };
+    },
+});
 function computeOverlapMinutes(shiftStart, shiftEnd, windowFrom, windowUntil) {
     const sStart = timeOfDayToMinutes(shiftStart);
     const sEnd = normalizeEndMinutes(sStart, timeOfDayToMinutes(shiftEnd));
     const wFrom = timeOfDayToMinutes(windowFrom);
     const wUntil = timeOfDayToMinutes(windowUntil);
-    // Expand window: if overnight (e.g., 22:00-06:00), wUntil < wFrom
-    // Represent as two intervals or one extended interval
-    let totalOverlap = 0;
     if (wFrom < wUntil) {
-        // Normal window (e.g., 14:00-18:00)
-        totalOverlap = rangeOverlap(sStart, sEnd, wFrom, wUntil);
-    }
-    else {
-        // Overnight window (e.g., 22:00-06:00)
-        // Split into [wFrom, MINUTES_PER_DAY) and [0, wUntil)
-        // But shift may also span overnight, so use extended ranges
-        totalOverlap += rangeOverlap(sStart, sEnd, wFrom, MINUTES_PER_DAY);
-        totalOverlap += rangeOverlap(sStart, sEnd, MINUTES_PER_DAY, MINUTES_PER_DAY + wUntil);
-        // Also check if shift overlaps [0, wUntil) in the same day
-        totalOverlap += rangeOverlap(sStart, sEnd, 0, wUntil);
+        return rangeOverlap(sStart, sEnd, wFrom, wUntil);
     }
-    return totalOverlap;
+    return (rangeOverlap(sStart, sEnd, wFrom, MINUTES_PER_DAY) +
+        rangeOverlap(sStart, sEnd, MINUTES_PER_DAY, MINUTES_PER_DAY + wUntil) +
+        rangeOverlap(sStart, sEnd, 0, wUntil));
 }
 function rangeOverlap(aStart, aEnd, bStart, bEnd) {
     const start = Math.max(aStart, bStart);
     const end = Math.min(aEnd, bEnd);
     return Math.max(0, end - start);
 }
-/**
- * Creates a time-of-day surcharge rule (e.g., night differential).
- *
- * Adds a flat surcharge per hour for the portion of a shift that overlaps
- * a time-of-day window. Independent of the member's base rate.
- *
- * When `minimizeCost()` is not present, no solver terms are emitted,
- * but the `cost()` method still contributes to post-solve calculation.
- */
-export function createTimeCostSurchargeRule(config) {
-    const parsed = TimeCostSurchargeSchema.parse(config);
-    const { amountPerHour, window } = parsed;
-    const entityScopeValue = parseEntityScope(parsed);
-    const timeScopeValue = parseTimeScope(parsed);
-    return {
-        compile(b) {
-            if (!b.costContext?.active)
-                return;
-            if (amountPerHour <= 0)
-                return;
-            const targetMembers = resolveMembersFromScope(entityScopeValue, b.members);
-            const activeDays = resolveActiveDaysFromScope(timeScopeValue, b.days);
-            if (targetMembers.length === 0 || activeDays.length === 0)
-                return;
-            const { normalizationFactor } = b.costContext;
-            for (const emp of targetMembers) {
-                for (const pattern of b.shiftPatterns) {
-                    if (!b.canAssign(emp, pattern))
-                        continue;
-                    const overlapMinutes = computeOverlapMinutes(pattern.startTime, pattern.endTime, window.from, window.until);
-                    if (overlapMinutes <= 0)
-                        continue;
-                    const surcharge = (amountPerHour * overlapMinutes) / 60;
-                    const normalizedPenalty = surcharge / normalizationFactor;
-                    for (const day of activeDays) {
-                        if (!b.patternAvailableOnDay(pattern, day))
-                            continue;
-                        b.addPenalty(b.assignment(emp.id, pattern.id, day), Math.max(1, normalizedPenalty));
-                    }
-                }
-            }
-        },
-        cost(assignments, members, shiftPatterns) {
-            if (amountPerHour <= 0)
-                return { entries: [] };
-            const patternMap = new Map(shiftPatterns.map((p) => [p.id, p]));
-            const allDays = [...new Set(assignments.map((a) => a.day))].toSorted();
-            const activeDays = new Set(resolveActiveDaysFromScope(timeScopeValue, allDays));
-            const targetEmpIds = new Set(resolveMembersFromScope(entityScopeValue, [...members]).map((e) => e.id));
-            const entries = [];
-            for (const a of assignments) {
-                if (!activeDays.has(a.day))
-                    continue;
-                if (!targetEmpIds.has(a.memberId))
-                    continue;
-                const pattern = patternMap.get(a.shiftPatternId);
-                if (!pattern)
-                    continue;
-                const overlapMinutes = computeOverlapMinutes(pattern.startTime, pattern.endTime, window.from, window.until);
-                if (overlapMinutes <= 0)
-                    continue;
-                const amount = (amountPerHour * overlapMinutes) / 60;
-                entries.push({
-                    memberId: a.memberId,
-                    day: a.day,
-                    category: COST_CATEGORY.PREMIUM,
-                    amount,
-                });
-            }
-            return { entries };
-        },
-    };
-}
 //# sourceMappingURL=time-cost-surcharge.js.map

package/dist/cpsat/rules/time-cost-surcharge.js.map

@@ -1 +1 @@
-{"version":3,"file":"time-cost-surcharge.js","sourceRoot":"","sources":["../../../src/cpsat/rules/time-cost-surcharge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"time-cost-surcharge.js","sourceRoot":"","sources":["../../../src/cpsat/rules/time-cost-surcharge.ts"],"names":[],"mappings":"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"}

package/dist/cpsat/rules/time-off.d.ts

@@ -1,7 +1,11 @@
 import * as z from "zod";
-import type { CompilationRule } from "../model-builder.js";
-declare const TimeOffSchema: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
-    priority: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"LOW">, z.ZodLiteral<"MEDIUM">, z.ZodLiteral<"HIGH">, z.ZodLiteral<"MANDATORY">]>>;
+export declare const TimeOffSchema: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
+    priority: z.ZodDefault<z.ZodEnum<{
+        LOW: "LOW";
+        MEDIUM: "MEDIUM";
+        HIGH: "HIGH";
+        MANDATORY: "MANDATORY";
+    }>>;
     startTime: z.ZodOptional<z.ZodObject<{
         hours: z.ZodNumber;
         minutes: z.ZodNumber;
@@ -12,63 +16,23 @@ declare const TimeOffSchema: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodType<import("./scope.types.js").EntityScopeType<"members" | "roles" | "skills">, unknown, z.core.$ZodTypeInternals<import("./scope.types.js").EntityScopeType<"members" | "roles" | "skills">, unknown>>>, z.ZodType<import("./scope.types.js").RequiredTimeScopeType<"dateRange" | "dayOfWeek" | "specificDates" | "recurring">, unknown, z.core.$ZodTypeInternals<import("./scope.types.js").RequiredTimeScopeType<"dateRange" | "dayOfWeek" | "specificDates" | "recurring">, unknown>>>;
 /**
- * Configuration for {@link createTimeOffRule}.
- *
- * - `priority` (required): how strictly the solver enforces this rule
- * - `startTime` (optional): start of the time-off window within each day; must be paired with `endTime`
- * - `endTime` (optional): end of the time-off window within each day; must be paired with `startTime`
- *
- * Entity scoping (at most one):
- * - `memberIds`: restrict to specific members
- * - `roleIds`: restrict to members with matching roles
- * - `skillIds`: restrict to members with matching skills
- *
- * Time scoping (exactly one required):
- * - `dateRange`: contiguous date range
- * - `specificDates`: specific dates
- * - `dayOfWeek`: days of the week
- * - `recurringPeriods`: recurring calendar periods
+ * Configuration for {@link timeOffRuleDescriptor}.
  */
 export type TimeOffConfig = z.infer<typeof TimeOffSchema>;
 /**
- * Blocks or penalizes assignments during specified time periods.
- *
- * Supports entity scoping (people, roles, skills) and time scoping
- * (date ranges, specific dates, days of week, recurring periods).
- * Optionally supports partial-day time-off with startTime/endTime.
- *
- * @param config - See {@link TimeOffConfig}
- * @example Full day vacation
- * ```ts
- * createTimeOffRule({
- *   memberIds: ["alice"],
- *   dateRange: { start: "2024-02-01", end: "2024-02-05" },
- *   priority: "MANDATORY",
- * });
- * ```
- *
- * @example Every Wednesday afternoon off for students
- * ```ts
- * createTimeOffRule({
- *   roleIds: ["student"],
- *   dayOfWeek: ["wednesday"],
- *   startTime: { hours: 14, minutes: 0 },
- *   endTime: { hours: 23, minutes: 59 },
- *   priority: "MANDATORY",
- * });
- * ```
+ * Low-level descriptor for the `time-off` rule.
  *
- * @example Specific date, partial day
- * ```ts
- * createTimeOffRule({
- *   memberIds: ["bob"],
- *   specificDates: ["2024-03-15"],
- *   startTime: { hours: 16, minutes: 0 },
- *   endTime: { hours: 23, minutes: 59 },
- *   priority: "MANDATORY",
- * });
- * ```
+ * @category Rules
  */
-export declare function createTimeOffRule(config: TimeOffConfig): CompilationRule;
-export {};
+export declare const timeOffRuleDescriptor: import("../rule-descriptor.js").RuleDescriptor<"time-off", ({
+    priority: "LOW" | "MEDIUM" | "HIGH" | "MANDATORY";
+    startTime?: {
+        hours: number;
+        minutes: number;
+    } | undefined;
+    endTime?: {
+        hours: number;
+        minutes: number;
+    } | undefined;
+} & import("./scope.types.js").EntityScopeType<"members" | "roles" | "skills">) & import("./scope.types.js").RequiredTimeScopeType<"dateRange" | "dayOfWeek" | "specificDates" | "recurring">>;
 //# sourceMappingURL=time-off.d.ts.map

package/dist/cpsat/rules/time-off.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-off.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/time-off.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,qBAAqB,CAAC;AAoBlF,QAAA,MAAM,aAAa;;;;;;;;;;mfAiBhB,CAAC;AAEJ;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CA4GxE"}
+{"version":3,"file":"time-off.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/time-off.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AA0BzB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;mfAiBvB,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;8LA+HhC,CAAC"}