@zuplo/cli 7.3.2 → 7.4.3

package/dist/cli.js

@@ -19,6 +19,7 @@ import editor from "./cmds/editor.js";
 import info from "./cmds/info.js";
 import init from "./cmds/init.js";
 import link from "./cmds/link.js";
+import lint from "./cmds/lint.js";
 import list from "./cmds/list.js";
 import login from "./cmds/login.js";
 import logout from "./cmds/logout.js";
@@ -88,6 +89,7 @@ if (gte(process.versions.node, MIN_NODE_VERSION)) {
         .command(editor)
         .command(info)
         .command(init)
+        .command(lint)
         .command(list)
         .command(link)
         .command(login)

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["import * as dotenv from \"dotenv\";\n\ndotenv.config();\n\nimport { readFileSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { confirm } from \"@inquirer/prompts\";\nimport { gte } from \"semver\";\nimport { hideBin } from \"yargs/helpers\";\nimport yargs from \"yargs/yargs\";\nimport bucket from \"./cmds/bucket/index.js\";\nimport build from \"./cmds/build.js\";\nimport caCertificate from \"./cmds/ca-certificate/index.js\";\nimport compile from \"./cmds/compile.js\";\nimport customDomain from \"./cmds/custom-domain/index.js\";\nimport deleteZup from \"./cmds/delete.js\";\nimport deploy from \"./cmds/deploy.js\";\nimport dev from \"./cmds/dev.js\";\nimport docs from \"./cmds/docs.js\";\nimport editor from \"./cmds/editor.js\";\nimport info from \"./cmds/info.js\";\nimport init from \"./cmds/init.js\";\nimport link from \"./cmds/link.js\";\nimport list from \"./cmds/list.js\";\nimport login from \"./cmds/login.js\";\nimport logout from \"./cmds/logout.js\";\nimport mtlsCertificates from \"./cmds/mtls-certificates/index.js\";\nimport oas from \"./cmds/open-api/index.js\";\nimport project from \"./cmds/project/index.js\";\nimport proxies from \"./cmds/proxies/index.js\";\nimport source from \"./cmds/source/index.js\";\nimport test from \"./cmds/test.js\";\nimport tunnel from \"./cmds/tunnel/index.js\";\nimport variable from \"./cmds/variable/index.js\";\nimport whoami from \"./cmds/whoami.js\";\nimport { captureCliInvocationEvent } from \"./common/analytics/cli-invocation.js\";\nimport { captureError, shutdownAnalytics } from \"./common/analytics/lib.js\";\nimport { ApiError } from \"./common/api/client.js\";\nimport { configureCliDispatcher } from \"./common/cli-dispatcher.js\";\nimport { logger } from \"./common/logger.js\";\nimport { checkPnpmLifecycle } from \"./common/middleware/check-pnpm-lifecycle.js\";\nimport { logLevel } from \"./common/middleware/logging.js\";\nimport { warnIfOutdatedVersion, warnNodeVersion } from \"./common/outdated.js\";\nimport setBlocking, {\n  printCriticalFailureToConsole,\n  printCriticalFailureToConsoleAndExit,\n} from \"./common/output.js\";\n\n// This allows us to stop the CLI from executing so we can connect the profiler\n\n// biome-ignore lint/style/noProcessEnv: Migrated from ESLint\nif (process.env.ZUPLO_CLI_PROFILING) {\n  await confirm({ message: \"Continue executing CLI?\", default: true });\n}\n\n// The CLI requires Node.js 24 or newer, enforced as a hard floor. Our docs\n// tell people to run `npx @zuplo/cli@latest` (including from CI/CD jobs), so\n// anything older stops here with the actionable message below rather than\n// failing later on unsupported syntax.\n// RECOMMENDED matches MIN, so warnNodeVersion() has nothing to warn about today:\n// it only runs once current >= MIN, and warns when current < RECOMMENDED. To add\n// a soft tier later, raise RECOMMENDED ABOVE MIN — versions in between then warn\n// instead of failing.\nconst MIN_NODE_VERSION = \"24.0.0\";\nconst RECOMMENDED_NODE_VERSION = \"24.0.0\";\n\nif (gte(process.versions.node, MIN_NODE_VERSION)) {\n  let cliVersion: string;\n  try {\n    const packageJson = JSON.parse(\n      readFileSync(\n        fileURLToPath(new URL(\"../package.json\", import.meta.url)),\n        \"utf-8\"\n      )\n    );\n    cliVersion = packageJson.version;\n  } catch (e) {\n    cliVersion = \"0.0.0\";\n    logger.error(e);\n    await printCriticalFailureToConsoleAndExit(\n      `Unable to load @zuplo/cli. The package.json is missing or malformed.`\n    );\n  }\n\n  await warnNodeVersion(RECOMMENDED_NODE_VERSION);\n\n  // Install CLI identity headers on undici's global dispatcher before any\n  // command handlers run fetch.\n  configureCliDispatcher(cliVersion);\n\n  const cli = yargs(hideBin(process.argv))\n    // This means that all env vars will have to be prefixed with ZUPLO_\n    .env(\"ZUPLO\")\n    .option(\"prompt\", {\n      type: \"boolean\",\n      describe: \"Bypass confirmation prompts\",\n      default: true,\n      hidden: true,\n    })\n    .option(\"verbose\", {\n      alias: \"v\",\n      type: \"count\",\n      describe: \"Increase verbosity level (-v, -vv, -vvv)\",\n      default: 0,\n    })\n    // setBlocking forces synchronous TTY writes so error messages flush before\n    // process.exit. Runs first so subsequent middleware (including the\n    // preflight, which can exit) benefit from it.\n    .middleware(setBlocking)\n    .middleware(logLevel)\n    .middleware(checkPnpmLifecycle)\n    .middleware((argv) => {\n      void captureCliInvocationEvent(argv, cliVersion);\n    })\n    .command(caCertificate)\n    .command(compile)\n    .command(customDomain)\n    .command(deleteZup) // delete is a reserved keyword in JavaScript, so we call this function deleteZup\n    .command(deploy)\n    .command(dev)\n    .command(docs)\n    .command(editor)\n    .command(info)\n    .command(init)\n    .command(list)\n    .command(link)\n    .command(login)\n    .command(logout)\n    .command(test)\n    .command(oas)\n    .command(mtlsCertificates)\n    .command(project)\n    .command(source)\n    .command(tunnel)\n    .command(variable)\n    .command(build)\n    .command(bucket)\n    .command(proxies)\n    .command(whoami)\n    .demandCommand()\n    .strictCommands()\n    .version(cliVersion)\n    .fail(false)\n    .help();\n\n  let exitCode = 0;\n  try {\n    await cli.argv;\n\n    // Don't block\n    void warnIfOutdatedVersion(cliVersion);\n  } catch (err) {\n    exitCode = 1;\n    if (err instanceof Error) {\n      await captureError(err);\n    }\n    if (err instanceof ApiError) {\n      // The API client has already logged the structured error and printed\n      // a user-facing diagnostic. Nothing more to display here.\n    } else {\n      printCriticalFailureToConsole(err.message ?? err);\n      cli.showHelp();\n    }\n  } finally {\n    await shutdownAnalytics();\n    process.exit(exitCode);\n  }\n} else {\n  await printCriticalFailureToConsoleAndExit(\n    `The Zuplo CLI requires at least node.js v${MIN_NODE_VERSION}. You are using v${process.versions.node}. Please update your version of node.js.\n\n    Consider using a Node.js version manager such as https://github.com/nvm-sh/nvm.`\n  );\n}\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,aAAa,CAAC;AAChC,OAAO,MAAM,MAAM,wBAAwB,CAAC;AAC5C,OAAO,KAAK,MAAM,iBAAiB,CAAC;AACpC,OAAO,aAAa,MAAM,gCAAgC,CAAC;AAC3D,OAAO,OAAO,MAAM,mBAAmB,CAAC;AACxC,OAAO,YAAY,MAAM,+BAA+B,CAAC;AACzD,OAAO,SAAS,MAAM,kBAAkB,CAAC;AACzC,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,GAAG,MAAM,eAAe,CAAC;AAChC,OAAO,IAAI,MAAM,gBAAgB,CAAC;AAClC,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,IAAI,MAAM,gBAAgB,CAAC;AAClC,OAAO,IAAI,MAAM,gBAAgB,CAAC;AAClC,OAAO,IAAI,MAAM,gBAAgB,CAAC;AAClC,OAAO,IAAI,MAAM,gBAAgB,CAAC;AAClC,OAAO,IAAI,MAAM,gBAAgB,CAAC;AAClC,OAAO,KAAK,MAAM,iBAAiB,CAAC;AACpC,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,gBAAgB,MAAM,mCAAmC,CAAC;AACjE,OAAO,GAAG,MAAM,0BAA0B,CAAC;AAC3C,OAAO,OAAO,MAAM,yBAAyB,CAAC;AAC9C,OAAO,OAAO,MAAM,yBAAyB,CAAC;AAC9C,OAAO,MAAM,MAAM,wBAAwB,CAAC;AAC5C,OAAO,IAAI,MAAM,gBAAgB,CAAC;AAClC,OAAO,MAAM,MAAM,wBAAwB,CAAC;AAC5C,OAAO,QAAQ,MAAM,0BAA0B,CAAC;AAChD,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,WAAW,EAAE,EAClB,6BAA6B,EAC7B,oCAAoC,GACrC,MAAM,oBAAoB,CAAC;AAK5B,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;IACpC,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC;AAUD,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAClC,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AAE1C,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAC;IACjD,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CACV,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAC1D,OAAO,CACR,CACF,CAAC;QACF,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC;IACnC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,UAAU,GAAG,OAAO,CAAC;QACrB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChB,MAAM,oCAAoC,CACxC,sEAAsE,CACvE,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,CAAC,wBAAwB,CAAC,CAAC;IAIhD,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEnC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAErC,GAAG,CAAC,OAAO,CAAC;SACZ,MAAM,CAAC,QAAQ,EAAE;QAChB,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,6BAA6B;QACvC,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;KACb,CAAC;SACD,MAAM,CAAC,SAAS,EAAE;QACjB,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,0CAA0C;QACpD,OAAO,EAAE,CAAC;KACX,CAAC;SAID,UAAU,CAAC,WAAW,CAAC;SACvB,UAAU,CAAC,QAAQ,CAAC;SACpB,UAAU,CAAC,kBAAkB,CAAC;SAC9B,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;QACnB,KAAK,yBAAyB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC;SACD,OAAO,CAAC,aAAa,CAAC;SACtB,OAAO,CAAC,OAAO,CAAC;SAChB,OAAO,CAAC,YAAY,CAAC;SACrB,OAAO,CAAC,SAAS,CAAC;SAClB,OAAO,CAAC,MAAM,CAAC;SACf,OAAO,CAAC,GAAG,CAAC;SACZ,OAAO,CAAC,IAAI,CAAC;SACb,OAAO,CAAC,MAAM,CAAC;SACf,OAAO,CAAC,IAAI,CAAC;SACb,OAAO,CAAC,IAAI,CAAC;SACb,OAAO,CAAC,IAAI,CAAC;SACb,OAAO,CAAC,IAAI,CAAC;SACb,OAAO,CAAC,IAAI,CAAC;SACb,OAAO,CAAC,KAAK,CAAC;SACd,OAAO,CAAC,MAAM,CAAC;SACf,OAAO,CAAC,IAAI,CAAC;SACb,OAAO,CAAC,GAAG,CAAC;SACZ,OAAO,CAAC,gBAAgB,CAAC;SACzB,OAAO,CAAC,OAAO,CAAC;SAChB,OAAO,CAAC,MAAM,CAAC;SACf,OAAO,CAAC,MAAM,CAAC;SACf,OAAO,CAAC,QAAQ,CAAC;SACjB,OAAO,CAAC,KAAK,CAAC;SACd,OAAO,CAAC,MAAM,CAAC;SACf,OAAO,CAAC,OAAO,CAAC;SAChB,OAAO,CAAC,MAAM,CAAC;SACf,aAAa,EAAE;SACf,cAAc,EAAE;SAChB,OAAO,CAAC,UAAU,CAAC;SACnB,IAAI,CAAC,KAAK,CAAC;SACX,IAAI,EAAE,CAAC;IAEV,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,IAAI,CAAC;QAGf,KAAK,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,GAAG,CAAC,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAG9B,CAAC;aAAM,CAAC;YACN,6BAA6B,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;YAClD,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,iBAAiB,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;KAAM,CAAC;IACN,MAAM,oCAAoC,CACxC,4CAA4C,gBAAgB,oBAAoB,OAAO,CAAC,QAAQ,CAAC,IAAI;;oFAErB,CACjF,CAAC;AACJ,CAAC","sourcesContent":["import * as dotenv from \"dotenv\";\n\ndotenv.config();\n\nimport { readFileSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { confirm } from \"@inquirer/prompts\";\nimport { gte } from \"semver\";\nimport { hideBin } from \"yargs/helpers\";\nimport yargs from \"yargs/yargs\";\nimport bucket from \"./cmds/bucket/index.js\";\nimport build from \"./cmds/build.js\";\nimport caCertificate from \"./cmds/ca-certificate/index.js\";\nimport compile from \"./cmds/compile.js\";\nimport customDomain from \"./cmds/custom-domain/index.js\";\nimport deleteZup from \"./cmds/delete.js\";\nimport deploy from \"./cmds/deploy.js\";\nimport dev from \"./cmds/dev.js\";\nimport docs from \"./cmds/docs.js\";\nimport editor from \"./cmds/editor.js\";\nimport info from \"./cmds/info.js\";\nimport init from \"./cmds/init.js\";\nimport link from \"./cmds/link.js\";\nimport lint from \"./cmds/lint.js\";\nimport list from \"./cmds/list.js\";\nimport login from \"./cmds/login.js\";\nimport logout from \"./cmds/logout.js\";\nimport mtlsCertificates from \"./cmds/mtls-certificates/index.js\";\nimport oas from \"./cmds/open-api/index.js\";\nimport project from \"./cmds/project/index.js\";\nimport proxies from \"./cmds/proxies/index.js\";\nimport source from \"./cmds/source/index.js\";\nimport test from \"./cmds/test.js\";\nimport tunnel from \"./cmds/tunnel/index.js\";\nimport variable from \"./cmds/variable/index.js\";\nimport whoami from \"./cmds/whoami.js\";\nimport { captureCliInvocationEvent } from \"./common/analytics/cli-invocation.js\";\nimport { captureError, shutdownAnalytics } from \"./common/analytics/lib.js\";\nimport { ApiError } from \"./common/api/client.js\";\nimport { configureCliDispatcher } from \"./common/cli-dispatcher.js\";\nimport { logger } from \"./common/logger.js\";\nimport { checkPnpmLifecycle } from \"./common/middleware/check-pnpm-lifecycle.js\";\nimport { logLevel } from \"./common/middleware/logging.js\";\nimport { warnIfOutdatedVersion, warnNodeVersion } from \"./common/outdated.js\";\nimport setBlocking, {\n  printCriticalFailureToConsole,\n  printCriticalFailureToConsoleAndExit,\n} from \"./common/output.js\";\n\n// This allows us to stop the CLI from executing so we can connect the profiler\n\n// biome-ignore lint/style/noProcessEnv: Migrated from ESLint\nif (process.env.ZUPLO_CLI_PROFILING) {\n  await confirm({ message: \"Continue executing CLI?\", default: true });\n}\n\n// The CLI requires Node.js 24 or newer, enforced as a hard floor. Our docs\n// tell people to run `npx @zuplo/cli@latest` (including from CI/CD jobs), so\n// anything older stops here with the actionable message below rather than\n// failing later on unsupported syntax.\n// RECOMMENDED matches MIN, so warnNodeVersion() has nothing to warn about today:\n// it only runs once current >= MIN, and warns when current < RECOMMENDED. To add\n// a soft tier later, raise RECOMMENDED ABOVE MIN — versions in between then warn\n// instead of failing.\nconst MIN_NODE_VERSION = \"24.0.0\";\nconst RECOMMENDED_NODE_VERSION = \"24.0.0\";\n\nif (gte(process.versions.node, MIN_NODE_VERSION)) {\n  let cliVersion: string;\n  try {\n    const packageJson = JSON.parse(\n      readFileSync(\n        fileURLToPath(new URL(\"../package.json\", import.meta.url)),\n        \"utf-8\"\n      )\n    );\n    cliVersion = packageJson.version;\n  } catch (e) {\n    cliVersion = \"0.0.0\";\n    logger.error(e);\n    await printCriticalFailureToConsoleAndExit(\n      `Unable to load @zuplo/cli. The package.json is missing or malformed.`\n    );\n  }\n\n  await warnNodeVersion(RECOMMENDED_NODE_VERSION);\n\n  // Install CLI identity headers on undici's global dispatcher before any\n  // command handlers run fetch.\n  configureCliDispatcher(cliVersion);\n\n  const cli = yargs(hideBin(process.argv))\n    // This means that all env vars will have to be prefixed with ZUPLO_\n    .env(\"ZUPLO\")\n    .option(\"prompt\", {\n      type: \"boolean\",\n      describe: \"Bypass confirmation prompts\",\n      default: true,\n      hidden: true,\n    })\n    .option(\"verbose\", {\n      alias: \"v\",\n      type: \"count\",\n      describe: \"Increase verbosity level (-v, -vv, -vvv)\",\n      default: 0,\n    })\n    // setBlocking forces synchronous TTY writes so error messages flush before\n    // process.exit. Runs first so subsequent middleware (including the\n    // preflight, which can exit) benefit from it.\n    .middleware(setBlocking)\n    .middleware(logLevel)\n    .middleware(checkPnpmLifecycle)\n    .middleware((argv) => {\n      void captureCliInvocationEvent(argv, cliVersion);\n    })\n    .command(caCertificate)\n    .command(compile)\n    .command(customDomain)\n    .command(deleteZup) // delete is a reserved keyword in JavaScript, so we call this function deleteZup\n    .command(deploy)\n    .command(dev)\n    .command(docs)\n    .command(editor)\n    .command(info)\n    .command(init)\n    .command(lint)\n    .command(list)\n    .command(link)\n    .command(login)\n    .command(logout)\n    .command(test)\n    .command(oas)\n    .command(mtlsCertificates)\n    .command(project)\n    .command(source)\n    .command(tunnel)\n    .command(variable)\n    .command(build)\n    .command(bucket)\n    .command(proxies)\n    .command(whoami)\n    .demandCommand()\n    .strictCommands()\n    .version(cliVersion)\n    .fail(false)\n    .help();\n\n  let exitCode = 0;\n  try {\n    await cli.argv;\n\n    // Don't block\n    void warnIfOutdatedVersion(cliVersion);\n  } catch (err) {\n    exitCode = 1;\n    if (err instanceof Error) {\n      await captureError(err);\n    }\n    if (err instanceof ApiError) {\n      // The API client has already logged the structured error and printed\n      // a user-facing diagnostic. Nothing more to display here.\n    } else {\n      printCriticalFailureToConsole(err.message ?? err);\n      cli.showHelp();\n    }\n  } finally {\n    await shutdownAnalytics();\n    process.exit(exitCode);\n  }\n} else {\n  await printCriticalFailureToConsoleAndExit(\n    `The Zuplo CLI requires at least node.js v${MIN_NODE_VERSION}. You are using v${process.versions.node}. Please update your version of node.js.\n\n    Consider using a Node.js version manager such as https://github.com/nvm-sh/nvm.`\n  );\n}\n"]}

package/dist/cmds/lint.d.ts

@@ -0,0 +1,9 @@
+import { Argv } from "yargs";
+declare const _default: {
+  desc: string;
+  command: string;
+  builder: (yargs: Argv) => Argv<unknown>;
+  handler: (argv: unknown) => Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=lint.d.ts.map

package/dist/cmds/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/cmds/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAUV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBA2Df,OAAO;;AA9D/B,wBAkEE"}

package/dist/cmds/lint.js

@@ -0,0 +1,67 @@
+import { captureEvent } from "../common/analytics/lib.js";
+import { identify } from "../common/middleware/user-identification.js";
+import { ZuploProjectValidator } from "../common/validators/file-system-validator.js";
+import { YargsChecker } from "../common/validators/lib.js";
+import { lint } from "../lint/handler.js";
+export default {
+    desc: "Lints your OpenAPI specs and policies for errors and Zuplo conventions",
+    command: "lint",
+    builder: (yargs) => {
+        return yargs
+            .usage("$0 lint [options]")
+            .option("dir", {
+            type: "string",
+            describe: "The directory containing your Zuplo API",
+            default: ".",
+            normalize: true,
+        })
+            .option("config", {
+            type: "string",
+            describe: "Path to a lint config file. Defaults to zuplo.lint.jsonc or zuplo.lint.json in the project directory.",
+            normalize: true,
+        })
+            .option("format", {
+            type: "string",
+            describe: "Output format",
+            choices: ["text", "json", "sarif"],
+            default: "text",
+        })
+            .option("fail-on", {
+            type: "string",
+            describe: "Severity threshold that fails the command. Defaults to the failOn value in your lint config, or 'error'.",
+            choices: ["error", "warn", "none"],
+        })
+            .option("fix", {
+            type: "boolean",
+            describe: "Rewrite your OpenAPI files to fix what can be fixed automatically, then report what is left",
+            default: false,
+        })
+            .option("lint-binary", {
+            type: "string",
+            describe: "Path to a zuplo-lint executable to use instead of the one installed with the CLI",
+            normalize: true,
+            hidden: true,
+        })
+            .example([
+            ["$0 lint", "Lint the project in the current directory"],
+            ["$0 lint --fix", "Apply the fixes that can be made automatically"],
+            [
+                "$0 lint --fail-on warn",
+                "Fail the command on warnings as well as errors",
+            ],
+            [
+                "$0 lint --format sarif > results.sarif",
+                "Emit SARIF for GitHub Code Scanning",
+            ],
+        ])
+            .check(async (argv) => {
+            return await new YargsChecker(new ZuploProjectValidator()).check(argv);
+        })
+            .middleware([identify]);
+    },
+    handler: async (argv) => {
+        await captureEvent({ argv, event: "zuplo lint" });
+        await lint(argv);
+    },
+};
+//# sourceMappingURL=lint.js.map

package/dist/cmds/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/cmds/lint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAa,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAErD,eAAe;IACb,IAAI,EAAE,wEAAwE;IAC9E,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CAAC,mBAAmB,CAAC;aAC1B,MAAM,CAAC,KAAK,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,yCAAyC;YACnD,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EACN,uGAAuG;YACzG,SAAS,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,eAAe;YACzB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;YAClC,OAAO,EAAE,MAAM;SAChB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EACN,0GAA0G;YAC5G,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;SACnC,CAAC;aACD,MAAM,CAAC,KAAK,EAAE;YACb,IAAI,EAAE,SAAS;YACf,QAAQ,EACN,6FAA6F;YAC/F,OAAO,EAAE,KAAK;SACf,CAAC;aACD,MAAM,CAAC,aAAa,EAAE;YACrB,IAAI,EAAE,QAAQ;YACd,QAAQ,EACN,kFAAkF;YACpF,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;SACb,CAAC;aACD,OAAO,CAAC;YACP,CAAC,SAAS,EAAE,2CAA2C,CAAC;YACxD,CAAC,eAAe,EAAE,gDAAgD,CAAC;YACnE;gBACE,wBAAwB;gBACxB,gDAAgD;aACjD;YACD;gBACE,wCAAwC;gBACxC,qCAAqC;aACtC;SACF,CAAC;aACD,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACpB,OAAO,MAAM,IAAI,YAAY,CAC3B,IAAI,qBAAqB,EAAE,CAC5B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC;aACD,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QAClD,MAAM,IAAI,CAAC,IAAiB,CAAC,CAAC;IAChC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../common/analytics/lib.js\";\nimport { identify } from \"../common/middleware/user-identification.js\";\nimport { ZuploProjectValidator } from \"../common/validators/file-system-validator.js\";\nimport { YargsChecker } from \"../common/validators/lib.js\";\nimport { Arguments, lint } from \"../lint/handler.js\";\n\nexport default {\n  desc: \"Lints your OpenAPI specs and policies for errors and Zuplo conventions\",\n  command: \"lint\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 lint [options]\")\n      .option(\"dir\", {\n        type: \"string\",\n        describe: \"The directory containing your Zuplo API\",\n        default: \".\",\n        normalize: true,\n      })\n      .option(\"config\", {\n        type: \"string\",\n        describe:\n          \"Path to a lint config file. Defaults to zuplo.lint.jsonc or zuplo.lint.json in the project directory.\",\n        normalize: true,\n      })\n      .option(\"format\", {\n        type: \"string\",\n        describe: \"Output format\",\n        choices: [\"text\", \"json\", \"sarif\"],\n        default: \"text\",\n      })\n      .option(\"fail-on\", {\n        type: \"string\",\n        describe:\n          \"Severity threshold that fails the command. Defaults to the failOn value in your lint config, or 'error'.\",\n        choices: [\"error\", \"warn\", \"none\"],\n      })\n      .option(\"fix\", {\n        type: \"boolean\",\n        describe:\n          \"Rewrite your OpenAPI files to fix what can be fixed automatically, then report what is left\",\n        default: false,\n      })\n      .option(\"lint-binary\", {\n        type: \"string\",\n        describe:\n          \"Path to a zuplo-lint executable to use instead of the one installed with the CLI\",\n        normalize: true,\n        hidden: true,\n      })\n      .example([\n        [\"$0 lint\", \"Lint the project in the current directory\"],\n        [\"$0 lint --fix\", \"Apply the fixes that can be made automatically\"],\n        [\n          \"$0 lint --fail-on warn\",\n          \"Fail the command on warnings as well as errors\",\n        ],\n        [\n          \"$0 lint --format sarif > results.sarif\",\n          \"Emit SARIF for GitHub Code Scanning\",\n        ],\n      ])\n      .check(async (argv) => {\n        return await new YargsChecker<typeof argv>(\n          new ZuploProjectValidator()\n        ).check(argv);\n      })\n      .middleware([identify]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({ argv, event: \"zuplo lint\" });\n    await lint(argv as Arguments);\n  },\n};\n"]}

