feat(workflow-executor): PRD-553 apply build-time filters on 1–n Load Related Record

[Scra3]

Context

Filter half of PRD-553 (executor), stacked on #1688. Applies the build-time filter the editor sets on a 1–n relation, narrowing the candidate records.

What

• preRecordedArgs.filters added to the executor step-definition schema (z.unknown().optional() — trusted build config, forwarded verbatim; the agent validates it).
• Threaded through GetRelatedDataQuery → adapter → agent-client SelectOptions.filters on the 1–n list fetch (fetchRelatedData). The agent-client already supports filters; this is pure wiring.
• xToOne untouched: it goes through getSingleRelatedData (no list to filter) → 1–1 relations never receive a filter, per PRD.
• Port stays agnostic (filters?: unknown); the adapter casts to the agent-client type at the single call site.

Tests

+1 executor test: HasMany with preRecordedArgs.filters → getRelatedData called with that filters. 1085/1085 pass.

Base = PRD-552 branch (stacked). Retarget on merge.

fixes PRD-553

🤖 Generated with Claude Code

Note

Apply build-time filters to 1–n Load Related Record step execution

• Adds an optional filters field to LoadRelatedRecordStepDefinitionSchema.preRecordedArgs in step-definition.ts, accepted as z.unknown() and validated by the agent.
• Extends GetRelatedDataQuery in agent-port.ts with an optional filters?: unknown field and forwards it through AgentClientAgentPort.getRelatedData to the agent client's relation().list() call.
• Updates load-related-record-step-executor.ts to include preRecordedArgs.filters in the getRelatedData payload when present.
• Behavioral Change: related record candidates for 1–n steps will now be filtered at fetch time when filters are defined, changing the returned rows compared to the previous unfiltered behavior.

^{Macroscope summarized d4a72ec.}

[linear-code]

PRD-553

[qltysh]

Coverage Impact

This PR will not change total coverage.

🚦 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.