Skip to content

docs(migration): correct the false "uses: is redirected on rename" claim#10

Merged
vaderyang merged 1 commit into
mainfrom
docs/fix-rename-uses-redirect
Jun 16, 2026
Merged

docs(migration): correct the false "uses: is redirected on rename" claim#10
vaderyang merged 1 commit into
mainfrom
docs/fix-rename-uses-redirect

Conversation

@vaderyang

Copy link
Copy Markdown
Contributor

What

Correct a factually wrong claim in the migration guidance, discovered while
performing the Netis/agent-opsNetis/olympus GitHub repo rename.

docs/migration.md (and pantheon.md + the migration linter's wording) stated
that GitHub redirects a renamed repo's uses: path, so a pinned-tag
consumer "keeps working unchanged / nothing breaks." That is the opposite of
GitHub's actual behavior. From GitHub's official renaming a repository docs:

GitHub will not redirect calls to an action hosted by a renamed repository.
Any workflow that uses that action will fail with the error repository not found.

git/web/API access is redirected (which is why a reusable workflow's own
inner actions/checkout of the old path still clones) — but the outer
uses: resolution is not
. The old guidance would have told pinned-tag
consumers to skip the single edit they must actually make.

Changes

  • docs/migration.md — short answer, the impact-by-pin table, the
    redirect-scope paragraph, and the "heron specifically" section. New truth: a
    pinned-tag consumer must change the uses: owner to Netis/olympus,
    keeping the same @tag (tags travelled with the repo) and keeping
    .agent-ops.json + agent_ops_ref until they re-pin to a post-rename tag.
  • Fixes the stale "heron is not a consumer yet" section — heron is
    consumer v0.2.0: review.yml pr_number input (fix manual-dispatch re-review) #1 (5 pinned wrappers at @v0.2.0/@v0.3.1). The repoint is tracked
    in Netis/heron#164.
  • docs/pantheon.md — mechanism-layer note + acceptance bullet clarified
    (git/web/API redirect ≠ Actions uses:).
  • scripts/lint/check-legacy-naming.sh — header comment + the uses: fix
    message no longer claim a redirect.

Context

This lands right after the repo rename Netis/agent-opsNetis/olympus. The
self-dogfood loop is unaffected by the rename (self-* workflows use local
uses: ./… + olympus_repo: ${{ github.repository }}); this PR's own
self-guard run is the live proof of that.

Docs/linter-message only — no behavior change. check-leakage,
check-legacy-naming, shellcheck, and the scripts/agent-bot/tests/* suite
all pass locally.

🤖 Generated with Claude Code

GitHub Actions does NOT follow repository renames when resolving `uses:`
(verified against GitHub's official "renaming a repository" docs: the call
fails with `repository not found`). git/web/API access *is* redirected — which
is why a reusable workflow's inner actions/checkout of the old path still works
— but the outer `uses:` resolution is not. The previous migration guidance said
the opposite ("nothing breaks, GitHub redirects the uses: path"), which would
have led pinned-tag consumers to skip the one edit they actually must make.

Now states the truth: a pinned-tag consumer must change the `uses:` owner to
Netis/olympus, keeping the same @tag (tags travelled with the repo) and keeping
.agent-ops.json + agent_ops_ref until they re-pin to a post-rename Olympus tag.

Also fixes the stale "heron is not a consumer yet" section — heron IS consumer
#1 (5 pinned wrappers at v0.2.0/v0.3.1); the repoint is tracked in Netis/heron#164.

- docs/migration.md: short answer, impact-by-pin table, redirect-scope note,
  heron section.
- docs/pantheon.md: mechanism-layer note + acceptance bullet.
- scripts/lint/check-legacy-naming.sh: header comment + the uses: fix message.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vaderyang
vaderyang merged commit 420d12b into main Jun 16, 2026
2 checks passed
@vaderyang
vaderyang deleted the docs/fix-rename-uses-redirect branch June 16, 2026 09:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant