feat(utils): introduce ExecuteOnChainSequenceAndMerge

[graham-chainlink]

Introduced ExecuteOnChainSequenceAndMerge util which originated from ccip tooling api here

This utils allows user to execute multiple sequence and accumulate their results into an object call OnChainOutput

import (
    "github.com/smartcontractkit/chainlink-deployments-framework/changeset/sequenceutils"
)
// Run multiple sequences and accumulate into one OnChainOutput.
var agg sequenceutils.OnChainOutput
agg, err = sequenceutils.ExecuteOnChainSequenceAndMerge(
    env.OperationsBundle, deps, deploySeq, deployInput, agg,
)
if err != nil {
    return agg, err
}
agg, err = sequenceutils.ExecuteOnChainSequenceAndMerge(
    env.OperationsBundle, deps, configureSeq, configureInput, agg,
)
if err != nil {
    return agg, err // prior merges preserved in agg
}

JIRA: https://smartcontract-it.atlassian.net/browse/CLD-2464

[changeset-bot]

🦋 Changeset detected

Latest commit: d169a8e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
chainlink-deployments-framework	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Copilot]

Pull request overview

This PR introduces a small sequenceutils helper for running multiple operations.Sequence instances that return OnChainOutput and accumulating their results into a single OnChainOutput, along with unit tests validating key merge behaviors.

Changes:

• Added ExecuteOnChainSequenceAndMerge utility to execute a sequence and merge its OnChainOutput into an accumulator.
• Added tests covering success, execution failure preservation, non-deduping behavior, and env metadata conflict behavior.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
changeset/sequenceutils/merge.go	Adds the merge utility for aggregating OnChainOutput across multiple sequence executions.
changeset/sequenceutils/merge_test.go	Adds unit tests for merge behavior and error handling.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

[cl-sonarqube-production]

Quality Gate passed

Issues
0 New issues
0 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube

[jkongie]

I'm finding the ordering of arguments here unintiutive (seq, deps, input would be better to me) but I assume that this keeps it backwards compatible.

Not a blocker though

[graham-chainlink]

ah yes, the sequence generic type ordering has always been like this

type Sequence[IN, OUT, DEP any] struct {
	def     Definition
	handler SequenceHandler[IN, OUT, DEP]
}