@fragment-dev/cli 2026.10.1 → 2026.10.2-1

package/README.md

@@ -646,12 +646,14 @@ Verify that a schema file follows the Fragment JSON schema format
 
 ```
 USAGE
-  $ fragment verify-schema [-p <value>] [-v] [-j]
+  $ fragment verify-schema [-p <value>] [-v] [-j] [-a <value>]
 
 FLAGS
-  -j, --json          Output validation results as JSON for programmatic use
-  -p, --path=<value>  [default: fragment/fragment.json] Path to schema file (e.g. my-schema.jsonc)
-  -v, --verbose       Show detailed validation output
+  -a, --against=<value>  Path to a previous version of the schema to check backwards compatibility against (e.g. the
+                         output of `fragment get-schema`)
+  -j, --json             Output validation results as JSON for programmatic use
+  -p, --path=<value>     [default: fragment/fragment.json] Path to schema file (e.g. my-schema.jsonc)
+  -v, --verbose          Show detailed validation output
 
 DESCRIPTION
   Verify that a schema file follows the Fragment JSON schema format
@@ -664,6 +666,16 @@ EXAMPLES
   $ fragment verify-schema -p fragment/fragment.json --verbose
 
   $ fragment verify-schema --path ./my-schema.jsonc --json
+
+  Check that the schema is backwards-compatible with the deployed schema.
+
+    $ fragment get-schema --key my-schema --output deployed-schema.jsonc && fragment verify-schema --path \
+      my-schema.jsonc --against deployed-schema.jsonc
+
+  Check that the schema is backwards-compatible with its copy on the main branch.
+
+    $ git show origin/main:my-schema.jsonc > base-schema.jsonc && fragment verify-schema --path my-schema.jsonc \
+      --against base-schema.jsonc
 ```
 
 ## `fragment version`

package/dist/{chunk-T7PAZDQ2.js → chunk-23KWDUJZ.js}

@@ -9,7 +9,7 @@ import {
   codes,
   getStringParametersInternal,
   z
-} from "./chunk-DKAEBT2M.js";
+} from "./chunk-XJ2TNWI7.js";
 import {
   init_cjs_shims
 } from "./chunk-7GH3YGSC.js";
@@ -400,6 +400,11 @@ var BaseSchema = z.object({
     })
   )
 });
+var VALID_LEDGER_ACCOUNT_STATUS_TRANSITIONS = {
+  active: ["disabled"],
+  disabled: ["archived", "active"],
+  archived: ["active"]
+};
 
 export {
   fillParams,
@@ -421,6 +426,7 @@ export {
   SYSTEM_PARAMETER_NAMES,
   SchemaPaymentTypeStatusSchema,
   SchemaEntryGroup,
+  VALID_LEDGER_ACCOUNT_STATUS_TRANSITIONS,
   getStructuralPath,
   getInstanceValueByAccountPath,
   getSubpaths,

package/dist/{chunk-JMFDKBJW.js → chunk-2LDAYJQR.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-4IMXVHLX.js";
+} from "./chunk-SU5G5HM2.js";
 import {
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-Q62TGFNL.js → chunk-2QR6NGWG.js}

@@ -5,7 +5,7 @@ import {
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   resolveMcpBaseUrl
 } from "./chunk-TLM4VKIC.js";

package/dist/{chunk-LINOTI5E.js → chunk-3IA6BI6A.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-34NLRFFT.js";
 import {
   parseJSON
-} from "./chunk-PU52GTGB.js";
+} from "./chunk-QZNZYG2G.js";
 import {
   require_graphql
 } from "./chunk-QF5EN33L.js";

package/dist/{chunk-GZF5GHBV.js → chunk-3IGRQ6LL.js}

@@ -1,12 +1,12 @@
 import {
   inquirer_default
-} from "./chunk-F6IDBMXZ.js";
+} from "./chunk-6PRTPBP7.js";
 import {
   AuthenticatedCommand
-} from "./chunk-4IMXVHLX.js";
+} from "./chunk-SU5G5HM2.js";
 import {
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-MUN6P2HN.js → chunk-3K6ERQYV.js}

