upstream-refresh

name	upstream-refresh
description	Refresh pinned upstream repos and check patch compatibility.

Intent

Use this skill when the user wants to update local upstream checkouts from their remotes, inspect patch compatibility, or refresh one pinned upstream repo to a specific ref.

Workflow model: edit -> sync, or need newer upstream -> update -> sync.

Inputs

• Repo selection: 1541ultimate, spiffy-ultimate, or all.
• Optional explicit ref when refreshing only one repo.

Execution

1. Prefer ./forge update as the operator-facing entrypoint.
2. Use ./forge update all for both pinned upstream repos.
3. Use ./forge update <repo> <ref> only for a single explicit branch, tag, or commit.
4. Treat update as advance upstream checkout(s) -> sync; run ./forge sync <repo|all> immediately after refresh unless the command already performed that check inline.
5. Analyze the resulting sync states and advise on them rather than stopping at raw command output.

Validation

1. Report the old and new upstream SHA when a checkout moved.
2. Report whether sync status is clean, upstreamed, conflict, orphaned, or retired.
3. Advise next action from the state: keep working for clean, consider pruning for upstreamed, repair and resync for conflict or orphaned.

Safety

• Do not pass an explicit ref together with all.
• Treat conflicts after refresh as a patch-compatibility issue, not as a reason to overwrite local patches.