package/dist/lint/handler.d.ts

@@ -0,0 +1,10 @@
+export interface Arguments {
+  dir: string;
+  config?: string;
+  format: string;
+  failOn?: string;
+  fix: boolean;
+  lintBinary?: string;
+}
+export declare function lint(argv: Arguments): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/lint/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/lint/handler.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,iBAqDzC"}

package/dist/lint/handler.js

@@ -0,0 +1,60 @@
+import path from "node:path";
+import { execa } from "execa";
+import { shutdownAnalytics } from "../common/analytics/lib.js";
+import { printCriticalFailureToConsole } from "../common/output.js";
+import { LintBinaryNotFoundError, resolveLintBinary, } from "./resolve-binary.js";
+const EXIT_VIOLATIONS_FOUND = 1;
+const EXIT_RUN_FAILED = 2;
+export async function lint(argv) {
+    let binary;
+    try {
+        binary = resolveLintBinary({ override: argv.lintBinary });
+    }
+    catch (err) {
+        if (err instanceof LintBinaryNotFoundError) {
+            printCriticalFailureToConsole(err.message);
+            await exit(EXIT_RUN_FAILED);
+            return;
+        }
+        throw err;
+    }
+    const args = ["--dir", path.resolve(argv.dir), "--format", argv.format];
+    if (argv.config) {
+        args.push("--config", path.resolve(argv.config));
+    }
+    if (argv.failOn) {
+        args.push("--fail-on", argv.failOn);
+    }
+    if (argv.fix) {
+        args.push("--fix");
+    }
+    try {
+        await execa(binary, args, { stdio: "inherit" });
+        return;
+    }
+    catch (cause) {
+        const exitCode = childExitCode(cause);
+        if (exitCode === undefined) {
+            printCriticalFailureToConsole(`Could not run the linter at ${binary}.\n` +
+                `${cause instanceof Error ? cause.message : String(cause)}`);
+            await exit(EXIT_RUN_FAILED);
+            return;
+        }
+        if (exitCode !== EXIT_VIOLATIONS_FOUND) {
+            printCriticalFailureToConsole(`Lint failed to run (exit code ${exitCode}).`);
+        }
+        await exit(exitCode);
+    }
+}
+async function exit(code) {
+    await shutdownAnalytics();
+    process.exit(code);
+}
+function childExitCode(err) {
+    if (err instanceof Error && "exitCode" in err) {
+        const { exitCode } = err;
+        return typeof exitCode === "number" ? exitCode : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=handler.js.map

package/dist/lint/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/lint/handler.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EACL,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAe7B,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAe;IACxC,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,uBAAuB,EAAE,CAAC;YAC3C,6BAA6B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3C,MAAM,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,CAAC;QAIH,MAAM,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAEtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,6BAA6B,CAC3B,+BAA+B,MAAM,KAAK;gBACxC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9D,CAAC;YACF,MAAM,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QAKD,IAAI,QAAQ,KAAK,qBAAqB,EAAE,CAAC;YACvC,6BAA6B,CAC3B,iCAAiC,QAAQ,IAAI,CAC9C,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAQD,KAAK,UAAU,IAAI,CAAC,IAAY;IAC9B,MAAM,iBAAiB,EAAE,CAAC;IAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAOD,SAAS,aAAa,CAAC,GAAY;IACjC,IAAI,GAAG,YAAY,KAAK,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QAC9C,MAAM,EAAE,QAAQ,EAAE,GAAG,GAA4B,CAAC;QAClD,OAAO,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import path from \"node:path\";\nimport { execa } from \"execa\";\nimport { shutdownAnalytics } from \"../common/analytics/lib.js\";\nimport { printCriticalFailureToConsole } from \"../common/output.js\";\nimport {\n  LintBinaryNotFoundError,\n  resolveLintBinary,\n} from \"./resolve-binary.js\";\n\nexport interface Arguments {\n  dir: string;\n  config?: string;\n  format: string;\n  failOn?: string;\n  fix: boolean;\n  lintBinary?: string;\n}\n\n/**\n * Exit codes, matching the linter's own contract so CI can tell the two apart:\n * 1 means the project has violations, 2 means the linter could not run.\n */\nconst EXIT_VIOLATIONS_FOUND = 1;\nconst EXIT_RUN_FAILED = 2;\n\nexport async function lint(argv: Arguments) {\n  let binary: string;\n  try {\n    binary = resolveLintBinary({ override: argv.lintBinary });\n  } catch (err) {\n    if (err instanceof LintBinaryNotFoundError) {\n      printCriticalFailureToConsole(err.message);\n      await exit(EXIT_RUN_FAILED);\n      return;\n    }\n    throw err;\n  }\n\n  const args = [\"--dir\", path.resolve(argv.dir), \"--format\", argv.format];\n  if (argv.config) {\n    args.push(\"--config\", path.resolve(argv.config));\n  }\n  if (argv.failOn) {\n    args.push(\"--fail-on\", argv.failOn);\n  }\n  if (argv.fix) {\n    args.push(\"--fix\");\n  }\n\n  try {\n    // The linter writes its own report — results to stdout, diagnostics to\n    // stderr — so inherit the streams rather than buffering and re-printing.\n    // That also leaves its color and TTY detection intact.\n    await execa(binary, args, { stdio: \"inherit\" });\n    return;\n  } catch (cause) {\n    const exitCode = childExitCode(cause);\n\n    if (exitCode === undefined) {\n      printCriticalFailureToConsole(\n        `Could not run the linter at ${binary}.\\n` +\n          `${cause instanceof Error ? cause.message : String(cause)}`\n      );\n      await exit(EXIT_RUN_FAILED);\n      return;\n    }\n\n    // Anything other than \"violations found\" means the linter itself failed.\n    // Its diagnostic already went to stderr, but on its own that reads like a\n    // lint result rather than a broken invocation.\n    if (exitCode !== EXIT_VIOLATIONS_FOUND) {\n      printCriticalFailureToConsole(\n        `Lint failed to run (exit code ${exitCode}).`\n      );\n    }\n\n    await exit(exitCode);\n  }\n}\n\n/**\n * Exit with the linter's own status rather than throwing. Throwing would send\n * this through cli.ts's catch, which prints a redundant error and dumps the\n * help text on top of a report the user has already read. Matches how\n * `zuplo test` propagates a failing run.\n */\nasync function exit(code: number): Promise<never> {\n  await shutdownAnalytics();\n  process.exit(code);\n}\n\n/**\n * The child's exit status, or undefined when the process never ran. execa types\n * `exitCode` as a number, but a spawn failure — the file is not executable, or\n * is a binary for another architecture — produces an error without one.\n */\nfunction childExitCode(err: unknown): number | undefined {\n  if (err instanceof Error && \"exitCode\" in err) {\n    const { exitCode } = err as { exitCode: unknown };\n    return typeof exitCode === \"number\" ? exitCode : undefined;\n  }\n  return undefined;\n}\n"]}

