@outbuild-company/schedule-core 1.17.2 → 1.18.0

package/dist/index.d.cts

@@ -191,6 +191,11 @@ interface CoreActivity {
     freeSlackHours: number | null;
     /** Inclusive calendar-day span, or `null` when unavailable. */
     calendarDuration?: number | null;
+    /**
+     * Signed working days between the activity end and its visible baseline end,
+     * or `null` when no visible baseline applies. Positive means finishing late.
+     */
+    baselineVarianceDays: number | null;
     /** Expected progress percentage, or `null` when unavailable. */
     expectedProgress: number | null;
     /** Baseline expected progress percentage, or `null` when unavailable. */
@@ -347,6 +352,7 @@ declare const ACTIVITY_SAVE_FIELD_POLICY: {
     readonly isCritical: "ignored";
     readonly freeSlackHours: "ignored";
     readonly calendarDuration: "ignored";
+    readonly baselineVarianceDays: "ignored";
     readonly expectedProgress: "ignored";
     readonly expectedProgressBaseline: "ignored";
     readonly status: "ignored";
@@ -428,6 +434,7 @@ declare const COLUMN: {
     readonly DURATION_BASE: "duration_base";
     readonly COST_BASE: "cost_base";
     readonly WORK_BASE: "work_base";
+    readonly BASELINE_VARIANCE: "baseline_variance";
     readonly CALENDAR_DURATION: "calendarDuration";
     readonly IS_CRITICAL: "is_critical";
     readonly EARLY_START: "earlyStart";
@@ -555,6 +562,7 @@ declare const FILTER_FIELD: {
     readonly TOTAL_SLACK_DAYS: "totalSlackDays";
     readonly EXPECTED_PROGRESS_BASELINE: "expectedProgressBaseline";
     readonly BASELINE_DURATION_DAYS: "baselineDurationDays";
+    readonly BASELINE_VARIANCE_DAYS: "baselineVarianceDays";
     readonly BASELINE_COST: "baselineCost";
     readonly BASELINE_WORK_HOURS: "baselineWorkHours";
     readonly EXPECTED_PROGRESS: "expectedProgress";
@@ -600,7 +608,7 @@ type MembershipOperator = typeof FILTER_OPERATOR.SOME_OF | typeof FILTER_OPERATO
 /** Operator accepted by at least one public filter field. */
 type FilterOperator = StringOperator | NumberOperator | DateOperator | typeof FILTER_OPERATOR.BETWEEN | MembershipOperator;
 type StringFilterField = typeof FILTER_FIELD.NAME | typeof FILTER_FIELD.DESCRIPTION | typeof FILTER_FIELD.CUSTOM_ID;
-type NumberFilterField = typeof FILTER_FIELD.CORRELATIVE_ID | typeof FILTER_FIELD.UNIQUE_CORRELATIVE_ID | typeof FILTER_FIELD.PROGRESS | typeof FILTER_FIELD.DURATION_DAYS | typeof FILTER_FIELD.CALENDAR_DURATION | typeof FILTER_FIELD.COST | typeof FILTER_FIELD.USED_COST | typeof FILTER_FIELD.REAL_COST | typeof FILTER_FIELD.WORK_HOURS | typeof FILTER_FIELD.REAL_WORK_HOURS | typeof FILTER_FIELD.PONDERATOR | typeof FILTER_FIELD.FREE_SLACK_DAYS | typeof FILTER_FIELD.TOTAL_SLACK_DAYS | typeof FILTER_FIELD.EXPECTED_PROGRESS_BASELINE | typeof FILTER_FIELD.BASELINE_DURATION_DAYS | typeof FILTER_FIELD.BASELINE_COST | typeof FILTER_FIELD.BASELINE_WORK_HOURS | typeof FILTER_FIELD.EXPECTED_PROGRESS;
+type NumberFilterField = typeof FILTER_FIELD.CORRELATIVE_ID | typeof FILTER_FIELD.UNIQUE_CORRELATIVE_ID | typeof FILTER_FIELD.PROGRESS | typeof FILTER_FIELD.DURATION_DAYS | typeof FILTER_FIELD.CALENDAR_DURATION | typeof FILTER_FIELD.COST | typeof FILTER_FIELD.USED_COST | typeof FILTER_FIELD.REAL_COST | typeof FILTER_FIELD.WORK_HOURS | typeof FILTER_FIELD.REAL_WORK_HOURS | typeof FILTER_FIELD.PONDERATOR | typeof FILTER_FIELD.FREE_SLACK_DAYS | typeof FILTER_FIELD.TOTAL_SLACK_DAYS | typeof FILTER_FIELD.EXPECTED_PROGRESS_BASELINE | typeof FILTER_FIELD.BASELINE_DURATION_DAYS | typeof FILTER_FIELD.BASELINE_VARIANCE_DAYS | typeof FILTER_FIELD.BASELINE_COST | typeof FILTER_FIELD.BASELINE_WORK_HOURS | typeof FILTER_FIELD.EXPECTED_PROGRESS;
 type DateFilterField = typeof FILTER_FIELD.START_DATE | typeof FILTER_FIELD.END_DATE | typeof FILTER_FIELD.CONSTRAINT_DATE | typeof FILTER_FIELD.BASELINE_START_DATE | typeof FILTER_FIELD.BASELINE_END_DATE | typeof FILTER_FIELD.EARLY_START | typeof FILTER_FIELD.EARLY_FINISH | typeof FILTER_FIELD.LATE_START | typeof FILTER_FIELD.LATE_FINISH;
 type IdArrayFilterField = typeof FILTER_FIELD.RESPONSABLE_IDS | typeof FILTER_FIELD.TAG_IDS;
 type EnumFilterField = typeof FILTER_FIELD.STATUS | typeof FILTER_FIELD.CONSTRAINT_TYPE;

package/dist/index.d.ts

@@ -191,6 +191,11 @@ interface CoreActivity {
     freeSlackHours: number | null;
     /** Inclusive calendar-day span, or `null` when unavailable. */
     calendarDuration?: number | null;
+    /**
+     * Signed working days between the activity end and its visible baseline end,
+     * or `null` when no visible baseline applies. Positive means finishing late.
+     */
+    baselineVarianceDays: number | null;
     /** Expected progress percentage, or `null` when unavailable. */
     expectedProgress: number | null;
     /** Baseline expected progress percentage, or `null` when unavailable. */
@@ -347,6 +352,7 @@ declare const ACTIVITY_SAVE_FIELD_POLICY: {
     readonly isCritical: "ignored";
     readonly freeSlackHours: "ignored";
     readonly calendarDuration: "ignored";
+    readonly baselineVarianceDays: "ignored";
     readonly expectedProgress: "ignored";
     readonly expectedProgressBaseline: "ignored";
     readonly status: "ignored";
@@ -428,6 +434,7 @@ declare const COLUMN: {
     readonly DURATION_BASE: "duration_base";
     readonly COST_BASE: "cost_base";
     readonly WORK_BASE: "work_base";
+    readonly BASELINE_VARIANCE: "baseline_variance";
     readonly CALENDAR_DURATION: "calendarDuration";
     readonly IS_CRITICAL: "is_critical";
     readonly EARLY_START: "earlyStart";
@@ -555,6 +562,7 @@ declare const FILTER_FIELD: {
     readonly TOTAL_SLACK_DAYS: "totalSlackDays";
     readonly EXPECTED_PROGRESS_BASELINE: "expectedProgressBaseline";
     readonly BASELINE_DURATION_DAYS: "baselineDurationDays";
+    readonly BASELINE_VARIANCE_DAYS: "baselineVarianceDays";
     readonly BASELINE_COST: "baselineCost";
     readonly BASELINE_WORK_HOURS: "baselineWorkHours";
     readonly EXPECTED_PROGRESS: "expectedProgress";
@@ -600,7 +608,7 @@ type MembershipOperator = typeof FILTER_OPERATOR.SOME_OF | typeof FILTER_OPERATO
 /** Operator accepted by at least one public filter field. */
 type FilterOperator = StringOperator | NumberOperator | DateOperator | typeof FILTER_OPERATOR.BETWEEN | MembershipOperator;
 type StringFilterField = typeof FILTER_FIELD.NAME | typeof FILTER_FIELD.DESCRIPTION | typeof FILTER_FIELD.CUSTOM_ID;
-type NumberFilterField = typeof FILTER_FIELD.CORRELATIVE_ID | typeof FILTER_FIELD.UNIQUE_CORRELATIVE_ID | typeof FILTER_FIELD.PROGRESS | typeof FILTER_FIELD.DURATION_DAYS | typeof FILTER_FIELD.CALENDAR_DURATION | typeof FILTER_FIELD.COST | typeof FILTER_FIELD.USED_COST | typeof FILTER_FIELD.REAL_COST | typeof FILTER_FIELD.WORK_HOURS | typeof FILTER_FIELD.REAL_WORK_HOURS | typeof FILTER_FIELD.PONDERATOR | typeof FILTER_FIELD.FREE_SLACK_DAYS | typeof FILTER_FIELD.TOTAL_SLACK_DAYS | typeof FILTER_FIELD.EXPECTED_PROGRESS_BASELINE | typeof FILTER_FIELD.BASELINE_DURATION_DAYS | typeof FILTER_FIELD.BASELINE_COST | typeof FILTER_FIELD.BASELINE_WORK_HOURS | typeof FILTER_FIELD.EXPECTED_PROGRESS;
+type NumberFilterField = typeof FILTER_FIELD.CORRELATIVE_ID | typeof FILTER_FIELD.UNIQUE_CORRELATIVE_ID | typeof FILTER_FIELD.PROGRESS | typeof FILTER_FIELD.DURATION_DAYS | typeof FILTER_FIELD.CALENDAR_DURATION | typeof FILTER_FIELD.COST | typeof FILTER_FIELD.USED_COST | typeof FILTER_FIELD.REAL_COST | typeof FILTER_FIELD.WORK_HOURS | typeof FILTER_FIELD.REAL_WORK_HOURS | typeof FILTER_FIELD.PONDERATOR | typeof FILTER_FIELD.FREE_SLACK_DAYS | typeof FILTER_FIELD.TOTAL_SLACK_DAYS | typeof FILTER_FIELD.EXPECTED_PROGRESS_BASELINE | typeof FILTER_FIELD.BASELINE_DURATION_DAYS | typeof FILTER_FIELD.BASELINE_VARIANCE_DAYS | typeof FILTER_FIELD.BASELINE_COST | typeof FILTER_FIELD.BASELINE_WORK_HOURS | typeof FILTER_FIELD.EXPECTED_PROGRESS;
 type DateFilterField = typeof FILTER_FIELD.START_DATE | typeof FILTER_FIELD.END_DATE | typeof FILTER_FIELD.CONSTRAINT_DATE | typeof FILTER_FIELD.BASELINE_START_DATE | typeof FILTER_FIELD.BASELINE_END_DATE | typeof FILTER_FIELD.EARLY_START | typeof FILTER_FIELD.EARLY_FINISH | typeof FILTER_FIELD.LATE_START | typeof FILTER_FIELD.LATE_FINISH;
 type IdArrayFilterField = typeof FILTER_FIELD.RESPONSABLE_IDS | typeof FILTER_FIELD.TAG_IDS;
 type EnumFilterField = typeof FILTER_FIELD.STATUS | typeof FILTER_FIELD.CONSTRAINT_TYPE;

package/dist/index.js

@@ -289,6 +289,7 @@ var READ_ONLY = {
   DURATION_BASE: "duration_base",
   COST_BASE: "cost_base",
   WORK_BASE: "work_base",
+  BASELINE_VARIANCE: "baseline_variance",
   CALENDAR_DURATION: "calendarDuration",
   IS_CRITICAL: "is_critical",
   EARLY_START: "earlyStart",
@@ -1042,6 +1043,7 @@ var FILTER_FIELD = {
   TOTAL_SLACK_DAYS: "totalSlackDays",
   EXPECTED_PROGRESS_BASELINE: "expectedProgressBaseline",
   BASELINE_DURATION_DAYS: "baselineDurationDays",
+  BASELINE_VARIANCE_DAYS: "baselineVarianceDays",
   BASELINE_COST: "baselineCost",
   BASELINE_WORK_HOURS: "baselineWorkHours",
   EXPECTED_PROGRESS: "expectedProgress",
@@ -1209,6 +1211,10 @@ var FIELD_REGISTRY = {
     valueKind: FILTER_VALUE_KIND.NUMBER,
     extract: (activity) => activity.baselineSnapshot?.durationDays ?? null
   },
+  [FILTER_FIELD.BASELINE_VARIANCE_DAYS]: {
+    valueKind: FILTER_VALUE_KIND.NUMBER,
+    extract: (activity) => activity.baselineVarianceDays
+  },
   [FILTER_FIELD.BASELINE_COST]: {
     valueKind: FILTER_VALUE_KIND.NUMBER,
     extract: (activity) => activity.baselineSnapshot?.cost ?? null
@@ -2354,7 +2360,8 @@ var ACTIVITY_PROPERTY = {
   CUSTOM_ID: "customId",
   NEW_ACTIVITIES_ARRAY: "newActivityIds",
   HAS_NEW_ACTIVITIES: "hasNewActivities",
-  CALENDAR_DURATION: "calendarDuration"};
+  CALENDAR_DURATION: "calendarDuration",
+  BASELINE_VARIANCE_DAYS: "baselineVarianceDays"};
 var LINK_PROPERTY = {
   SOURCE: "source",
   TARGET: "target",
@@ -6286,12 +6293,16 @@ function mergeCorrelativeShiftIntoDiff(diff, correlativeBefore, activityId, live
     after: liveActivity.correlativeId
   };
 }
+var DERIVED_DISPLAY_FIELDS = [
+  ACTIVITY_PROPERTY.CALENDAR_DURATION,
+  ACTIVITY_PROPERTY.BASELINE_VARIANCE_DAYS
+];
 function diffActivity(before, after) {
   const fields = {};
   const beforeRec = before ?? {};
   const afterRec = after;
   const keys = /* @__PURE__ */ new Set([...Object.keys(beforeRec), ...Object.keys(afterRec)]);
-  keys.delete(ACTIVITY_PROPERTY.CALENDAR_DURATION);
+  for (const derived of DERIVED_DISPLAY_FIELDS) keys.delete(derived);
   for (const k of keys) {
     if (Object.hasOwn(beforeRec, k) !== Object.hasOwn(afterRec, k) || !fieldValueEqual(beforeRec[k], afterRec[k])) {
       fields[k] = {
@@ -6541,6 +6552,43 @@ function applyStatusPass(state, criteria) {
   return changed;
 }
 
+// src/propagations/shared/get-visible-baseline.ts
+function getVisibleBaseline(activity) {
+  const points = activity?.baselinePoints;
+  if (!Array.isArray(points) || points.length === 0) return null;
+  return points.find((point) => point.isVisibleVersion) ?? null;
+}
+
+// src/columns/baseline-variance/compute.ts
+var VARIANCE_DECIMAL_SCALE = 100;
+var roundToVariancePrecision = (days) => Math.round(days * VARIANCE_DECIMAL_SCALE) / VARIANCE_DECIMAL_SCALE;
+function computeBaselineVarianceDays(activity, calendars, hoursPerDay) {
+  if (hoursPerDay <= 0) return null;
+  const baselineEnd = getVisibleBaseline(activity)?.endDate;
+  const activityEnd = activity.endDate;
+  if (!baselineEnd || !activityEnd) return null;
+  const finishesLate = activityEnd.getTime() > baselineEnd.getTime();
+  const finishesEarly = baselineEnd.getTime() > activityEnd.getTime();
+  if (!finishesLate && !finishesEarly) return 0;
+  const durationHours = calendars.calculateDuration({
+    startDate: finishesLate ? baselineEnd : activityEnd,
+    endDate: finishesLate ? activityEnd : baselineEnd,
+    task: activity
+  });
+  const magnitude = roundToVariancePrecision(durationHours / hoursPerDay);
+  return finishesLate ? magnitude : -magnitude;
+}
+function applyBaselineVariancePass(state, hoursPerDay) {
+  const changed = [];
+  state.forEachActivity((activity, id) => {
+    const variance = computeBaselineVarianceDays(activity, state, hoursPerDay);
+    if (activity.baselineVarianceDays === variance) return;
+    activity.baselineVarianceDays = variance;
+    changed.push(String(id));
+  });
+  return changed;
+}
+
 // src/critical-path/legacy/shims/moment.js
 function moment(input) {
   const d = input instanceof Date ? new Date(input.getTime()) : input && typeof input === "object" && typeof input.valueOf === "function" ? new Date(input.valueOf()) : new Date(input);
@@ -11265,6 +11313,7 @@ var DERIVED_PASS = {
   REAL_WORK: "real-work",
   EXPECTED_PROGRESS: "expected-progress",
   REAL_COST: "real-cost",
+  BASELINE_VARIANCE: "baseline-variance",
   CRITICAL_PATH: "critical-path"
 };
 function resolveDerivedPasses(action, autoSchedule, options) {
@@ -11282,6 +11331,9 @@ function resolveDerivedPasses(action, autoSchedule, options) {
   if (runsLoadRecomputes && resolveRunRealCost(action)) {
     passes.add(DERIVED_PASS.REAL_COST);
   }
+  if (dispatchChangesSchedulingState(action)) {
+    passes.add(DERIVED_PASS.BASELINE_VARIANCE);
+  }
   const runsCriticalPath = runsLoadRecomputes && resolveRunCriticalPath(action) && !options.skipCriticalPath;
   if (runsCriticalPath) passes.add(DERIVED_PASS.CRITICAL_PATH);
   return passes;
@@ -11944,6 +11996,9 @@ async function runDerivedRecomputes(deps, passes, now) {
   if (passes.has(DERIVED_PASS.REAL_COST)) {
     emitRealCost(deps.adapter);
   }
+  if (passes.has(DERIVED_PASS.BASELINE_VARIANCE)) {
+    applyBaselineVariancePass(deps.adapter, deps.sector.hoursPerDay);
+  }
   if (passes.has(DERIVED_PASS.CRITICAL_PATH)) {
     await applyCriticalPath(deps.adapter, deps.sector.hoursPerDay);
   }
@@ -12891,6 +12946,7 @@ var NEW_ACTIVITY_DEFAULTS = Object.freeze({
   tagIds: [],
   baselinePoints: [],
   baselineSnapshot: null,
+  baselineVarianceDays: null,
   recursiveDurationHours: 0,
   isCritical: false,
   freeSlackHours: null,
@@ -16622,6 +16678,7 @@ async function dispatchBaselineApply(action, deps) {
     deps.reporter,
     deps.defaultBaseCalendarId ?? null
   );
+  applyBaselineVariancePass(deps.adapter, deps.sector.hoursPerDay);
   if (activeBaselineSignature(deps) !== activeBaselineBefore) {
     recomputeBaselineWeightedFields(
       deps,
@@ -21709,6 +21766,7 @@ var ACTIVITY_SAVE_FIELD_POLICY = {
   isCritical: SAVE_FIELD_POLICY.IGNORED,
   freeSlackHours: SAVE_FIELD_POLICY.IGNORED,
   calendarDuration: SAVE_FIELD_POLICY.IGNORED,
+  baselineVarianceDays: SAVE_FIELD_POLICY.IGNORED,
   expectedProgress: SAVE_FIELD_POLICY.IGNORED,
   expectedProgressBaseline: SAVE_FIELD_POLICY.IGNORED,
   status: SAVE_FIELD_POLICY.IGNORED,
@@ -22335,6 +22393,7 @@ function parseActivity(raw, context) {
       isMilestone
     ),
     baselineSnapshot: null,
+    baselineVarianceDays: null,
     recursiveDurationHours: durationToHours(
       Number(raw.sumOfDurationRecursively ?? 0),
       context.hoursPerDay
@@ -23557,6 +23616,7 @@ async function runInitialPasses(deps) {
       applyExpectedProgressLive(state, now);
       applyStatusPass(state, sector.statusCriteria);
     }
+    applyBaselineVariancePass(state, sector.hoursPerDay);
     return;
   }
   const result = await scheduler.schedule({});
@@ -23569,6 +23629,7 @@ async function runInitialPasses(deps) {
     applyExpectedProgressLive(state, now);
     applyStatusPass(state, sector.statusCriteria);
   }
+  applyBaselineVariancePass(state, sector.hoursPerDay);
 }
 function recomputeSkippedLeafEnds(state) {
   state.forEachActivity((activity) => {