You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
PR #1576 adds the organization-owned desired-state reconciler for repository descriptions, GitHub Topics, and GitHub Pages settings. Audit mode needs no write credential, but live apply mode intentionally fails closed until a dedicated repository-settings identity exists.
Do not reuse reviewer/model/provider credentials or silently broaden the ordinary workflow GITHUB_TOKEN.
Required authority
Provision a dedicated GitHub App installation token path or other approved short-lived credential exposed to the protected central workflow as CWL_REPOSITORY_METADATA_TOKEN with the minimum permissions needed by the managed repositories:
repository Administration: write for PATCH /repos/{owner}/{repo} description/homepage changes and PUT /repos/{owner}/{repo}/topics;
repository Pages: write plus Administration write only where GitHub Pages creation/update is enabled in the desired-state manifest;
no Issues/PR/review/merge/release/package/Actions-secret/model-provider authority unless independently justified.
Prefer a GitHub App restricted to the explicit managed repository set over a long-lived personal token. Keep the credential unavailable to pull-request code and model processes.
Repository Metadata Reconciliation audit mode reports expected drift on a protected-main run.
Apply mode obtains the dedicated credential without exposing it in logs/artifacts and updates one canary repository's description/topics.
A fresh live REST read proves the exact description/topics now match config/repository-metadata.json.
When a repository's Pages intent is later enabled, the same path creates/updates GitHub Pages and a fresh Pages endpoint read proves the published source/settings; source/workflow definition alone is not completion evidence.
Revoking or removing the dedicated identity makes apply fail closed and leaves audit mode usable.
This issue owns external credential/App provisioning only; desired-state semantics and reconciler implementation remain in #1576.
Operational blocker
PR #1576 adds the organization-owned desired-state reconciler for repository descriptions, GitHub Topics, and GitHub Pages settings. Audit mode needs no write credential, but live apply mode intentionally fails closed until a dedicated repository-settings identity exists.
Do not reuse reviewer/model/provider credentials or silently broaden the ordinary workflow
GITHUB_TOKEN.Required authority
Provision a dedicated GitHub App installation token path or other approved short-lived credential exposed to the protected central workflow as
CWL_REPOSITORY_METADATA_TOKENwith the minimum permissions needed by the managed repositories:PATCH /repos/{owner}/{repo}description/homepage changes andPUT /repos/{owner}/{repo}/topics;Prefer a GitHub App restricted to the explicit managed repository set over a long-lived personal token. Keep the credential unavailable to pull-request code and model processes.
Acceptance
Repository Metadata Reconciliationaudit mode reports expected drift on a protected-main run.config/repository-metadata.json.This issue owns external credential/App provisioning only; desired-state semantics and reconciler implementation remain in #1576.