package/dist/lint/resolve-binary.d.ts

@@ -0,0 +1,20 @@
+export declare function lintPackageName(
+  platform?: NodeJS.Platform,
+  arch?: string
+): string;
+export declare class LintBinaryNotFoundError extends Error {
+  readonly packageName: string;
+  constructor(message: string, packageName: string);
+}
+export interface ResolveLintBinaryOptions {
+  override?: string;
+  platform?: NodeJS.Platform;
+  arch?: string;
+  resolveFrom?: string;
+  devBinaryPath?: string;
+  fileExists?: (filePath: string) => boolean;
+}
+export declare function resolveLintBinary(
+  options?: ResolveLintBinaryOptions
+): string;
+//# sourceMappingURL=resolve-binary.d.ts.map

package/dist/lint/resolve-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-binary.d.ts","sourceRoot":"","sources":["../../src/lint/resolve-binary.ts"],"names":[],"mappings":"AAaA,wBAAgB,eAAe,CAC7B,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,IAAI,GAAE,MAAqB,GAC1B,MAAM,CAER;AAOD,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,WAAW,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,MAAM;CAMtC;AAED,MAAM,WAAW,wBAAwB;IAMvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IAQd,WAAW,CAAC,EAAE,MAAM,CAAC;IAMrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C;AAQD,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,MAAM,CA8CR"}

