Orca ORCA v0.174.2

Tools

CLI tools available under orca tools. This list is auto-discovered from the command tree.

mock-compliant-release

Create a mock compliant production release PR
Create a mock compliant production release PR.

Finds the latest GitHub release of a source repository, then creates a
production deployment PR in a GitOps deployments repository whose body carries
the Impact Review form, changelog, and compliance markers — exactly what the
real compliant release workflow would produce. Runs standalone: only a GitHub
token is required (no Orca server, DBOS, database, or GitHub App).

The deployed service defaults to a clearly-mock name ("the-silver-bullet") so
the PR is not mistaken for a real production deploy, while the source repo's
real releases still provide the version (and, with --real-changelog, the
changelog).

By default the changelog is synthesized from mock Linear issues created in the
Platform team (each carrying a conventional-commit prefix + safety markers), so the
compliance CI validates cleanly. Provide --linear-key to enable this. Use
--real-changelog to deploy with the real aggregated changelog instead (no Linear
calls).

The PR is created with auto-merge enabled but is never merged unless a human
approves it. Use --dry-run to preview the planned PR without making any
changes.

Use the "cleanup" subcommand to cancel the mock Linear issues a PR references.
Subcommands
cleanup Cancel the mock Linear issues referenced by a PR
Cancel the mock Linear issues referenced by a production deployment PR.

Fetches the PR at the given URL, extracts the bracketed Linear IDs from its
body, and cancels each issue — but only if it carries this tool's mock safety
markers (a [mock-compliant-release] title prefix and a description sentinel).
Issues missing either marker are skipped and left untouched, so pointing this at
the wrong (real) PR is a no-op.
--base-url — GitHub API base URL (defaults to https://api.github.com; primarily for tests)
--github-token — GitHub API token; defaults to $GITHUB_TOKEN
--linear-endpoint — Linear GraphQL endpoint (defaults to https://api.linear.app/graphql; primarily for tests)
--linear-key — Linear API key; defaults to $LINEAR_API_KEY (required)
--linear-team (default: PLA) — Linear team key the issues belong to (default PLA = Platform)
--pr-url — URL of the production deployment PR whose mock Linear issues should be cancelled (required)