gregale 0.1.18-rc.224

package/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2026 Hüseyin Poyraz Küçükarslan. All rights reserved.
+
+PROPRIETARY SOFTWARE — NOT OPEN SOURCE.
+
+This software and its source code are made available for viewing only.
+Unauthorized copying, modification, distribution, public display,
+public performance, or use of this software, in whole or in part, via
+any medium, is strictly prohibited without prior written permission
+from the copyright holder.
+
+To request a license to use this software, contact the copyright
+holder:
+  - Email:  hpk.poyraz@gmail.com
+  - GitHub: https://github.com/poyrazK
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# gregale
+
+The CLI for [Gregale](https://github.com/poyrazK/faas) — scale-to-zero
+Functions-as-a-Service on Firecracker microVMs.
+
+```sh
+npm install -g gregale
+gregale login
+gregale deploy
+```
+
+Or without installing:
+
+```sh
+npx gregale deploy
+```
+
+## What this package contains
+
+No binary. This package is a small launcher; the compiled binary arrives
+through one of four `optionalDependencies`, gated on `os` and `cpu` so npm
+downloads only the one matching your machine:
+
+| Platform | Package |
+|---|---|
+| macOS Apple Silicon | `@gregale/cli-darwin-arm64` |
+| macOS Intel | `@gregale/cli-darwin-amd64` |
+| Linux x86_64 | `@gregale/cli-linux-amd64` |
+| Linux arm64 | `@gregale/cli-linux-arm64` |
+
+If the launcher reports a missing platform package, optional dependencies
+were skipped during install:
+
+```sh
+npm install --include=optional gregale
+```
+
+**Windows is not supported yet.** The `os` field makes npm refuse the
+install rather than leave you with a launcher that cannot find a binary.
+
+## Release channels
+
+`latest` tracks stable releases. Pre-1.0 release candidates publish under
+the `rc` tag:
+
+```sh
+npm install -g gregale@rc
+```
+
+## Other install methods
+
+```sh
+curl -fsSL https://get.gregale.dev | sh
+```
+
+Both channels install the same binary from the same signed GitHub Release.
+Shell completion and man pages come from the binary itself —
+`gregale completion --help` and `gregale man`.
+
+## License
+
+Proprietary. See `LICENSE`.

package/bin/gregale.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+// packaging/npm/cli/bin/gregale.js — launcher for the npm channel (ADR-172).
+//
+// The `gregale` npm package carries no binary. It declares the four
+// @gregale/cli-<os>-<arch> packages as optionalDependencies with `os` and
+// `cpu` constraints, so npm downloads exactly the one that matches the
+// host and skips the rest. This shim finds that package and execs it.
+//
+// Why a JS shim and not a postinstall that symlinks the binary into place:
+// a postinstall is skipped entirely under `npm ci --ignore-scripts`, which
+// is what security-conscious CI uses. The shim costs one node startup
+// (~30 ms) and always works.
+
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+
+// process.arch uses node's names (x64); release artifacts use Go's
+// (amd64). This table is the only place the two vocabularies meet.
+const TARGETS = {
+	"darwin-arm64": "@gregale/cli-darwin-arm64",
+	"darwin-x64": "@gregale/cli-darwin-amd64",
+	"linux-arm64": "@gregale/cli-linux-arm64",
+	"linux-x64": "@gregale/cli-linux-amd64",
+};
+
+function fail(message) {
+	process.stderr.write(`gregale: ${message}\n`);
+	process.exit(1);
+}
+
+function resolveBinary() {
+	const key = `${process.platform}-${process.arch}`;
+	const pkg = TARGETS[key];
+	if (!pkg) {
+		// Windows lands here only if npm's `os` gate was bypassed
+		// (--force). See ADR-172: cmd/gregale imports pkg/fcvm, which
+		// is unix-only.
+		fail(
+			`unsupported platform ${key}. gregale ships darwin and linux on ` +
+				`amd64/arm64. Install from https://get.gregale.dev if you believe ` +
+				`this is wrong.`,
+		);
+	}
+	try {
+		return require.resolve(`${pkg}/bin/gregale`);
+	} catch {
+		fail(
+			`the platform package ${pkg} is missing.\n` +
+				`This usually means npm skipped optional dependencies. Reinstall with:\n` +
+				`  npm install --include=optional gregale\n` +
+				`or install directly:  curl -fsSL https://get.gregale.dev | sh`,
+		);
+	}
+}
+
+const result = spawnSync(resolveBinary(), process.argv.slice(2), {
+	stdio: "inherit",
+});
+
+if (result.error) {
+	fail(`could not run the gregale binary: ${result.error.message}`);
+}
+
+// Re-raise the child's signal so callers see a real signal death rather
+// than a synthesised exit code; `gregale logs -f` interrupted with Ctrl-C
+// should look interrupted to the shell.
+if (result.signal) {
+	process.kill(process.pid, result.signal);
+} else {
+	process.exit(result.status === null ? 1 : result.status);
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "gregale",
+  "version": "0.1.18-rc.224",
+  "description": "Gregale CLI — deploy and operate scale-to-zero apps on Firecracker microVMs",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://github.com/poyrazK/faas",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/poyrazK/faas.git"
+  },
+  "bugs": {
+    "url": "https://github.com/poyrazK/faas/issues"
+  },
+  "keywords": [
+    "gregale",
+    "faas",
+    "serverless",
+    "firecracker",
+    "deploy",
+    "cli"
+  ],
+  "bin": {
+    "gregale": "bin/gregale.js"
+  },
+  "files": [
+    "bin/gregale.js",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "optionalDependencies": {
+    "@gregale/cli-darwin-amd64": "0.1.18-rc.224",
+    "@gregale/cli-darwin-arm64": "0.1.18-rc.224",
+    "@gregale/cli-linux-amd64": "0.1.18-rc.224",
+    "@gregale/cli-linux-arm64": "0.1.18-rc.224"
+  }
+}