> ## Documentation Index
> Fetch the complete documentation index at: https://docs.erna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# mustAssign

```ts theme={null}
function mustAssign(opts?): RuleEntry<"must-assign", {
  appliesTo?: string | string[];
}>;
```

Softly prefers that targeted members appear at least once per scheduling week
without making infeasible schedules fail.

## Parameters

<ResponseField name="appliesTo" type="string | string[]" />

## Returns

```ts theme={null}
RuleEntry\<"must-assign", {
  appliesTo?: string | string[];
}\>
```

Adds a strong soft requirement that each targeted member has at least one
assignment per scheduling week.

Always a soft constraint (HIGH priority internally). The schedule still
generates when a member genuinely cannot be placed (e.g., full week of
absences). Violations surface as validation warnings with distinct
messaging from [minDaysPerWeek](minDaysPerWeek). Priority is not configurable;
the rule name communicates the intent.