feat(cli): add --process-type option to override process execution mode

[Copilot]

Summary

Adds --process-type CLI option to plugboard process run for switching between LocalProcess and RayProcess execution modes, overriding YAML configuration.

Changes

• CLI Enhancement

  • Added --process-type {local|ray} option to run command
  • Validates input, exits with clear error on invalid values

• Override Logic (_override_process_type())

  • Updates process type, connector builder, and state backend atomically using model_copy()
  • When switching to ray: LocalProcess → RayProcess, AsyncioConnector → RayConnector, DictStateBackend → RayStateBackend
  • When switching to local: reverses the above transformations
  • Preserves connector builder args during override
  • Only modifies incompatible components (e.g., won't change RayConnector when already on Ray)

• Tests

  • Unit tests for local override, ray override, and invalid input handling

Example usage:

# Override any YAML config to run locally
plugboard process run ray-config.yaml --process-type local

# Force Ray execution regardless of YAML
plugboard process run local-config.yaml --process-type ray

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• astral.sh
  • Triggering command: /usr/bin/curl curl -LsSf REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>CLI option to switch between local and Ray process</issue_title>
<issue_description>See #49 (comment)

We would like to be able to switch between Local and Ray processes from the CLI.</issue_description>

<agent_instructions>We need an option on the CLI to switch between RayProcess and LocalProcess by overriding whatever is specified in the input YAML. Note that when changing from local to ray, it is not enough just to change the Process type: you will also need to make sure the connector_builder and State type are changed if they are specified in the YAML and not compatible with Ray.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes CLI option to switch between local and Ray process #60

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.