package/dist/lint/resolve-binary.js

@@ -0,0 +1,71 @@
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export function lintPackageName(platform = process.platform, arch = process.arch) {
+    return `@zuplo/lint-${platform}-${arch}`;
+}
+function binaryFileName(platform = process.platform) {
+    return platform === "win32" ? "zuplo-lint.exe" : "zuplo-lint";
+}
+export class LintBinaryNotFoundError extends Error {
+    packageName;
+    constructor(message, packageName) {
+        super(message);
+        this.packageName = packageName;
+        this.name = "LintBinaryNotFoundError";
+        Object.setPrototypeOf(this, LintBinaryNotFoundError.prototype);
+    }
+}
+export function resolveLintBinary(options = {}) {
+    const { override, platform = process.platform, arch = process.arch, resolveFrom = fileURLToPath(import.meta.url), devBinaryPath = defaultDevBinaryPath(platform), fileExists = existsSync, } = options;
+    if (override) {
+        const resolved = path.resolve(override);
+        if (!fileExists(resolved)) {
+            throw new LintBinaryNotFoundError(`No zuplo-lint binary at ${resolved}.\n` +
+                `This path came from --lint-binary (or ZUPLO_LINT_BINARY). Point it at a zuplo-lint executable, or unset it to use the binary installed with the CLI.`, lintPackageName(platform, arch));
+        }
+        return resolved;
+    }
+    const packageName = lintPackageName(platform, arch);
+    const fileName = binaryFileName(platform);
+    const fromPackage = resolveFromPackage(packageName, fileName, resolveFrom, fileExists);
+    if (fromPackage) {
+        return fromPackage;
+    }
+    if (devBinaryPath && fileExists(devBinaryPath)) {
+        return devBinaryPath;
+    }
+    throw new LintBinaryNotFoundError(`The zuplo-lint binary for your platform (${platform}-${arch}) is not installed.\n` +
+        `It ships as the optional dependency ${packageName}. Reinstall the CLI to pick it up:\n` +
+        `  npm install --force @zuplo/cli\n` +
+        `If your install skips optional dependencies (npm install --no-optional, or a lockfile from another platform), install ${packageName} directly, or point --lint-binary at a zuplo-lint executable you provide.`, packageName);
+}
+function resolveFromPackage(packageName, fileName, resolveFrom, fileExists) {
+    let manifest;
+    try {
+        manifest = createRequire(resolveFrom).resolve(`${packageName}/package.json`);
+    }
+    catch (cause) {
+        if (isModuleNotFound(cause)) {
+            return undefined;
+        }
+        throw new LintBinaryNotFoundError(`The zuplo-lint package ${packageName} is installed but could not be read:\n` +
+            `${cause instanceof Error ? cause.message : String(cause)}\n` +
+            `Reinstalling usually fixes this:\n` +
+            `  npm install --force @zuplo/cli`, packageName);
+    }
+    const candidate = path.join(path.dirname(manifest), "bin", fileName);
+    return fileExists(candidate) ? candidate : undefined;
+}
+function isModuleNotFound(err) {
+    if (!(err instanceof Error) || !("code" in err)) {
+        return false;
+    }
+    const { code } = err;
+    return code === "MODULE_NOT_FOUND" || code === "ERR_MODULE_NOT_FOUND";
+}
+function defaultDevBinaryPath(platform) {
+    return fileURLToPath(new URL(`../../../../dist/zuplo-lint/${binaryFileName(platform)}`, import.meta.url));
+}
+//# sourceMappingURL=resolve-binary.js.map

