[dmerand]

WHY are these changes introduced?

Subscription migration JSON must follow the shared CLI conventions and expose a discoverable contract.

WHAT is this pull request doing?

Replace outcomes with operations, use operationGid/gid/shopGid, flatten per-shop results, and place fieldPath diagnostics in item errors. Failed single cancellations use the fatal error envelope, and batch requests retain every outcome when another request fails. Remove schemaVersion; result contracts follow CLI release versions. Update the schema, tests, and generated help together. These existing JSON contract changes include a major changeset.

How to manually test your changes?

shopify app subscription-migrations cancel --id <operation-gid> --json
shopify app subscription-migrations cancel --json-schema

Checklist

• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've considered possible documentation changes
• I've considered analytics changes to measure impact
• The change is user-facing and includes a major changeset

[gonzaloriestra]

/snapit

[github-actions]

🫰✨ Thanks @gonzaloriestra! Your snapshot has been published to npm.

Test the snapshot by installing your package globally:

pnpm i -g --@shopify:registry=https://registry.npmjs.org @shopify/cli@0.0.0-snapshot-20260915114653

Caution

After installing, validate the version by running shopify version in your terminal.
If the versions don't match, you might have multiple global instances installed.
Use which shopify to find out which one you are running and uninstall it.

[isaacroldan]

One issue with cancellation batch output.

---

🤖 Generated by the review-pr skill

[Copilot]

🟡 Changes recommended

Batch exception handling loses shared error classifications and recovery guidance.

1 open finding

• Preserve request error classifications and recovery fields in batch outcomes · New

What changed in this PR

Normalizes subscription migration cancellation JSON and exposes its contract through the CLI’s shared schema support.

Changes:

• Adds normalized operation fields, flattened results, and structured cancellation errors.
• Retains batch outcomes and uses fatal errors for failed single cancellations.
• Removes schemaVersion from migration outputs; updates tests, generated help, and the major changeset.

File	Description
packages/​eslint-plugin-cli/​rules/​json-output-command-exceptions.js	Removes cancellation’s schema exception.
packages/​cli/​README.md	Updates generated command documentation.
packages/​cli/​oclif.manifest.json	Refreshes generated help metadata.
packages/​app/​src/​cli/​services/​subscription-migrations/​types.ts	Defines cancellation schema and domain types.
packages/​app/​src/​cli/​services/​subscription-migrations/​result-codec.ts	Projects normalized operations and diagnostics.
packages/​app/​src/​cli/​services/​subscription-migrations/​list-output.ts	Removes list output’s schema version.
packages/​app/​src/​cli/​services/​subscription-migrations/​list-output.test.ts	Updates list serialization expectations.
packages/​app/​src/​cli/​services/​subscription-migrations/​command-output.ts	Removes operation output’s schema version.
packages/​app/​src/​cli/​services/​subscription-migrations/​command-output.test.ts	Updates operation output expectations.
packages/​app/​src/​cli/​services/​subscription-migrations/​cancel-operations.ts	Validates IDs and retains batch failures.
packages/​app/​src/​cli/​services/​subscription-migrations/​cancel-operations.test.ts	Covers validation and retained outcomes.
packages/​app/​src/​cli/​commands/​app/​subscription-migrations/​result-presenter.ts	Makes single cancellation failures fatal.
packages/​app/​src/​cli/​commands/​app/​subscription-migrations/​result-presenter.test.ts	Updates presentation coverage.
packages/​app/​src/​cli/​commands/​app/​subscription-migrations/​result-presenter-output.test.ts	Checks JSON stdout behavior.
packages/​app/​src/​cli/​commands/​app/​subscription-migrations/​result-codec.ts	Encodes normalized cancellation JSON.
packages/​app/​src/​cli/​commands/​app/​subscription-migrations/​result-codec.test.ts	Tests serialization and schema validation.
packages/​app/​src/​cli/​commands/​app/​subscription-migrations/​list.ts	Updates JSON help wording.
packages/​app/​src/​cli/​commands/​app/​subscription-migrations/​list.integration.test.ts	Updates integration output expectations.
packages/​app/​src/​cli/​commands/​app/​subscription-migrations/​commands.test.ts	Checks output and schema metadata.
packages/​app/​src/​cli/​commands/​app/​subscription-migrations/​cancel.ts	Exposes the cancellation JSON schema.
.changeset/​normalize-subscription-migration-json.md	Declares a major release change.

🧠 Review effort: Balanced

---

Give feedback about Copilot approvals in this survey to enter a drawing for a $150 gift card.

[github-actions]

⚠️ Potential Breaking Changes Detected

This PR contains changes that may break the existing contract.

@shopify/dev_experience — this PR contains breaking changes that require coordination for the next major release.

📦 Major Version Changesets

The following changesets request a major version bump:

Changeset	Package
normalize-subscription-migration-json.md	"@shopify/cli": major

[github-actions]

Differences in type declarations

We detected differences in the type declarations generated by Typescript for this branch compared to the baseline ('main' branch). Please, review them to ensure they are backward-compatible. Here are some important things to keep in mind:

• Some seemingly private modules might be re-exported through public modules.
• If the branch is behind main you might see odd diffs, rebase main into this branch.

New type declarations

packages/cli-kit/dist/public/node/error/serialization.d.ts

import type { JsonError } from './types.js';
/**
 * Projects an error into the shared JSON error contract, retaining only allowlisted fields.
 *
 * @param source - Error to project.
 * @returns The error classification, message, and available recovery information.
 */
export declare function errorToJson(source: unknown): JsonError;

Existing type declarations

packages/cli-kit/dist/private/node/json-error.d.ts

@@ -1,16 +1,3 @@
-interface FatalErrorLike {
-    type?: number;
-    message?: unknown;
-    formattedMessage?: unknown;
-    tryMessage?: unknown;
-    nextSteps?: unknown;
-    customSections?: unknown;
-    stack?: unknown;
-    command?: unknown;
-    args?: unknown;
-    details?: unknown;
-    code?: unknown;
-}
 /**
  * Writes the public JSON representation of a fatal error to stdout.
  *
@@ -19,5 +6,4 @@ interface FatalErrorLike {
  *
  * @param error - Fatal error to serialize.
  */
-export declare function renderFatalErrorAsJson(error: FatalErrorLike): void;
-export {};
\ No newline at end of file
+export declare function renderFatalErrorAsJson(error: unknown): void;
\ No newline at end of file