Skip to content

docs: document isolated sync verification modes #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
LightDevCoder wants to merge 1 commit into from
Closed

docs: document isolated sync verification modes #3

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 7 additions & 3 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,15 +61,19 @@ Use the controlled script with the read-only upstream checkout:
```powershell
.\scripts\sync-upstream.ps1 -Mode check
.\scripts\sync-upstream.ps1 -Mode dry-run
.\scripts\sync-upstream.ps1 -Mode resource
.\scripts\sync-upstream.ps1 -Mode diff
.\scripts\sync-upstream.ps1 -Mode unauthorized-patch
.\scripts\sync-upstream.ps1 -Mode sync
```

`check` fails on missing packages, missing referenced resources, drift from the
pinned revision, or unauthorized local changes to upstream-managed files.
`dry-run` and `diff` do not write. `sync` is allowed only after reviewing the
upstream revision and its diff. Never silently resolve a conflict or overwrite
an unrecorded local patch.
`resource` isolates complete-package and referenced-resource checks;
`unauthorized-patch` isolates managed-file, local-patch-record, and extra-file
boundary checks. `dry-run` and `diff` do not write. `sync` is allowed only after
reviewing the upstream revision and its diff. Never silently resolve a conflict
or overwrite an unrecorded local patch.

## Review, installation, and release

Expand Down
Loading