mmt-testlight 1.42.1-pre → 1.42.3-pre

package/README.md

@@ -1,6 +1,8 @@
 # Multimeter CLI (mmtcli)
 
-CLI runner for Multimeter test files. The npm package is `mmt-testlight`; the command you run is `testlight`.
+**testlight** runs Multimeter YAML `.mmt` tests in CI and locally. npm package: `mmt-testlight`.
+
+Multimeter is an AI-powered REST Client and API testing tool for VS Code and CI. It is not an electrical multimeter. Git-native alternative to Postman. Docs: https://mmt.dev
 
 ## Usage
 
@@ -22,6 +24,8 @@ npm run build
 
 ## Bundle standalone binaries (pkg)
 
+Uses `@yao-pkg/pkg` in SEA mode (Node 22). Requires Node ≥ 22 on the machine that builds binaries.
+
 ```
 npm run pkg
 ```

package/dist/cli.js

@@ -25513,6 +25513,7 @@ function resolvePassphrase(passphrasePlain, passphraseEnv, envVars, processEnv)
 var DEFAULT_NETWORK_CONFIG;
 var init_NetworkData = __esm({
   "../core/src/NetworkData.ts"() {
+    "use strict";
     DEFAULT_NETWORK_CONFIG = {
       ca: { enabled: false },
       clients: [],
@@ -36327,118 +36328,138 @@ var require_browser = __commonJS({
   }
 });
 
-// node_modules/has-flag/index.js
-var require_has_flag = __commonJS({
-  "node_modules/has-flag/index.js"(exports2, module2) {
-    "use strict";
-    module2.exports = (flag, argv = process.argv) => {
-      const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
-      const position = argv.indexOf(prefix + flag);
-      const terminatorPosition = argv.indexOf("--");
-      return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
-    };
-  }
+// ../node_modules/supports-color/index.js
+var supports_color_exports = {};
+__export(supports_color_exports, {
+  createSupportsColor: () => createSupportsColor,
+  default: () => supports_color_default
 });
-
-// node_modules/supports-color/index.js
-var require_supports_color = __commonJS({
-  "node_modules/supports-color/index.js"(exports2, module2) {
-    "use strict";
-    var os3 = require("os");
-    var tty2 = require("tty");
-    var hasFlag2 = require_has_flag();
-    var { env: env2 } = process;
-    var forceColor;
-    if (hasFlag2("no-color") || hasFlag2("no-colors") || hasFlag2("color=false") || hasFlag2("color=never")) {
-      forceColor = 0;
-    } else if (hasFlag2("color") || hasFlag2("colors") || hasFlag2("color=true") || hasFlag2("color=always")) {
-      forceColor = 1;
-    }
-    if ("FORCE_COLOR" in env2) {
-      if (env2.FORCE_COLOR === "true") {
-        forceColor = 1;
-      } else if (env2.FORCE_COLOR === "false") {
-        forceColor = 0;
-      } else {
-        forceColor = env2.FORCE_COLOR.length === 0 ? 1 : Math.min(parseInt(env2.FORCE_COLOR, 10), 3);
-      }
+function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : import_node_process.default.argv) {
+  const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
+  const position = argv.indexOf(prefix + flag);
+  const terminatorPosition = argv.indexOf("--");
+  return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
+}
+function envForceColor() {
+  if ("FORCE_COLOR" in env) {
+    if (env.FORCE_COLOR === "true") {
+      return 1;
     }
-    function translateLevel2(level) {
-      if (level === 0) {
-        return false;
-      }
-      return {
-        level,
-        hasBasic: true,
-        has256: level >= 2,
-        has16m: level >= 3
-      };
+    if (env.FORCE_COLOR === "false") {
+      return 0;
     }
-    function supportsColor2(haveStream, streamIsTTY) {
-      if (forceColor === 0) {
-        return 0;
-      }
-      if (hasFlag2("color=16m") || hasFlag2("color=full") || hasFlag2("color=truecolor")) {
-        return 3;
-      }
-      if (hasFlag2("color=256")) {
-        return 2;
-      }
-      if (haveStream && !streamIsTTY && forceColor === void 0) {
-        return 0;
-      }
-      const min = forceColor || 0;
-      if (env2.TERM === "dumb") {
-        return min;
-      }
-      if (process.platform === "win32") {
-        const osRelease = os3.release().split(".");
-        if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
-          return Number(osRelease[2]) >= 14931 ? 3 : 2;
-        }
-        return 1;
-      }
-      if ("CI" in env2) {
-        if (["TRAVIS", "CIRCLECI", "APPVEYOR", "GITLAB_CI", "GITHUB_ACTIONS", "BUILDKITE"].some((sign) => sign in env2) || env2.CI_NAME === "codeship") {
-          return 1;
-        }
-        return min;
-      }
-      if ("TEAMCITY_VERSION" in env2) {
-        return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env2.TEAMCITY_VERSION) ? 1 : 0;
-      }
-      if (env2.COLORTERM === "truecolor") {
-        return 3;
-      }
-      if ("TERM_PROGRAM" in env2) {
-        const version = parseInt((env2.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
-        switch (env2.TERM_PROGRAM) {
-          case "iTerm.app":
-            return version >= 3 ? 3 : 2;
-          case "Apple_Terminal":
-            return 2;
-        }
+    return env.FORCE_COLOR.length === 0 ? 1 : Math.min(Number.parseInt(env.FORCE_COLOR, 10), 3);
+  }
+}
+function translateLevel(level) {
+  if (level === 0) {
+    return false;
+  }
+  return {
+    level,
+    hasBasic: true,
+    has256: level >= 2,
+    has16m: level >= 3
+  };
+}
+function _supportsColor(haveStream, { streamIsTTY, sniffFlags = true } = {}) {
+  const noFlagForceColor = envForceColor();
+  if (noFlagForceColor !== void 0) {
+    flagForceColor = noFlagForceColor;
+  }
+  const forceColor = sniffFlags ? flagForceColor : noFlagForceColor;
+  if (forceColor === 0) {
+    return 0;
+  }
+  if (sniffFlags) {
+    if (hasFlag("color=16m") || hasFlag("color=full") || hasFlag("color=truecolor")) {
+      return 3;
+    }
+    if (hasFlag("color=256")) {
+      return 2;
+    }
+  }
+  if ("TF_BUILD" in env && "AGENT_NAME" in env) {
+    return 1;
+  }
+  if (haveStream && !streamIsTTY && forceColor === void 0) {
+    return 0;
+  }
+  const min = forceColor || 0;
+  if (env.TERM === "dumb") {
+    return min;
+  }
+  if (import_node_process.default.platform === "win32") {
+    const osRelease = import_node_os.default.release().split(".");
+    if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
+      return Number(osRelease[2]) >= 14931 ? 3 : 2;
+    }
+    return 1;
+  }
+  if ("CI" in env) {
+    if ("GITHUB_ACTIONS" in env || "GITEA_ACTIONS" in env) {
+      return 3;
+    }
+    if (["TRAVIS", "CIRCLECI", "APPVEYOR", "GITLAB_CI", "BUILDKITE", "DRONE"].some((sign) => sign in env) || env.CI_NAME === "codeship") {
+      return 1;
+    }
+    return min;
+  }
+  if ("TEAMCITY_VERSION" in env) {
+    return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env.TEAMCITY_VERSION) ? 1 : 0;
+  }
+  if (env.COLORTERM === "truecolor") {
+    return 3;
+  }
+  if (env.TERM === "xterm-kitty") {
+    return 3;
+  }
+  if ("TERM_PROGRAM" in env) {
+    const version = Number.parseInt((env.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
+    switch (env.TERM_PROGRAM) {
+      case "iTerm.app": {
+        return version >= 3 ? 3 : 2;
       }
-      if (/-256(color)?$/i.test(env2.TERM)) {
+      case "Apple_Terminal": {
         return 2;
       }
-      if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env2.TERM)) {
-        return 1;
-      }
-      if ("COLORTERM" in env2) {
-        return 1;
-      }
-      return min;
     }
-    function getSupportLevel(stream4) {
-      const level = supportsColor2(stream4, stream4 && stream4.isTTY);
-      return translateLevel2(level);
+  }
+  if (/-256(color)?$/i.test(env.TERM)) {
+    return 2;
+  }
+  if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env.TERM)) {
+    return 1;
+  }
+  if ("COLORTERM" in env) {
+    return 1;
+  }
+  return min;
+}
+function createSupportsColor(stream4, options = {}) {
+  const level = _supportsColor(stream4, {
+    streamIsTTY: stream4 && stream4.isTTY,
+    ...options
+  });
+  return translateLevel(level);
+}
+var import_node_process, import_node_os, import_node_tty, env, flagForceColor, supportsColor, supports_color_default;
+var init_supports_color = __esm({
+  "../node_modules/supports-color/index.js"() {
+    import_node_process = __toESM(require("node:process"), 1);
+    import_node_os = __toESM(require("node:os"), 1);
+    import_node_tty = __toESM(require("node:tty"), 1);
+    ({ env } = import_node_process.default);
+    if (hasFlag("no-color") || hasFlag("no-colors") || hasFlag("color=false") || hasFlag("color=never")) {
+      flagForceColor = 0;
+    } else if (hasFlag("color") || hasFlag("colors") || hasFlag("color=true") || hasFlag("color=always")) {
+      flagForceColor = 1;
     }
-    module2.exports = {
-      supportsColor: getSupportLevel,
-      stdout: translateLevel2(supportsColor2(true, tty2.isatty(1))),
-      stderr: translateLevel2(supportsColor2(true, tty2.isatty(2)))
+    supportsColor = {
+      stdout: createSupportsColor({ isTTY: import_node_tty.default.isatty(1) }),
+      stderr: createSupportsColor({ isTTY: import_node_tty.default.isatty(2) })
     };
+    supports_color_default = supportsColor;
   }
 });
 
@@ -36460,7 +36481,7 @@ var require_node = __commonJS({
     );
     exports2.colors = [6, 2, 3, 4, 5, 1];
     try {
-      const supportsColor2 = require_supports_color();
+      const supportsColor2 = (init_supports_color(), __toCommonJS(supports_color_exports));
       if (supportsColor2 && (supportsColor2.stderr || supportsColor2).level >= 2) {
         exports2.colors = [
           20,
@@ -51750,141 +51771,6 @@ var require_browser2 = __commonJS({
   }
 });
 
-// ../node_modules/supports-color/index.js
-var supports_color_exports = {};
-__export(supports_color_exports, {
-  createSupportsColor: () => createSupportsColor,
-  default: () => supports_color_default
-});
-function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : import_node_process.default.argv) {
-  const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
-  const position = argv.indexOf(prefix + flag);
-  const terminatorPosition = argv.indexOf("--");
-  return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
-}
-function envForceColor() {
-  if ("FORCE_COLOR" in env) {
-    if (env.FORCE_COLOR === "true") {
-      return 1;
-    }
-    if (env.FORCE_COLOR === "false") {
-      return 0;
-    }
-    return env.FORCE_COLOR.length === 0 ? 1 : Math.min(Number.parseInt(env.FORCE_COLOR, 10), 3);
-  }
-}
-function translateLevel(level) {
-  if (level === 0) {
-    return false;
-  }
-  return {
-    level,
-    hasBasic: true,
-    has256: level >= 2,
-    has16m: level >= 3
-  };
-}
-function _supportsColor(haveStream, { streamIsTTY, sniffFlags = true } = {}) {
-  const noFlagForceColor = envForceColor();
-  if (noFlagForceColor !== void 0) {
-    flagForceColor = noFlagForceColor;
-  }
-  const forceColor = sniffFlags ? flagForceColor : noFlagForceColor;
-  if (forceColor === 0) {
-    return 0;
-  }
-  if (sniffFlags) {
-    if (hasFlag("color=16m") || hasFlag("color=full") || hasFlag("color=truecolor")) {
-      return 3;
-    }
-    if (hasFlag("color=256")) {
-      return 2;
-    }
-  }
-  if ("TF_BUILD" in env && "AGENT_NAME" in env) {
-    return 1;
-  }
-  if (haveStream && !streamIsTTY && forceColor === void 0) {
-    return 0;
-  }
-  const min = forceColor || 0;
-  if (env.TERM === "dumb") {
-    return min;
-  }
-  if (import_node_process.default.platform === "win32") {
-    const osRelease = import_node_os.default.release().split(".");
-    if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
-      return Number(osRelease[2]) >= 14931 ? 3 : 2;
-    }
-    return 1;
-  }
-  if ("CI" in env) {
-    if ("GITHUB_ACTIONS" in env || "GITEA_ACTIONS" in env) {
-      return 3;
-    }
-    if (["TRAVIS", "CIRCLECI", "APPVEYOR", "GITLAB_CI", "BUILDKITE", "DRONE"].some((sign) => sign in env) || env.CI_NAME === "codeship") {
-      return 1;
-    }
-    return min;
-  }
-  if ("TEAMCITY_VERSION" in env) {
-    return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env.TEAMCITY_VERSION) ? 1 : 0;
-  }
-  if (env.COLORTERM === "truecolor") {
-    return 3;
-  }
-  if (env.TERM === "xterm-kitty") {
-    return 3;
-  }
-  if ("TERM_PROGRAM" in env) {
-    const version = Number.parseInt((env.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
-    switch (env.TERM_PROGRAM) {
-      case "iTerm.app": {
-        return version >= 3 ? 3 : 2;
-      }
-      case "Apple_Terminal": {
-        return 2;
-      }
-    }
-  }
-  if (/-256(color)?$/i.test(env.TERM)) {
-    return 2;
-  }
-  if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env.TERM)) {
-    return 1;
-  }
-  if ("COLORTERM" in env) {
-    return 1;
-  }
-  return min;
-}
-function createSupportsColor(stream4, options = {}) {
-  const level = _supportsColor(stream4, {
-    streamIsTTY: stream4 && stream4.isTTY,
-    ...options
-  });
-  return translateLevel(level);
-}
-var import_node_process, import_node_os, import_node_tty, env, flagForceColor, supportsColor, supports_color_default;
-var init_supports_color = __esm({
-  "../node_modules/supports-color/index.js"() {
-    import_node_process = __toESM(require("node:process"), 1);
-    import_node_os = __toESM(require("node:os"), 1);
-    import_node_tty = __toESM(require("node:tty"), 1);
-    ({ env } = import_node_process.default);
-    if (hasFlag("no-color") || hasFlag("no-colors") || hasFlag("color=false") || hasFlag("color=never")) {
-      flagForceColor = 0;
-    } else if (hasFlag("color") || hasFlag("colors") || hasFlag("color=true") || hasFlag("color=always")) {
-      flagForceColor = 1;
-    }
-    supportsColor = {
-      stdout: createSupportsColor({ isTTY: import_node_tty.default.isatty(1) }),
-      stderr: createSupportsColor({ isTTY: import_node_tty.default.isatty(2) })
-    };
-    supports_color_default = supportsColor;
-  }
-});
-
 // ../node_modules/debug/src/node.js
 var require_node2 = __commonJS({
   "../node_modules/debug/src/node.js"(exports2, module2) {
@@ -84329,10 +84215,18 @@ function detectPlatform(unameOs = process.platform, unameArch = process.arch) {
   }
   return `${osName}-${arch}`;
 }
+function isSeaBinary() {
+  try {
+    const sea = require("node:sea");
+    return typeof sea.isSea === "function" && sea.isSea();
+  } catch {
+    return false;
+  }
+}
 function detectInstallChannel(execPath, scriptPath) {
   const exec = execPath.replace(/\\/g, "/");
   const script = (scriptPath || "").replace(/\\/g, "/");
-  if (process.pkg) {
+  if (process.pkg || isSeaBinary()) {
     return "standalone";
   }
   if (/\/Cellar\/mmt-testlight\//i.test(exec) || /\/homebrew\/.*(mmt-testlight|testlight)/i.test(exec)) {

package/esbuild.pkg.mjs

@@ -0,0 +1,39 @@
+import * as esbuild from 'esbuild';
+import path from 'path';
+import {fileURLToPath} from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const coreDir = path.resolve(__dirname, '..', 'core', 'src');
+
+// Same resolver as esbuild.mjs so the pkg bundle inlines core from source.
+const mmtCorePlugin = {
+  name: 'mmt-core-resolver',
+  setup(build) {
+    build.onResolve({filter: /^mmt-core$/}, () => ({
+      path: path.join(coreDir, 'index.ts'),
+    }));
+    build.onResolve({filter: /^mmt-core\//}, (args) => {
+      const sub = args.path.replace(/^mmt-core\//, '');
+      return {path: path.join(coreDir, sub + '.ts')};
+    });
+  },
+};
+
+await esbuild.build({
+  entryPoints: ['src/pkg-entry.cjs'],
+  bundle: true,
+  platform: 'node',
+  target: 'node22',
+  format: 'cjs',
+  outfile: 'dist-cjs/pkg-bundle.cjs',
+  plugins: [mmtCorePlugin],
+  resolveExtensions: ['.ts', '.js', '.cjs', '.mjs', '.json'],
+  // Native addons + reflection protos stay on disk for pkg to embed.
+  external: [
+    '@grpc/grpc-js',
+    '@grpc/proto-loader',
+  ],
+  logOverride: {
+    'unsupported-dynamic-import': 'silent',
+  },
+});

package/package.json

@@ -1,9 +1,29 @@
 {
   "name": "mmt-testlight",
-  "version": "1.42.1-pre",
-  "description": "Multimeter CLI test runner",
+  "version": "1.42.3-pre",
+  "description": "AI-powered REST Client and Git-native API testing CLI for YAML .mmt files. Same tests in VS Code and CI. Alternative to Postman.",
   "license": "Apache-2.0",
   "private": false,
+  "homepage": "https://mmt.dev/docs/features/testlight/install",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mshobeyri/multimeter.git",
+    "directory": "mmtcli"
+  },
+  "bugs": {
+    "url": "https://github.com/mshobeyri/multimeter/issues"
+  },
+  "keywords": [
+    "api-testing",
+    "rest-client",
+    "cli",
+    "ci",
+    "yaml",
+    "postman-alternative",
+    "testlight",
+    "multimeter",
+    "mcp"
+  ],
   "bin": {
     "testlight": "dist/cli.js",
     "mmt": "dist/cli.js"
@@ -13,25 +33,20 @@
     "build": "node esbuild.mjs",
     "build:tsc": "tsc -p tsconfig.json",
     "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:pkg-bundle": "node esbuild.pkg.mjs",
     "dev": "tsx src/cli.ts --help",
     "clean": "rimraf dist",
-    "pkg": "rimraf dist-cjs && npm run build:cjs && bash ../scripts/build-binaries.sh",
+    "pkg": "rimraf dist-cjs && npm run build:pkg-bundle && bash ../scripts/build-binaries.sh",
     "test": "echo \"(no tests yet)\""
   },
   "pkg": {
-    "scripts": [
-      "dist-cjs/**/*.js",
-      "node_modules/mmt-core/dist/**/*.js",
-      "../core/dist/**/*.js"
-    ],
     "assets": [
-      "node_modules/axios/dist/**",
-      "node_modules/axios/lib/**",
-      "node_modules/axios/dist/node/axios.cjs",
-      "node_modules/ws/**/*.js",
-      "node_modules/mmt-core/dist/**",
-      "node_modules/mmt-core/package.json",
-      "../core/dist/**"
+      "node_modules/@grpc/grpc-js/**",
+      "node_modules/@grpc/proto-loader/**",
+      "../node_modules/@grpc/grpc-js/**",
+      "../node_modules/@grpc/proto-loader/**",
+      "../core/node_modules/@grpc/grpc-js/**",
+      "../core/node_modules/@grpc/proto-loader/**"
     ]
   },
   "dependencies": {
@@ -44,9 +59,14 @@
     "node-forge": "^1.3.2"
   },
   "devDependencies": {
+    "@grpc/grpc-js": "^1.12.6",
+    "@grpc/proto-loader": "^0.7.13",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.11.30",
-    "pkg": "^5.8.1",
+    "@yao-pkg/pkg": "^6.22.0",
+    "pe-library": "^2.0.1",
+    "png-to-ico": "^2.1.8",
+    "resedit": "^3.1.0",
     "rimraf": "^5.0.5",
     "tsx": "^4.7.0",
     "typescript": "^5.4.2"

package/src/pkg-entry.cjs

@@ -547,6 +547,7 @@ function printHelp() {
 	const commands = formatHelpRows([
 		['run [options] <file>', 'Run a .mmt file'],
 		['print-js [options] <file>', 'Print generated JS for a test'],
+		['update [options]', 'Update this standalone binary from GitHub Releases'],
 		['debug-resolve', 'Print pkg module resolution info'],
 	]);
 	const options = formatHelpRows([
@@ -569,6 +570,8 @@ function printHelp() {
 		['testlight run path/to/test.mmt'],
 		['testlight run path/to/test.mmt -e api_url=https://test.mmt.dev -q'],
 		['testlight print-js path/to/test.mmt'],
+		['testlight update'],
+		['testlight update --check'],
 	], '  ', 0);
 	const out = [
 		'Usage: testlight <command> [options]',
@@ -643,6 +646,35 @@ function printPrintJsHelp() {
 	process.stdout.write(out + '\n');
 }
 
+function printUpdateHelp() {
+	const options = formatHelpRows([
+		['-h, --help', 'Show help'],
+		['--check', 'Only check whether an update is available'],
+		['--to <version>', 'Install a specific version (e.g. 1.38.1)'],
+		['--channel <name>', 'Latest matching channel (beta, rc, prerelease)'],
+		['--force', 'Reinstall even when already newest'],
+		['--repo <owner/name>', 'GitHub repo (default: mshobeyri/multimeter)'],
+		['--base-url <url>', 'Portal/mirror base URL'],
+	]);
+	const examples = formatHelpRows([
+		['testlight update'],
+		['testlight update --check'],
+		['testlight update --to 1.38.1'],
+	], '  ', 0);
+	const out = [
+		'Usage: testlight update [options]',
+		'',
+		'Update this standalone binary from GitHub Releases (or a portal mirror)',
+		'',
+		'Options:',
+		...options,
+		'',
+		'Examples:',
+		...examples,
+	].join('\n');
+	process.stdout.write(out + '\n');
+}
+
 function coerceCliValue(v) {
 	const t = String(v ?? '').trim();
 	if (/^(true|false)$/i.test(t)) {
@@ -919,6 +951,53 @@ function parsePrintJsArgv(argv) {
 	return { filePath, opts };
 }
 
+function parseUpdateArgv(argv) {
+	const opts = {
+		check: false,
+		to: undefined,
+		channel: undefined,
+		force: false,
+		repo: undefined,
+		baseUrl: undefined,
+		help: false,
+	};
+	for (let i = 1; i < argv.length; i++) {
+		const a = argv[i];
+		if (!a) {
+			continue;
+		}
+		if (a === '-h' || a === '--help') {
+			opts.help = true;
+			continue;
+		}
+		if (a === '--check') {
+			opts.check = true;
+			continue;
+		}
+		if (a === '--force') {
+			opts.force = true;
+			continue;
+		}
+		if (a === '--to') {
+			opts.to = argv[++i];
+			continue;
+		}
+		if (a === '--channel') {
+			opts.channel = argv[++i];
+			continue;
+		}
+		if (a === '--repo') {
+			opts.repo = argv[++i];
+			continue;
+		}
+		if (a === '--base-url') {
+			opts.baseUrl = argv[++i];
+			continue;
+		}
+	}
+	return opts;
+}
+
 function parseLogLevel(argv) {
 	for (let i = 1; i < argv.length; i++) {
 		const a = argv[i];
@@ -1023,6 +1102,39 @@ async function main() {
 		process.stdout.write(msgs.join('\n') + '\n');
 		return;
 	}
+	if (command === 'update') {
+		const parsed = parseUpdateArgv(argv);
+		if (parsed.help) {
+			printUpdateHelp();
+			return;
+		}
+		let currentVersion = '';
+		try {
+			currentVersion = String(require('../package.json').version || '');
+		} catch {
+			currentVersion = '';
+		}
+		try {
+			const {runUpdate} = require('./selfUpdate');
+			const result = await runUpdate({
+				currentVersion,
+				checkOnly: !!parsed.check,
+				version: parsed.to,
+				channel: parsed.channel,
+				force: !!parsed.force,
+				repo: parsed.repo,
+				releaseBaseUrl: parsed.baseUrl,
+			});
+			process.stdout.write(String(result.message || '') + '\n');
+			if (!result.ok) {
+				process.exitCode = 2;
+			}
+		} catch (e) {
+			process.stderr.write(`Error updating testlight: ${e && e.message ? e.message : e}\n`);
+			process.exitCode = 2;
+		}
+		return;
+	}
 	if (command !== 'run' && command !== 'print-js') {
 		process.stderr.write(`Unknown command: ${command}\n`);
 		printHelp();

package/src/selfUpdate.test.ts

@@ -1,3 +1,7 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import {execFileSync} from 'child_process';
 import {
   buildDownloadUrl,
   compareVersions,
@@ -5,6 +9,7 @@ import {
   detectPlatform,
   normalizeVersion,
   planUpdate,
+  runUpdate,
 } from './selfUpdate';
 
 describe('selfUpdate helpers', () => {
@@ -31,6 +36,7 @@ describe('selfUpdate helpers', () => {
                '/usr/local/bin/node',
                '/usr/local/lib/node_modules/mmt-testlight/dist/cli.js'))
         .toBe('npm');
+    expect(detectInstallChannel('/Applications/testlight')).toBe('standalone');
   });
 
   it('builds github and portal download urls', () => {
@@ -76,4 +82,41 @@ describe('selfUpdate helpers', () => {
     expect(plan.action).toBe('download');
     expect(plan.downloadUrl).toContain('/v1.2.3/testlight-');
   });
+
+  it('replaces a standalone binary from a downloaded archive', async () => {
+    if (process.platform === 'win32') {
+      return;
+    }
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'testlight-update-test-'));
+    try {
+      const installDir = path.join(tmp, 'install');
+      const payloadDir = path.join(tmp, 'payload');
+      fs.mkdirSync(installDir);
+      fs.mkdirSync(payloadDir);
+      const current = path.join(installDir, 'testlight');
+      fs.writeFileSync(current, 'OLD');
+      fs.chmodSync(current, 0o755);
+      fs.writeFileSync(path.join(payloadDir, 'testlight'), 'NEW');
+      const archive = path.join(tmp, 'pkg.tar.gz');
+      execFileSync('tar', ['-czf', archive, '-C', payloadDir, 'testlight']);
+
+      const result = await runUpdate({
+        currentVersion: '1.0.0',
+        version: '1.2.3',
+        execPath: current,
+        fetchJson: async () => ({tag_name: 'v1.2.3'}),
+        downloadToFile: async (_url, dest) => {
+          fs.copyFileSync(archive, dest);
+        },
+        log: () => {},
+      });
+
+      expect(result.ok).toBe(true);
+      expect(result.updated).toBe(true);
+      expect(fs.readFileSync(current, 'utf8')).toBe('NEW');
+      expect(fs.lstatSync(path.join(installDir, 'mmt')).isSymbolicLink()).toBe(true);
+    } finally {
+      fs.rmSync(tmp, {recursive: true, force: true});
+    }
+  });
 });

package/src/selfUpdate.ts

@@ -107,11 +107,21 @@ export function detectPlatform(
   return `${osName}-${arch}` as UpdatePlatform;
 }
 
+function isSeaBinary(): boolean {
+  try {
+    // Node 20+ official SEA (used by @yao-pkg/pkg --sea). Not set for vercel/pkg.
+    const sea = require('node:sea') as {isSea?: () => boolean};
+    return typeof sea.isSea === 'function' && sea.isSea();
+  } catch {
+    return false;
+  }
+}
+
 export function detectInstallChannel(execPath: string, scriptPath?: string):
     InstallChannel {
   const exec = execPath.replace(/\\/g, '/');
   const script = (scriptPath || '').replace(/\\/g, '/');
-  if ((process as any).pkg) {
+  if ((process as any).pkg || isSeaBinary()) {
     return 'standalone';
   }
   if (/\/Cellar\/mmt-testlight\//i.test(exec) ||