openapps 0.0.0-stage → 0.0.151

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# openapps
 
-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.
+The `openapps` CLI for [OpenApps](https://openapps.xyz): build and ship apps
+that have their own agent, from your coding agent.
+
+```sh
+npm install -D openapps
+npx openapps init
+```
+
+`openapps init` signs you in, creates `policy.json`, and installs the OpenApps
+skills for the agents on your machine.
+
+This package is a small launcher. npm installs the native binary for your
+platform through one of the optional dependencies (`openapps-darwin-arm64`,
+`openapps-darwin-x64`, `openapps-linux-arm64`, `openapps-linux-x64`), so keep
+optional dependencies enabled. macOS and Linux; Node 20 or later.
+
+Run every command through npx: `npx openapps init`, `npx openapps deploy`, and
+so on. Update with `npm install -D openapps@latest`.

package/bin/openapps.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+'use strict';
+
+// Launcher for the CLI's npm package.
+//
+// The CLI itself is a native Go binary. npm installs exactly one of the
+// per-platform packages listed as optional dependencies (each declares `os` and
+// `cpu`, so npm skips the rest); this file finds that package next to itself and
+// runs the binary with the caller's stdio, forwarding signals and the exit code.
+// It has no dependencies and no install scripts. The child sees
+// BOUNDED_INSTALL_CHANNEL=npm so its `update` command defers to npm instead of
+// replacing a file npm owns.
+//
+// The same file ships in two packages built from one release (see
+// release/npm-package.sh): @bounded-sh/cli runs `bounded` from
+// @bounded-sh/cli-<os>-<cpu>, and openapps runs `openapps` from
+// openapps-<os>-<cpu>. It reads which one it is from its own package.json.
+
+const { spawn } = require('node:child_process');
+const path = require('node:path');
+
+const PLATFORMS = {
+  darwin: { arm64: 'darwin-arm64', x64: 'darwin-x64' },
+  linux: { arm64: 'linux-arm64', x64: 'linux-x64' },
+  win32: { x64: 'win32-x64' },
+};
+const OVERRIDE_ENV = 'BOUNDED_CLI_BINARY_OVERRIDE';
+const CHANNEL_ENV = 'BOUNDED_INSTALL_CHANNEL';
+const MANIFEST = require('../package.json');
+const PACKAGE = MANIFEST.name;
+const COMMAND = PACKAGE === 'openapps' ? 'openapps' : 'bounded';
+const PLATFORM_PREFIX = PACKAGE === 'openapps' ? 'openapps-' : `${PACKAGE}-`;
+const REINSTALL = `npm install -D ${PACKAGE}`;
+
+function platformPackage() {
+  const byArch = PLATFORMS[process.platform];
+  const suffix = byArch && byArch[process.arch];
+  const shipped = MANIFEST.optionalDependencies;
+  if (!suffix || (shipped && !(`${PLATFORM_PREFIX}${suffix}` in shipped))) {
+    throw new Error(
+      `${PACKAGE} has no prebuilt binary for ${process.platform}-${process.arch}. ` +
+        `Supported: ${shipped ? Object.keys(shipped).map((name) => name.slice(PLATFORM_PREFIX.length)).join(', ') : 'darwin-arm64, darwin-x64, linux-arm64, linux-x64, win32-x64'}.`,
+    );
+  }
+  return {
+    name: `${PLATFORM_PREFIX}${suffix}`,
+    executable: process.platform === 'win32' ? `${COMMAND}.exe` : COMMAND,
+  };
+}
+
+function resolveBinary() {
+  const override = process.env[OVERRIDE_ENV];
+  if (override) return override;
+  const { name, executable } = platformPackage();
+  let manifest;
+  try {
+    manifest = require.resolve(`${name}/package.json`);
+  } catch {
+    throw new Error(
+      `${name} is not installed next to ${PACKAGE}. Reinstall with "${REINSTALL}" ` +
+        'with optional dependencies enabled; npm installs only the package for this platform.',
+    );
+  }
+  return path.join(path.dirname(manifest), 'bin', executable);
+}
+
+function main() {
+  let binary;
+  try {
+    binary = resolveBinary();
+  } catch (error) {
+    console.error(`${COMMAND}: ${error.message}`);
+    process.exit(1);
+  }
+
+  const child = spawn(binary, process.argv.slice(2), {
+    stdio: 'inherit',
+    env: { ...process.env, [CHANNEL_ENV]: 'npm' },
+  });
+
+  const forwarders = new Map();
+  for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+    const forward = () => {
+      if (child.exitCode === null && child.signalCode === null) child.kill(signal);
+    };
+    try {
+      process.on(signal, forward);
+      forwarders.set(signal, forward);
+    } catch {
+      // A platform without this signal simply does not forward it.
+    }
+  }
+  const release = () => {
+    for (const [signal, forward] of forwarders) process.removeListener(signal, forward);
+  };
+
+  child.on('error', (error) => {
+    release();
+    console.error(`${COMMAND}: could not start ${binary}: ${error.message}`);
+    process.exit(1);
+  });
+  child.on('exit', (code, signal) => {
+    release();
+    if (signal !== null) {
+      if (process.platform !== 'win32') {
+        try {
+          process.kill(process.pid, signal);
+          // Keep the event loop alive for the signal to land; exit 1 otherwise.
+          setTimeout(() => process.exit(1), 1000);
+          return;
+        } catch {
+          // Fall through to a plain failure exit.
+        }
+      }
+      process.exit(1);
+    }
+    process.exit(code === null ? 1 : code);
+  });
+}
+
+main();

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "openapps",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.151",
+  "description": "The OpenApps CLI (openapps.xyz): build, ship and run apps with their own agent. Installs the native binary for this platform as an optional dependency.",
+  "license": "MIT",
+  "author": "OpenApps",
+  "homepage": "https://openapps.xyz",
+  "keywords": [
+    "openapps",
+    "cli",
+    "full-stack",
+    "app-builder",
+    "agents",
+    "policy"
+  ],
+  "bin": {
+    "openapps": "bin/openapps.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "openapps-darwin-arm64": "0.0.151",
+    "openapps-darwin-x64": "0.0.151",
+    "openapps-linux-arm64": "0.0.151",
+    "openapps-linux-x64": "0.0.151"
+  }
+}