Interface: LessonSignalTriggerBuilder

Defined in: builders/lesson-signal-trigger-builder.ts:7

Fluent configurator for lesson promotion signal triggers ($t in .emitSignalWhen(sig, $t => ..., mapper)).

Configures the minimum lifetime clean passes, maximum lifetime violations, and cooldown window in hours required before emitting a rule-promotion signal for a high-leverage lesson.

Methods

build()

build(): object;

Defined in: builders/lesson-signal-trigger-builder.ts:48

Compiles and returns the frozen threshold numbers for this promotion trigger.

Returns an immutable object containing minCleanPasses, maxViolations, and cooldownHours.

Returns

object

Frozen trigger thresholds.

Name	Type	Defined in
cooldownHours	number	builders/lesson-signal-trigger-builder.ts:51
maxViolations	number	builders/lesson-signal-trigger-builder.ts:50
minCleanPasses	number	builders/lesson-signal-trigger-builder.ts:49

---

cooldownHours()

cooldownHours(hours): LessonSignalTriggerBuilder;

Defined in: builders/lesson-signal-trigger-builder.ts:39

Sets the cooldown window in hours before re-emitting the signal for the same lesson.

Prevents duplicate promotion signals from firing repeatedly within hours hours.

Parameters

Parameter	Type	Description
hours	number	Positive cooldown duration in hours.

Returns

LessonSignalTriggerBuilder

New immutable signal trigger builder.

---

maxViolations()

maxViolations(count): LessonSignalTriggerBuilder;

Defined in: builders/lesson-signal-trigger-builder.ts:28

Sets the maximum lifetime violated count allowed to emit the promotion signal.

Lessons with more than count lifetime violations are excluded from promotion signal emission.

Parameters

Parameter	Type	Description
count	number	Maximum allowed lifetime violation count.

Returns

LessonSignalTriggerBuilder

New immutable signal trigger builder.

---

minCleanPasses()

minCleanPasses(count): LessonSignalTriggerBuilder;

Defined in: builders/lesson-signal-trigger-builder.ts:17

Sets the minimum lifetime clean_pass count required to emit the promotion signal.

Lessons must accumulate at least count clean passes before becoming eligible for promotion.

Parameters

Parameter	Type	Description
count	number	Minimum lifetime clean pass count.

Returns

LessonSignalTriggerBuilder

New immutable signal trigger builder.