feat(workflow-executor): pin Trigger Action source by stable step id (PRD-469)

[Scra3]

What

Executor side of the Deterministic Trigger Action epic (PRD-469). The trigger-action executor resolved its source record by a runtime selectedRecordStepIndex (breaks on revise). Migrate to the stable selectedRecordStepId standardized by Load Related Record.

Changes

• step-definition: TriggerAction.preRecordedArgs now uses selectedRecordStepId (revise-safe BPMN step id / workflow-start sentinel)
• Lifted resolveSourceRecordRef from load-related-record-step-executor into the shared RecordStepExecutor base (trigger-action is now a second caller → extract); load-related inherits it
• trigger-action: deterministic source via stable id; a source Load Related Record step that loaded nothing → SourceRecordMissingError (no AI fallback, no action triggered)
• legacy steps (no selectedRecordStepId) keep AI record selection; actionName pinning unchanged
• generalized SourceRecordMissingError wording (shared by load-related + trigger-action)

Tests

trigger-action: pinned workflow-start source + action → executes without AI (exact executeAction args asserted); pinned source that loaded nothing → error, no action. All 246 executor tests pass.

Stacked on feature/prd-553-executor-filters-load-related (PRD-471 not yet merged).

fixes PRD-598

Note

Pin Trigger Action source record by stable step id instead of index

• Replaces selectedRecordStepIndex (number) with selectedRecordStepId (string) in TriggerActionStepDefinitionSchema.preRecordedArgs to reference a step by its stable BPMN id or WORKFLOW_START_STEP_ID.
• When selectedRecordStepId is present, TriggerRecordActionStepExecutor.handleFirstCall resolves the source record deterministically via a new resolveSourceRecordRef method on the base RecordStepExecutor, skipping AI-based selection entirely.
• resolveSourceRecordRef walks the live execution path to find the latest matching LoadRelatedRecord step, returns its loaded record, or throws SourceRecordMissingError if the step loaded nothing.
• Legacy steps without selectedRecordStepId continue to use AI-based selection as before.
• Behavioral Change: steps that previously fell back to AI selection when given an index will now error with SourceRecordMissingError if the pinned source step exists but loaded no record.

^{Macroscope summarized 3a96144.}

[linear-code]

PRD-598

PRD-469

[qltysh]

Coverage Impact

This PR will not change total coverage.

Modified Files with Diff Coverage (3)

Rating	File	% Diff	Uncovered Line #s
	...ow-executor/src/executors/load-related-record-step-executor.ts	100.0%
	packages/workflow-executor/src/executors/record-step-executor.ts	100.0%
	...-executor/src/executors/trigger-record-action-step-executor.ts	100.0%
	Total	100.0%

🚦 See full report on Qlty Cloud »

🛟 Help

• Diff Coverage: Coverage for added or modified lines of code (excludes deleted files). Learn more.

• Total Coverage: Coverage for the whole repository, calculated as the sum of all File Coverage. Learn more.

• File Coverage: Covered Lines divided by Covered Lines plus Missed Lines. (Excludes non-executable lines including blank lines and comments.)

  • Indirect Changes: Changes to File Coverage for files that were not modified in this PR. Learn more.