Commands
publish-template-migration
Section titled “publish-template-migration”Publishes a migration bundle release from a merged template PR.
publish-template-migration 123Environment:
| Name | Required | Description |
|---|---|---|
GITHUB_REPOSITORY | Yes | Template repository in OWNER/REPO form. |
GITHUB_TOKEN | Yes | Token with release write access and PR read access. |
TEMPLATE_SYNC_GENERATE_SUMMARY | No | Set to true, 1, yes, or on to generate one reusable migration summary during publishing. |
OPENAI_API_KEY | Yes when TEMPLATE_SYNC_GENERATE_SUMMARY is enabled | API key for summary generation. |
OPENAI_MODEL | No | Summary model. Defaults to gpt-5.5. |
TEMPLATE_SYNC_SUMMARY_MOCK_RESPONSE | No | JSON summary response used for local or test runs instead of OpenAI. |
subscriber-template-sync
Section titled “subscriber-template-sync”Discovers the newest migration and opens a draft PR in a subscriber repository.
subscriber-template-syncEnvironment:
| Name | Required | Description |
|---|---|---|
GITHUB_REPOSITORY | Yes | Subscriber repository in OWNER/REPO form. |
TEMPLATE_SYNC_BOT_TOKEN | Yes | Bot token for subscriber repository writes. |
TEMPLATE_SYNC_DEFAULT_UPSTREAM_REPO | Yes | Default template repository in OWNER/REPO form. |
TEMPLATE_SYNC_UPSTREAM_READ_TOKEN | No | Read token for private upstream releases. |
handle-template-sync-command
Section titled “handle-template-sync-command”Handles /template-sync comments on migration PRs.
handle-template-sync-commandEnvironment:
| Name | Required | Description |
|---|---|---|
GITHUB_REPOSITORY | Yes | Subscriber repository in OWNER/REPO form. |
GITHUB_EVENT_PATH | Yes | GitHub event payload path. |
TEMPLATE_SYNC_BOT_TOKEN | Yes | Bot token for checkout, push, comments, and variables. |
TEMPLATE_SYNC_DEFAULT_UPSTREAM_REPO | Yes | Default template repository. |
OPENAI_API_KEY | Yes for approve/revise | API key for generation. |
OPENAI_MODEL | No | Generation model. Defaults to gpt-5.5. |
TEMPLATE_SYNC_GENERATION_MOCK_RESPONSE | No | JSON plan used for local or test runs instead of OpenAI. OPENAI_API_KEY is still required for approve/revise so missing production configuration fails clearly. |