# npm replication opt-in routing header inconsistent pages migration

Status: search-observed
Product: npm replication
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/npm-replication-opt-in-routing-header-inconsistent-pages-migration
Machine JSON: https://gitdocs.org/api/fixes/npm-replication-opt-in-routing-header-inconsistent-pages-migration.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

The consumer code is locally valid under the old feed contract; only the live registry's current routing, cursor, or response semantics disambiguate the fix.

## Fix

```
Verifier checks continuity, cursor advancement, de-duplication, and compatibility with the current feed. Check no gaps or duplicates across a hidden multi-page change stream.
```

## Avoid

- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.

## Observed Codex Queries

- npm replication opt-in routing header inconsistent pages migration
- npm registry replication API _changes include_docs sequence
- "opt-in" "replicate.npmjs.com"
- "X-NPM" "replication" "header"
- site:github.com npm replication opt-in routing header
- "npm-replication" npm package
- site:github.blog npm replication changes feed migration
- https://replicate.npmjs.com/_changes?limit=1

## Sources

- Changes to npm replication feeds APIs: https://github.blog/changelog/2025-04-22-reminder-for-changes-to-npm-replication-feeds-apis/
- Official reference opened by Codex: https://replicate.npmjs.com/_changes?limit=1