feat: add predecessors package logic ported from create-proposal-pr composite action

[ecPablo]

We are moving the files related to opcounts and predecessor calculation to this package to allow better reusability across all the GH workflows as this is something that might be used in different mcms related pipelines.

Main API's Exposed

Opcount computation related

ComputeHighestOpCountsFromPredecessors: Returns the newly computed opcounts for the given PR and list of predecessors.

func ComputeHighestOpCountsFromPredecessors(
	lggr logger.Logger,
	newProposalData ProposalsOpData,
	predecessors []PRView,
) map[mcmstypes.ChainSelector]uint64

ApplyHighestOpCountsToProposal: Applies the new opcounts provided to the proposal and saves the proposal to the filesystem

func ApplyHighestOpCountsToProposal(
	lggr logger.Logger,
	proposalPath string,
	newOpCounts map[mcmstypes.ChainSelector]uint64,
) 

ParseProposalOpsData: small helper to extract just the opcount related information into an easier to access struct.

func ParseProposalOpsData(ctx context.Context, filePath string) (ProposalsOpData, error)

[changeset-bot]

🦋 Changeset detected

Latest commit: c91ddcc

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 adds predecessor and operation count calculation logic to the proposalutils package, porting functionality from a composite GitHub action to improve reusability across MCMS-related pipelines. The implementation provides tools for finding proposal PR dependencies, computing operation counts, and managing proposal metadata.

Key changes:

• GitHub API integration for searching and analyzing proposal PRs with dependency resolution
• Operation count computation logic that calculates highest opcounts from predecessor PRs
• Proposal graph building using topological sorting to establish PR dependencies based on shared MCM addresses

Reviewed Changes

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

Show a summary per file

File	Description
go.mod	Adds github.com/google/go-github/v71 dependency for GitHub API integration
experimental/proposalutils/predecessors/types.go	Defines core data structures for PR views, MCM operation data, and context
experimental/proposalutils/predecessors/types_test.go	Unit tests for the EndingOpCount calculation method
experimental/proposalutils/predecessors/proposal_graph.go	Implements dependency graph building and topological sorting for PR relationships
experimental/proposalutils/predecessors/proposal_graph_test.go	Comprehensive tests for graph construction and MCM relationship detection
experimental/proposalutils/predecessors/predecessor.go	Core logic for computing opcounts and applying them to proposals
experimental/proposalutils/predecessors/predecessor_test.go	Tests for opcount computation, proposal parsing, and file operations
experimental/proposalutils/predecessors/github_ops.go	GitHub API client implementation for PR searching and content retrieval
experimental/proposalutils/predecessors/github_ops_test.go	Tests for GitHub API integration with mock HTTP servers
.changeset/mighty-ways-kick.md	Changeset documentation for the minor version bump

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[ChrisAmora]

LGTM

[Copilot]

Pull Request Overview

Copilot reviewed 10 out of 11 changed files in this pull request and generated no new comments.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Pull Request Overview

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

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Pull Request Overview

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

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Pull Request Overview

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

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Pull Request Overview

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

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Pull Request Overview

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

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[cl-sonarqube-production]

Quality Gate passed

Issues
0 New issues
0 Fixed issues
0 Accepted issues

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

See analysis details on SonarQube