cawide 0.4.5 → 0.4.7

package/README.md

@@ -1,50 +1,29 @@
-# Cawide CLI
+# cawide
 
-**Mobile remote code editor & AI agent terminal companion**
+Mobile remote code editor & AI agent terminal companion.
 
-Connect your mobile device (iOS & Android) to your desktop or remote server with end-to-end encrypted, zero-trust P2P tunnels. Edit code, view diffs, and control AI coding agents (Claude Code, OpenCode, Codex) directly from your phone.
+Control your local development environment, terminals, and AI coding agents (Claude Code, OpenAI Codex, OpenCode, Pi, OMP, Hermes) directly from the Cawide mobile app.
 
-## Quick start
+## Install
 
-```sh
-# Run directly via npx
-npx cawide start
-
-# Or install globally
+```bash
 npm install -g cawide
-cawide start
 ```
 
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `cawide start` | Start the daemon in your project directory and display the pairing QR code. |
-| `cawide qr` | Show the pairing QR code for the active workspace. |
-| `cawide status` | Inspect connected sessions, active terminals, and relay status. |
-| `cawide setup [agent]` | Configure hooks and skills for AI agents (Claude, Codex, OpenCode). |
-| `cawide logs` | View daemon logs. |
-| `cawide stop` | Stop the background daemon. |
-
-Use `cawide <command> --help` for the options supported by a particular command.
-
-## Security & Architecture
+Or run directly without installing:
 
-- **Peer-to-peer QUIC / UDP** direct connection with automatic relay fallback.
-- **Ed25519** cryptographic challenge-response authentication.
-- **End-to-end encrypted** transport — your code never passes through third-party servers unencrypted.
-
-## Supported platforms
-
-- **macOS** — Apple Silicon & Intel
-- **Linux** — x86_64 & ARM64
-- **Windows** — x86_64 & ARM64
+```bash
+npx cawide --help
+```
 
-## Support
+## Getting Started
 
-- [cawide.dev](https://cawide.dev) — documentation, updates, and community
-- [Support](https://cawide.dev/support) — report issues and get help
+```bash
+# Start the workspace daemon
+cawide start
 
