Skip to content

Conversation

@adamziel
Copy link
Collaborator

@adamziel adamziel commented Dec 9, 2025

Summary

github-proxy.com is being shut down. This PR provides a graceful migration path for existing Blueprints that reference github-proxy.com URLs.

When a Blueprint contains a URL resource pointing to github-proxy.com, it is now automatically rewritten to native Blueprint resources with a console warning prompting users to update their Blueprints.

Migration mapping

github-proxy.com pattern Migrates to
?repo=owner/name zip wrapping git:directory at HEAD
?repo=...&branch=trunk zip wrapping git:directory with branch ref
?repo=...&pr=123 zip wrapping git:directory with refs/pull/123/head
?repo=...&commit=abc zip wrapping git:directory with commit ref
?repo=...&release=v1.0 zip wrapping git:directory with tag ref
?repo=...&directory=subdir zip wrapping git:directory with path
?repo=...&release=v1.0&asset=file.zip url to GitHub releases download
?repo=...&release=latest&asset=file.zip url to GitHub /releases/latest/download/
https://github-proxy.com/https://... url with the inner GitHub URL

New zip resource type

A new resource type that wraps file or directory resources and outputs them as ZIP files. This maintains semantic compatibility with github-proxy.com which always returned ZIP files.

{
  "resource": "zip",
  "inner": {
    "resource": "git:directory",
    "url": "https://github.com/owner/repo",
    "ref": "main"
  }
}

Other changes

  • Fixed ZIP encoding to use 0-based disk numbering (was causing PHP's ZipArchive to reject files with "multi-disk archive" error)
  • Updated documentation to use git:directory instead of github-proxy.com examples
  • The /proxy redirect now points to the resources documentation
  • Local dev server now proxies /cors-proxy/ requests through Vite to avoid Chrome's Private Network Access restrictions

Test plan

  • Run a Blueprint with a github-proxy.com URL and verify it works with a deprecation warning
  • Test all github-proxy.com URL patterns (branch, PR, commit, release, directory, asset)
  • Verify the zip resource type works with installPlugin and installTheme steps
  • Check that existing git:directory resources still work as expected

🤖 Generated with Claude Code

@adamziel adamziel marked this pull request as draft December 9, 2025 19:32
github-proxy.com is being shut down. This change provides a graceful
migration path for existing Blueprints that reference github-proxy.com
URLs.

When a Blueprint contains a URL resource pointing to github-proxy.com,
it is now automatically rewritten to native Blueprint resources:

- Repository URLs (?repo=...) become `zip` wrapping `git:directory`
- Branch/PR/commit/release parameters map to git refs
- Release assets (?release=...&asset=...) become direct GitHub URLs
- Proxied GitHub URLs are unwrapped to direct URLs

A new `zip` resource type wraps file or directory resources and outputs
them as ZIP files, maintaining semantic compatibility with github-proxy.com
which always returned ZIP files.

Also fixes ZIP encoding to use 0-based disk numbering, which was causing
PHP's ZipArchive to reject files with "multi-disk archive" error.

Documentation updated to use git:directory instead of github-proxy.com.
The /proxy redirect now points to the resources documentation.

Local dev server now proxies /cors-proxy/ requests through Vite to avoid
Chrome's Private Network Access restrictions.
@adamziel adamziel force-pushed the github-proxy-com-migration-path branch from f444655 to 8080edb Compare December 9, 2025 19:35
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.

2 participants