Skip to main content

Eigenoid (Automation Bot)

CI/CD bot for the eigenoid org. Comments on issues, closes issues, and manages labels in repository lifecycle workflows.

In short

Credential-only bot (Type A) -- it has no code of its own. It exists so that automated comments on issues appear as eigenoid-automation-bot[bot] instead of github-actions[bot], giving the automation a recognizable identity.


Technical details

FieldValue
TypeA (credential-only -- no code)
App ID3416093
Bot User ID277151495
Slugeigenoid-automation-bot
InstallationEntire org (repository_selection: all)
RuntimeNone -- only dispenses tokens for workflows
Cost$0 (no infrastructure)

Permissions (Repository)

PermissionLevelReason
ContentsRead & WriteRead repo files during workflows
IssuesRead & WriteComment on and close lifecycle issues
MetadataReadBase permission required by GitHub
Pull requestsRead & WriteReserved for future CI/CD workflows

Usage in workflows

Workflows generate an ephemeral token via actions/create-github-app-token:

- name: Generate automation-bot token
id: bot-token
uses: actions/create-github-app-token@vX.Y.Z # SHA-pinned
with:
client-id: ${{ vars.AUTOMATION_BOT_CLIENT_ID }}
private-key: ${{ secrets.AUTOMATION_BOT_PRIVATE_KEY }}
yaml

Credentials stored in platform-settings

NameTypeValue
AUTOMATION_BOT_CLIENT_IDVariableIv23lir5g3lQ3S8Jla6x
AUTOMATION_BOT_PRIVATE_KEYSecretPrivate key PEM for the bot

Workflows that use it

WorkflowPurpose
new-repo.ymlPosts a summary table and closes duplicate issues
approve-repo.ymlPosts confirmation and closes the issue when the repo is created
archive-repo.ymlPosts the result and closes the issue when the repo is archived
delete-archived-repos.ymlComments on the original issue when the repo is deleted
notify-lifecycle-approvers.ymlNotifies @eigenoid/platform-lifecycle-approvers
auto-tag.ymlCreates environment-suffixed git tags for the distribution pipeline

Difference from Settings Bot

Settings BotAutomation Bot
PurposeGovernance (push config, checkout, repo operations)CI/CD automation (comments, labels, notifications)
TypeB (with code -- Cloud Run)A (credential-only)
Bypass actor in rulesetsYesNo
Appears as commit authorYesNo
Appears as comment authorNo (reserved for governance)Yes

Private key rotation

  1. Go to github.com/organizations/eigenoid/settings/apps/eigenoid-automation-bot and navigate to Private keys.
  2. Click Generate a private key and download the new .pem file.
  3. Update the AUTOMATION_BOT_PRIVATE_KEY secret in platform-settings under Settings, then Secrets.
  4. Delete the old key on the app page under Private keys.
  5. Verify: open a test issue and confirm the bot comments correctly.

Human owner

@shoootyou is responsible for this App. Contact them for permission changes, installations, or incidents.