@lightward/mechanic-cli 0.1.12 → 0.1.13

package/README.md

@@ -40,6 +40,12 @@ npm install -g @lightward/mechanic-cli
 
 In interactive terminals, Mechanic occasionally checks npm and prints the update command when a newer CLI is available.
 
+To check your installed CLI version against the latest published version:
+
+```bash
+mechanic version
+```
+
 ## Quick Start
 
 Create an API token in Mechanic:
@@ -121,6 +127,7 @@ Use JSON output for automation instead of parsing tables or colored text.
 ```bash
 mechanic init --shop example.myshopify.com [--token <token>] [--api-base-url <url>] [--app-url <url>] [--force]
 mechanic help [command]
+mechanic version [--json]
 mechanic doctor
 mechanic auth login [--token <token>]
 mechanic auth logout
@@ -489,6 +496,15 @@ new globals but refuses to overwrite existing remote globals whose values differ
 use `mechanic globals push --dry-run` to review the plan, then pass `--force`
 when the local file should replace those remote values.
 
+For one-off global changes:
+
+```bash
+mechanic globals list
+mechanic globals set warehouse_id --json '"main"'
+mechanic globals set shipping_rules --json '{"regions":["CA","US"]}'
+mechanic globals delete warehouse_id --force
+```
+
 Shop secrets are write-only string values. The CLI never creates a secrets file,
 and task pull, preview, and publish never write secret values into task JSON.
 Use `mechanic secrets set <key> --from-stdin` or `--value-env <env>` for
@@ -497,6 +513,16 @@ trailing newlines. Secret values are not printed after save. Replacing or
 deleting a secret can break tasks until they are updated, so existing secret
 values and secret deletes require `--force`.
 
+For one-off secret changes:
+
+```bash
+mechanic secrets list
+mechanic secrets set api_token
+printf %s "$API_TOKEN" | mechanic secrets set api_token --from-stdin
+mechanic secrets set api_token --value-env API_TOKEN --force
+mechanic secrets delete api_token --force
+```
+
 ## Task Sync API
 
 This package targets Mechanic's v1 task sync API. The CLI is the recommended

package/dist/base-command.js

@@ -9,7 +9,7 @@ import { getUpdateNotice, shouldCheckForUpdates } from "./update-check.js";
 export class BaseCommand extends Command {
     async finally(error) {
         await super.finally(error);
-        if (error || !shouldCheckForUpdates(this.argv)) {
+        if (error || this.id === "version" || !shouldCheckForUpdates(this.argv)) {
             return;
         }
         const notice = await getUpdateNotice();

package/dist/commands/globals/delete.d.ts

@@ -2,6 +2,7 @@ import { BaseCommand } from "../../base-command.js";
 export default class GlobalsDelete extends BaseCommand {
     static summary: string;
     static description: string;
+    static examples: string[];
     static args: {
         key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/globals/delete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/globals/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,OAAO,SAA6B;IACpD,OAAgB,WAAW,SAA2C;IAEtE,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;MAKnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAc3B"}
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/globals/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,OAAO,SAA6B;IACpD,OAAgB,WAAW,SAA2C;IACtE,OAAgB,QAAQ,WAEtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;MAKnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAc3B"}

package/dist/commands/globals/delete.js

@@ -5,13 +5,16 @@ import { CliError } from "../../errors.js";
 export default class GlobalsDelete extends BaseCommand {
     static summary = "Delete one shop global.";
     static description = "Delete one visible shop-level global.";
+    static examples = [
+        "$ mechanic globals delete warehouse_id --force",
+    ];
     static args = {
         key: Args.string({ required: true, description: "Global key, using lower snake-case." }),
     };
     static flags = {
         force: Flags.boolean({
             char: "f",
-            description: "Delete without an interactive confirmation.",
+            description: "Confirm deleting this global.",
         }),
     };
     async run() {

package/dist/commands/globals/pull.d.ts

@@ -2,6 +2,7 @@ import { BaseCommand } from "../../base-command.js";
 export default class GlobalsPull extends BaseCommand {
     static summary: string;
     static description: string;
+    static examples: string[];
     static flags: {
         out: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/commands/globals/pull.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/commands/globals/pull.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,OAAO,SAAmD;IAC1E,OAAgB,WAAW,SAAiE;IAE5F,OAAgB,KAAK;;;MAQnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA0B3B"}
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/commands/globals/pull.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,OAAO,SAAmD;IAC1E,OAAgB,WAAW,SAAiE;IAC5F,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;MAQnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA0B3B"}

package/dist/commands/globals/pull.js

@@ -8,9 +8,14 @@ const DEFAULT_GLOBALS_FILE = "mechanic.globals.json";
 export default class GlobalsPull extends BaseCommand {
     static summary = "Pull shop globals into mechanic.globals.json.";
     static description = "Pull visible shop-level globals into a repo-safe JSON file.";
+    static examples = [
+        "$ mechanic globals pull",
+        "$ mechanic globals pull --out mechanic.globals.json",
+        "$ mechanic globals pull --force",
+    ];
     static flags = {
         out: Flags.string({
-            description: "File path to write.",
+            description: "File path to write. Defaults to repo-safe mechanic.globals.json.",
             default: DEFAULT_GLOBALS_FILE,
         }),
         force: Flags.boolean({

package/dist/commands/globals/push.d.ts

@@ -2,6 +2,7 @@ import { BaseCommand } from "../../base-command.js";
 export default class GlobalsPush extends BaseCommand {
     static summary: string;
     static description: string;
+    static examples: string[];
     static flags: {
         file: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         "dry-run": import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/commands/globals/push.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/commands/globals/push.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAgBpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,OAAO,SAA8C;IACrE,OAAgB,WAAW,SAAmI;IAE9J,OAAgB,KAAK;;;;MAYnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6D3B"}
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/commands/globals/push.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAgBpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,OAAO,SAA8C;IACrE,OAAgB,WAAW,SAAmI;IAC9J,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,KAAK;;;;MAYnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6D3B"}

package/dist/commands/globals/push.js

@@ -15,9 +15,15 @@ function ensurePlainObject(value, source) {
 export default class GlobalsPush extends BaseCommand {
     static summary = "Push mechanic.globals.json to this shop.";
     static description = "Push visible shop-level globals from a repo-safe JSON file. This updates listed keys and does not delete missing remote keys.";
+    static examples = [
+        "$ mechanic globals push --dry-run",
+        "$ mechanic globals push",
+        "$ mechanic globals push --force",
+        "$ mechanic globals push --file mechanic.globals.json --dry-run",
+    ];
     static flags = {
         file: Flags.string({
-            description: "Globals JSON file to read.",
+            description: "Globals JSON file to read. Missing remote keys are not deleted.",
             default: DEFAULT_GLOBALS_FILE,
         }),
         "dry-run": Flags.boolean({

package/dist/commands/globals/set.d.ts

@@ -2,6 +2,7 @@ import { BaseCommand } from "../../base-command.js";
 export default class GlobalsSet extends BaseCommand {
     static summary: string;
     static description: string;
+    static examples: string[];
     static args: {
         key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/globals/set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/commands/globals/set.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,OAAO,SAA0B;IACjD,OAAgB,WAAW,SAA6C;IAExE,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;MAKnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAU3B"}
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/commands/globals/set.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,OAAO,SAA0B;IACjD,OAAgB,WAAW,SAA6C;IACxE,OAAgB,QAAQ,WAItB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;MAKnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAU3B"}

package/dist/commands/globals/set.js

@@ -5,13 +5,18 @@ import { parseJson } from "../../json.js";
 export default class GlobalsSet extends BaseCommand {
     static summary = "Set one shop global.";
     static description = "Set one visible shop-level JSON global.";
+    static examples = [
+        "$ mechanic globals set warehouse_id --json '\"main\"'",
+        "$ mechanic globals set shipping_rules --json '{\"regions\":[\"CA\",\"US\"]}'",
+        "$ mechanic globals set reorder_threshold --json 5",
+    ];
     static args = {
         key: Args.string({ required: true, description: "Global key, using lower snake-case." }),
     };
     static flags = {
         json: Flags.string({
             required: true,
-            description: "JSON value to store.",
+            description: "Any valid JSON value. For strings, include JSON quotes, e.g. --json '\"main\"'.",
         }),
     };
     async run() {

package/dist/commands/secrets/delete.d.ts

@@ -2,6 +2,7 @@ import { BaseCommand } from "../../base-command.js";
 export default class SecretsDelete extends BaseCommand {
     static summary: string;
     static description: string;
+    static examples: string[];
     static args: {
         key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/secrets/delete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/secrets/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,OAAO,SAA6B;IACpD,OAAgB,WAAW,SAAqF;IAEhH,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;MAKnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAc3B"}
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/secrets/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,OAAO,SAA6B;IACpD,OAAgB,WAAW,SAAqF;IAChH,OAAgB,QAAQ,WAEtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;MAKnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAc3B"}

package/dist/commands/secrets/delete.js

@@ -5,13 +5,16 @@ import { CliError } from "../../errors.js";
 export default class SecretsDelete extends BaseCommand {
     static summary = "Delete one shop secret.";
     static description = "Delete one write-only shop-level secret. Affected tasks may fail until updated.";
+    static examples = [
+        "$ mechanic secrets delete api_token --force",
+    ];
     static args = {
         key: Args.string({ required: true, description: "Secret key, using lower snake-case." }),
     };
     static flags = {
         force: Flags.boolean({
             char: "f",
-            description: "Delete without an interactive confirmation.",
+            description: "Confirm deleting this secret.",
         }),
     };
     async run() {

package/dist/commands/secrets/set.d.ts

@@ -7,6 +7,7 @@ export declare function readSecretValueFromEnv(envName: string, env?: NodeJS.Pro
 export default class SecretsSet extends BaseCommand {
     static summary: string;
     static description: string;
+    static examples: string[];
     static args: {
         key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/secrets/set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/commands/secrets/set.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,KAAK,WAAW,GAAG,OAAO,KAAK,CAAC;AAEhC,wBAAgB,SAAS,CAAC,KAAK,GAAE,WAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBrE;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,GAAE,WAAmB,GACzB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAYR;AAED,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,OAAO,SAA0B;IACjD,OAAgB,WAAW,SAAwE;IAEnG,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;MAanB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBpB,WAAW,CAAC,KAAK,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAsB5F"}
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/commands/secrets/set.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,KAAK,WAAW,GAAG,OAAO,KAAK,CAAC;AAEhC,wBAAgB,SAAS,CAAC,KAAK,GAAE,WAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBrE;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,GAAE,WAAmB,GACzB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAYR;AAED,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,OAAO,SAA0B;IACjD,OAAgB,WAAW,SAAwE;IACnG,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;MAanB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBpB,WAAW,CAAC,KAAK,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAsB5F"}

package/dist/commands/secrets/set.js

@@ -40,12 +40,18 @@ export function readSecretValueFromEnv(envName, env = process.env) {
 export default class SecretsSet extends BaseCommand {
     static summary = "Set one shop secret.";
     static description = "Set one write-only shop secret. The secret value is never printed.";
+    static examples = [
+        "$ mechanic secrets set api_token",
+        "$ printf %s \"$API_TOKEN\" | mechanic secrets set api_token --from-stdin",
+        "$ mechanic secrets set api_token --value-env API_TOKEN",
+        "$ mechanic secrets set api_token --value-env API_TOKEN --force",
+    ];
     static args = {
         key: Args.string({ required: true, description: "Secret key, using lower snake-case." }),
     };
     static flags = {
         "from-stdin": Flags.boolean({
-            description: "Read the secret value from stdin.",
+            description: "Read the secret value from stdin. Preserves exact input, including trailing newlines.",
             exclusive: ["value-env"],
         }),
         force: Flags.boolean({
@@ -53,7 +59,7 @@ export default class SecretsSet extends BaseCommand {
             description: "Replace the value when this secret key already exists.",
         }),
         "value-env": Flags.string({
-            description: "Read the secret value from the named environment variable.",
+            description: "Read the secret value from the named environment variable. Empty values are rejected.",
             exclusive: ["from-stdin"],
         }),
     };

package/dist/commands/version.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from "../base-command.js";
+type VersionStatus = "ahead_of_latest" | "unknown" | "update_available" | "up_to_date";
+export default class VersionCommand extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    statusLabel(status: VersionStatus): string;
+}
+export {};
+//# sourceMappingURL=version.d.ts.map

package/dist/commands/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQjD,KAAK,aAAa,GAAG,iBAAiB,GAAG,SAAS,GAAG,kBAAkB,GAAG,YAAY,CAAC;AAkBvF,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IACrD,OAAgB,OAAO,SAAsD;IAC7E,OAAgB,WAAW,SAAwF;IACnH,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,KAAK;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC1B,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;CAY3C"}

package/dist/commands/version.js

@@ -0,0 +1,69 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../base-command.js";
+import { CURRENT_VERSION, PACKAGE_NAME, fetchLatestPackageVersion, isVersionNewer, } from "../update-check.js";
+function statusFor(latestVersion) {
+    if (!latestVersion) {
+        return "unknown";
+    }
+    if (isVersionNewer(latestVersion, CURRENT_VERSION)) {
+        return "update_available";
+    }
+    if (isVersionNewer(CURRENT_VERSION, latestVersion)) {
+        return "ahead_of_latest";
+    }
+    return "up_to_date";
+}
+export default class VersionCommand extends BaseCommand {
+    static summary = "Show installed and latest Mechanic CLI versions.";
+    static description = "Check the installed Mechanic CLI version against the latest published npm version.";
+    static examples = [
+        "$ mechanic version",
+        "$ mechanic version --json",
+    ];
+    static flags = {
+        json: Flags.boolean({
+            description: "Print version status as JSON for agents or scripts.",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(VersionCommand);
+        const latestVersion = await fetchLatestPackageVersion();
+        const status = statusFor(latestVersion);
+        if (flags.json) {
+            this.outputJson({
+                package_name: PACKAGE_NAME,
+                installed_version: CURRENT_VERSION,
+                latest_version: latestVersion,
+                status,
+                update_available: status === "update_available",
+            });
+            return;
+        }
+        this.table([
+            ["Version", "Value"],
+            ["Installed", CURRENT_VERSION],
+            ["Latest", latestVersion || "unknown"],
+            ["Status", this.statusLabel(status)],
+        ]);
+        if (status === "update_available") {
+            this.log("");
+            this.log(`Update with: ${this.taskName("npm install -g @lightward/mechanic-cli")}`);
+        }
+        else if (status === "unknown") {
+            this.log("");
+            this.log(this.muted("Could not check the npm registry. Try again when your network is available."));
+        }
+    }
+    statusLabel(status) {
+        switch (status) {
+            case "ahead_of_latest":
+                return this.color("yellow", "installed version is newer than latest");
+            case "unknown":
+                return this.color("yellow", "unable to check latest version");
+            case "update_available":
+                return this.color("yellow", "update available");
+            case "up_to_date":
+                return this.success("up to date");
+        }
+    }
+}

package/dist/update-check.d.ts

@@ -1,3 +1,5 @@
+export declare const PACKAGE_NAME: string;
+export declare const CURRENT_VERSION: string;
 export type UpdateNotice = {
     currentVersion: string;
     latestVersion: string;
@@ -9,6 +11,7 @@ export type UpdateNoticeOptions = {
     now?: Date;
 };
 export declare function isVersionNewer(candidate: string, current: string): boolean;
+export declare function fetchLatestPackageVersion(): Promise<string | null>;
 export declare function getUpdateNotice(options?: UpdateNoticeOptions): Promise<UpdateNotice | null>;
 export declare function shouldCheckForUpdates(argv?: string[], env?: NodeJS.ProcessEnv, isTty?: boolean): boolean;
 //# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,YAAY,GAAG;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AAsBF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CA+B1E;AA2CD,wBAAsB,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA8CrG;AAED,wBAAgB,qBAAqB,CACnC,IAAI,WAAwB,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,KAAK,UAAgC,GACpC,OAAO,CAeT"}
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,YAAY,QAAgD,CAAC;AAC1E,eAAO,MAAM,eAAe,QAAiC,CAAC;AAiB9D,MAAM,MAAM,YAAY,GAAG;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AAsBF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CA+B1E;AAYD,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBxE;AAUD,wBAAsB,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA8CrG;AAED,wBAAgB,qBAAqB,CACnC,IAAI,WAAwB,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,KAAK,UAAgC,GACpC,OAAO,CAmBT"}

package/dist/update-check.js

@@ -2,8 +2,8 @@ import { createRequire } from "node:module";
 import { appConfigPath, readJson, writeJson } from "./fs.js";
 const require = createRequire(import.meta.url);
 const packageJson = require("../package.json");
-const PACKAGE_NAME = packageJson.name || "@lightward/mechanic-cli";
-const CURRENT_VERSION = packageJson.version || "0.0.0";
+export const PACKAGE_NAME = packageJson.name || "@lightward/mechanic-cli";
+export const CURRENT_VERSION = packageJson.version || "0.0.0";
 const NPM_LATEST_URL = `https://registry.npmjs.org/${encodeURIComponent(PACKAGE_NAME).replace("%40", "@")}/latest`;
 const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 const NOTIFY_INTERVAL_MS = 24 * 60 * 60 * 1000;
@@ -55,7 +55,7 @@ function millisecondsSince(value, now) {
     const parsed = Date.parse(value);
     return Number.isFinite(parsed) ? now.getTime() - parsed : Number.POSITIVE_INFINITY;
 }
-async function fetchLatestPackageVersion() {
+export async function fetchLatestPackageVersion() {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
     try {
@@ -132,5 +132,7 @@ export function shouldCheckForUpdates(argv = process.argv.slice(2), env = proces
         || env.MECHANIC_UPDATE_CHECK === "0") {
         return false;
     }
-    return !argv.some((arg) => arg === "--json" || arg.startsWith("--json="));
+    return !argv.some((arg) => (arg === "version"
+        || arg === "--json"
+        || arg.startsWith("--json=")));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightward/mechanic-cli",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "Develop, preview, diff, and publish Mechanic Shopify automation tasks from local files",
   "type": "module",
   "keywords": [