@@ -1,6 +1,6 @@
 import {
   AuthenticatedCommand
-} from "./chunk-4IMXVHLX.js";
+} from "./chunk-SU5G5HM2.js";
 import {
   init_cjs_shims
 } from "./chunk-7GH3YGSC.js";

package/dist/{chunk-D65TXRLZ.js → chunk-5NKCOZCW.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-4IMXVHLX.js";
+} from "./chunk-SU5G5HM2.js";
 import {
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-VZA2YKI6.js → chunk-5UOYY7GS.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-4IMXVHLX.js";
+} from "./chunk-SU5G5HM2.js";
 import {
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-F6IDBMXZ.js → chunk-6PRTPBP7.js}

@@ -13,7 +13,7 @@ import {
   require_syntax,
   require_type,
   require_uri
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   require_color_convert,
   require_source

package/dist/{chunk-XUOVQRQH.js → chunk-D45KVQKB.js}

@@ -1,6 +1,6 @@
 import {
   AuthenticatedCommand
-} from "./chunk-4IMXVHLX.js";
+} from "./chunk-SU5G5HM2.js";
 import {
   init_cjs_shims
 } from "./chunk-7GH3YGSC.js";

package/dist/{chunk-7LEHQFLL.js → chunk-DT372IG6.js}

@@ -1,6 +1,6 @@
 import {
   FragmentCommand
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   init_cjs_shims
 } from "./chunk-7GH3YGSC.js";

package/dist/{chunk-I7HWZUNL.js → chunk-DYIB3NZM.js}

@@ -1,25 +1,29 @@
+import {
+  BackCompatCheckError,
+  verifySchemaAgainstFile
+} from "./chunk-NT74GT6W.js";
 import {
   extractSchemaMetadata,
   isJsonParseError,
   validateSchemaStructure
-} from "./chunk-JV34IPXX.js";
+} from "./chunk-IQIFAKDJ.js";
 import {
   DEFAULT_SCHEMA_PATH
 } from "./chunk-A4BSWX5D.js";
 import {
   logValidationErrors
-} from "./chunk-MOBC7AAW.js";
+} from "./chunk-V4IQY3DF.js";
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   colorizeJson,
   emphasize,
   getParsedSchema,
   getParsedSchemaString,
   parseJSON