package/dist/lint/resolve-binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-binary.js","sourceRoot":"","sources":["../../src/lint/resolve-binary.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/**\n * The npm package that carries the zuplo-lint binary for a given platform.\n *\n * @zuplo/cli declares every supported platform as an optional dependency with\n * matching `os`/`cpu` fields, so npm installs only the one that fits the\n * consumer's machine. The naming convention is shared with\n * cmd/zuplo-lint/npm-targets.json, which generates those packages.\n */\nexport function lintPackageName(\n  platform: NodeJS.Platform = process.platform,\n  arch: string = process.arch\n): string {\n  return `@zuplo/lint-${platform}-${arch}`;\n}\n\nfunction binaryFileName(platform: NodeJS.Platform = process.platform): string {\n  return platform === \"win32\" ? \"zuplo-lint.exe\" : \"zuplo-lint\";\n}\n\n/** Raised when no zuplo-lint binary can be found for the current platform. */\nexport class LintBinaryNotFoundError extends Error {\n  constructor(\n    message: string,\n    public readonly packageName: string\n  ) {\n    super(message);\n    this.name = \"LintBinaryNotFoundError\";\n    Object.setPrototypeOf(this, LintBinaryNotFoundError.prototype);\n  }\n}\n\nexport interface ResolveLintBinaryOptions {\n  /**\n   * An explicit binary path, from `--lint-binary` / `ZUPLO_LINT_BINARY`. Used\n   * verbatim when set, which is the escape hatch for air-gapped installs and\n   * for testing a locally built linter.\n   */\n  override?: string;\n  platform?: NodeJS.Platform;\n  arch?: string;\n  /**\n   * The file path node resolves the platform package relative to — a file, not\n   * a directory, because that is what `createRequire` expects (a directory path\n   * would be treated as a file and resolve one level too high). Defaults to\n   * this module's own location, which is what makes resolution work from a\n   * global install.\n   */\n  resolveFrom?: string;\n  /**\n   * Repo-local build output (dist/zuplo-lint/zuplo-lint), used when developing\n   * in the monorepo where the platform packages are not installed. Resolution\n   * falls back to it only after the platform package is not found.\n   */\n  devBinaryPath?: string;\n  fileExists?: (filePath: string) => boolean;\n}\n\n/**\n * Locate the zuplo-lint executable.\n *\n * Order: explicit override, then the platform's optional dependency, then the\n * monorepo's own build output.\n */\nexport function resolveLintBinary(\n  options: ResolveLintBinaryOptions = {}\n): string {\n  const {\n    override,\n    platform = process.platform,\n    arch = process.arch,\n    resolveFrom = fileURLToPath(import.meta.url),\n    devBinaryPath = defaultDevBinaryPath(platform),\n    fileExists = existsSync,\n  } = options;\n\n  if (override) {\n    const resolved = path.resolve(override);\n    if (!fileExists(resolved)) {\n      throw new LintBinaryNotFoundError(\n        `No zuplo-lint binary at ${resolved}.\\n` +\n          `This path came from --lint-binary (or ZUPLO_LINT_BINARY). Point it at a zuplo-lint executable, or unset it to use the binary installed with the CLI.`,\n        lintPackageName(platform, arch)\n      );\n    }\n    return resolved;\n  }\n\n  const packageName = lintPackageName(platform, arch);\n  const fileName = binaryFileName(platform);\n\n  const fromPackage = resolveFromPackage(\n    packageName,\n    fileName,\n    resolveFrom,\n    fileExists\n  );\n  if (fromPackage) {\n    return fromPackage;\n  }\n\n  if (devBinaryPath && fileExists(devBinaryPath)) {\n    return devBinaryPath;\n  }\n\n  throw new LintBinaryNotFoundError(\n    `The zuplo-lint binary for your platform (${platform}-${arch}) is not installed.\\n` +\n      `It ships as the optional dependency ${packageName}. Reinstall the CLI to pick it up:\\n` +\n      `  npm install --force @zuplo/cli\\n` +\n      `If your install skips optional dependencies (npm install --no-optional, or a lockfile from another platform), install ${packageName} directly, or point --lint-binary at a zuplo-lint executable you provide.`,\n    packageName\n  );\n}\n\n/**\n * Resolve the binary inside the platform package. `require.resolve` on the\n * package's package.json — rather than on the package name — works even though\n * these packages have no `main`/`exports` entry: they contain only a binary.\n *\n * Returns undefined when the package simply is not installed, which is an\n * ordinary outcome: npm skips optional dependencies whose os/cpu do not match,\n * and a `--no-optional` install skips all of them. Any other resolver failure\n * means the package IS there but is unusable, so it is reported rather than\n * folded into the \"not installed\" path — otherwise a corrupt install sends the\n * user looking for a package that is sitting right there.\n */\nfunction resolveFromPackage(\n  packageName: string,\n  fileName: string,\n  resolveFrom: string,\n  fileExists: (filePath: string) => boolean\n): string | undefined {\n  let manifest: string;\n  try {\n    manifest = createRequire(resolveFrom).resolve(\n      `${packageName}/package.json`\n    );\n  } catch (cause) {\n    if (isModuleNotFound(cause)) {\n      return undefined;\n    }\n    throw new LintBinaryNotFoundError(\n      `The zuplo-lint package ${packageName} is installed but could not be read:\\n` +\n        `${cause instanceof Error ? cause.message : String(cause)}\\n` +\n        `Reinstalling usually fixes this:\\n` +\n        `  npm install --force @zuplo/cli`,\n      packageName\n    );\n  }\n\n  const candidate = path.join(path.dirname(manifest), \"bin\", fileName);\n  return fileExists(candidate) ? candidate : undefined;\n}\n\n/** Whether an error from `require.resolve` means the package is absent. */\nfunction isModuleNotFound(err: unknown): boolean {\n  if (!(err instanceof Error) || !(\"code\" in err)) {\n    return false;\n  }\n  const { code } = err as { code: unknown };\n  return code === \"MODULE_NOT_FOUND\" || code === \"ERR_MODULE_NOT_FOUND\";\n}\n\n/**\n * Where `nx run zuplo-lint:build` puts the binary, relative to the compiled\n * CLI at packages/cli/dist/lint/. Only meaningful inside the monorepo.\n */\nfunction defaultDevBinaryPath(platform: NodeJS.Platform): string {\n  return fileURLToPath(\n    new URL(\n      `../../../../dist/zuplo-lint/${binaryFileName(platform)}`,\n      import.meta.url\n    )\n  );\n}\n"]}

