Prefer orchestrate command

[frostebite]

Summary

• adds game-ci orchestrate as the preferred provider-backed job command
• keeps game-ci remote run and game-ci remote build as hidden backwards-compatible aliases
• renames the Unity provider-backed command implementation to orchestrate terminology
• updates README/help wording so provider jobs are not framed as build-only

Tests

• bun test
• bun run build

[coderabbitai]

Warning

Rate limit exceeded

@frostebite has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 49 minutes and 50 seconds before requesting another review.

To continue reviewing without waiting, purchase usage credits in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 87282532-d178-49f6-8225-5bbff8098af9

📥 Commits

Reviewing files that changed from the base of the PR and between 857dac1 and 7f2dd30.

📒 Files selected for processing (11)

• README.md
• package.json
• src/cli-commands.ts
• src/cli.test.ts
• src/command-options/remote-options.ts
• src/command/orchestrate/unity-orchestrate-command.ts
• src/plugin/builtin/unity-plugin.ts
• src/plugin/cli-protocol-plugin.ts
• src/plugin/plugin-interface.ts
• test-projects/godot-minimal/project.godot
• test-projects/godot-minimal/scenes/Main.tscn

📝 Walkthrough

Walkthrough

The PR updates GameCI CLI terminology from "remote build" to "remote run," aligning with a new orchestrator-plugin workflow pattern. The class UnityRemoteBuildCommand is renamed to UnityRemoteRunCommand, CLI wiring is restructured to offer run as the primary command with build as a legacy alias, and documentation is updated throughout to reflect this shift.

Changes

Remote Run Terminology and Wiring Transition

Layer / File(s)	Summary
Class & Command Definitions src/command/remote/unity-remote-run-command.ts	UnityRemoteBuildCommand is renamed to UnityRemoteRunCommand; log messages and docblocks updated from "remote build" to "remote job" terminology.
CLI Command Structure src/cli-commands.ts	Remote command description updated to "Run provider-backed jobs outside the local process"; new run subcommand added with build as a backwards-compatible alias.
Option Documentation src/command-options/remote-options.ts	Header and providerStrategy description updated from "remote build" to "remote provider" and "remote jobs" terminology.
Plugin Wiring src/plugin/builtin/unity-plugin.ts, src/plugin/cli-protocol-plugin.ts, src/plugin/plugin-interface.ts	Unity plugin updated to wire UnityRemoteRunCommand for both run and build subcommands; plugin interface and protocol documentation reflect new "remote run" terminology.
Tests & Configuration src/cli.test.ts, package.json	Tests added for remote run command selection and remote build alias; package description updated to "automation for game engines."
User-Facing Documentation README.md	Introductory branding updated from "Build automation" to "Automation for game engines"; usage examples and orchestrator-plugin invocations updated to use remote run instead of orchestrate; new AWS provider example added under External plugins section.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 The remote build's now a run, hooray!
Orchestrator plugins light the way,
Terminology dances from cloud to sky,
Build aliases wave as they flutter by. 🚀

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The PR description covers the main changes and test commands, but doesn't fully follow the template structure with explicit 'Changes' section or completed 'Readme' and 'Tests' checklist items.	Consider restructuring the description to match the template with a 'Changes' bulleted list and completing the checklist items to indicate what was updated.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Prefer remote run command' accurately summarizes the main change—introducing remote run as the preferred command while maintaining backward compatibility with remote build.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/remote-run-command

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}