@aware-aeco/cli 0.7.0

package/README.md

@@ -0,0 +1,46 @@
+# @aware-aeco/cli
+
+The AWARE CLI as an npm package. Wraps the underlying Rust + C# binaries.
+
+## Install
+
+Pick your package manager — all four work with the same package:
+
+```bash
+npm  install -g @aware-aeco/cli
+pnpm add     -g @aware-aeco/cli
+yarn global add  @aware-aeco/cli
+bun  install -g @aware-aeco/cli
+
+aware --version
+```
+
+On install, `postinstall` downloads the right binary for your platform (Windows x64, Linux x64, or macOS arm64) from the [GitHub Releases](https://github.com/aware-aeco/aware/releases) for the matching version. The package itself contains no platform-specific code, only Node built-ins, so any manager that runs `postinstall` and supports the npm registry works.
+
+For other platforms, build from source: https://github.com/aware-aeco/aware
+
+## Docs
+
+See the main repo: https://github.com/aware-aeco/aware
+
+## License
+
+Apache-2.0 — same as the upstream project.
+
+## Behind the curtain
+
+This package is a thin shim. The actual implementation is:
+
+- The Rust CLI binary (`aware`) — open source at [aware-aeco/aware](https://github.com/aware-aeco/aware), under `cli/`
+- The C# NativeAOT sidecar (`aware-sidecar`) — same repo, under `cli-sidecar/`
+
+The package's `postinstall` hook fetches both binaries from the GitHub Release matching the package version. The npm tarball itself is ~10 KB.
+
+To skip the download (corp networks, etc.):
+
+```bash
+AWARE_NPM_SKIP_DOWNLOAD=1 npm install -g @aware-aeco/cli
+# (or pnpm / yarn / bun — same env var)
+```
+
+Then install the binaries manually from the GitHub Release.

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@aware-aeco/cli",
+  "version": "0.7.0",
+  "description": "AWARE CLI — open-source agentic substrate for AECO",
+  "homepage": "https://github.com/aware-aeco/aware",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aware-aeco/aware.git",
+    "directory": "cli-npm"
+  },
+  "license": "Apache-2.0",
+  "bin": {
+    "aware": "scripts/bin/aware.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "uninstall": "node scripts/uninstall.js"
+  },
+  "os": [
+    "win32",
+    "linux",
+    "darwin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "scripts",
+    "README.md"
+  ]
+}

package/scripts/bin/aware.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const binaryName = process.platform === 'win32' ? 'aware.exe' : 'aware';
+const binary = path.join(__dirname, '..', '..', 'binaries', binaryName);
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: 'inherit' });
+process.exit(result.status ?? 1);

package/scripts/postinstall.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const { execSync } = require('child_process');
+
+const PKG_VERSION = require('../package.json').version;
+const REPO = 'aware-aeco/aware';
+
+const RID_MAP = {
+  'win32/x64':    { rid: 'win-x64',    ext: '.exe', archive: 'zip' },
+  'linux/x64':    { rid: 'linux-x64',  ext: '',     archive: 'tar.gz' },
+  'darwin/arm64': { rid: 'osx-arm64',  ext: '',     archive: 'tar.gz' },
+};
+
+// Skip-download escape hatch — for environments without network (corp networks, CI sandboxes)
+if (process.env.AWARE_NPM_SKIP_DOWNLOAD === '1') {
+  console.log('[aware-npm] AWARE_NPM_SKIP_DOWNLOAD=1 — skipping binary download.');
+  process.exit(0);
+}
+
+const key = `${process.platform}/${process.arch}`;
+const target = RID_MAP[key];
+if (!target) {
+  console.error(`[aware-npm] unsupported platform: ${key}`);
+  console.error(`Supported: ${Object.keys(RID_MAP).join(', ')}`);
+  console.error(`Manual install: https://github.com/${REPO}/releases`);
+  process.exit(1);
+}
+
+const archiveName = `aware-${PKG_VERSION}-${target.rid}.${target.archive}`;
+const url = `https://github.com/${REPO}/releases/download/v${PKG_VERSION}/${archiveName}`;
+const binariesDir = path.join(__dirname, '..', 'binaries');
+const tmpFile = path.join(binariesDir, archiveName);
+
+console.log(`[aware-npm] installing ${PKG_VERSION} for ${target.rid}`);
+console.log(`  source: ${url}`);
+
+fs.mkdirSync(binariesDir, { recursive: true });
+
+function download(srcUrl, dest, depth = 0) {
+  return new Promise((resolve, reject) => {
+    if (depth > 5) return reject(new Error('too many redirects'));
+    https.get(srcUrl, { headers: { 'User-Agent': 'aware-npm-installer' } }, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return resolve(download(res.headers.location, dest, depth + 1));
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error(`HTTP ${res.statusCode}: ${srcUrl}`));
+      }
+      const file = fs.createWriteStream(dest);
+      res.pipe(file);
+      file.on('finish', () => file.close(() => resolve()));
+      file.on('error', reject);
+    }).on('error', reject);
+  });
+}
+
+(async () => {
+  try {
+    await download(url, tmpFile);
+
+    console.log('[aware-npm] extracting...');
+    if (target.archive === 'zip') {
+      execSync(`powershell -NoProfile -Command "Expand-Archive -Path '${tmpFile}' -DestinationPath '${binariesDir}' -Force"`, { stdio: 'inherit' });
+    } else {
+      execSync(`tar -xzf "${tmpFile}" -C "${binariesDir}"`, { stdio: 'inherit' });
+    }
+    fs.unlinkSync(tmpFile);
+
+    // Promote binaries from <binariesDir>/aware-<version>-<rid>/ to <binariesDir>/
+    const extractedDir = path.join(binariesDir, `aware-${PKG_VERSION}-${target.rid}`);
+    if (fs.existsSync(extractedDir)) {
+      for (const file of fs.readdirSync(extractedDir)) {
+        fs.renameSync(path.join(extractedDir, file), path.join(binariesDir, file));
+      }
+      fs.rmdirSync(extractedDir);
+    }
+
+    if (process.platform !== 'win32') {
+      fs.chmodSync(path.join(binariesDir, `aware${target.ext}`), 0o755);
+      fs.chmodSync(path.join(binariesDir, `aware-sidecar${target.ext}`), 0o755);
+    }
+
+    console.log(`[aware-npm] installed to ${binariesDir}`);
+  } catch (err) {
+    console.error(`[aware-npm] install failed: ${err.message}`);
+    console.error(`Set AWARE_NPM_SKIP_DOWNLOAD=1 to skip download and install binaries manually.`);
+    console.error(`Manual install: https://github.com/${REPO}/releases`);
+    process.exit(1);
+  }
+})();

package/scripts/uninstall.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const dir = path.join(__dirname, '..', 'binaries');
+if (fs.existsSync(dir)) {
+  fs.rmSync(dir, { recursive: true, force: true });
+  console.log(`[aware-npm] removed ${dir}`);
+}