@digitalex99/unison 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexander Mossin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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
+AUTHORS OR COPYRIGHT HOLDERS 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/bin/unison.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+"use strict";
+
+const { main } = require("../lib/install.js");
+
+main(process.argv.slice(2)).catch((err) => {
+  console.error(`unison-cli: ${err.message}`);
+  process.exit(1);
+});

package/checksums.json

@@ -0,0 +1,7 @@
+{
+  "unison-darwin-amd64.gz": "4ec8cbf3cd0416dfa7fb119c26401f2843d75ee4da67d58b8b815faed2d473f3",
+  "unison-darwin-arm64.gz": "7c904c5aee1d2d574ed37427427c91ddc85bc2be72105d2e0e00681f193a1cc1",
+  "unison-linux-amd64.gz": "f872387bd24134911e38067763f4486f13f3671fe7a106b302f145ac496d5a35",
+  "unison-linux-arm64.gz": "45e8c3d88692275f1164350afffff9202569e097e636dbb04b14b7a4c225780d",
+  "unison-windows-amd64.exe.gz": "d735e36ab270bfc86be0c8275472217f5b1deb4a68095f07809e9a492ba0808e"
+}

package/lib/install.js

@@ -0,0 +1,92 @@
+"use strict";
+
+// The npm package holds no binary: on first run it downloads the one for this
+// platform from the GitHub release of the same version, checks it against the
+// checksums published in the package, caches it, and from then on just runs it.
+// Stdout belongs to the binary (agents parse --json), so progress goes to stderr.
+
+const { spawn } = require("node:child_process");
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const zlib = require("node:zlib");
+
+const RELEASES = "https://github.com/digitalex/unison/releases/download";
+const OSES = { darwin: "darwin", linux: "linux", win32: "windows" };
+const ARCHES = { arm64: "arm64", x64: "amd64" };
+const DOWNLOAD_TIMEOUT_MS = 120_000;
+
+// assetName is the release file for a platform, as release.yml names it.
+function assetName(platform, arch) {
+  const goos = OSES[platform];
+  const goarch = ARCHES[arch];
+  if (!goos || !goarch || (goos === "windows" && goarch !== "amd64")) {
+    throw new Error(`no prebuilt binary for ${platform}/${arch}; build from source with Go: https://github.com/digitalex/unison`);
+  }
+  return `unison-${goos}-${goarch}${goos === "windows" ? ".exe" : ""}.gz`;
+}
+
+function cacheDir(env, platform) {
+  if (platform === "win32" && env.LOCALAPPDATA) return path.join(env.LOCALAPPDATA, "unison-cli");
+  return path.join(env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache"), "unison-cli");
+}
+
+// ensureBinary returns the path of the cached binary, downloading it if needed.
+async function ensureBinary({ version, checksums, platform, arch, env, baseURL = RELEASES }) {
+  const asset = assetName(platform, arch);
+  const want = checksums[asset];
+  if (!want) throw new Error(`this package has no checksum for ${asset}`);
+
+  const dir = path.join(cacheDir(env, platform), version);
+  const bin = path.join(dir, platform === "win32" ? "unison.exe" : "unison");
+  if (fs.existsSync(bin)) return bin;
+
+  const url = `${baseURL}/v${version}/${asset}`;
+  console.error(`unison-cli: downloading ${asset} (v${version})...`);
+  const resp = await fetch(url, { signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS) });
+  if (!resp.ok) throw new Error(`downloading ${url} failed: HTTP ${resp.status}`);
+  const gz = Buffer.from(await resp.arrayBuffer());
+  const got = crypto.createHash("sha256").update(gz).digest("hex");
+  if (got !== want) throw new Error(`checksum mismatch for ${asset}: refusing to run it`);
+
+  // Rename into place, so a concurrent or interrupted run never sees half a binary.
+  fs.mkdirSync(dir, { recursive: true });
+  const tmp = `${bin}.${process.pid}.tmp`;
+  fs.writeFileSync(tmp, zlib.gunzipSync(gz), { mode: 0o755 });
+  fs.renameSync(tmp, bin);
+  return bin;
+}
+
+// runBinary runs bin to completion, passing on its exit code: the protocol
+// depends on them (`unison wait` exits 2 on a timeout, 4 when logged out).
+function runBinary(bin, args) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(bin, args, { stdio: "inherit" });
+    const forward = (sig) => child.kill(sig);
+    process.on("SIGINT", forward);
+    process.on("SIGTERM", forward);
+    child.on("error", reject);
+    child.on("exit", (code, signal) => {
+      process.off("SIGINT", forward);
+      process.off("SIGTERM", forward);
+      resolve({ code, signal });
+    });
+  });
+}
+
+async function main(args) {
+  const { version } = require("../package.json");
+  let checksums;
+  try {
+    checksums = require("../checksums.json");
+  } catch {
+    throw new Error("this copy has no checksums.json: only published packages can download a binary");
+  }
+  const bin = await ensureBinary({ version, checksums, platform: process.platform, arch: process.arch, env: process.env });
+  const { code, signal } = await runBinary(bin, args);
+  if (signal) process.kill(process.pid, signal);
+  else process.exit(code);
+}
+
+module.exports = { assetName, ensureBinary, main, runBinary };

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@digitalex99/unison",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "The Unison CLI: a real-time project workspace where humans and agents build together.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/digitalex/unison.git",
+    "directory": "npm"
+  },
+  "homepage": "https://unison.cloud.run",
+  "bin": {
+    "unison": "bin/unison.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "checksums.json"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test test/install.test.js"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.