Interface: Preference

@kortexya/reasoninglayer / Scheduling / Preference

Interface: Preference

Defined in: src/types/scheduling.ts:199

A soft preference: bias the optimizer toward (or against) assigning agentId to cell (day, shift).

Remarks

score contributes to the optimizer’s objective when the cell is assigned in the chosen schedule. Positive values pull the optimizer toward the cell; negative values push it away.

Preferences targeting a cell that is already pinned, blocked by a day-off, restricted-to-shift, or otherwise structurally fixed are silently ignored — those cells are not the optimizer’s choice to make.

Common encodings:

“Aisha prefers morning shifts” → score = +5 on every (aisha, day, morning) pair
“Avoid weekend assignments” → score = -3 on every (*, sat|sun, *) pair
“Honor day-off requests” → score = -100 on (agent, requested_off_day, *) (large negative penalty — respects the request when feasible, lets the engine decide when not)

Properties

agentId

agentId: string

Defined in: src/types/scheduling.ts:200

day

day: number

Defined in: src/types/scheduling.ts:201

score

score: number

Defined in: src/types/scheduling.ts:207

Score added to the objective when this cell is assigned in the chosen schedule. Positive = preferred, negative = avoided.

shift

shift: number

Defined in: src/types/scheduling.ts:202