-} from "./chunk-PU52GTGB.js";
+} from "./chunk-QZNZYG2G.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";
@@ -32,6 +36,12 @@ import {
 init_cjs_shims();
 var import_core = __toESM(require_lib(), 1);
 var import_chalk = __toESM(require_source(), 1);
+var getErrorType = (error) => {
+  if (error instanceof BackCompatCheckError) {
+    return error.jsonType;
+  }
+  return isJsonParseError(error) ? "parse_error" : "validation_error";
+};
 var VerifySchema = class _VerifySchema extends FragmentCommand {
   static {
     this.description = "Verify that a schema file follows the Fragment JSON schema format";
@@ -41,7 +51,15 @@ var VerifySchema = class _VerifySchema extends FragmentCommand {
       "<%= config.bin %> <%= command.id %>",
       "<%= config.bin %> <%= command.id %> --path ./my-schema.jsonc",
       "<%= config.bin %> <%= command.id %> -p fragment/fragment.json --verbose",
-      "<%= config.bin %> <%= command.id %> --path ./my-schema.jsonc --json"
+      "<%= config.bin %> <%= command.id %> --path ./my-schema.jsonc --json",
+      {
+        description: "Check that the schema is backwards-compatible with the deployed schema.",
+        command: "fragment get-schema --key my-schema --output deployed-schema.jsonc && <%= config.bin %> <%= command.id %> --path my-schema.jsonc --against deployed-schema.jsonc"
+      },
+      {
+        description: "Check that the schema is backwards-compatible with its copy on the main branch.",
+        command: "$ git show origin/main:my-schema.jsonc > base-schema.jsonc && <%= config.bin %> <%= command.id %> --path my-schema.jsonc --against base-schema.jsonc"
+      }
     ];
   }
   static {
@@ -60,11 +78,16 @@ var VerifySchema = class _VerifySchema extends FragmentCommand {
         char: "j",
         description: "Output validation results as JSON for programmatic use",
         default: false
+      }),
+      against: import_core.Flags.string({
+        char: "a",
+        description: "Path to a previous version of the schema to check backwards compatibility against (e.g. the output of `fragment get-schema`)"
       })
     };
   }
   async run() {
     const { flags } = await this.parse(_VerifySchema);
+    const against = flags.against ? { path: flags.against } : null;
     try {
       let schema;
       if (flags.json) {
@@ -91,18 +114,26 @@ var VerifySchema = class _VerifySchema extends FragmentCommand {
         });
       }
       this.validateSchema(schema);
+      if (against) {
+        verifySchemaAgainstFile({
+          command: this,
+          schema,
+          againstPath: against.path,
+          requireEnvVariables: !flags.json
+        });
+      }
       if (flags.json) {
-        this.outputJsonResult(schema, flags.path, true);
+        this.outputJsonResult(schema, flags.path, true, void 0, against);
       } else {
         if (flags.verbose) {
           this.displayParsedSchema(schema);
           this.displayValidationDetails(schema);
         }
-        this.displaySuccessMessage(schema, flags.verbose);
+        this.displaySuccessMessage(schema, flags.verbose, against);
       }
     } catch (error) {
       if (flags.json) {
-        this.outputJsonResult(null, flags.path, false, error);
+        this.outputJsonResult(null, flags.path, false, error, against);
       } else {
         this.handleValidationError(error, flags.path);
       }
@@ -126,12 +157,17 @@ var VerifySchema = class _VerifySchema extends FragmentCommand {
       `   Ledger entry types: ${emphasize(metadata.entryTypeCount.toString())}`
     );
   }
