Tools
CLI tools available under orca tools. This list is auto-discovered from the command tree.
Commands
mock-compliant-release
Create a mock compliant production release PRCreate 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)