@swirls/cli 0.0.23 → 0.1.1

package/README.md

@@ -28,6 +28,14 @@ Run with `swirls`
 swirls <command> [options]
 ```
 
+## Installation and how it works
+
+The published package is a **launcher**: the `swirls` / `cli` bin points at `launcher/cli.js`, which runs on **every** CLI invocation (not at install time).
+
+On install, the package manager installs the launcher plus **one** platform-specific binary. That binary is provided by an optional dependency (`@swirls/cli-darwin-arm64`, etc.). The package manager installs only the optional dependency whose `os` and `cpu` match the host, so you only get the binary for your platform.
+
+At run time, the launcher looks up the current platform, resolves that optional dependency's binary, and exec's it with your arguments.
+
 ## Reference
 
 Run `--help` for a reference guide; use `-v` or `--version` to print the CLI version.

package/launcher/README.md

@@ -0,0 +1,17 @@
+# Launcher
+
+The launcher is the Node entry point for `@swirls/cli`. It runs on every `swirls` invocation, resolves the current platform's optional dependency, and exec's that package's `swirls` binary.
+
+## Files
+
+- **cli.js** — Entry script. Resolves `platform-arch`, looks up the package in `platforms.js`, and exec's the binary with the user's arguments.
+- **platforms.js** — Generated during build from the repo root `platforms.ts`. Do not edit by hand.
+
+## Adding a platform
+
+1. Add an entry to [platforms.ts](../platforms.ts).
+2. Run the build (which regenerates `launcher/platforms.js`).
+3. Add or update the package under `packages/<pkgDir>/` and its `package.json` (with `os` and `cpu`).
+4. Add the npm package to `optionalDependencies` in [package.json](../package.json).
+
+See [AGENTS.md](../AGENTS.md) "Adding a new platform" for detailed build and publish steps.

package/launcher/cli.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+
+import { execFileSync } from 'node:child_process'
+import { createRequire } from 'node:module'
+import { dirname, join } from 'node:path'
+import { platforms } from './platforms.js'
+
+const require = createRequire(import.meta.url)
+
+const key = `${process.platform}-${process.arch}`
+const pkg = platforms[key]
+
+// handle unsupported platform
+if (!pkg) {
+  printUnsupportedPlatform(key)
+  process.exit(1)
+}
+
+const pkgDir = dirname(require.resolve(`${pkg}/package.json`))
+const binary = join(pkgDir, 'swirls')
+
+execFileSync(binary, process.argv.slice(2), { stdio: 'inherit' })
+
+function printUnsupportedPlatform(key) {
+  const noColor = 'NO_COLOR' in process.env
+  const reset = noColor ? '' : '\x1b[0m'
+  const yellow = noColor ? '' : '\x1b[33m'
+  // const bold = noColor ? '' : '\x1b[1m'
+  const cyan = noColor ? '' : '\x1b[36m'
+  const blue = noColor ? '' : '\x1b[34m'
+  const dim = noColor ? '' : '\x1b[2m'
+
+  console.warn(
+    `\n${yellow}Your platform is not currently supported:${reset} ${key}\n`,
+  )
+  console.log('Supported platforms:')
+  for (const [platform, pkgName] of Object.entries(platforms)) {
+    console.log(
+      `  ${cyan}${platform.padEnd(16)}${reset}\t${dim}${pkgName}${reset}`,
+    )
+  }
+  console.log(
+    `\nTo request support for your platform, send us an email at ${blue}help@swirls.ai${reset}\n`,
+  )
+}

package/launcher/platforms.js

@@ -0,0 +1,10 @@
+// Generated during build from `platforms.ts`. Do not edit manually.
+//
+// biome-ignore-all format: generated file
+
+export const platforms = {
+  "darwin-arm64": "@swirls/cli-darwin-arm64",
+  "darwin-x64": "@swirls/cli-darwin-x64",
+  "linux-arm64": "@swirls/cli-linux-arm64",
+  "linux-x64": "@swirls/cli-linux-x64",
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swirls/cli",
-  "version": "0.0.23",
+  "version": "0.1.1",
   "description": "Swirls command line application",
   "author": {
     "name": "Swirls",
@@ -8,20 +8,17 @@
   },
   "type": "module",
   "bin": {
-    "cli": "./dist/cli-shim.js",
-    "swirls": "./dist/cli.js"
+    "cli": "./launcher/cli.js",
+    "swirls": "./launcher/cli.js"
   },
   "files": [
-    "dist"
+    "launcher"
   ],
   "scripts": {
-    "prebuild": "tsc -p tsconfig.json",
-    "build": "if [ \"$SWIRLS_ENV\" = 'production' ]; then tsup; elif command -v op >/dev/null 2>&1; then op run --no-masking --env-file=.env.development -- tsup; else tsup; fi",
-    "postbuild": "cp scripts/cli-shim.js dist/cli-shim.js && chmod +x ./dist/cli.js ./dist/cli-shim.js",
-    "dev": "op run --no-masking --env-file=.env.development -- tsup --watch",
-    "pkg:publish": "bun publish",
-    "pkg:publish:dry": "bun publish --dry-run",
-    "prepublishOnly": "SWIRLS_ENV=production bun run build"
+    "build": "bun run ci/build.ts",
+    "dev": "bun run --watch src/bin/cli.ts",
+    "publish": "SWIRLS_ENV=production bun run build && bun run cd/publish.ts",
+    "publish:dry": "SWIRLS_ENV=production bun run build && bun run cd/publish.ts --dry-run"
   },
   "devDependencies": {
     "@byteslice/result": "0.3.0",
@@ -33,15 +30,20 @@
     "@stricli/core": "1.2.4",
     "@swirls/core": "0.0.1",
     "@swirls/sdk": "0.0.13",
+    "@types/bun": "1.3.9",
     "@types/node": "24.10.0",
     "console-table-printer": "2.15.0",
     "dotenv": "16.4.7",
     "open": "10.2.0",
-    "sucrase": "3.35.1",
-    "tsup": "8.5.1",
     "typescript": "5.9.3",
     "zod": "4.3.5"
   },
+  "optionalDependencies": {
+    "@swirls/cli-darwin-arm64": "0.1.1",
+    "@swirls/cli-darwin-x64": "0.1.1",
+    "@swirls/cli-linux-arm64": "0.1.1",
+    "@swirls/cli-linux-x64": "0.1.1"
+  },
   "engines": {
     "node": ">=22"
   },

package/dist/cli-shim.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import './cli.js'