-  displaySuccessMessage(schema, verbose) {
+  displaySuccessMessage(schema, verbose, against) {
     this.log(`
 ${import_chalk.default.green("\u2705 Schema validation successful!")}`);
     this.log(
       `Schema "${schema.key}" is valid and follows the Fragment JSON schema format.`
     );
+    if (against) {
+      this.log(
+        `Schema is backwards-compatible with ${emphasize(against.path)}.`
+      );
+    }
     if (!verbose) {
       this.log(
         `
@@ -141,7 +177,7 @@ Run with ${emphasize(
       );
     }
   }
-  outputJsonResult(schema, schemaPath, success, error) {
+  outputJsonResult(schema, schemaPath, success, error, against) {
     const result = {
       success,
       schemaPath,
@@ -156,10 +192,13 @@ Run with ${emphasize(
         entryTypeCount: metadata.entryTypeCount
       };
     }
+    if (against) {
+      result.against = against;
+    }
     if (!success && error) {
       result.error = {
         message: error.message || "Unknown validation error",
-        type: isJsonParseError(error) ? "parse_error" : "validation_error"
+        type: getErrorType(error)
       };
       if (error.validationErrors) {
         result.error.validationErrors = error.validationErrors;
@@ -171,7 +210,15 @@ Run with ${emphasize(
     }
   }
   handleValidationError(error, schemaPath) {
-    if (!isJsonParseError(error)) {
+    if (error instanceof BackCompatCheckError) {
+      this.logToStderr(
+        `
+${import_chalk.default.red("\u274C Schema backwards-compatibility check failed!")}`
+      );
+      this.logToStderr(error.message);
+      this.logToStderr(`
+${import_chalk.default.gray("Schema file:")} ${schemaPath}`);
+    } else if (!isJsonParseError(error)) {
       this.logToStderr(`
 ${import_chalk.default.red("\u274C Schema validation failed!")}`);
       if (error.validationErrors) {

package/dist/{chunk-3QIKHVTA.js → chunk-E7ZKZZP4.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-4IMXVHLX.js";
+} from "./chunk-SU5G5HM2.js";
 import {
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-C67WHN2H.js → chunk-F4DGB2QI.js}

@@ -1,10 +1,10 @@
 import {
   inquirer_default
-} from "./chunk-F6IDBMXZ.js";
+} from "./chunk-6PRTPBP7.js";
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-TXPR56T5.js → chunk-H3ZCVAW3.js}

@@ -8,7 +8,7 @@ import {
   SYSTEM_PARAMETER_NAMES,
   getSchemaObjectParameters,
   getStructuralSubpaths
-} from "./chunk-T7PAZDQ2.js";
+} from "./chunk-23KWDUJZ.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-B3OMOGVU.js → chunk-HK327LQP.js}

@@ -1,12 +1,12 @@
 import {
   AuthenticatedCommand
-} from "./chunk-4IMXVHLX.js";
+} from "./chunk-SU5G5HM2.js";
 import {
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   getParsedSchema
-} from "./chunk-PU52GTGB.js";
+} from "./chunk-QZNZYG2G.js";
 import {
   __toESM,
   init_cjs_shims

package/dist/{chunk-JV34IPXX.js → chunk-IQIFAKDJ.js}

@@ -1,13 +1,13 @@
 import {
   Schema,
   parseWithError
-} from "./chunk-WUKDB7IX.js";
+} from "./chunk-PHWV3NOP.js";
 import {
   formatValidationErrors
-} from "./chunk-MOBC7AAW.js";
+} from "./chunk-V4IQY3DF.js";
 import {
   BadRequestError
-} from "./chunk-DKAEBT2M.js";
+} from "./chunk-XJ2TNWI7.js";
 import {
   init_cjs_shims
 } from "./chunk-7GH3YGSC.js";

package/dist/{chunk-BMPSZNHE.js → chunk-JO6OQM5C.js}

@@ -1,6 +1,6 @@
 import {
   AuthenticatedCommand
-} from "./chunk-4IMXVHLX.js";
+} from "./chunk-SU5G5HM2.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-DURV4GOT.js → chunk-KVBNKJBH.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-4IMXVHLX.js";
+} from "./chunk-SU5G5HM2.js";
 import {
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-5VGUS75G.js → chunk-LDS5IWT5.js}

@@ -4,25 +4,25 @@ import {
   schemaToEntryDefinitions,
   schemaToPaymentDefinitions,
   validateOutputName
-} from "./chunk-TXPR56T5.js";
+} from "./chunk-H3ZCVAW3.js";
 import {
   Schema,
   parseWithError
-} from "./chunk-WUKDB7IX.js";
+} from "./chunk-PHWV3NOP.js";
 import {
   formatValidationErrors,
   logValidationErrors
-} from "./chunk-MOBC7AAW.js";
+} from "./chunk-V4IQY3DF.js";
 import {
   BadRequestError
-} from "./chunk-DKAEBT2M.js";
+} from "./chunk-XJ2TNWI7.js";
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   getParsedSchema
-} from "./chunk-PU52GTGB.js";
+} from "./chunk-QZNZYG2G.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-SWVXV42Y.js → chunk-M7BM6YC2.js}

@@ -1,7 +1,7 @@
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";

package/dist/{chunk-5JTGKU4S.js → chunk-NJSYUXAC.js}

@@ -1,6 +1,6 @@
 import {
   inquirer_default
-} from "./chunk-F6IDBMXZ.js";
+} from "./chunk-6PRTPBP7.js";
 import {
   defaultBrowserAuthDeps,
   provisionApiClient
@@ -8,7 +8,7 @@ import {
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-LINOTI5E.js";
+} from "./chunk-3IA6BI6A.js";
 import {
   require_source
 } from "./chunk-QDAKBUNO.js";