What changed
Manifest write-back now handled by the action itself.
Previously, the consuming repo's workflow was responsible for committing updated page IDs back to confluence-manifest.yaml after new pages were created. This required a direct push to main, which broke when branch protection was enabled.
The action now handles write-back automatically:
- After a sync run, if new page IDs were assigned, the action commits the manifest via the GitHub Contents API.
- If branch protection blocks the direct commit, the action opens a PR automatically. Merge it promptly -- until merged, the next publish run will not have the new page IDs.
To avoid the PR fallback, grant github-actions[bot] bypass permission on the branch protection rule for main in your repository settings.
Required workflow permissions
Add these to your publish workflow:
permissions:
contents: write
pull-requests: writeNew input
| Input | Default | Description |
|---|---|---|
github-token |
GITHUB_TOKEN |
Override the token used for manifest write-back; useful when a PAT with elevated permissions is needed |
See ONBOARDING.md for full details.