Website repository
The customer’s own website repository on GitHub. When a site audit finds something PULSE can fix in the site’s files, Propose as pull request opens one branch and one pull request there for a person to review and merge. PULSE never pushes to the base branch and never merges.
Create the token on GitHub
PULSE uses a fine-grained personal access token, not a GitHub OAuth app: an OAuth app’s narrowest write scope opens every repository the person can reach, while a fine-grained token can be limited to one.
- On GitHub: Settings › Developer settings › Fine-grained tokens › Generate new token.
- Repository access: Only select repositories, and pick the site’s repository only.
- Permissions: Contents read and write, and Pull requests read and write. Nothing else.
- Choose an expiry you will remember to renew.
No OAuth client and no server secret are needed for this connection.
Connect it in PULSE
An administrator opens Settings › Integrations › Website repository,
enters the owner (user or organization), the repository name, the base
branch (main when empty) and the token, and presses Connect and check.
The token is sealed with the envelope key; leaving the field empty later keeps
the stored one. The card shows one of: Connected, Missing permission, Token
rejected, Base branch not found, GitHub unreachable, Not connected, with when
it was last checked.
Arm proposals
Proposing is off until the administrator sets both PULSE_APPLY_ENABLED=true
and PULSE_AUDIT_APPLY=true, and only an administrator may propose. Either
switch off refuses the proposal before anything is read from or sent to
GitHub. PULSE_APPLY_ROOT is not needed. See
Switches and arming order.
What a proposal does
- Reads the base branch over the GitHub REST API, places the fix for one audit finding with the same stack logic as the server-side apply agent, and has the plan gate judge the edit against the measured finding. A dissent opens nothing and the proposal shows as withheld.
- Writes a new branch
pulse/<audit>-<finding>and opens a pull request whose body cites the finding and the gate’s verdict. One proposal per finding. - Never edits
.github/workflows/or.git/, refuses..paths and links, and is capped at 20 files, 256 KiB each and 1 MiB in all. - A fix already in the repository, or one that cannot be placed, is “No pull request needed” with the reason. The pull request’s state (open, merged, closed without merging) is read back from GitHub when asked.
This is separate from the Website card, which publishes blog posts with
the repository set in PULSE_SITE_REPO; see
Site pipeline.