@wordbricks/cva 0.1.1

package/README.md

@@ -0,0 +1,22 @@
+# @wordbricks/cva
+
+Install the Codex Virtual Assistant CLI:
+
+```bash
+npm install -g @wordbricks/cva
+```
+
+This package installs a small Node wrapper and downloads the native `cva` binary for the current platform from GitHub Releases.
+
+After installation:
+
+```bash
+cva version
+cva start
+```
+
+Notes:
+
+- The package name is scoped because the unscoped `cva` package is already taken on npm.
+- The installed command is still `cva`.
+- The downloader expects a matching GitHub release tag in the form `v<package-version>`.

package/bin/cva.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+
+const { binaryPath, currentTarget } = require("../lib/platform");
+const { ensureBinary } = require("../lib/install");
+
+async function main() {
+  const target = currentTarget();
+  let executable = binaryPath(target);
+  if (!fs.existsSync(executable)) {
+    executable = await ensureBinary({ quiet: false });
+  }
+  if (!executable || !fs.existsSync(executable)) {
+    console.error("The native cva binary is not installed.");
+    console.error("Try reinstalling the package or run with CVA_SKIP_DOWNLOAD unset.");
+    process.exit(1);
+  }
+
+  const result = spawnSync(executable, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env
+  });
+  if (result.error) {
+    console.error(result.error.message);
+    process.exit(1);
+  }
+  process.exit(result.status === null ? 1 : result.status);
+}
+
+main().catch((error) => {
+  console.error(error.message);
+  process.exit(1);
+});

package/lib/install.js

@@ -0,0 +1,78 @@
+const fs = require("node:fs");
+const path = require("node:path");
+const https = require("node:https");
+const { pipeline } = require("node:stream/promises");
+
+const {
+  binaryPath,
+  currentTarget,
+  downloadURL,
+  packageRoot
+} = require("./platform");
+
+async function downloadFile(url, destination) {
+  const tempFile = `${destination}.tmp`;
+  await new Promise((resolve, reject) => {
+    const request = https.get(url, (response) => {
+      if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+        response.resume();
+        downloadFile(response.headers.location, destination).then(resolve).catch(reject);
+        return;
+      }
+      if (response.statusCode !== 200) {
+        response.resume();
+        reject(new Error(`Download failed with HTTP ${response.statusCode}: ${url}`));
+        return;
+      }
+
+      const output = fs.createWriteStream(tempFile, { mode: 0o755 });
+      pipeline(response, output)
+        .then(resolve)
+        .catch(reject);
+    });
+    request.on("error", reject);
+  });
+
+  fs.renameSync(tempFile, destination);
+}
+
+async function ensureBinary(options = {}) {
+  const { force = false, quiet = false } = options;
+  if (process.env.CVA_SKIP_DOWNLOAD === "1") {
+    if (!quiet) {
+      console.warn("Skipping cva binary download because CVA_SKIP_DOWNLOAD=1.");
+    }
+    return null;
+  }
+
+  const target = currentTarget();
+  const destination = binaryPath(target);
+  if (!force && fs.existsSync(destination)) {
+    return destination;
+  }
+
+  fs.mkdirSync(path.dirname(destination), { recursive: true });
+  const url = downloadURL(target);
+  if (!quiet) {
+    console.log(`Downloading cva binary from ${url}`);
+  }
+  await downloadFile(url, destination);
+  if (target.platform !== "win32") {
+    fs.chmodSync(destination, 0o755);
+  }
+  return destination;
+}
+
+if (require.main === module) {
+  ensureBinary()
+    .catch((error) => {
+      const relativeRoot = packageRoot();
+      console.error(`Failed to install the native cva binary into ${relativeRoot}`);
+      console.error(error.message);
+      process.exit(1);
+    });
+}
+
+module.exports = {
+  ensureBinary
+};

package/lib/platform.js

@@ -0,0 +1,66 @@
+const os = require("node:os");
+const path = require("node:path");
+
+function packageRoot() {
+  return path.resolve(__dirname, "..");
+}
+
+function readPackageMetadata() {
+  // eslint-disable-next-line global-require, import/no-dynamic-require
+  return require(path.join(packageRoot(), "package.json"));
+}
+
+function currentTarget() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  const supported = new Set([
+    "linux:x64",
+    "linux:arm64",
+    "darwin:x64",
+    "darwin:arm64",
+    "win32:x64",
+    "win32:arm64"
+  ]);
+
+  if (!supported.has(`${platform}:${arch}`)) {
+    throw new Error(`Unsupported platform for cva: ${platform}/${arch}`);
+  }
+
+  return { platform, arch };
+}
+
+function executableName(platform) {
+  return platform === "win32" ? "cva.exe" : "cva";
+}
+
+function assetName(target) {
+  const metadata = readPackageMetadata();
+  const prefix = metadata.cva && metadata.cva.assetPrefix ? metadata.cva.assetPrefix : "cva";
+  return `${prefix}-${target.platform}-${target.arch}${target.platform === "win32" ? ".exe" : ""}`;
+}
+
+function binaryPath(target = currentTarget()) {
+  return path.join(packageRoot(), "vendor", target.platform, target.arch, executableName(target.platform));
+}
+
+function releaseTag(metadata = readPackageMetadata()) {
+  return `v${metadata.version}`;
+}
+
+function downloadURL(target = currentTarget(), metadata = readPackageMetadata()) {
+  const owner = metadata.cva && metadata.cva.owner ? metadata.cva.owner : "wordbricks";
+  const repo = metadata.cva && metadata.cva.repo ? metadata.cva.repo : "codex-virtual-assistant";
+  return `https://github.com/${owner}/${repo}/releases/download/${releaseTag(metadata)}/${assetName(target)}`;
+}
+
+module.exports = {
+  assetName,
+  binaryPath,
+  currentTarget,
+  downloadURL,
+  executableName,
+  packageRoot,
+  readPackageMetadata,
+  releaseTag
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@wordbricks/cva",
+  "version": "0.1.1",
+  "description": "Codex Virtual Assistant CLI wrapper that installs the native cva binary.",
+  "homepage": "https://github.com/wordbricks/codex-virtual-assistant",
+  "bugs": {
+    "url": "https://github.com/wordbricks/codex-virtual-assistant/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wordbricks/codex-virtual-assistant.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "cva": "bin/cva.js"
+  },
+  "scripts": {
+    "postinstall": "node ./lib/install.js"
+  },
+  "files": [
+    "README.md",
+    "bin",
+    "lib"
+  ],
+  "keywords": [
+    "agent",
+    "assistant",
+    "cli",
+    "codex",
+    "cva"
+  ],
+  "cva": {
+    "owner": "wordbricks",
+    "repo": "codex-virtual-assistant",
+    "assetPrefix": "cva"
+  }
+}