-## License
+# Print pairing QR code
+cawide qr
+```
 
-MIT
+For full documentation, visit [cawide.hermillon.com](https://cawide.hermillon.com).

package/bin/cawide.js

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
 
 const fs = require("node:fs");
-const path = require("node:path");
 const os = require("node:os");
-const https = require("node:https");
+const path = require("node:path");
 const childProcess = require("node:child_process");
-const zlib = require("node:zlib");
 
-const VERSION = "0.4.5";
-const RELEASE_BASE = `https://releases.cawide.dev/v${VERSION}`;
-const TARGETS = {
-  "darwin-arm64": ["aarch64-apple-darwin"],
-  "darwin-x64": ["x86_64-apple-darwin", "aarch64-apple-darwin"],
-  "linux-x64": ["x86_64-unknown-linux-gnu"],
-  "linux-arm64": ["aarch64-unknown-linux-gnu"],
-  "win32-x64": ["x86_64-pc-windows-msvc"],
-  "win32-arm64": ["aarch64-pc-windows-msvc"],
+// Maps `${process.platform}-${process.arch}` to the platform-specific npm
+// package that ships the prebuilt binary for it (see
+// scripts/package-npm.js and the six `cawide-<platform>`
+// optionalDependencies in package.json).
+const PLATFORM_PACKAGES = {
+  "darwin-arm64": "cawide-darwin-arm64",
+  "darwin-x64": "cawide-darwin-x64",
+  "linux-x64": "cawide-linux-x64",
+  "linux-arm64": "cawide-linux-arm64",
+  "win32-x64": "cawide-win32-x64",
+  "win32-arm64": "cawide-win32-x64",
 };
 const SIGNAL_EXIT_CODES = { SIGINT: 130, SIGTERM: 143 };
 
@@ -23,9 +23,21 @@ function executableName() {
   return process.platform === "win32" ? "cawide.exe" : "cawide";
 }
 
+function platformKey() {
+  return `${process.platform}-${process.arch}`;
+}
+
 function localBinary() {
   const repositoryRoot = path.resolve(__dirname, "../../..");
-  if (!fs.existsSync(path.join(repositoryRoot, "Cargo.toml"))) return null;
+  const cargoTomlPath = path.join(repositoryRoot, "Cargo.toml");
+  if (!fs.existsSync(cargoTomlPath)) return null;
+
+  try {
+    const cargoToml = fs.readFileSync(cargoTomlPath, "utf8");
+    if (!cargoToml.includes("cawide")) return null;
+  } catch {
+    return null;
+  }
 
   for (const profile of ["release", "debug"]) {
     const candidate = path.join(repositoryRoot, "target", profile, executableName());
@@ -34,168 +46,63 @@ function localBinary() {
   return null;
 }
 
-function cacheBinary() {
-  const cacheRoot =
-    process.platform === "win32"
-      ? process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local")
-      : path.join(os.homedir(), ".cache");
-  return path.join(cacheRoot, "cawide", "bin", `v${VERSION}`, executableName());
-}
-
-function platformTargets() {
-  const targets = TARGETS[`${process.platform}-${process.arch}`];
-  if (!targets) {
+function platformPackageName() {
+  const packageName = PLATFORM_PACKAGES[platformKey()];
+  if (!packageName) {
     throw new Error(
-      `Cawide does not provide a binary for ${process.platform}/${process.arch}. Supported platforms: macOS (arm64, x64), Linux (arm64, x64), and Windows (arm64, x64).`
+      `Cawide does not provide a binary for ${process.platform}/${process.arch}. Supported platforms: ${Object.keys(
+        PLATFORM_PACKAGES
+      ).join(", ")}.`
     );
   }
-  return targets;
+  return packageName;
 }
 
-function download(url, redirectsLeft = 5) {
-  return new Promise((resolve, reject) => {
-    const request = https.get(
-      url,
-      { headers: { "User-Agent": `cawide-npm/${VERSION}` } },
-      (response) => {
-        const status = response.statusCode || 0;
-        if (status >= 300 && status < 400 && response.headers.location) {
-          response.resume();
-          if (redirectsLeft === 0) {
-            reject(new Error(`Too many redirects while downloading ${url}`));
-            return;
-          }
-          resolve(download(new URL(response.headers.location, url).toString(), redirectsLeft - 1));
-          return;
-        }
-        if (status !== 200) {
-          response.resume();
-          const error = new Error(`Download failed with HTTP ${status}: ${url}`);
-          error.statusCode = status;
-          reject(error);
-          return;
-        }
-
-        const chunks = [];
-        response.on("data", (chunk) => chunks.push(chunk));
-        response.on("end", () => resolve(Buffer.concat(chunks)));
-        response.on("error", reject);
-      }
-    );
-    request.on("error", reject);
-  });
-}
-
-function tarBinary(archive) {
-  const tar = zlib.gunzipSync(archive);
-  let offset = 0;
-  while (offset + 512 <= tar.length) {
-    const header = tar.subarray(offset, offset + 512);
-    if (header.every((byte) => byte === 0)) break;
-    const name = header.subarray(0, 100).toString("utf8").replace(/\0.*$/, "");
-    const sizeText = header.subarray(124, 136).toString("ascii").replace(/\0.*$/, "").trim();
-    const size = Number.parseInt(sizeText || "0", 8);
-    const dataStart = offset + 512;
-    if (!Number.isFinite(size) || dataStart + size > tar.length) {
-      throw new Error("Downloaded tar archive is corrupt");
+function resolvePlatformBinary() {
+  const packageName = platformPackageName();
+
+  let packageJsonPath;
+  try {
+    packageJsonPath = require.resolve(`${packageName}/package.json`);
+  } catch (error) {
+    if (error.code === "MODULE_NOT_FOUND") {
+      throw new Error(
+        `Cawide could not find the "${packageName}" platform package for ${platformKey()}.\nThis usually happens when the package was installed with --no-optional/--omit=optional, npm skipped optional dependencies, or the platform is unsupported.\nTry reinstalling without skipping optional dependencies: npm install -g cawide`
+      );
     }
-    if (path.posix.basename(name) === "cawide") return tar.subarray(dataStart, dataStart + size);
-    offset = dataStart + Math.ceil(size / 512) * 512;
+    throw error;
   }
-  throw new Error("Downloaded archive does not contain the cawide binary");
-}
 
-function zipBinary(archive) {
-  const endSignature = 0x06054b50;
-  const centralSignature = 0x02014b50;
-  const localSignature = 0x04034b50;
-  const searchStart = Math.max(0, archive.length - 65557);
-  let endOffset = -1;
-  for (let offset = archive.length - 22; offset >= searchStart; offset -= 1) {
-    if (archive.readUInt32LE(offset) === endSignature) {
-      endOffset = offset;
-      break;
-    }
-  }
-  if (endOffset < 0) throw new Error("Downloaded zip archive is corrupt");
-
-  const entryCount = archive.readUInt16LE(endOffset + 10);
-  let offset = archive.readUInt32LE(endOffset + 16);
-  for (let index = 0; index < entryCount; index += 1) {
-    if (archive.readUInt32LE(offset) !== centralSignature) {
-      throw new Error("Downloaded zip archive has an invalid directory");
-    }
-    const method = archive.readUInt16LE(offset + 10);
-    const compressedSize = archive.readUInt32LE(offset + 20);
-    const fileNameLength = archive.readUInt16LE(offset + 28);
-    const extraLength = archive.readUInt16LE(offset + 30);
-    const commentLength = archive.readUInt16LE(offset + 32);
-    const localOffset = archive.readUInt32LE(offset + 42);
-    const name = archive.subarray(offset + 46, offset + 46 + fileNameLength).toString("utf8");
-
-    if (path.posix.basename(name.replace(/\\/g, "/")) === "cawide.exe") {
-      if (archive.readUInt32LE(localOffset) !== localSignature) {
-        throw new Error("Downloaded zip archive has an invalid entry");
-      }
-      const localNameLength = archive.readUInt16LE(localOffset + 26);
-      const localExtraLength = archive.readUInt16LE(localOffset + 28);
-      const dataStart = localOffset + 30 + localNameLength + localExtraLength;
-      const compressed = archive.subarray(dataStart, dataStart + compressedSize);
-      if (method === 0) return compressed;
-      if (method === 8) return zlib.inflateRawSync(compressed);
-      throw new Error(`Downloaded zip uses unsupported compression method ${method}`);
-    }
-    offset += 46 + fileNameLength + extraLength + commentLength;
-  }
-  throw new Error("Downloaded archive does not contain cawide.exe");
-}
-
-async function installBinary(destination) {
-  const extension = process.platform === "win32" ? "zip" : "tar.gz";
-  let lastError;
-  for (const target of platformTargets()) {
-    const asset = `cawide-${target}.${extension}`;
-    const url = `${RELEASE_BASE}/${asset}`;
-    try {
-      process.stderr.write(`Downloading Cawide v${VERSION} for ${target}...\n`);
-      const archive = await download(url);
-      const binary = extension === "zip" ? zipBinary(archive) : tarBinary(archive);
-      fs.mkdirSync(path.dirname(destination), { recursive: true });
-      const temporary = `${destination}.${process.pid}.tmp`;
-      try {
-        fs.writeFileSync(temporary, binary, { mode: 0o755 });
-        fs.chmodSync(temporary, 0o755);
-        fs.renameSync(temporary, destination);
-      } finally {
-        if (fs.existsSync(temporary)) fs.unlinkSync(temporary);
-      }
-      return;
-    } catch (error) {
-      lastError = error;
-      if (error.statusCode !== 404) break;
-    }
+  const binaryPath = path.join(path.dirname(packageJsonPath), "bin", executableName());
+  if (!fs.existsSync(binaryPath)) {
+    throw new Error(
+      `The "${packageName}" platform package is installed but is missing its binary at ${binaryPath}. Try reinstalling: npm install -g cawide`
+    );
   }
-  throw lastError;
+  return binaryPath;
 }
 
 function run(binaryPath) {
   const result = childProcess.spawnSync(binaryPath, process.argv.slice(2), { stdio: "inherit" });
   if (result.error) throw result.error;
-  if (result.signal && SIGNAL_EXIT_CODES[result.signal])
-    process.exit(SIGNAL_EXIT_CODES[result.signal]);
+  if (result.signal) {
+    const signalCode =
+      SIGNAL_EXIT_CODES[result.signal] ||
+      (process.platform !== "win32" && os.constants?.signals?.[result.signal]
+        ? 128 + os.constants.signals[result.signal]
+        : 1);
+    process.exit(signalCode);
+  }
   process.exit(result.status ?? 0);
 }
 
-async function main() {
-  const local = localBinary();
-  if (local) run(local);
-
-  const cached = cacheBinary();
-  if (!fs.existsSync(cached)) await installBinary(cached);
-  run(cached);
+function main() {
+  run(localBinary() || resolvePlatformBinary());
 }
 
-main().catch((error) => {
+try {
+  main();
+} catch (error) {
   process.stderr.write(`cawide: ${error.message}\n`);
   process.exit(1);
-});
+}

package/package.json

@@ -1,17 +1,28 @@
 {
   "name": "cawide",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "Mobile remote code editor & AI agent terminal companion",
-  "homepage": "https://cawide.dev",
-  "bugs": "https://cawide.dev/support",
+  "homepage": "https://cawide.hermillon.com",
+  "bugs": "https://github.com/Hermillon/cawide/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Hermillon/cawide.git"
+  },
   "bin": {
-    "cawide": "./bin/cawide.js"
+    "cawide": "bin/cawide.js"
   },
   "files": ["bin/", "README.md"],
   "engines": {
     "node": ">=16.0.0"
   },
   "keywords": ["cawide", "terminal", "ai-agent", "remote-editor", "mobile", "editor"],
-  "author": "Cawide Team",
-  "license": "MIT"
+  "author": "Cawide Team <support@hermillon.com>",
+  "license": "MIT",
+  "optionalDependencies": {
+    "cawide-darwin-arm64": "0.4.7",
+    "cawide-darwin-x64": "0.4.7",
+    "cawide-linux-x64": "0.4.7",
+    "cawide-linux-arm64": "0.4.7",
+    "cawide-win32-x64": "0.4.7"
+  }
 }