@intellia/hutly-cli 0.0.0 → 1.0.0

package/README.md

@@ -0,0 +1,37 @@
+# @intellia/hutly-cli
+
+Command-line interface for the Hutly Platform.
+
+## Install
+
+```bash
+npm install -g @intellia/hutly-cli
+```
+
+## Configure
+
+```bash
+export HUTLY_ORG_ID="<your org id>"
+export HUTLY_API_KEY="<your api key>"
+# Optional — defaults to the production endpoint
+export HUTLY_API_ENDPOINT="https://api.intellia.com.au"
+```
+
+## Use
+
+```bash
+hutly --help
+hutly workflow list
+hutly org create --kind office --name "Sydney Office"
+```
+
+Full reference: <https://docs.hutly.com/cli>.
+
+## Supported platforms
+
+- macOS (Apple Silicon and Intel)
+- Linux (x86_64 and arm64)
+- Windows (x86_64)
+
+Each platform receives a single bun-compiled native binary. The npm package
+is a thin launcher that dispatches to the matching binary.

package/bin/hutly.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+/**
+ * Public-facing launcher for `@intellia/hutly-cli`. Pure platform-detection +
+ * `execvp` of the per-platform binary. No business logic.
+ *
+ * Each per-platform sub-package (e.g. `@intellia/hutly-cli-darwin-arm64`) is
+ * listed as an `optionalDependency` of `@intellia/hutly-cli`, so npm only
+ * installs the one matching the host's os/cpu. This launcher resolves
+ * the installed one and forks it.
+ */
+
+"use strict";
+
+const PLATFORM_MAP = {
+  "darwin-arm64": { pkg: "@intellia/hutly-cli-darwin-arm64", binRelative: "bin/hutly" },
+  "darwin-x64":   { pkg: "@intellia/hutly-cli-darwin-x64",   binRelative: "bin/hutly" },
+  "linux-arm64":  { pkg: "@intellia/hutly-cli-linux-arm64",  binRelative: "bin/hutly" },
+  "linux-x64":    { pkg: "@intellia/hutly-cli-linux-x64",    binRelative: "bin/hutly" },
+  "win32-x64":    { pkg: "@intellia/hutly-cli-win32-x64",    binRelative: "bin/hutly.exe" },
+};
+
+function resolveBinaryFor(host) {
+  const key = `${host.platform}-${host.arch}`;
+  const entry = PLATFORM_MAP[key];
+  if (!entry) {
+    const supported = Object.keys(PLATFORM_MAP).join(", ");
+    throw new Error(
+      `no @intellia/hutly-cli build for ${key}; supported platforms: ${supported}`,
+    );
+  }
+  return entry;
+}
+
+module.exports = { resolveBinaryFor, PLATFORM_MAP };
+
+// CLI entry — skip when imported by tests.
+if (require.main === module) {
+  const { spawnSync } = require("node:child_process");
+  const path = require("node:path");
+  try {
+    const entry = resolveBinaryFor({
+      platform: process.platform,
+      arch: process.arch,
+    });
+    // Use require.resolve so we surface a clear error if the optionalDep
+    // wasn't installed (e.g. user is on an unsupported platform and npm
+    // skipped it silently).
+    let binPath;
+    try {
+      binPath = require.resolve(`${entry.pkg}/${entry.binRelative}`);
+    } catch (e) {
+      console.error(
+        `error: ${entry.pkg} is not installed. If you installed @intellia/hutly-cli ` +
+        `with --no-optional or are on an unsupported platform, please ` +
+        `re-install without that flag.`,
+      );
+      process.exit(127);
+    }
+    const result = spawnSync(binPath, process.argv.slice(2), {
+      stdio: "inherit",
+      env: process.env,
+    });
+    if (result.error) {
+      console.error(`error: failed to spawn ${binPath}: ${result.error.message}`);
+      process.exit(1);
+    }
+    // A signal-killed child has status === null and signal set. Map it to the
+    // Unix 128 + signum convention so a wrapping script's $? sees the abnormal
+    // termination instead of a masked exit 0.
+    if (result.signal) {
+      const signum = require("node:os").constants.signals[result.signal];
+      process.exit(128 + (signum ?? 1));
+    }
+    process.exit(result.status ?? 0);
+  } catch (err) {
+    console.error(`error: ${err.message}`);
+    process.exit(1);
+  }
+}

package/package.json

@@ -1,7 +1,29 @@
 {
   "name": "@intellia/hutly-cli",
-  "version": "0.0.0",
-  "description": "Placeholder — the real artifact is published via CI. See https://github.com/NexEvol/intellia-monorepo",
+  "version": "1.0.0",
+  "description": "Hutly Platform CLI — workflow / agent / KB deployment, secrets, sub-org provisioning",
+  "bin": {
+    "hutly": "bin/hutly.js"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
   "license": "UNLICENSED",
-  "repository": { "type": "git", "url": "https://github.com/NexEvol/intellia-monorepo.git" }
+  "homepage": "https://docs.hutly.com/cli",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NexEvol/intellia-monorepo.git",
+    "directory": "packages/hutly-cli-npm/launcher"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "optionalDependencies": {
+    "@intellia/hutly-cli-darwin-arm64": "1.0.0",
+    "@intellia/hutly-cli-darwin-x64": "1.0.0",
+    "@intellia/hutly-cli-linux-arm64": "1.0.0",
+    "@intellia/hutly-cli-linux-x64": "1.0.0",
+    "@intellia/hutly-cli-win32-x64": "1.0.0"
+  }
 }