@outbuild-company/schedule-core 1.6.3 → 1.7.0

package/dist/index.d.cts

@@ -134,6 +134,14 @@ interface CoreActivity {
     recursiveDurationHours: number;
     isCritical: boolean;
     freeSlackHours: number | null;
+    /**
+     * Días de calendario crudos entre start y end (incluye no laborables). Es una
+     * columna del grid, así que la posee el core (decisión del owner 2026-08-03):
+     * estado derivado que el core mantiene al nacer la actividad y al escribir
+     * start/end/type (`internal/state/calendar-duration.ts`), y que por eso fluye
+     * solo por vistas, ChangeSets y undo. Milestone → 0; fechas inválidas → null.
+     */
+    calendarDuration?: number | null;
     expectedProgress: number | null;
     expectedProgressBaseline: number | null;
     status: ActivityStatus | null;
@@ -193,6 +201,8 @@ interface SectorMetadata {
     updateDurationForPrimaveraEndDate?: boolean;
     activityCreter?: ActivityCreter;
     statusCriteria: StatusCriteria;
+    /** Declared by the loader input; never derived from the backend payload. */
+    ganttId: number | null;
 }
 interface EntityChange<T> {
     id: string;
@@ -279,14 +289,22 @@ type NumberOperator = 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'gre
 type DateOperator = 'after' | 'before';
 type MembershipOperator = 'someOf' | 'notSomeOf';
 type FilterOperator = StringOperator | NumberOperator | DateOperator | MembershipOperator;
-type FilterField = 'name' | 'description' | 'customId' | 'correlativeId' | 'uniqueCorrelativeId' | 'progress' | 'durationDays' | 'calendarDuration' | 'cost' | 'usedCost' | 'realCost' | 'workHours' | 'realWorkHours' | 'ponderator' | 'freeSlackDays' | 'totalSlackDays' | 'expectedProgressBaseline' | 'baselineDurationDays' | 'baselineCost' | 'baselineWorkHours' | 'startDate' | 'endDate' | 'constraintDate' | 'baselineStartDate' | 'baselineEndDate' | 'earlyStart' | 'earlyFinish' | 'lateStart' | 'lateFinish' | 'responsableIds' | 'tagIds' | 'status' | 'constraintType' | 'calendarId' | 'subcontractId' | 'isCritical';
+type StringFilterField = 'name' | 'description' | 'customId';
+type NumberFilterField = 'correlativeId' | 'uniqueCorrelativeId' | 'progress' | 'durationDays' | 'calendarDuration' | 'cost' | 'usedCost' | 'realCost' | 'workHours' | 'realWorkHours' | 'ponderator' | 'freeSlackDays' | 'totalSlackDays' | 'expectedProgressBaseline' | 'baselineDurationDays' | 'baselineCost' | 'baselineWorkHours';
+type DateFilterField = 'startDate' | 'endDate' | 'constraintDate' | 'baselineStartDate' | 'baselineEndDate' | 'earlyStart' | 'earlyFinish' | 'lateStart' | 'lateFinish';
+type IdArrayFilterField = 'responsableIds' | 'tagIds';
+type EnumFilterField = 'status' | 'constraintType';
+type ReferenceFilterField = 'calendarId' | 'subcontractId';
+type BooleanFilterField = 'isCritical';
+type FilterField = StringFilterField | NumberFilterField | DateFilterField | IdArrayFilterField | EnumFilterField | ReferenceFilterField | BooleanFilterField;
 type FilterScalarValue = string | number | Date;
-type FilterCriterionValue = FilterScalarValue | ReadonlyArray<string | number>;
-interface FilterCriterion {
-    readonly field: FilterField;
-    readonly operator: FilterOperator;
-    readonly value: FilterCriterionValue;
+type FilterCriterionValue = FilterScalarValue | ReadonlyArray<string | number | boolean>;
+interface Criterion<Field extends FilterField, Operator, Value> {
+    readonly field: Field;
+    readonly operator: Operator;
+    readonly value: Value;
 }
+type FilterCriterion = Criterion<StringFilterField, StringOperator, string> | Criterion<NumberFilterField, NumberOperator, string | number> | Criterion<DateFilterField, DateOperator, string | number | Date> | Criterion<IdArrayFilterField, MembershipOperator, ReadonlyArray<string | number>> | Criterion<EnumFilterField, MembershipOperator, ReadonlyArray<string>> | Criterion<ReferenceFilterField, MembershipOperator, ReadonlyArray<string | number>> | Criterion<BooleanFilterField, MembershipOperator, ReadonlyArray<boolean>>;
 interface FilterDateRange {
     readonly start: Date;
     readonly end: Date;
@@ -341,6 +359,10 @@ type LinksBatchOperation = {
     kind: 'delete';
     linkId: LinkId;
 };
+interface ReconciledActivityProgress {
+    readonly activityId: string;
+    readonly progress: number;
+}
 interface PersistedEntityIdentity {
     readonly id: string;
     readonly proplannerId: number;
@@ -373,9 +395,28 @@ interface ActivityBatchAction {
 }
 
 type DispatchAction = {
+    kind: 'activity-copy';
+    eventSource?: string;
+} | {
+    kind: 'activity-clipboard-clear';
+    eventSource?: string;
+} | {
+    kind: 'activity-paste-copied';
+    destination: {
+        afterSiblingId: ActivityId;
+    };
+    eventSource?: string;
+} | {
     kind: 'persistence-acknowledge';
     activities?: ReadonlyArray<PersistedEntityIdentity>;
     links?: ReadonlyArray<PersistedEntityIdentity>;
+    /**
+     * CP19 (ISSUE-070): valores que el backend normalizo al guardar (hoy solo
+     * progress). El motor los reconcilia — aplica los que difieren, ignora
+     * los iguales — para que el core refleje lo persistido. Sin undo: el
+     * acuse es clear-on-success y el tracker snapshotea despues.
+     */
+    reconciledProgress?: ReadonlyArray<ReconciledActivityProgress>;
 } | {
     kind: 'baseline-apply';
     points: ReadonlyArray<BaselinePoint>;
@@ -454,6 +495,15 @@ type DispatchAction = {
     kind: 'activity-set-progress';
     activityId: ActivityId;
     newValue: 0 | 100;
+    /**
+     * CP15 (ISSUE-066): el origen se DECLARA, no se adivina (mismo patron
+     * que inputUnit). 'action-button' es el unico origen con salvoconducto
+     * de negocio para actividades en Lookahead (espejo del flag
+     * progressChangedByActionButton que consume parseToUpdate en el
+     * backend; guia agents/progreso-lookahead.md). Sin origen declarado
+     * aplica el canEdit completo del pipeline.
+     */
+    origin?: 'action-button';
     eventSource?: string;
 } | {
     kind: 'selection-toggle';
@@ -485,6 +535,13 @@ type DispatchAction = {
     activityId: ActivityId;
     pendingRequests: ReadonlyArray<PendingRequest>;
     eventSource?: string;
+} | {
+    kind: 'sir-approve';
+    activityId: ActivityId;
+    approvedRequestId: string;
+    startDate: unknown;
+    endDate: unknown;
+    eventSource?: string;
 } | {
     kind: 'activity-lookahead-sync';
     activityIds: ReadonlyArray<ActivityId>;
@@ -492,38 +549,32 @@ type DispatchAction = {
     hasLookaheadTasks: boolean;
     acknowledgePersistedLookahead?: boolean;
     eventSource?: string;
-} | {
-    kind: 'activity-paste';
-    destination: {
-        parentId: ActivityId | '0';
-        index: number;
-    } | {
-        afterSiblingId: ActivityId;
-    };
-    referenceActivityId: ActivityId;
-    activities: ReadonlyArray<PastedActivityInput>;
-    links: ReadonlyArray<PastedLinkInput>;
-    eventSource?: string;
 };
 type InternalDispatchAction = DispatchAction | ActivityBatchAction;
-interface PastedActivityInput {
-    readonly originalId: ActivityId;
-    readonly originalParentId: ActivityId | '0';
-    readonly activityId?: ActivityId;
-    readonly overrides: CreationOverrides;
-    readonly baselineSnapshot?: ActivityBaselineSnapshot | null;
-}
-interface PastedLinkInput {
-    readonly source: ActivityId;
-    readonly target: ActivityId;
-    readonly type: LinkType;
-    readonly lag: number;
-    readonly linkId?: LinkId;
-}
 interface DispatchOptions {
     skipAutoSchedule?: boolean;
     skipCriticalPath?: boolean;
     inputUnit?: 'days' | 'hours';
+    /**
+     * Reversible preview mode (SIR). The edit mutates internal state with the
+     * exact same scheduling rules as a real edit (calendar, link/autoschedule
+     * propagation, parents, derived fields), but leaves no session trace: no
+     * save-tracker dirty, no undo entry, no SIR auto-reject effect or
+     * pendingRequestIds mutation, and the schedule revision does not move.
+     * The result carries `preview` with the exact inverse ChangeSet; exiting
+     * the preview is `ScheduleCore.applyPreviewInverse(inverse)`.
+     */
+    preview?: boolean;
+}
+interface PreviewDispatchInfo {
+    /**
+     * Exact inverse of `changes`. Note its `after` images were captured while
+     * the preview edit was still applied; project the ChangeSet RETURNED by
+     * `applyPreviewInverse`, which re-reads them from the restored state.
+     */
+    inverse: ChangeSet;
+    /** `getScheduleRevision()` at the time the preview was computed. */
+    revision: number;
 }
 type DispatchResult = {
     ok: true;
@@ -531,6 +582,8 @@ type DispatchResult = {
     verdicts?: ReadonlyArray<DatesBatchVerdict>;
     activityVerdicts?: ReadonlyArray<DatesBatchVerdict>;
     linkVerdicts?: ReadonlyArray<LinkBatchVerdict>;
+    /** Present only when dispatched with `DispatchOptions.preview`. */
+    preview?: PreviewDispatchInfo;
 } | {
     ok: false;
     reason: string;
@@ -746,6 +799,7 @@ interface ScheduleCoreInput extends BackendScheduleInput {
     clock?: () => Date;
     criticalPathOnLoad?: boolean;
     statusCriteria?: StatusCriteria;
+    ganttId?: number;
     reporter?: ScheduleCoreReporter;
 }
 
@@ -764,12 +818,20 @@ interface DateGesturePreview {
     } | null;
 }
 
+interface EffectiveGraphAudit {
+    readonly activityCount: number;
+    readonly logicalLinkCount: number;
+    readonly effectiveEdgeCount: number;
+    readonly circularComponents: ReadonlyArray<ReadonlyArray<string>>;
+    readonly largestComponentSize: number;
+}
 interface UndoOptions {
     readonly skipCriticalPath?: boolean;
     readonly expectedUndoDepth?: number;
 }
 
 declare class ScheduleCore {
+    private readonly _activityClipboard;
     private _status;
     private readonly coreRuntime;
     private readonly _undo;
@@ -811,9 +873,18 @@ declare class ScheduleCore {
     getActivityView(id: ActivityId): Readonly<CoreActivity> | null;
     createDateGesturePreview(gesture: DateGesture): DateGesturePreview;
     getAllActivitiesView(): ReadonlyArray<Readonly<CoreActivity>>;
+    /**
+     * Read del plan de indent (ISSUE-080): los padres destino DISTINTOS bajo los
+     * que quedarían las actividades si se indentaran ahora. Es exactamente la
+     * planificación que ejecuta el handler (`planIndentMoves`, autoridad única),
+     * expuesta para que la frontera pueda correr el protocolo de conversión a
+     * madre (chequeo backend + modal) ANTES de despachar. Solo lecturas.
+     */
+    getIndentTargetParentIds(activityIds: ReadonlyArray<ActivityId | string>): readonly string[];
     getChildrenView(parentId: ActivityId | '0'): ReadonlyArray<Readonly<CoreActivity>>;
     getLinkView(id: LinkId): Readonly<Link> | null;
     getAllLinksView(): ReadonlyArray<Readonly<Link>>;
+    auditEffectiveGraph(): EffectiveGraphAudit;
     getProperty<Property extends keyof CoreActivity>(activityId: ActivityId, property: Property): CoreActivity[Property] | null;
     getAllIds(): readonly string[];
     forEachActivityId(visit: (id: string) => void): void;
@@ -832,6 +903,26 @@ declare class ScheduleCore {
     getModifiedLinks(): ReadonlyArray<Readonly<Link>>;
     getModifiedActivities(): ReadonlyArray<Readonly<CoreActivity>>;
     hasUnsavedChanges(): boolean;
+    /**
+     * Read-only view of the internal schedule revision. It moves once per
+     * substantive CANONICAL mutation (dispatch, undo, redo). It does NOT move
+     * for a preview dispatch nor for `applyPreviewInverse`: comparing the value
+     * captured in `PreviewDispatchInfo.revision` against the current one
+     * answers "did the schedule change while the preview was open".
+     */
+    getScheduleRevision(): number;
+    /**
+     * Exit channel for a preview dispatch (`DispatchOptions.preview`): applies
+     * the inverse ChangeSet the preview returned, restoring the canonical
+     * state exactly. Like the preview itself it leaves no session trace: no
+     * save-tracker dirty, no undo entry, no effects, and the schedule revision
+     * does not move (see `getScheduleRevision`).
+     *
+     * Returns the ChangeSet to project to the view layer: the same changes as
+     * `inverse`, but with `after` images re-read from the restored state (the
+     * ones inside `inverse` were captured while the preview edit was applied).
+     */
+    applyPreviewInverse(inverse: ChangeSet): Promise<ChangeSet>;
     getDeletedActivitiesSinceLastSave(): ReadonlyArray<Readonly<DeletedActivitySnapshot>>;
     getDeletedLinksSinceLastSave(): ReadonlyArray<Readonly<DeletedLinkSnapshot>>;
     private _enqueue;
@@ -1029,6 +1120,9 @@ declare const DEFAULT_HOURS_PER_DAY = 8;
 
 type DispatchActionKind = DispatchAction['kind'];
 declare const DISPATCH_ACTION_KIND: {
+    readonly ACTIVITY_CLIPBOARD_CLEAR: "activity-clipboard-clear";
+    readonly ACTIVITY_COPY: "activity-copy";
+    readonly ACTIVITY_PASTE_COPIED: "activity-paste-copied";
     readonly PERSISTENCE_ACKNOWLEDGE: "persistence-acknowledge";
     readonly BASELINE_APPLY: "baseline-apply";
     readonly PONDERATOR_CRITERION_SET: "ponderator-criterion-set";
@@ -1046,13 +1140,13 @@ declare const DISPATCH_ACTION_KIND: {
     readonly ACTIVITY_INDENT: "activity-indent";
     readonly ACTIVITY_OUTDENT: "activity-outdent";
     readonly ACTIVITY_SET_PROGRESS: "activity-set-progress";
-    readonly ACTIVITY_PASTE: "activity-paste";
     readonly SELECTION_TOGGLE: "selection-toggle";
     readonly SELECTION_REPLACE: "selection-replace";
     readonly VISIBILITY_SET: "visibility-set";
     readonly FILTER_SET: "filter-set";
     readonly SORT_SET: "sort-set";
     readonly SIR_SYNC: "sir-sync";
+    readonly SIR_APPROVE: "sir-approve";
     readonly ACTIVITY_LOOKAHEAD_SYNC: "activity-lookahead-sync";
 };
 declare const DISPATCH_ACTION_KINDS: ReadonlyArray<DispatchActionKind>;
@@ -1077,13 +1171,19 @@ declare const REJECTION_REASON: {
     readonly ACTIVITY_NOT_FOUND: "activity_not_found";
     readonly PARENT_NOT_FOUND: "parent_not_found";
     readonly ACTIVITY_IDS_EMPTY: "activity_ids_empty";
+    readonly NO_ACTIVITY_SELECTION: "no_activity_selection";
+    readonly CLIPBOARD_EMPTY: "clipboard_empty";
+    readonly ACTIVITY_PASTE_INVARIANT_FAILED: "activity_paste_invariant_failed";
     readonly ANCHOR_SIBLING_CONFLICT: "anchor_sibling_conflict";
     readonly ANCHOR_SIBLING_NOT_FOUND: "anchor_sibling_not_found";
     readonly ANCHOR_SIBLING_WRONG_PARENT: "anchor_sibling_wrong_parent";
     readonly PARENT_FROZEN_BY_SIR: "parent_frozen_by_sir";
+    readonly SIR_REQUEST_NOT_PENDING: "sir_request_not_pending";
+    readonly PREVIEW_UNSUPPORTED_ACTION: "preview_unsupported_action";
     readonly CANNOT_MOVE_INTO_OWN_DESCENDANT: "cannot_move_into_own_descendant";
     readonly INDENT_NO_ELIGIBLE_SIBLING: "indent_no_eligible_sibling";
     readonly OUTDENT_ROOT_LEVEL_NOT_EDITABLE: "outdent_root_level_not_editable";
+    readonly HIERARCHY_CYCLE: "hierarchy_cycle";
     readonly INVALID_PROGRESS_VALUE: "invalid_progress_value_must_be_0_or_100";
 };
 type DispatchRejectReason = (typeof REJECTION_REASON)[keyof typeof REJECTION_REASON];
@@ -1097,4 +1197,4 @@ declare const DISPATCH_TRACK_EVENT: {
 };
 type DispatchTrackEvent = (typeof DISPATCH_TRACK_EVENT)[keyof typeof DISPATCH_TRACK_EVENT];
 
-export { ACTIVITY_TYPE, type ActivityBaselineSnapshot, type ActivityBatchAction, type ActivityBatchItem, type ActivityBatchLinkInput, type ActivityBatchMode, type ActivityBatchParentReference, type ActivityBatchReference, type ActivityCreter, type ActivityId, type ActivityStatus, type ActivityType, type BackendActivityInput, type BackendCalendarExceptionInput, type BackendCalendarInput, type BackendLinkInput, type BackendScheduleInput, type BackendSectorInput, type BackendShiftInput, type BaselinePoint, type BaselineVersion, type BranchOrderChange, CALENDAR_UNIT, COLUMN, CONSTRAINT_TYPE, CONSTRAINT_TYPE_TO_LABEL, CREATION_KIND, type Calendar, type CalendarId, type CalendarLike, type CalendarUnit, type CalendarWorktime, type ChangeSet, type ChangeSetSource, type ColumnName, type ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CreationOverrides, type CriticalPathResult, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_TRACK_EVENT, type DateGesture, type DateGesturePreview, type DatesBatchVerdict, type DeletedActivitySnapshot, type DeletedLinkSnapshot, type DispatchAction, type DispatchActionKind, type DispatchOptions, type DispatchRejectReason, type DispatchResult, type DispatchTrackEvent, type EditableColumnName, type EntityChange, type ExpectedProgressAdapter, type FilterCriterion, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterOperator, type FilterState, LINK_CODE_TO_TYPE, LINK_TYPE, LINK_TYPE_CODE, type Link, type LinkBatchVerdict, type LinkId, type LinkType, type LinkTypeCode, type LinksBatchOperation, NEW_ACTIVITY_DEFAULTS, type OrderRule, type OrderState, type ParsedInput, type PastedActivityInput, type PastedLinkInput, type PendingRequest, type PersistedEntityIdentity, type PipelineColumnName, type ProjectWorkHours, REJECTION_REASON, ROOT_PARENT_ID, SCHEDULE_CORE_STATUS, STATUS, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleEffect, type SectorMetadata, type StaticActivityDefaults, type StatusCriteria, type TrackingEvent, type UndoOptions, type ViewStateChange, type ViewStatePropChange, WORK_TIME_DIRECTION, type WithProplannerId, type WorkTimeDirection, checkNoUpdatedLinks, computeExpectedProgress, expectedProgressFromBaseline, getActiveBaseline, getUnsavedActivities, isRootParent, normalizeParentKey, parseFromBackend, willRunCriticalPath, yieldToBrowser };
+export { ACTIVITY_TYPE, type ActivityBaselineSnapshot, type ActivityBatchAction, type ActivityBatchItem, type ActivityBatchLinkInput, type ActivityBatchMode, type ActivityBatchParentReference, type ActivityBatchReference, type ActivityCreter, type ActivityId, type ActivityStatus, type ActivityType, type BackendActivityInput, type BackendCalendarExceptionInput, type BackendCalendarInput, type BackendLinkInput, type BackendScheduleInput, type BackendSectorInput, type BackendShiftInput, type BaselinePoint, type BaselineVersion, type BranchOrderChange, CALENDAR_UNIT, COLUMN, CONSTRAINT_TYPE, CONSTRAINT_TYPE_TO_LABEL, CREATION_KIND, type Calendar, type CalendarId, type CalendarLike, type CalendarUnit, type CalendarWorktime, type ChangeSet, type ChangeSetSource, type ColumnName, type ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CreationOverrides, type CriticalPathResult, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_TRACK_EVENT, type DateGesture, type DateGesturePreview, type DatesBatchVerdict, type DeletedActivitySnapshot, type DeletedLinkSnapshot, type DispatchAction, type DispatchActionKind, type DispatchOptions, type DispatchRejectReason, type DispatchResult, type DispatchTrackEvent, type EditableColumnName, type EffectiveGraphAudit, type EntityChange, type ExpectedProgressAdapter, type FilterCriterion, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterOperator, type FilterState, LINK_CODE_TO_TYPE, LINK_TYPE, LINK_TYPE_CODE, type Link, type LinkBatchVerdict, type LinkId, type LinkType, type LinkTypeCode, type LinksBatchOperation, NEW_ACTIVITY_DEFAULTS, type OrderRule, type OrderState, type ParsedInput, type PendingRequest, type PersistedEntityIdentity, type PipelineColumnName, type PreviewDispatchInfo, type ProjectWorkHours, REJECTION_REASON, ROOT_PARENT_ID, SCHEDULE_CORE_STATUS, STATUS, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleEffect, type SectorMetadata, type StaticActivityDefaults, type StatusCriteria, type TrackingEvent, type UndoOptions, type ViewStateChange, type ViewStatePropChange, WORK_TIME_DIRECTION, type WithProplannerId, type WorkTimeDirection, checkNoUpdatedLinks, computeExpectedProgress, expectedProgressFromBaseline, getActiveBaseline, getUnsavedActivities, isRootParent, normalizeParentKey, parseFromBackend, willRunCriticalPath, yieldToBrowser };

package/dist/index.d.ts

@@ -134,6 +134,14 @@ interface CoreActivity {
     recursiveDurationHours: number;
     isCritical: boolean;
     freeSlackHours: number | null;
+    /**
+     * Días de calendario crudos entre start y end (incluye no laborables). Es una
+     * columna del grid, así que la posee el core (decisión del owner 2026-08-03):
+     * estado derivado que el core mantiene al nacer la actividad y al escribir
+     * start/end/type (`internal/state/calendar-duration.ts`), y que por eso fluye
+     * solo por vistas, ChangeSets y undo. Milestone → 0; fechas inválidas → null.
+     */
+    calendarDuration?: number | null;
     expectedProgress: number | null;
     expectedProgressBaseline: number | null;
     status: ActivityStatus | null;
@@ -193,6 +201,8 @@ interface SectorMetadata {
     updateDurationForPrimaveraEndDate?: boolean;
     activityCreter?: ActivityCreter;
     statusCriteria: StatusCriteria;
+    /** Declared by the loader input; never derived from the backend payload. */
+    ganttId: number | null;
 }
 interface EntityChange<T> {
     id: string;
@@ -279,14 +289,22 @@ type NumberOperator = 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'gre
 type DateOperator = 'after' | 'before';
 type MembershipOperator = 'someOf' | 'notSomeOf';
 type FilterOperator = StringOperator | NumberOperator | DateOperator | MembershipOperator;
-type FilterField = 'name' | 'description' | 'customId' | 'correlativeId' | 'uniqueCorrelativeId' | 'progress' | 'durationDays' | 'calendarDuration' | 'cost' | 'usedCost' | 'realCost' | 'workHours' | 'realWorkHours' | 'ponderator' | 'freeSlackDays' | 'totalSlackDays' | 'expectedProgressBaseline' | 'baselineDurationDays' | 'baselineCost' | 'baselineWorkHours' | 'startDate' | 'endDate' | 'constraintDate' | 'baselineStartDate' | 'baselineEndDate' | 'earlyStart' | 'earlyFinish' | 'lateStart' | 'lateFinish' | 'responsableIds' | 'tagIds' | 'status' | 'constraintType' | 'calendarId' | 'subcontractId' | 'isCritical';
+type StringFilterField = 'name' | 'description' | 'customId';
+type NumberFilterField = 'correlativeId' | 'uniqueCorrelativeId' | 'progress' | 'durationDays' | 'calendarDuration' | 'cost' | 'usedCost' | 'realCost' | 'workHours' | 'realWorkHours' | 'ponderator' | 'freeSlackDays' | 'totalSlackDays' | 'expectedProgressBaseline' | 'baselineDurationDays' | 'baselineCost' | 'baselineWorkHours';
+type DateFilterField = 'startDate' | 'endDate' | 'constraintDate' | 'baselineStartDate' | 'baselineEndDate' | 'earlyStart' | 'earlyFinish' | 'lateStart' | 'lateFinish';
+type IdArrayFilterField = 'responsableIds' | 'tagIds';
+type EnumFilterField = 'status' | 'constraintType';
+type ReferenceFilterField = 'calendarId' | 'subcontractId';
+type BooleanFilterField = 'isCritical';
+type FilterField = StringFilterField | NumberFilterField | DateFilterField | IdArrayFilterField | EnumFilterField | ReferenceFilterField | BooleanFilterField;
 type FilterScalarValue = string | number | Date;
-type FilterCriterionValue = FilterScalarValue | ReadonlyArray<string | number>;
-interface FilterCriterion {
-    readonly field: FilterField;
-    readonly operator: FilterOperator;
-    readonly value: FilterCriterionValue;
+type FilterCriterionValue = FilterScalarValue | ReadonlyArray<string | number | boolean>;
+interface Criterion<Field extends FilterField, Operator, Value> {
+    readonly field: Field;
+    readonly operator: Operator;
+    readonly value: Value;
 }
+type FilterCriterion = Criterion<StringFilterField, StringOperator, string> | Criterion<NumberFilterField, NumberOperator, string | number> | Criterion<DateFilterField, DateOperator, string | number | Date> | Criterion<IdArrayFilterField, MembershipOperator, ReadonlyArray<string | number>> | Criterion<EnumFilterField, MembershipOperator, ReadonlyArray<string>> | Criterion<ReferenceFilterField, MembershipOperator, ReadonlyArray<string | number>> | Criterion<BooleanFilterField, MembershipOperator, ReadonlyArray<boolean>>;
 interface FilterDateRange {
     readonly start: Date;
     readonly end: Date;
@@ -341,6 +359,10 @@ type LinksBatchOperation = {
     kind: 'delete';
     linkId: LinkId;
 };
+interface ReconciledActivityProgress {
+    readonly activityId: string;
+    readonly progress: number;
+}
 interface PersistedEntityIdentity {
     readonly id: string;
     readonly proplannerId: number;
@@ -373,9 +395,28 @@ interface ActivityBatchAction {
 }
 
 type DispatchAction = {
+    kind: 'activity-copy';
+    eventSource?: string;
+} | {
+    kind: 'activity-clipboard-clear';
+    eventSource?: string;
+} | {
+    kind: 'activity-paste-copied';
+    destination: {
+        afterSiblingId: ActivityId;
+    };
+    eventSource?: string;
+} | {
     kind: 'persistence-acknowledge';
     activities?: ReadonlyArray<PersistedEntityIdentity>;
     links?: ReadonlyArray<PersistedEntityIdentity>;
+    /**
+     * CP19 (ISSUE-070): valores que el backend normalizo al guardar (hoy solo
+     * progress). El motor los reconcilia — aplica los que difieren, ignora
+     * los iguales — para que el core refleje lo persistido. Sin undo: el
+     * acuse es clear-on-success y el tracker snapshotea despues.
+     */
+    reconciledProgress?: ReadonlyArray<ReconciledActivityProgress>;
 } | {
     kind: 'baseline-apply';
     points: ReadonlyArray<BaselinePoint>;
@@ -454,6 +495,15 @@ type DispatchAction = {
     kind: 'activity-set-progress';
     activityId: ActivityId;
     newValue: 0 | 100;
+    /**
+     * CP15 (ISSUE-066): el origen se DECLARA, no se adivina (mismo patron
+     * que inputUnit). 'action-button' es el unico origen con salvoconducto
+     * de negocio para actividades en Lookahead (espejo del flag
+     * progressChangedByActionButton que consume parseToUpdate en el
+     * backend; guia agents/progreso-lookahead.md). Sin origen declarado
+     * aplica el canEdit completo del pipeline.
+     */
+    origin?: 'action-button';
     eventSource?: string;
 } | {
     kind: 'selection-toggle';
@@ -485,6 +535,13 @@ type DispatchAction = {
     activityId: ActivityId;
     pendingRequests: ReadonlyArray<PendingRequest>;
     eventSource?: string;
+} | {
+    kind: 'sir-approve';
+    activityId: ActivityId;
+    approvedRequestId: string;
+    startDate: unknown;
+    endDate: unknown;
+    eventSource?: string;
 } | {
     kind: 'activity-lookahead-sync';
     activityIds: ReadonlyArray<ActivityId>;
@@ -492,38 +549,32 @@ type DispatchAction = {
     hasLookaheadTasks: boolean;
     acknowledgePersistedLookahead?: boolean;
     eventSource?: string;
-} | {
-    kind: 'activity-paste';
-    destination: {
-        parentId: ActivityId | '0';
-        index: number;
-    } | {
-        afterSiblingId: ActivityId;
-    };
-    referenceActivityId: ActivityId;
-    activities: ReadonlyArray<PastedActivityInput>;
-    links: ReadonlyArray<PastedLinkInput>;
-    eventSource?: string;
 };
 type InternalDispatchAction = DispatchAction | ActivityBatchAction;
-interface PastedActivityInput {
-    readonly originalId: ActivityId;
-    readonly originalParentId: ActivityId | '0';
-    readonly activityId?: ActivityId;
-    readonly overrides: CreationOverrides;
-    readonly baselineSnapshot?: ActivityBaselineSnapshot | null;
-}
-interface PastedLinkInput {
-    readonly source: ActivityId;
-    readonly target: ActivityId;
-    readonly type: LinkType;
-    readonly lag: number;
-    readonly linkId?: LinkId;
-}
 interface DispatchOptions {
     skipAutoSchedule?: boolean;
     skipCriticalPath?: boolean;
     inputUnit?: 'days' | 'hours';
+    /**
+     * Reversible preview mode (SIR). The edit mutates internal state with the
+     * exact same scheduling rules as a real edit (calendar, link/autoschedule
+     * propagation, parents, derived fields), but leaves no session trace: no
+     * save-tracker dirty, no undo entry, no SIR auto-reject effect or
+     * pendingRequestIds mutation, and the schedule revision does not move.
+     * The result carries `preview` with the exact inverse ChangeSet; exiting
+     * the preview is `ScheduleCore.applyPreviewInverse(inverse)`.
+     */
+    preview?: boolean;
+}
+interface PreviewDispatchInfo {
+    /**
+     * Exact inverse of `changes`. Note its `after` images were captured while
+     * the preview edit was still applied; project the ChangeSet RETURNED by
+     * `applyPreviewInverse`, which re-reads them from the restored state.
+     */
+    inverse: ChangeSet;
+    /** `getScheduleRevision()` at the time the preview was computed. */
+    revision: number;
 }
 type DispatchResult = {
     ok: true;
@@ -531,6 +582,8 @@ type DispatchResult = {
     verdicts?: ReadonlyArray<DatesBatchVerdict>;
     activityVerdicts?: ReadonlyArray<DatesBatchVerdict>;
     linkVerdicts?: ReadonlyArray<LinkBatchVerdict>;
+    /** Present only when dispatched with `DispatchOptions.preview`. */
+    preview?: PreviewDispatchInfo;
 } | {
     ok: false;
     reason: string;
@@ -746,6 +799,7 @@ interface ScheduleCoreInput extends BackendScheduleInput {
     clock?: () => Date;
     criticalPathOnLoad?: boolean;
     statusCriteria?: StatusCriteria;
+    ganttId?: number;
     reporter?: ScheduleCoreReporter;
 }
 
@@ -764,12 +818,20 @@ interface DateGesturePreview {
     } | null;
 }
 
+interface EffectiveGraphAudit {
+    readonly activityCount: number;
+    readonly logicalLinkCount: number;
+    readonly effectiveEdgeCount: number;
+    readonly circularComponents: ReadonlyArray<ReadonlyArray<string>>;
+    readonly largestComponentSize: number;
+}
 interface UndoOptions {
     readonly skipCriticalPath?: boolean;
     readonly expectedUndoDepth?: number;
 }
 
 declare class ScheduleCore {
+    private readonly _activityClipboard;
     private _status;
     private readonly coreRuntime;
     private readonly _undo;
@@ -811,9 +873,18 @@ declare class ScheduleCore {
     getActivityView(id: ActivityId): Readonly<CoreActivity> | null;
     createDateGesturePreview(gesture: DateGesture): DateGesturePreview;
     getAllActivitiesView(): ReadonlyArray<Readonly<CoreActivity>>;
+    /**
+     * Read del plan de indent (ISSUE-080): los padres destino DISTINTOS bajo los
+     * que quedarían las actividades si se indentaran ahora. Es exactamente la
+     * planificación que ejecuta el handler (`planIndentMoves`, autoridad única),
+     * expuesta para que la frontera pueda correr el protocolo de conversión a
+     * madre (chequeo backend + modal) ANTES de despachar. Solo lecturas.
+     */
+    getIndentTargetParentIds(activityIds: ReadonlyArray<ActivityId | string>): readonly string[];
     getChildrenView(parentId: ActivityId | '0'): ReadonlyArray<Readonly<CoreActivity>>;
     getLinkView(id: LinkId): Readonly<Link> | null;
     getAllLinksView(): ReadonlyArray<Readonly<Link>>;
+    auditEffectiveGraph(): EffectiveGraphAudit;
     getProperty<Property extends keyof CoreActivity>(activityId: ActivityId, property: Property): CoreActivity[Property] | null;
     getAllIds(): readonly string[];
     forEachActivityId(visit: (id: string) => void): void;
@@ -832,6 +903,26 @@ declare class ScheduleCore {
     getModifiedLinks(): ReadonlyArray<Readonly<Link>>;
     getModifiedActivities(): ReadonlyArray<Readonly<CoreActivity>>;
     hasUnsavedChanges(): boolean;
+    /**
+     * Read-only view of the internal schedule revision. It moves once per
+     * substantive CANONICAL mutation (dispatch, undo, redo). It does NOT move
+     * for a preview dispatch nor for `applyPreviewInverse`: comparing the value
+     * captured in `PreviewDispatchInfo.revision` against the current one
+     * answers "did the schedule change while the preview was open".
+     */
+    getScheduleRevision(): number;
+    /**
+     * Exit channel for a preview dispatch (`DispatchOptions.preview`): applies
+     * the inverse ChangeSet the preview returned, restoring the canonical
+     * state exactly. Like the preview itself it leaves no session trace: no
+     * save-tracker dirty, no undo entry, no effects, and the schedule revision
+     * does not move (see `getScheduleRevision`).
+     *
+     * Returns the ChangeSet to project to the view layer: the same changes as
+     * `inverse`, but with `after` images re-read from the restored state (the
+     * ones inside `inverse` were captured while the preview edit was applied).
+     */
+    applyPreviewInverse(inverse: ChangeSet): Promise<ChangeSet>;
     getDeletedActivitiesSinceLastSave(): ReadonlyArray<Readonly<DeletedActivitySnapshot>>;
     getDeletedLinksSinceLastSave(): ReadonlyArray<Readonly<DeletedLinkSnapshot>>;
     private _enqueue;
@@ -1029,6 +1120,9 @@ declare const DEFAULT_HOURS_PER_DAY = 8;
 
 type DispatchActionKind = DispatchAction['kind'];
 declare const DISPATCH_ACTION_KIND: {
+    readonly ACTIVITY_CLIPBOARD_CLEAR: "activity-clipboard-clear";
+    readonly ACTIVITY_COPY: "activity-copy";
+    readonly ACTIVITY_PASTE_COPIED: "activity-paste-copied";
     readonly PERSISTENCE_ACKNOWLEDGE: "persistence-acknowledge";
     readonly BASELINE_APPLY: "baseline-apply";
     readonly PONDERATOR_CRITERION_SET: "ponderator-criterion-set";
@@ -1046,13 +1140,13 @@ declare const DISPATCH_ACTION_KIND: {
     readonly ACTIVITY_INDENT: "activity-indent";
     readonly ACTIVITY_OUTDENT: "activity-outdent";
     readonly ACTIVITY_SET_PROGRESS: "activity-set-progress";
-    readonly ACTIVITY_PASTE: "activity-paste";
     readonly SELECTION_TOGGLE: "selection-toggle";
     readonly SELECTION_REPLACE: "selection-replace";
     readonly VISIBILITY_SET: "visibility-set";
     readonly FILTER_SET: "filter-set";
     readonly SORT_SET: "sort-set";
     readonly SIR_SYNC: "sir-sync";
+    readonly SIR_APPROVE: "sir-approve";
     readonly ACTIVITY_LOOKAHEAD_SYNC: "activity-lookahead-sync";
 };
 declare const DISPATCH_ACTION_KINDS: ReadonlyArray<DispatchActionKind>;
@@ -1077,13 +1171,19 @@ declare const REJECTION_REASON: {
     readonly ACTIVITY_NOT_FOUND: "activity_not_found";
     readonly PARENT_NOT_FOUND: "parent_not_found";
     readonly ACTIVITY_IDS_EMPTY: "activity_ids_empty";
+    readonly NO_ACTIVITY_SELECTION: "no_activity_selection";
+    readonly CLIPBOARD_EMPTY: "clipboard_empty";
+    readonly ACTIVITY_PASTE_INVARIANT_FAILED: "activity_paste_invariant_failed";
     readonly ANCHOR_SIBLING_CONFLICT: "anchor_sibling_conflict";
     readonly ANCHOR_SIBLING_NOT_FOUND: "anchor_sibling_not_found";
     readonly ANCHOR_SIBLING_WRONG_PARENT: "anchor_sibling_wrong_parent";
     readonly PARENT_FROZEN_BY_SIR: "parent_frozen_by_sir";
+    readonly SIR_REQUEST_NOT_PENDING: "sir_request_not_pending";
+    readonly PREVIEW_UNSUPPORTED_ACTION: "preview_unsupported_action";
     readonly CANNOT_MOVE_INTO_OWN_DESCENDANT: "cannot_move_into_own_descendant";
     readonly INDENT_NO_ELIGIBLE_SIBLING: "indent_no_eligible_sibling";
     readonly OUTDENT_ROOT_LEVEL_NOT_EDITABLE: "outdent_root_level_not_editable";
+    readonly HIERARCHY_CYCLE: "hierarchy_cycle";
     readonly INVALID_PROGRESS_VALUE: "invalid_progress_value_must_be_0_or_100";
 };
 type DispatchRejectReason = (typeof REJECTION_REASON)[keyof typeof REJECTION_REASON];
@@ -1097,4 +1197,4 @@ declare const DISPATCH_TRACK_EVENT: {
 };
 type DispatchTrackEvent = (typeof DISPATCH_TRACK_EVENT)[keyof typeof DISPATCH_TRACK_EVENT];
 
-export { ACTIVITY_TYPE, type ActivityBaselineSnapshot, type ActivityBatchAction, type ActivityBatchItem, type ActivityBatchLinkInput, type ActivityBatchMode, type ActivityBatchParentReference, type ActivityBatchReference, type ActivityCreter, type ActivityId, type ActivityStatus, type ActivityType, type BackendActivityInput, type BackendCalendarExceptionInput, type BackendCalendarInput, type BackendLinkInput, type BackendScheduleInput, type BackendSectorInput, type BackendShiftInput, type BaselinePoint, type BaselineVersion, type BranchOrderChange, CALENDAR_UNIT, COLUMN, CONSTRAINT_TYPE, CONSTRAINT_TYPE_TO_LABEL, CREATION_KIND, type Calendar, type CalendarId, type CalendarLike, type CalendarUnit, type CalendarWorktime, type ChangeSet, type ChangeSetSource, type ColumnName, type ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CreationOverrides, type CriticalPathResult, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_TRACK_EVENT, type DateGesture, type DateGesturePreview, type DatesBatchVerdict, type DeletedActivitySnapshot, type DeletedLinkSnapshot, type DispatchAction, type DispatchActionKind, type DispatchOptions, type DispatchRejectReason, type DispatchResult, type DispatchTrackEvent, type EditableColumnName, type EntityChange, type ExpectedProgressAdapter, type FilterCriterion, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterOperator, type FilterState, LINK_CODE_TO_TYPE, LINK_TYPE, LINK_TYPE_CODE, type Link, type LinkBatchVerdict, type LinkId, type LinkType, type LinkTypeCode, type LinksBatchOperation, NEW_ACTIVITY_DEFAULTS, type OrderRule, type OrderState, type ParsedInput, type PastedActivityInput, type PastedLinkInput, type PendingRequest, type PersistedEntityIdentity, type PipelineColumnName, type ProjectWorkHours, REJECTION_REASON, ROOT_PARENT_ID, SCHEDULE_CORE_STATUS, STATUS, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleEffect, type SectorMetadata, type StaticActivityDefaults, type StatusCriteria, type TrackingEvent, type UndoOptions, type ViewStateChange, type ViewStatePropChange, WORK_TIME_DIRECTION, type WithProplannerId, type WorkTimeDirection, checkNoUpdatedLinks, computeExpectedProgress, expectedProgressFromBaseline, getActiveBaseline, getUnsavedActivities, isRootParent, normalizeParentKey, parseFromBackend, willRunCriticalPath, yieldToBrowser };
+export { ACTIVITY_TYPE, type ActivityBaselineSnapshot, type ActivityBatchAction, type ActivityBatchItem, type ActivityBatchLinkInput, type ActivityBatchMode, type ActivityBatchParentReference, type ActivityBatchReference, type ActivityCreter, type ActivityId, type ActivityStatus, type ActivityType, type BackendActivityInput, type BackendCalendarExceptionInput, type BackendCalendarInput, type BackendLinkInput, type BackendScheduleInput, type BackendSectorInput, type BackendShiftInput, type BaselinePoint, type BaselineVersion, type BranchOrderChange, CALENDAR_UNIT, COLUMN, CONSTRAINT_TYPE, CONSTRAINT_TYPE_TO_LABEL, CREATION_KIND, type Calendar, type CalendarId, type CalendarLike, type CalendarUnit, type CalendarWorktime, type ChangeSet, type ChangeSetSource, type ColumnName, type ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CreationOverrides, type CriticalPathResult, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_TRACK_EVENT, type DateGesture, type DateGesturePreview, type DatesBatchVerdict, type DeletedActivitySnapshot, type DeletedLinkSnapshot, type DispatchAction, type DispatchActionKind, type DispatchOptions, type DispatchRejectReason, type DispatchResult, type DispatchTrackEvent, type EditableColumnName, type EffectiveGraphAudit, type EntityChange, type ExpectedProgressAdapter, type FilterCriterion, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterOperator, type FilterState, LINK_CODE_TO_TYPE, LINK_TYPE, LINK_TYPE_CODE, type Link, type LinkBatchVerdict, type LinkId, type LinkType, type LinkTypeCode, type LinksBatchOperation, NEW_ACTIVITY_DEFAULTS, type OrderRule, type OrderState, type ParsedInput, type PendingRequest, type PersistedEntityIdentity, type PipelineColumnName, type PreviewDispatchInfo, type ProjectWorkHours, REJECTION_REASON, ROOT_PARENT_ID, SCHEDULE_CORE_STATUS, STATUS, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleEffect, type SectorMetadata, type StaticActivityDefaults, type StatusCriteria, type TrackingEvent, type UndoOptions, type ViewStateChange, type ViewStatePropChange, WORK_TIME_DIRECTION, type WithProplannerId, type WorkTimeDirection, checkNoUpdatedLinks, computeExpectedProgress, expectedProgressFromBaseline, getActiveBaseline, getUnsavedActivities, isRootParent, normalizeParentKey, parseFromBackend, willRunCriticalPath, yieldToBrowser };