@outbuild-company/schedule-core 1.17.2 → 1.18.0

package/dist/index.cjs

@@ -291,6 +291,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",
@@ -1044,6 +1045,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",
@@ -1211,6 +1213,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
@@ -2356,7 +2362,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",
@@ -6288,12 +6295,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] = {
@@ -6543,6 +6554,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);
@@ -11267,6 +11315,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) {
@@ -11284,6 +11333,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;
@@ -11946,6 +11998,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);
   }
@@ -12893,6 +12948,7 @@ var NEW_ACTIVITY_DEFAULTS = Object.freeze({
   tagIds: [],
   baselinePoints: [],
   baselineSnapshot: null,
+  baselineVarianceDays: null,
   recursiveDurationHours: 0,
   isCritical: false,
   freeSlackHours: null,
@@ -16624,6 +16680,7 @@ async function dispatchBaselineApply(action, deps) {
     deps.reporter,
     deps.defaultBaseCalendarId ?? null
   );
+  applyBaselineVariancePass(deps.adapter, deps.sector.hoursPerDay);
   if (activeBaselineSignature(deps) !== activeBaselineBefore) {
     recomputeBaselineWeightedFields(
       deps,
@@ -21711,6 +21768,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,
@@ -22337,6 +22395,7 @@ function parseActivity(raw, context) {
       isMilestone
     ),
     baselineSnapshot: null,
+    baselineVarianceDays: null,
     recursiveDurationHours: durationToHours(
       Number(raw.sumOfDurationRecursively ?? 0),
       context.hoursPerDay
@@ -23559,6 +23618,7 @@ async function runInitialPasses(deps) {
       applyExpectedProgressLive(state, now);
       applyStatusPass(state, sector.statusCriteria);
     }
+    applyBaselineVariancePass(state, sector.hoursPerDay);
     return;
   }
   const result = await scheduler.schedule({});
@@ -23571,6 +23631,7 @@ async function runInitialPasses(deps) {
     applyExpectedProgressLive(state, now);
     applyStatusPass(state, sector.statusCriteria);
   }
+  applyBaselineVariancePass(state, sector.hoursPerDay);
 }
 function recomputeSkippedLeafEnds(state) {
   state.forEachActivity((activity) => {