@fragment-dev/cli 2026.7.9-1 → 2026.7.9-12

package/README.md

@@ -31,6 +31,7 @@
 * [`fragment update`](#fragment-update)
 * [`fragment update-ledger-account`](#fragment-update-ledger-account)
 * [`fragment verify-schema`](#fragment-verify-schema)
+* [`fragment version`](#fragment-version)
 * [`fragment workspace`](#fragment-workspace)
 
 ## `fragment add-ledger-entry`
@@ -665,6 +666,21 @@ EXAMPLES
   $ fragment verify-schema --path ./my-schema.jsonc --json
 ```
 
+## `fragment version`
+
+Print the installed FRAGMENT CLI version.
+
+```
+USAGE
+  $ fragment version
+
+DESCRIPTION
+  Print the installed FRAGMENT CLI version.
+
+EXAMPLES
+  $ fragment version
+```
+
 ## `fragment workspace`
 
 Get the details of the workspace this CLI is authenticated to

package/dist/{chunk-PILLZB3E.js → chunk-27IQNS3A.js}

@@ -1,16 +1,17 @@
-import {
-  parseJSON
-} from "./chunk-O7AE4SQS.js";
 import {
   readVersionFile,
   updateVersionFile
 } from "./chunk-34NLRFFT.js";
+import {
+  parseJSON
+} from "./chunk-O7AE4SQS.js";
 import {
   require_graphql
 } from "./chunk-QF5EN33L.js";
 import {
+  detectInstallationMethodFromPath,
   getFragmentCliVersion
-} from "./chunk-CW4UI44G.js";
+} from "./chunk-DYLKAHKE.js";
 import {
   require_color_convert,
   require_has_flag,
@@ -47764,6 +47765,9 @@ var FragmentCommand = class extends import_core.Command {
   constructor() {
     super(...arguments);
     this.isBeta = this.config.pjson["beta"] ?? true;
+    // Commands that run their own version check (e.g. `version`) set this to
+    // false to skip init's throttled check and avoid a duplicate warning.
+    this.checkVersionOnInit = true;
     this.auth = null;
     this.posthogClient = null;
   }
@@ -47788,14 +47792,41 @@ var FragmentCommand = class extends import_core.Command {
     };
   }
   async outOfDate() {
-    const latestRelease = await getFragmentCliVersion(this.isBeta);
+    const installationMethod = this.detectInstallationMethod();
+    const latestRelease = await getFragmentCliVersion(
+      this.isBeta,
+      installationMethod
+    );
     const outOfDate = process.env.FRAGMENT_LOCAL_DEV !== "true" && (0, import_semver.compare)(latestRelease, this.config.version) > 0;
-    return { outOfDate, latestRelease };
+    return { outOfDate, latestRelease, installationMethod };
+  }
+  // Warns on stderr when out of date and advances the shared throttle so the
+  // next command skips its own check for six hours. A failed check (e.g.
+  // offline) is swallowed — it never blocks the command or advances the
+  // throttle.
+  async warnIfOutOfDate() {
+    try {
+      const { outOfDate } = await this.outOfDate();
+      if (outOfDate) {
+        this.logToStderr(
+          `${import_chalk.default.yellow("Your CLI version is out of date. Run")} ${import_chalk.default.cyan(
+            "fragment update"
+          )} ${import_chalk.default.yellow("to get the latest version.")}`
+        );
+      }
+      await updateVersionFile(this.debug);
+    } catch (e) {
+      this.debug(`Version check failed: ${e}`);
+    }
   }
   detectInstallationMethod() {
     if (process.env.FRAGMENT_CLI_TEST_ENV === "true") {
       return "npm";
     }
+    const fromPath = detectInstallationMethodFromPath(this.config.root);
+    if (fromPath) {
+      return fromPath;
+    }
     try {
       const brewListResult = (0, import_cross_spawn.sync)("brew", ["list", "--formula"], {
         stdio: "pipe"
@@ -47894,10 +47925,11 @@ var FragmentCommand = class extends import_core.Command {
     }
   }
   async updateFragmentCli({
-    dryRun = false
+    dryRun = false,
+    installationMethod
   }) {
-    const installationMethod = this.detectInstallationMethod();
-    switch (installationMethod) {
+    const method = installationMethod ?? this.detectInstallationMethod();
+    switch (method) {
       case "npm":
         this.log("Detected npm installation. Updating via npm...");
         await this.updateViaNpm({ dryRun });
@@ -47999,7 +48031,7 @@ var FragmentCommand = class extends import_core.Command {
         }
       });
     }
-    if (process.env.FRAGMENT_CLI_TEST_ENV === "true" || process.env.FRAGMENT_SKIP_AUTO_UPDATE === "true") {
+    if (!this.checkVersionOnInit || process.env.FRAGMENT_CLI_TEST_ENV === "true" || process.env.FRAGMENT_SKIP_AUTO_UPDATE === "true") {
       return;
     }
     const versionConfig = await readVersionFile(this.debug);
@@ -48008,15 +48040,7 @@ var FragmentCommand = class extends import_core.Command {
         return;
       }
     }
-    const { outOfDate } = await this.outOfDate();
-    await updateVersionFile(this.debug);
-    if (outOfDate) {
-      this.logToStderr(
-        `${import_chalk.default.yellow("Your CLI version is out of date. Run")} ${import_chalk.default.cyan(
-          "fragment update"
-        )} ${import_chalk.default.yellow("to get the latest version.")}`
-      );
-    }
+    await this.warnIfOutOfDate();
   }
   async catch(err) {
     this.debug(err);

package/dist/{chunk-QRP56DLY.js → chunk-3BWYGCTW.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   getParsedSchema
 } from "./chunk-O7AE4SQS.js";

package/dist/{chunk-QDA5BIHP.js → chunk-3OHJCZZM.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-K2UATKJI.js → chunk-47SENOIF.js}

@@ -18,7 +18,7 @@ import {
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   getParsedSchema
 } from "./chunk-O7AE4SQS.js";

package/dist/{chunk-UOXPSGVC.js → chunk-4CEBCA46.js}

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

package/dist/{chunk-5HH4NNSE.js → chunk-4E6Y3PSS.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-VIVSBPCD.js → chunk-4MZBCWZQ.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-HCTAYKGL.js → chunk-5KUA4RJK.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-VGBDSE7K.js → chunk-5MQSQSME.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   __toESM,
   init_cjs_shims

package/dist/{chunk-NWPJRN3W.js → chunk-624X4WQX.js}

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

package/dist/{chunk-5A52AXRT.js → chunk-7TNXITUF.js}

@@ -1,12 +1,12 @@
 import {
   inquirer_default
-} from "./chunk-QJOWCJUB.js";
+} from "./chunk-KFAA2PA4.js";
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-WMBVWK2M.js → chunk-BC2OJSPA.js}

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

package/dist/{chunk-ZMSR4Z3E.js → chunk-BMOEYXRT.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-FELYEHSZ.js → chunk-CNRBK46D.js}

@@ -5,7 +5,7 @@ import {
   FragmentCommand,
   GraphQLClient,
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   colorizeJson
 } from "./chunk-O7AE4SQS.js";

package/dist/chunk-DYLKAHKE.js

@@ -0,0 +1,36 @@
+import {
+  init_cjs_shims
+} from "./chunk-7GH3YGSC.js";
+
+// src/lib/version.ts
+init_cjs_shims();
+import assert from "node:assert";
+var tapPackageJsonUrl = "https://raw.githubusercontent.com/fragment-dev/homebrew-tap/main/package.json";
+var npmRegistryUrl = "https://registry.npmjs.org/@fragment-dev/cli";
+var detectInstallationMethodFromPath = (root) => {
+  if (/[\\/]Cellar[\\/]/i.test(root)) {
+    return "brew";
+  }
+  if (root.includes("node_modules")) {
+    return "npm";
+  }
+  return void 0;
+};
+var getHomebrewCliVersion = async (isBeta) => {
+  const packageJson = await (await fetch(tapPackageJsonUrl)).json();
+  return packageJson[isBeta ? "dev" : "prod"];
+};
+var getNpmCliVersion = async (isBeta) => {
+  const { "dist-tags": distTags } = await (await fetch(npmRegistryUrl, {
+    headers: { accept: "application/vnd.npm.install-v1+json" }
+  })).json();
+  const version = (isBeta ? distTags?.beta : void 0) ?? distTags?.latest;
+  assert(version, "npm registry returned no dist-tag version");
+  return version;
+};
+var getFragmentCliVersion = async (isBeta, installationMethod = "unknown") => installationMethod === "npm" ? getNpmCliVersion(isBeta) : getHomebrewCliVersion(isBeta);
+
+export {
+  detectInstallationMethodFromPath,
+  getFragmentCliVersion
+};

package/dist/{chunk-BPXEIAXA.js → chunk-EYAGCQYO.js}

@@ -12,7 +12,7 @@ import {
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   colorizeJson,
   emphasize,

package/dist/{chunk-45CYJ3K6.js → chunk-IZBMLZIC.js}

@@ -5,7 +5,7 @@ import {
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   resolveMcpBaseUrl
 } from "./chunk-TLM4VKIC.js";

package/dist/{chunk-QJOWCJUB.js → chunk-KFAA2PA4.js}

@@ -13,7 +13,7 @@ import {
   require_syntax,
   require_type,
   require_uri
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_color_convert,
   require_source

package/dist/{chunk-C7ROAUIM.js → chunk-KT3DLGYI.js}

@@ -1,6 +1,6 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-Z5OAHICZ.js → chunk-LFD4H2HA.js}

@@ -1,75 +1,78 @@
+import {
+  Version
+} from "./chunk-SH5YJD4P.js";
 import {
   Workspace
-} from "./chunk-NWPJRN3W.js";
+} from "./chunk-624X4WQX.js";
 import {
   QuerySchemas
-} from "./chunk-UOXPSGVC.js";
+} from "./chunk-4CEBCA46.js";
 import {
   ReverseLedgerEntry
-} from "./chunk-ZMSR4Z3E.js";
+} from "./chunk-BMOEYXRT.js";
 import {
   Start
-} from "./chunk-LB3C4WTL.js";
+} from "./chunk-PIHY2GFS.js";
 import {
   StoreSchema
-} from "./chunk-OZQUYOQH.js";
+} from "./chunk-QNGMAK7L.js";
 import {
   Token
-} from "./chunk-C7ROAUIM.js";
+} from "./chunk-KT3DLGYI.js";
 import {
   UpdateLedgerAccount
-} from "./chunk-2VYJABNZ.js";
+} from "./chunk-NAO73VDE.js";
 import {
   Update
-} from "./chunk-UMIUGX6O.js";
+} from "./chunk-OAJCTIWT.js";
 import {
   VerifySchema
-} from "./chunk-BPXEIAXA.js";
+} from "./chunk-EYAGCQYO.js";
 import {
   GenGraphQL
-} from "./chunk-K2UATKJI.js";
+} from "./chunk-47SENOIF.js";
 import {
   GetSchema
-} from "./chunk-5A52AXRT.js";
+} from "./chunk-7TNXITUF.js";
 import {
   Init
-} from "./chunk-SQL643PS.js";
+} from "./chunk-VUVWR4BG.js";
 import {
   Login
-} from "./chunk-NAJ7S3OV.js";
+} from "./chunk-LLGNTKT5.js";
 import {
   MigrateLedgerEntry
-} from "./chunk-XDGKUJ32.js";
+} from "./chunk-THBZ6XSN.js";
 import {
   QueryLedgerAccounts
-} from "./chunk-MOZRABR6.js";
+} from "./chunk-OBI2YPSX.js";
 import {
   QueryLedgers
-} from "./chunk-WMBVWK2M.js";
+} from "./chunk-BC2OJSPA.js";
 import {
   GetSchema as GetSchema2
-} from "./chunk-VGBDSE7K.js";
+} from "./chunk-5MQSQSME.js";
 import {
   AddLedgerEntry
-} from "./chunk-J6GQWO4E.js";
+} from "./chunk-U7FUVHZJ.js";
 import {
   ApiClientCreate
-} from "./chunk-45CYJ3K6.js";
+} from "./chunk-IZBMLZIC.js";
 import {
   CreateCustomLink
-} from "./chunk-QDA5BIHP.js";
+} from "./chunk-3OHJCZZM.js";
 import {
   CreateLedger
-} from "./chunk-QRP56DLY.js";
+} from "./chunk-3BWYGCTW.js";
 import {
   DeleteCustomTxs
-} from "./chunk-VIVSBPCD.js";
+} from "./chunk-4MZBCWZQ.js";
 import {
   DeleteLedger
-} from "./chunk-HCTAYKGL.js";
+} from "./chunk-5KUA4RJK.js";
 import {
   DeleteSchema
-} from "./chunk-5HH4NNSE.js";
+} from "./chunk-4E6Y3PSS.js";
 import {
   init_cjs_shims
 } from "./chunk-7GH3YGSC.js";
@@ -81,6 +84,7 @@ var COMMANDS = {
   start: Start,
   // CLI commands
   update: Update,
+  version: Version,
   // Auth commands
   login: Login,
   token: Token,

package/dist/{chunk-NAJ7S3OV.js → chunk-LLGNTKT5.js}

@@ -1,6 +1,6 @@
 import {
   inquirer_default
-} from "./chunk-QJOWCJUB.js";
+} from "./chunk-KFAA2PA4.js";
 import {
   defaultBrowserAuthDeps,
   provisionApiClient
@@ -8,7 +8,7 @@ import {
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-2VYJABNZ.js → chunk-NAO73VDE.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-UMIUGX6O.js → chunk-OAJCTIWT.js}

@@ -1,10 +1,10 @@
 import {
   inquirer_default
-} from "./chunk-QJOWCJUB.js";
+} from "./chunk-KFAA2PA4.js";
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";
@@ -33,7 +33,7 @@ var Update = class _Update extends FragmentCommand {
   async run() {
     const { flags } = await this.parse(_Update);
     let shouldUpdate = flags.yes;
-    const { outOfDate, latestRelease } = await this.outOfDate();
+    const { outOfDate, latestRelease, installationMethod } = await this.outOfDate();
     if (!outOfDate) {
       this.log("Already up-to-date.");
       return;
@@ -54,7 +54,10 @@ Would you like to update the FRAGMENT CLI? (y/n)`,
       ]));
     }
     if (shouldUpdate) {
-      await this.updateFragmentCli({ dryRun: flags["dry-run"] });
+      await this.updateFragmentCli({
+        dryRun: flags["dry-run"],
+        installationMethod
+      });
     } else {
       this.log("Not updating.");
       return;

package/dist/{chunk-MOZRABR6.js → chunk-OBI2YPSX.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   __toESM,
   init_cjs_shims

package/dist/{chunk-LB3C4WTL.js → chunk-PIHY2GFS.js}

@@ -1,7 +1,7 @@
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-OZQUYOQH.js → chunk-QNGMAK7L.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   getParsedSchema
 } from "./chunk-O7AE4SQS.js";

package/dist/chunk-SH5YJD4P.js

@@ -0,0 +1,31 @@
+import {
+  FragmentCommand
+} from "./chunk-27IQNS3A.js";
+import {
+  init_cjs_shims
+} from "./chunk-7GH3YGSC.js";
+
+// src/commands/version.ts
+init_cjs_shims();
+var Version = class _Version extends FragmentCommand {
+  constructor() {
+    super(...arguments);
+    // Skip init's throttled check; run() always does a fresh one below.
+    this.checkVersionOnInit = false;
+  }
+  static {
+    this.description = "Print the installed FRAGMENT CLI version.";
+  }
+  static {
+    this.examples = ["<%= config.bin %> <%= command.id %>"];
+  }
+  async run() {
+    await this.parse(_Version);
+    this.log(this.config.version);
+    await this.warnIfOutOfDate();
+  }
+};
+
+export {
+  Version
+};

package/dist/{chunk-XDGKUJ32.js → chunk-THBZ6XSN.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-J6GQWO4E.js → chunk-U7FUVHZJ.js}

@@ -1,9 +1,9 @@
 import {
   AuthenticatedCommand
-} from "./chunk-FELYEHSZ.js";
+} from "./chunk-CNRBK46D.js";
 import {
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";

package/dist/{chunk-SQL643PS.js → chunk-VUVWR4BG.js}

@@ -1,7 +1,7 @@
 import {
   FragmentCommand,
   require_lib
-} from "./chunk-PILLZB3E.js";
+} from "./chunk-27IQNS3A.js";
 import {
   require_source
 } from "./chunk-XK2D2Z44.js";