Add deployment order scope

[GrantBirki]

Adds an opt-in deployment_order_scope: branch-deploy mode that makes enforced deployment order consider only deployments whose payload identifies them as Branch Deploy. The existing all behavior remains the default, and the exact candidate SHA passed the issue #492 sandbox reproduction after the default mode reproduced the failure.

---

fixes: #492

[Copilot]

Pull request overview

Adds opt-in Branch Deploy–scoped deployment-order checks while preserving existing behavior by default.

Changes:

• Adds and validates the deployment_order_scope input.
• Filters deployment history by Branch Deploy payload when requested.
• Updates documentation, tests, acceptance coverage, and the bundled action.

Reviewed changes

Copilot reviewed 21 out of 23 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
action.yml	Declares the new input and default.
README.md	Documents input usage.
docs/enforced-deployment-order.md	Explains scope behavior and configuration.
docs/deployment-payload.md	Documents the payload marker.
docs/v11-to-v12-upgrade-guide.md	Clarifies scoped order semantics.
src/action-io.ts	Registers the input key.
src/types.ts	Defines the scope type and input field.
src/functions/inputs.ts	Parses and validates scope values.
src/functions/deployment.ts	Selects scoped deployment history.
src/functions/deployment-operation.ts	Passes scope into order enforcement.
src/functions/valid-deployment-order.ts	Applies scope during prerequisite checks.
src/functions/help.ts	Reports configured scope in help output.
tools/acceptance/index.ts	Adds end-to-end scope scenarios.
__tests__/action-contract.test.ts	Verifies the public input contract.
__tests__/schemas/action.schema.yml	Extends action metadata validation.
__tests__/types.test.ts	Verifies literal registry types.
__tests__/test-helpers.ts	Adds the default test input.
__tests__/main.test.ts	Tests validation and scope propagation.
__tests__/functions/deployment.test.ts	Tests filtered deployment selection.
__tests__/functions/valid-deployment-order.test.ts	Tests scoped order enforcement.
__tests__/functions/help.test.ts	Tests scope-specific help text.
dist/index.js	Updates the committed runtime bundle.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.