[angeloashmore]

Resolves:

Description

Before this PR, each Prismic service had its own client file. The files hid parts of each request in shared helpers. For example, to know which token, headers, and error messages a request used, a reader had to follow two or three helpers.

After this PR, all requests to Prismic are in one client file, grouped by service. Each client function shows its full request and returns the API response as it is. A new endpoint starts from a copy of a similar function. The next PR adds a login retry to each of these functions (#443).

The behavior of the CLI does not change.

Checklist

• If my changes require tests, I added them.
• If my changes affect backward compatibility, it has been discussed.
• If my changes require an update to the CONTRIBUTING.md guide, I updated it.

Preview

How to QA ¹

Run the commands that use the Prismic API, for example prismic repo view, prismic pull, and prismic webhook list. They work as before.

🤖 Generated with Claude Code

https://claude.ai/code/session_01L1dGD6G4hXCqeewEhox2Du

---

Note

Medium Risk
Wide mechanical refactor across all Prismic API usage; regressions would affect auth, repo settings, push/pull, and dev sync if any response handling was missed.

Overview
Consolidates every Prismic HTTP client that lived under src/lib/prismic/clients/ into a single src/lib/prismic/client.ts, grouped by backend service. Shared request wrappers are removed so each export builds its own URL, headers/credentials, and Zod schema inline. AGENTS.md now points at client.ts instead of a clients/ folder.

Call sites across commands, adapters, auth, models, and tracking import from the new module. Several exports are renamed for clarity (getProfile → getUserProfile, getRepositories → getUserRepositories, removePreview/removeLocale → deletePreview/deleteLocale, screenshot and API-access helpers similarly). List and metadata helpers now return parsed API envelopes (e.g. { results } for previews/locales, { simulator_url }, { id } from createRelease, { total } for document counts) instead of unwrapping inside the client—commands destructure those fields locally. Model sync uses bulkUpdateModels / BulkModelChange instead of the old custom-types names.

Intended CLI behavior is unchanged; the shape change sets up a follow-up to add login retry per request.

^{Reviewed by Cursor Bugbot for commit 09efad4. Bugbot is set up for automated code reviews on this repo. Configure here.}

Footnotes

1. Please use these labels when submitting a review:
   ❓ #ask: Ask a question.
   💡 #idea: Suggest an idea.
   ⚠️ #issue: Strongly suggest a change.
   🎉 #nice: Share a compliment. ↩