Migration

[luarss]

Handover Checklist: luarss → The-OpenROAD-Project

Migration of github.com/luarss/openroad-mcp to github.com/The-OpenROAD-Project/openroad-mcp.

---

1. GitHub Repository

• Create / configure The-OpenROAD-Project/openroad-mcp (public)
• Push full git history to new repo
• Set branch protection rules on main
• Configure team permissions (merge rights, release approvers)
• Migrate open Issues (manual or via gh scripting — no native transfer)
• Archive luarss/openroad-mcp with redirect notice in README

---

2. Secrets

• CODECOV_TOKEN — add new org repo to Codecov, copy token into GitHub repo secrets
• [ ] GITHUB_TOKEN — auto-injected; no action needed (scoped to new org automatically)

---

3. PyPI Package

• Update author email in pyproject.toml:9 (currently jluar@precisioninno.com)
• On PyPI → openroad-mcp → Publishing: add trusted publisher for The-OpenROAD-Project/openroad-mcp, workflow release.yml, environment pypi
• Remove old luarss trusted publisher from PyPI

---

4. Docker / GHCR

• Update Makefile:6 — IMAGE_NAME from ghcr.io/luarss/openroad-mcp → ghcr.io/the-openroad-project/openroad-mcp
• Update docker-publish.yml — IMAGE= line
• Update release.yml — sed commands that patch server.json image path
• Update server.json:20 — "identifier" OCI package path
• (Optional) Re-push existing tags to new namespace for continuity

---

5. MCP Registry

• Update server.json:3 — "name" from io.github.luarss/openroad-mcp → io.github.the-openroad-project/openroad-mcp
• Update server.json:6 — "repository.url" to new GitHub URL
• Contact MCP Registry maintainers to remove/redirect orphaned io.github.luarss/openroad-mcp entry (see Replace openroad-mcp owner modelcontextprotocol/registry#1347)

---

6. Codecov

• Add new org repo on codecov.io
• Add CODECOV_TOKEN as a GitHub repo secret

---

7. Source File URL Updates

Replace all github.com/luarss/openroad-mcp references:

• README.md — ~25 git+https://github.com/luarss/openroad-mcp@v... install snippets
• CHANGELOG.md — PR links (historical; update or leave)
• ROADMAP.md — issue tracker and discussions links
• server.json — repo URL, MCP name, Docker identifier
• Makefile — IMAGE_NAME
• pyproject.toml — author email
• .github/workflows/docker-publish.yml — Docker image path
• .github/workflows/release.yml — sed commands patching image path
• .claude/skills/release/SKILL.md — any hardcoded luarss refs

---

8. Cut First Release from New Org Repo

• Verify CI passes on main in new repo
• Tag a new release — this will:
  • Publish to PyPI under the new trusted publisher
  • Push Docker image to ghcr.io/the-openroad-project/...
  • Register new MCP Registry entry io.github.the-openroad-project/openroad-mcp
• Confirm all three publish steps succeeded in the Actions run