clawreform 0.3.1

package/README.md

@@ -0,0 +1,20 @@
+# clawreform (npm CLI launcher)
+
+Installs the native `clawreform` CLI from GitHub Releases and exposes it on your npm global PATH.
+
+## Install
+
+```bash
+npm install -g clawreform
+```
+
+## Verify
+
+```bash
+clawreform --version
+```
+
+## Notes
+
+- This package downloads the matching binary for Linux, macOS, and Windows.
+- No third-party runtime dependencies are used in this npm package.

package/bin/clawreform.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const { ensureBinaryInstalled } = require("../lib/install");
+
+async function main() {
+  let binaryPath;
+  try {
+    binaryPath = await ensureBinaryInstalled();
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`clawreform npm launcher failed to install runtime binary: ${message}`);
+    process.exit(1);
+  }
+
+  const result = spawnSync(binaryPath, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env
+  });
+
+  if (result.error) {
+    console.error(`Failed to run clawreform binary: ${result.error.message}`);
+    process.exit(1);
+  }
+
+  process.exit(result.status ?? 1);
+}
+
+main();

package/lib/install.js

@@ -0,0 +1,169 @@
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const REPO = process.env.CLAWREFORM_NPM_REPO || "aegntic/clawreform";
+
+function normalizeVersion(version) {
+  if (!version) {
+    throw new Error("Missing package version.");
+  }
+  return version.startsWith("v") ? version : `v${version}`;
+}
+
+function resolveTargetFor(platform, arch) {
+  if (platform === "linux" && arch === "x64") {
+    return { target: "x86_64-unknown-linux-gnu", ext: "tar.gz", binName: "clawreform" };
+  }
+  if (platform === "linux" && arch === "arm64") {
+    return { target: "aarch64-unknown-linux-gnu", ext: "tar.gz", binName: "clawreform" };
+  }
+  if (platform === "darwin" && arch === "x64") {
+    return { target: "x86_64-apple-darwin", ext: "tar.gz", binName: "clawreform" };
+  }
+  if (platform === "darwin" && arch === "arm64") {
+    return { target: "aarch64-apple-darwin", ext: "tar.gz", binName: "clawreform" };
+  }
+  if (platform === "win32" && arch === "x64") {
+    return { target: "x86_64-pc-windows-msvc", ext: "zip", binName: "clawreform.exe" };
+  }
+  if (platform === "win32" && arch === "arm64") {
+    return { target: "aarch64-pc-windows-msvc", ext: "zip", binName: "clawreform.exe" };
+  }
+
+  throw new Error(`Unsupported platform/arch: ${platform}/${arch}`);
+}
+
+function resolveTarget() {
+  return resolveTargetFor(process.platform, process.arch);
+}
+
+function assetUrl(version, target, ext) {
+  const file = `clawreform-${target}.${ext}`;
+  return `https://github.com/${REPO}/releases/download/${version}/${file}`;
+}
+
+async function downloadToFile(url, destination) {
+  const response = await fetch(url, {
+    headers: {
+      "User-Agent": "clawreform-npm-installer"
+    }
+  });
+
+  if (!response.ok) {
+    throw new Error(`Download failed (${response.status}): ${url}`);
+  }
+
+  const arrayBuffer = await response.arrayBuffer();
+  fs.writeFileSync(destination, Buffer.from(arrayBuffer));
+}
+
+function extractArchive(archivePath, destinationPath, ext) {
+  if (ext === "tar.gz") {
+    const result = spawnSync("tar", ["-xzf", archivePath, "-C", destinationPath], {
+      stdio: "pipe"
+    });
+    if (result.status !== 0) {
+      throw new Error(`tar extraction failed: ${result.stderr?.toString() || "unknown error"}`);
+    }
+    return;
+  }
+
+  if (ext === "zip") {
+    const psArchive = archivePath.replace(/'/g, "''");
+    const psDest = destinationPath.replace(/'/g, "''");
+    const psScript = `$ErrorActionPreference='Stop'; Expand-Archive -Path '${psArchive}' -DestinationPath '${psDest}' -Force`;
+    const result = spawnSync("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", psScript], {
+      stdio: "pipe"
+    });
+
+    if (result.status === 0) {
+      return;
+    }
+
+    const tarResult = spawnSync("tar", ["-xf", archivePath, "-C", destinationPath], {
+      stdio: "pipe"
+    });
+    if (tarResult.status !== 0) {
+      const powerShellError = result.stderr?.toString() || "unknown powershell error";
+      const tarError = tarResult.stderr?.toString() || "unknown tar error";
+      throw new Error(`zip extraction failed. powershell: ${powerShellError}; tar: ${tarError}`);
+    }
+    return;
+  }
+
+  throw new Error(`Unsupported archive extension: ${ext}`);
+}
+
+function findFileRecursively(rootDir, fileName) {
+  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(rootDir, entry.name);
+    if (entry.isFile() && entry.name === fileName) {
+      return fullPath;
+    }
+    if (entry.isDirectory()) {
+      const nested = findFileRecursively(fullPath, fileName);
+      if (nested) {
+        return nested;
+      }
+    }
+  }
+  return null;
+}
+
+function installedBinaryPath() {
+  const binName = process.platform === "win32" ? "clawreform.exe" : "clawreform";
+  return path.join(__dirname, "bin", binName);
+}
+
+async function installBinary(options = {}) {
+  const log = typeof options.log === "function" ? options.log : console.log;
+  const version = normalizeVersion(options.version || process.env.CLAWREFORM_VERSION || require("../package.json").version);
+  const { target, ext, binName } = resolveTarget();
+  const downloadUrl = assetUrl(version, target, ext);
+
+  const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "clawreform-npm-"));
+  const archivePath = path.join(tmpRoot, `clawreform.${ext}`);
+  const extractPath = path.join(tmpRoot, "extract");
+  fs.mkdirSync(extractPath, { recursive: true });
+
+  try {
+    log(`clawreform npm: downloading ${version} (${target})`);
+    await downloadToFile(downloadUrl, archivePath);
+    extractArchive(archivePath, extractPath, ext);
+
+    const sourceBinary = findFileRecursively(extractPath, binName);
+    if (!sourceBinary) {
+      throw new Error(`Could not find ${binName} in downloaded archive.`);
+    }
+
+    const destination = installedBinaryPath();
+    fs.mkdirSync(path.dirname(destination), { recursive: true });
+    fs.copyFileSync(sourceBinary, destination);
+    if (process.platform !== "win32") {
+      fs.chmodSync(destination, 0o755);
+    }
+
+    return destination;
+  } finally {
+    fs.rmSync(tmpRoot, { recursive: true, force: true });
+  }
+}
+
+async function ensureBinaryInstalled() {
+  const destination = installedBinaryPath();
+  if (fs.existsSync(destination)) {
+    return destination;
+  }
+  return installBinary();
+}
+
+module.exports = {
+  ensureBinaryInstalled,
+  installBinary,
+  installedBinaryPath,
+  resolveTargetFor,
+  resolveTarget
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "clawreform",
+  "version": "0.3.1",
+  "description": "Cross-platform npm launcher for clawREFORM by aegntic.ai CLI",
+  "license": "MIT",
+  "author": "clawREFORM by aegntic.ai Team",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aegntic/clawreform"
+  },
+  "bugs": {
+    "url": "https://github.com/aegntic/clawreform/issues"
+  },
+  "homepage": "https://clawreform.com",
+  "keywords": [
+    "clawreform",
+    "agent",
+    "ai",
+    "cli",
+    "agent-os"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "clawreform": "./bin/clawreform.js"
+  },
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.js"
+  },
+  "files": [
+    "README.md",
+    "bin",
+    "lib/install.js",
+    "scripts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+const path = require("node:path");
+const { installBinary } = require("../lib/install");
+
+function globalBinDir() {
+  const prefix = process.env.npm_config_prefix;
+  if (!prefix) {
+    return null;
+  }
+  return process.platform === "win32" ? prefix : path.join(prefix, "bin");
+}
+
+function pathContains(targetDir) {
+  if (!targetDir) {
+    return false;
+  }
+  const pathValue = process.env.PATH || "";
+  const entries = pathValue.split(path.delimiter).filter(Boolean);
+  return entries.includes(targetDir);
+}
+
+async function main() {
+  try {
+    await installBinary();
+    const binDir = globalBinDir();
+    if (binDir && !pathContains(binDir)) {
+      if (process.platform === "win32") {
+        console.warn(`clawreform npm: global npm bin is not on PATH: ${binDir}`);
+        console.warn("Open a new terminal or add it to your user PATH in System Settings.");
+      } else {
+        console.warn(`clawreform npm: global npm bin is not on PATH: ${binDir}`);
+        console.warn(`Add it with: export PATH="${binDir}:$PATH"`);
+      }
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`clawreform npm postinstall failed: ${message}`);
+    process.exit(1);
+  }
+}
+
+main();