[BackStacked]

This is handoff item F: move the api to catalog-kit 2.x (MGPL ids) as a planned step, not drift.

Breaking change

• CatalogTest.id changes from Int! to ID!. It is now the MGPL id: MGPLT0001 for a test, MGPLP0001 for a profile, MGPLK0001 for a package.
• New fields: kind: CatalogKind!, legacyId: Int (the old numeric id) and isPackage.
• catalogTest(id: ID) accepts an MGPL id or the old numeric id. priceQuote accepts codes, MGPL ids or old ids.
• isProfile is now true only for profiles. In 1.x it was true for any test with more than one parameter, so CBC counted.

Bookings, reports and bills store test codes, so no stored data changes.

Also

• catalog-kit ^2.2.0, which is catalog-kit#14: 2.x plus the 1.2 narrative and Widal fixes, so nothing regresses.
• client ^2.0.0 (client PR alongside).
• deploy/production.env.example, .env.example and docs/09 now document PATIENT_LINK_SECRET, PATIENT_LINK_BASE_URL, MGPL_UPI_ID and MGPL_UPI_NAME.
• New docs/10 section "Catalog ids". Schema, reference and llms are regenerated. Version 0.1.6.

Release order

1. Merge catalog-kit#14, then tag catalog-kit v2.2.0.
2. Merge the client PR, then tag client v2.0.0.
3. Merge this PR, then tag api v0.1.6.
4. Merge the dashboard PR, then tag dashboard v0.1.9.

CI here fails until steps 1 and 2 are published.

Checks

npm run typecheck. TEST_BACKENDS=pg npm test: 283 passed. The two new checks cover:

• an MGPL id and kind, and lookup by MGPL id or old numeric id;
• a profile gets an MGPLP id, and priceQuote accepts MGPL ids.

All the existing narrative and Widal checks pass on catalog-kit 2.2.0. MongoDB can't be downloaded in my container; CI runs both databases.

---

---

Generated by Claude Code

[BackStacked]

The ci and docker failures are expected for now: npm ci stops with ETARGET because @mgpl-diagnostics/client@2.0.0 (and catalog-kit 2.2.0) are not published yet. Both checks should pass on a re-run once these are tagged in order: catalog-kit#14 → v2.2.0, client#20 → v1.12.1, client#21 → v2.0.0. Locally, TEST_BACKENDS=pg npm test passes 283 checks against the packed tarballs.

---

Generated by Claude Code