Migration to repoctx 3.0

repoctx 3.0 removes deprecated surfaces that 2.x kept for backwards compatibility. Plan the upgrade before 3.0 ships.

What 3.0 removes

Surface	Removed in 3.0	Replacement
dev-context CLI bin	yes	repoctx
Legacy MCP tool names (18 retired names)	yes	13 canonical tools — see MIGRATION-2.0.md
pass / pass-pr CLI aliases	planned	repoctx gate
tools/list legacy aliases	yes	canonical names only

Pre-migration checklist

1. Search configs for dev-context
2. MCP host configs, CI workflows, shell aliases, skills, and docs.

3. Replace with repoctx or npx -y @nugehs/repoctx.

4. Search MCP configs for retired tool names

5. pr_review, review_pr, merge_readiness, pr_merge_readiness
6. repo_catalog, repo_discover, find_domain, find_file_kind, find_backend_route, find_frontend_api_client

7. Map each call using MIGRATION-2.0.md.

8. Update CLI scripts

9. repoctx pass → repoctx gate <repo> [--base ref]

10. repoctx pass-pr → repoctx gate --pr <selector>

11. Run doctor and smoke after changes

repoctx doctor
repoctx harness . --json

1. Enable telemetry warnings (optional before 3.0)
2. repoctx telemetry on logs legacy MCP alias usage locally to spot stragglers.

Canonical MCP tools (3.0)

Same 13 tools as 2.3 — see MCP and Agent Workflows.

Timeline guidance

• 2.x: legacy aliases work; deprecation warnings on dev-context bin only.
• 3.0.0-rc: legacy MCP names removed from tools/call; migration window closes.
• 3.0.0: dev-context bin removed; breaking semver bump.

Track release notes in CHANGELOG.md for the exact 3.0 ship date.