package/dist/lint/resolve-binary.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-binary.test.d.ts.map

package/dist/lint/resolve-binary.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-binary.test.d.ts","sourceRoot":"","sources":["../../src/lint/resolve-binary.test.ts"],"names":[],"mappings":""}

package/dist/lint/resolve-binary.test.js

@@ -0,0 +1,155 @@
+import assert from "node:assert";
+import { mkdirSync, mkdtempSync, realpathSync, rmSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { after, before, describe, it } from "node:test";
+import { LintBinaryNotFoundError, lintPackageName, resolveLintBinary, } from "./resolve-binary.js";
+describe("lintPackageName", () => {
+    it("derives the package name from platform and arch", () => {
+        assert.strictEqual(lintPackageName("darwin", "arm64"), "@zuplo/lint-darwin-arm64");
+        assert.strictEqual(lintPackageName("linux", "x64"), "@zuplo/lint-linux-x64");
+        assert.strictEqual(lintPackageName("win32", "x64"), "@zuplo/lint-win32-x64");
+    });
+});
+describe("resolveLintBinary", () => {
+    let tmpRoot;
+    let overridePath;
+    before(() => {
+        tmpRoot = realpathSync(mkdtempSync(path.join(tmpdir(), "lint-binary-")));
+        overridePath = path.join(tmpRoot, "custom-zuplo-lint");
+        writeFileSync(overridePath, "#!/bin/sh\n");
+    });
+    after(() => {
+        rmSync(tmpRoot, { recursive: true, force: true });
+    });
+    it("uses an explicit override ahead of everything else", () => {
+        const devBinaryPath = path.join(tmpRoot, "dev", "zuplo-lint");
+        mkdirSync(path.dirname(devBinaryPath), { recursive: true });
+        writeFileSync(devBinaryPath, "");
+        assert.strictEqual(resolveLintBinary({ override: overridePath, devBinaryPath }), overridePath);
+    });
+    it("resolves a relative override against the working directory", () => {
+        const relative = path.relative(process.cwd(), overridePath);
+        assert.strictEqual(resolveLintBinary({ override: relative }), path.resolve(relative));
+    });
+    it("reports the bad path when the override does not exist", () => {
+        const missing = path.join(tmpRoot, "nope");
+        assert.throws(() => resolveLintBinary({ override: missing }), (err) => {
+            assert.ok(err instanceof LintBinaryNotFoundError);
+            assert.match(err.message, /No zuplo-lint binary at/);
+            assert.ok(err.message.includes(missing), "expected the resolved path in the message");
+            assert.match(err.message, /--lint-binary/);
+            return true;
+        });
+    });
+    it("falls back to the repo build output when the platform package is absent", () => {
+        const devBinaryPath = path.join(tmpRoot, "dist", "zuplo-lint");
+        mkdirSync(path.dirname(devBinaryPath), { recursive: true });
+        writeFileSync(devBinaryPath, "");
+        assert.strictEqual(resolveLintBinary({
+            platform: "linux",
+            arch: "mips",
+            devBinaryPath,
+        }), devBinaryPath);
+    });
+    it("throws an actionable error when nothing is installed", () => {
+        assert.throws(() => resolveLintBinary({
+            platform: "linux",
+            arch: "mips",
+            devBinaryPath: path.join(tmpRoot, "does-not-exist"),
+        }), (err) => {
+            assert.ok(err instanceof LintBinaryNotFoundError);
+            assert.strictEqual(err.packageName, "@zuplo/lint-linux-mips");
+            assert.match(err.message, /@zuplo\/lint-linux-mips/);
+            assert.match(err.message, /linux-mips/);
+            assert.match(err.message, /--lint-binary/);
+            return true;
+        });
+    });
+    it("finds the binary inside an installed platform package", () => {
+        const projectDir = path.join(tmpRoot, "consumer");
+        const pkgDir = path.join(projectDir, "node_modules", "@zuplo", "lint-linux-x64");
+        mkdirSync(path.join(pkgDir, "bin"), { recursive: true });
+        writeFileSync(path.join(pkgDir, "package.json"), JSON.stringify({ name: "@zuplo/lint-linux-x64", version: "1.0.0" }));
+        const binPath = path.join(pkgDir, "bin", "zuplo-lint");
+        writeFileSync(binPath, "");
+        const resolved = resolveLintBinary({
+            platform: "linux",
+            arch: "x64",
+            resolveFrom: path.join(projectDir, "index.js"),
+            devBinaryPath: path.join(tmpRoot, "does-not-exist"),
+        });
+        assert.strictEqual(resolved, binPath);
+    });
+    it("looks for the .exe on Windows", () => {
+        const projectDir = path.join(tmpRoot, "consumer-win");
+        const pkgDir = path.join(projectDir, "node_modules", "@zuplo", "lint-win32-x64");
+        mkdirSync(path.join(pkgDir, "bin"), { recursive: true });
+        writeFileSync(path.join(pkgDir, "package.json"), JSON.stringify({ name: "@zuplo/lint-win32-x64", version: "1.0.0" }));
+        const binPath = path.join(pkgDir, "bin", "zuplo-lint.exe");
+        writeFileSync(binPath, "");
+        const resolved = resolveLintBinary({
+            platform: "win32",
+            arch: "x64",
+            resolveFrom: path.join(projectDir, "index.js"),
+            devBinaryPath: path.join(tmpRoot, "does-not-exist"),
+        });
+        assert.strictEqual(resolved, binPath);
+    });
+    it("reports a package that is present but unreadable, instead of calling it missing", () => {
+        const projectDir = path.join(tmpRoot, "consumer-corrupt");
+        const pkgDir = path.join(projectDir, "node_modules", "@zuplo", "lint-linux-x64");
+        mkdirSync(path.join(pkgDir, "bin"), { recursive: true });
+        writeFileSync(path.join(pkgDir, "package.json"), JSON.stringify({
+            name: "@zuplo/lint-linux-x64",
+            version: "1.0.0",
+            exports: { "./bin/*": "./bin/*" },
+        }));
+        writeFileSync(path.join(pkgDir, "bin", "zuplo-lint"), "");
+        const devBinaryPath = path.join(tmpRoot, "dist", "zuplo-lint");
+        mkdirSync(path.dirname(devBinaryPath), { recursive: true });
+        writeFileSync(devBinaryPath, "");
+        assert.throws(() => resolveLintBinary({
+            platform: "linux",
+            arch: "x64",
+            resolveFrom: path.join(projectDir, "index.js"),
+            devBinaryPath,
+        }), (err) => {
+            assert.ok(err instanceof LintBinaryNotFoundError);
+            assert.match(err.message, /installed but could not be read/);
+            assert.strictEqual(err.packageName, "@zuplo/lint-linux-x64");
+            return true;
+        });
+    });
+    it("treats a genuinely absent package as not installed, not an error to rethrow", () => {
+        const projectDir = path.join(tmpRoot, "consumer-absent");
+        mkdirSync(projectDir, { recursive: true });
+        const devBinaryPath = path.join(tmpRoot, "dist", "zuplo-lint");
+        mkdirSync(path.dirname(devBinaryPath), { recursive: true });
+        writeFileSync(devBinaryPath, "");
+        assert.strictEqual(resolveLintBinary({
+            platform: "linux",
+            arch: "x64",
+            resolveFrom: path.join(projectDir, "index.js"),
+            devBinaryPath,
+        }), devBinaryPath);
+    });
+    it("prefers the installed platform package over the repo build output", () => {
+        const projectDir = path.join(tmpRoot, "consumer-precedence");
+        const pkgDir = path.join(projectDir, "node_modules", "@zuplo", "lint-linux-x64");
+        mkdirSync(path.join(pkgDir, "bin"), { recursive: true });
+        writeFileSync(path.join(pkgDir, "package.json"), JSON.stringify({ name: "@zuplo/lint-linux-x64", version: "1.0.0" }));
+        const binPath = path.join(pkgDir, "bin", "zuplo-lint");
+        writeFileSync(binPath, "");
+        const devBinaryPath = path.join(tmpRoot, "dist", "zuplo-lint");
+        mkdirSync(path.dirname(devBinaryPath), { recursive: true });
+        writeFileSync(devBinaryPath, "");
+        assert.strictEqual(resolveLintBinary({
+            platform: "linux",
+            arch: "x64",
+            resolveFrom: path.join(projectDir, "index.js"),
+            devBinaryPath,
+        }), binPath);
+    });
+});
+//# sourceMappingURL=resolve-binary.test.js.map

package/dist/lint/resolve-binary.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-binary.test.js","sourceRoot":"","sources":["../../src/lint/resolve-binary.test.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from \"node:assert\";\nimport {\n  mkdirSync,\n  mkdtempSync,\n  realpathSync,\n  rmSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport { after, before, describe, it } from \"node:test\";\nimport {\n  LintBinaryNotFoundError,\n  lintPackageName,\n  resolveLintBinary,\n} from \"./resolve-binary.js\";\n\ndescribe(\"lintPackageName\", () => {\n  it(\"derives the package name from platform and arch\", () => {\n    assert.strictEqual(\n      lintPackageName(\"darwin\", \"arm64\"),\n      \"@zuplo/lint-darwin-arm64\"\n    );\n    assert.strictEqual(\n      lintPackageName(\"linux\", \"x64\"),\n      \"@zuplo/lint-linux-x64\"\n    );\n    assert.strictEqual(\n      lintPackageName(\"win32\", \"x64\"),\n      \"@zuplo/lint-win32-x64\"\n    );\n  });\n});\n\ndescribe(\"resolveLintBinary\", () => {\n  let tmpRoot: string;\n  let overridePath: string;\n\n  before(() => {\n    // realpath because require.resolve returns real paths, and on macOS\n    // os.tmpdir() is /tmp, a symlink to /private/tmp.\n    tmpRoot = realpathSync(mkdtempSync(path.join(tmpdir(), \"lint-binary-\")));\n    overridePath = path.join(tmpRoot, \"custom-zuplo-lint\");\n    writeFileSync(overridePath, \"#!/bin/sh\\n\");\n  });\n\n  after(() => {\n    rmSync(tmpRoot, { recursive: true, force: true });\n  });\n\n  it(\"uses an explicit override ahead of everything else\", () => {\n    const devBinaryPath = path.join(tmpRoot, \"dev\", \"zuplo-lint\");\n    mkdirSync(path.dirname(devBinaryPath), { recursive: true });\n    writeFileSync(devBinaryPath, \"\");\n\n    assert.strictEqual(\n      resolveLintBinary({ override: overridePath, devBinaryPath }),\n      overridePath\n    );\n  });\n\n  it(\"resolves a relative override against the working directory\", () => {\n    const relative = path.relative(process.cwd(), overridePath);\n\n    assert.strictEqual(\n      resolveLintBinary({ override: relative }),\n      path.resolve(relative)\n    );\n  });\n\n  it(\"reports the bad path when the override does not exist\", () => {\n    const missing = path.join(tmpRoot, \"nope\");\n\n    assert.throws(\n      () => resolveLintBinary({ override: missing }),\n      (err: unknown) => {\n        assert.ok(err instanceof LintBinaryNotFoundError);\n        assert.match(err.message, /No zuplo-lint binary at/);\n        assert.ok(\n          err.message.includes(missing),\n          \"expected the resolved path in the message\"\n        );\n        // The message has to name the flag, or the user cannot tell where the\n        // path came from.\n        assert.match(err.message, /--lint-binary/);\n        return true;\n      }\n    );\n  });\n\n  it(\"falls back to the repo build output when the platform package is absent\", () => {\n    const devBinaryPath = path.join(tmpRoot, \"dist\", \"zuplo-lint\");\n    mkdirSync(path.dirname(devBinaryPath), { recursive: true });\n    writeFileSync(devBinaryPath, \"\");\n\n    assert.strictEqual(\n      resolveLintBinary({\n        platform: \"linux\",\n        arch: \"mips\",\n        devBinaryPath,\n      }),\n      devBinaryPath\n    );\n  });\n\n  it(\"throws an actionable error when nothing is installed\", () => {\n    assert.throws(\n      () =>\n        resolveLintBinary({\n          platform: \"linux\",\n          arch: \"mips\",\n          devBinaryPath: path.join(tmpRoot, \"does-not-exist\"),\n        }),\n      (err: unknown) => {\n        assert.ok(err instanceof LintBinaryNotFoundError);\n        assert.strictEqual(err.packageName, \"@zuplo/lint-linux-mips\");\n        // An unsupported platform must say which package is missing and how to\n        // recover, not just that something went wrong.\n        assert.match(err.message, /@zuplo\\/lint-linux-mips/);\n        assert.match(err.message, /linux-mips/);\n        assert.match(err.message, /--lint-binary/);\n        return true;\n      }\n    );\n  });\n\n  it(\"finds the binary inside an installed platform package\", () => {\n    // Lay out a node_modules tree the way npm would, and resolve from a module\n    // inside it.\n    const projectDir = path.join(tmpRoot, \"consumer\");\n    const pkgDir = path.join(\n      projectDir,\n      \"node_modules\",\n      \"@zuplo\",\n      \"lint-linux-x64\"\n    );\n    mkdirSync(path.join(pkgDir, \"bin\"), { recursive: true });\n    writeFileSync(\n      path.join(pkgDir, \"package.json\"),\n      JSON.stringify({ name: \"@zuplo/lint-linux-x64\", version: \"1.0.0\" })\n    );\n    const binPath = path.join(pkgDir, \"bin\", \"zuplo-lint\");\n    writeFileSync(binPath, \"\");\n\n    const resolved = resolveLintBinary({\n      platform: \"linux\",\n      arch: \"x64\",\n      resolveFrom: path.join(projectDir, \"index.js\"),\n      devBinaryPath: path.join(tmpRoot, \"does-not-exist\"),\n    });\n\n    assert.strictEqual(resolved, binPath);\n  });\n\n  it(\"looks for the .exe on Windows\", () => {\n    const projectDir = path.join(tmpRoot, \"consumer-win\");\n    const pkgDir = path.join(\n      projectDir,\n      \"node_modules\",\n      \"@zuplo\",\n      \"lint-win32-x64\"\n    );\n    mkdirSync(path.join(pkgDir, \"bin\"), { recursive: true });\n    writeFileSync(\n      path.join(pkgDir, \"package.json\"),\n      JSON.stringify({ name: \"@zuplo/lint-win32-x64\", version: \"1.0.0\" })\n    );\n    const binPath = path.join(pkgDir, \"bin\", \"zuplo-lint.exe\");\n    writeFileSync(binPath, \"\");\n\n    const resolved = resolveLintBinary({\n      platform: \"win32\",\n      arch: \"x64\",\n      resolveFrom: path.join(projectDir, \"index.js\"),\n      devBinaryPath: path.join(tmpRoot, \"does-not-exist\"),\n    });\n\n    assert.strictEqual(resolved, binPath);\n  });\n\n  it(\"reports a package that is present but unreadable, instead of calling it missing\", () => {\n    // An `exports` map that does not expose ./package.json makes require.resolve\n    // fail with ERR_PACKAGE_PATH_NOT_EXPORTED rather than MODULE_NOT_FOUND. The\n    // package is right there, so saying \"not installed\" would send the user\n    // hunting for something they already have.\n    const projectDir = path.join(tmpRoot, \"consumer-corrupt\");\n    const pkgDir = path.join(\n      projectDir,\n      \"node_modules\",\n      \"@zuplo\",\n      \"lint-linux-x64\"\n    );\n    mkdirSync(path.join(pkgDir, \"bin\"), { recursive: true });\n    writeFileSync(\n      path.join(pkgDir, \"package.json\"),\n      JSON.stringify({\n        name: \"@zuplo/lint-linux-x64\",\n        version: \"1.0.0\",\n        exports: { \"./bin/*\": \"./bin/*\" },\n      })\n    );\n    writeFileSync(path.join(pkgDir, \"bin\", \"zuplo-lint\"), \"\");\n\n    // A dev binary is available, but must NOT be used to paper over this: the\n    // consumer's own platform package is broken and they need to know.\n    const devBinaryPath = path.join(tmpRoot, \"dist\", \"zuplo-lint\");\n    mkdirSync(path.dirname(devBinaryPath), { recursive: true });\n    writeFileSync(devBinaryPath, \"\");\n\n    assert.throws(\n      () =>\n        resolveLintBinary({\n          platform: \"linux\",\n          arch: \"x64\",\n          resolveFrom: path.join(projectDir, \"index.js\"),\n          devBinaryPath,\n        }),\n      (err: unknown) => {\n        assert.ok(err instanceof LintBinaryNotFoundError);\n        assert.match(err.message, /installed but could not be read/);\n        assert.strictEqual(err.packageName, \"@zuplo/lint-linux-x64\");\n        return true;\n      }\n    );\n  });\n\n  it(\"treats a genuinely absent package as not installed, not an error to rethrow\", () => {\n    // The counterpart to the test above: MODULE_NOT_FOUND must stay on the\n    // ordinary path so the dev fallback still applies.\n    const projectDir = path.join(tmpRoot, \"consumer-absent\");\n    mkdirSync(projectDir, { recursive: true });\n\n    const devBinaryPath = path.join(tmpRoot, \"dist\", \"zuplo-lint\");\n    mkdirSync(path.dirname(devBinaryPath), { recursive: true });\n    writeFileSync(devBinaryPath, \"\");\n\n    assert.strictEqual(\n      resolveLintBinary({\n        platform: \"linux\",\n        arch: \"x64\",\n        resolveFrom: path.join(projectDir, \"index.js\"),\n        devBinaryPath,\n      }),\n      devBinaryPath\n    );\n  });\n\n  it(\"prefers the installed platform package over the repo build output\", () => {\n    const projectDir = path.join(tmpRoot, \"consumer-precedence\");\n    const pkgDir = path.join(\n      projectDir,\n      \"node_modules\",\n      \"@zuplo\",\n      \"lint-linux-x64\"\n    );\n    mkdirSync(path.join(pkgDir, \"bin\"), { recursive: true });\n    writeFileSync(\n      path.join(pkgDir, \"package.json\"),\n      JSON.stringify({ name: \"@zuplo/lint-linux-x64\", version: \"1.0.0\" })\n    );\n    const binPath = path.join(pkgDir, \"bin\", \"zuplo-lint\");\n    writeFileSync(binPath, \"\");\n\n    const devBinaryPath = path.join(tmpRoot, \"dist\", \"zuplo-lint\");\n    mkdirSync(path.dirname(devBinaryPath), { recursive: true });\n    writeFileSync(devBinaryPath, \"\");\n\n    assert.strictEqual(\n      resolveLintBinary({\n        platform: \"linux\",\n        arch: \"x64\",\n        resolveFrom: path.join(projectDir, \"index.js\"),\n        devBinaryPath,\n      }),\n      binPath\n    );\n  });\n});\n"]}