@outbuild-company/schedule-core 1.1.2 → 1.2.0

package/dist/index.d.cts

@@ -29,16 +29,32 @@ interface LinkSnapshot {
      * duration (`_targetLag = -summary.duration`) and the per-leaf offset from
      * the summary's start (`_trueLag = userLag + off_tgt(leaf)`), matching legacy
      * `_getImplicitLinks`/`_convertToFinishToStartLink` under
-     * `auto_scheduling_move_projects`. Computed ONCE at expansion time
-     * (`parent-link-expansion.ts`), never per scheduling tick.
+     * `auto_scheduling_move_projects`. `_targetLag`/`_trueLag` are computed once
+     * at expansion time, matching legacy relations frozen per run, and the
+     * per-leaf offset in `_trueLag` applies only to leaves with no incoming
+     * links (legacy `!c.$target.length` — a leaf with its own driver keeps
+     * offset 0, otherwise the frozen offset compounds on every settle).
+     * `_sourceLag` is the expansion-time fallback: when `_summarySourceId` is
+     * present (SS/SF out of a summary), the ASAP calculator re-derives it at
+     * evaluation time from the summary's CURRENT derived bounds so the virtual
+     * constraint stays anchored at the summary start even after the anchor leaf
+     * moves within the same run.
      *
-     * All three must be set together (or none): a half-populated link would mix
-     * precomputed and derived components. Only the FF/SF-into-summary path emits
-     * them; every other link leaves them undefined and hits the fast path.
+     * `_summaryTargetId` marks a virtual link whose `_trueLag` bakes a NON-ZERO
+     * leaf offset measured from the target summary's expansion-time bounds: the
+     * ASAP pass refuses to pull the leaf back through such a link unless the
+     * predecessor itself moved in the run (a stale frozen offset must never
+     * drag its own leaf earlier — that is the summary-link drift bug).
+     *
+     * The three lag components must be set together (or none): a half-populated
+     * link would mix precomputed and derived components. Every non-virtual link
+     * leaves them undefined and hits the fast path.
      */
     _sourceLag?: number;
     _targetLag?: number;
     _trueLag?: number;
+    _summarySourceId?: ActivityId$1;
+    _summaryTargetId?: ActivityId$1;
     ganttId?: number;
     sectorId?: number;
     /** BE row id (distinct from the schedule-level `id`). */
@@ -269,17 +285,6 @@ interface CoreActivity {
     expectedProgressBaseline: number | null;
     status: ActivityStatus | null;
     criticalPath: CriticalPathResult | null;
-    /** Internal reversible leaf→project promotion state; never serialized. */
-    promotionRestore: {
-        type: 'task' | 'milestone';
-        startDate: Date;
-        endDate: Date;
-        durationHours: number;
-        expectedProgressBaseline: number | null;
-        constraintType: ConstraintType;
-        constraintDate: Date | null;
-        progress: number;
-    } | null;
 }
 interface Link {
     id: LinkId;
@@ -888,6 +893,8 @@ type DispatchResult = {
      * rechazados.
      */
     verdicts?: ReadonlyArray<DatesBatchVerdict>;
+    activityVerdicts?: ReadonlyArray<DatesBatchVerdict>;
+    linkVerdicts?: ReadonlyArray<LinkBatchVerdict>;
     /**
      * INTERNAL (undo / B4). Full pre-mutation snapshot of every
      * deleted/structurally-removed activity row, keyed by STRING id. The
@@ -917,6 +924,17 @@ type DatesBatchVerdict = {
     reason: string;
     alertKey?: string | undefined;
 };
+type LinkBatchVerdict = {
+    operationIndex: number;
+    kind: LinksBatchOperation['kind'];
+    ok: true;
+    linkId: string;
+} | {
+    operationIndex: number;
+    kind: LinksBatchOperation['kind'];
+    ok: false;
+    reason: string;
+};
 
 interface TrackingEvent {
     name: string;
@@ -1211,7 +1229,7 @@ declare class ScheduleCore {
     get ready(): Promise<void>;
     get criticalPathReady(): Promise<{
         changes: ChangeSet;
-    }>;
+    } | null>;
     get status(): ScheduleCoreStatus;
     getSector(): Readonly<SectorMetadata>;
     getActivityView(id: ActivityId): Readonly<CoreActivity> | null;
@@ -1278,7 +1296,7 @@ declare class ScheduleCore {
     private _resyncCustomIdTrackerFromModel;
     destroy(): void;
     private readonly _initPromise;
-    private readonly _criticalPathReady;
+    private _criticalPathReady;
     private readonly _ready;
     private readonly _saveTracker;
     private assertReady;

package/dist/index.d.ts

@@ -29,16 +29,32 @@ interface LinkSnapshot {
      * duration (`_targetLag = -summary.duration`) and the per-leaf offset from
      * the summary's start (`_trueLag = userLag + off_tgt(leaf)`), matching legacy
      * `_getImplicitLinks`/`_convertToFinishToStartLink` under
-     * `auto_scheduling_move_projects`. Computed ONCE at expansion time
-     * (`parent-link-expansion.ts`), never per scheduling tick.
+     * `auto_scheduling_move_projects`. `_targetLag`/`_trueLag` are computed once
+     * at expansion time, matching legacy relations frozen per run, and the
+     * per-leaf offset in `_trueLag` applies only to leaves with no incoming
+     * links (legacy `!c.$target.length` — a leaf with its own driver keeps
+     * offset 0, otherwise the frozen offset compounds on every settle).
+     * `_sourceLag` is the expansion-time fallback: when `_summarySourceId` is
+     * present (SS/SF out of a summary), the ASAP calculator re-derives it at
+     * evaluation time from the summary's CURRENT derived bounds so the virtual
+     * constraint stays anchored at the summary start even after the anchor leaf
+     * moves within the same run.
      *
-     * All three must be set together (or none): a half-populated link would mix
-     * precomputed and derived components. Only the FF/SF-into-summary path emits
-     * them; every other link leaves them undefined and hits the fast path.
+     * `_summaryTargetId` marks a virtual link whose `_trueLag` bakes a NON-ZERO
+     * leaf offset measured from the target summary's expansion-time bounds: the
+     * ASAP pass refuses to pull the leaf back through such a link unless the
+     * predecessor itself moved in the run (a stale frozen offset must never
+     * drag its own leaf earlier — that is the summary-link drift bug).
+     *
+     * The three lag components must be set together (or none): a half-populated
+     * link would mix precomputed and derived components. Every non-virtual link
+     * leaves them undefined and hits the fast path.
      */
     _sourceLag?: number;
     _targetLag?: number;
     _trueLag?: number;
+    _summarySourceId?: ActivityId$1;
+    _summaryTargetId?: ActivityId$1;
     ganttId?: number;
     sectorId?: number;
     /** BE row id (distinct from the schedule-level `id`). */
@@ -269,17 +285,6 @@ interface CoreActivity {
     expectedProgressBaseline: number | null;
     status: ActivityStatus | null;
     criticalPath: CriticalPathResult | null;
-    /** Internal reversible leaf→project promotion state; never serialized. */
-    promotionRestore: {
-        type: 'task' | 'milestone';
-        startDate: Date;
-        endDate: Date;
-        durationHours: number;
-        expectedProgressBaseline: number | null;
-        constraintType: ConstraintType;
-        constraintDate: Date | null;
-        progress: number;
-    } | null;
 }
 interface Link {
     id: LinkId;
@@ -888,6 +893,8 @@ type DispatchResult = {
      * rechazados.
      */
     verdicts?: ReadonlyArray<DatesBatchVerdict>;
+    activityVerdicts?: ReadonlyArray<DatesBatchVerdict>;
+    linkVerdicts?: ReadonlyArray<LinkBatchVerdict>;
     /**
      * INTERNAL (undo / B4). Full pre-mutation snapshot of every
      * deleted/structurally-removed activity row, keyed by STRING id. The
@@ -917,6 +924,17 @@ type DatesBatchVerdict = {
     reason: string;
     alertKey?: string | undefined;
 };
+type LinkBatchVerdict = {
+    operationIndex: number;
+    kind: LinksBatchOperation['kind'];
+    ok: true;
+    linkId: string;
+} | {
+    operationIndex: number;
+    kind: LinksBatchOperation['kind'];
+    ok: false;
+    reason: string;
+};
 
 interface TrackingEvent {
     name: string;
@@ -1211,7 +1229,7 @@ declare class ScheduleCore {
     get ready(): Promise<void>;
     get criticalPathReady(): Promise<{
         changes: ChangeSet;
-    }>;
+    } | null>;
     get status(): ScheduleCoreStatus;
     getSector(): Readonly<SectorMetadata>;
     getActivityView(id: ActivityId): Readonly<CoreActivity> | null;
@@ -1278,7 +1296,7 @@ declare class ScheduleCore {
     private _resyncCustomIdTrackerFromModel;
     destroy(): void;
     private readonly _initPromise;
-    private readonly _criticalPathReady;
+    private _criticalPathReady;
     private readonly _ready;
     private readonly _saveTracker;
     private assertReady;