aigate 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# AIProxy — npm installer
+
+Install **AIProxy** globally via npm. This package bootstraps a self-contained Python virtual environment and installs the [aiguard](https://pypi.org/project/aiguard/) PyPI package automatically.
+
+## Prerequisites
+
+- **Node.js** 16+
+- **Python** 3.11+ (must be on your `PATH`)
+
+## Install
+
+```bash
+npm install -g aiproxy
+```
+
+## Usage
+
+```bash
+# Start the proxy server
+guard start
+
+# Or use the full command name
+aiproxy server start
+
+# Interactive onboarding wizard
+aiproxy onboard
+
+# View all commands
+aiproxy --help
+```
+
+## How it works
+
+1. `npm install -g aiproxy` downloads this wrapper package
+2. The `postinstall` script locates Python 3.11+ on your system
+3. A virtual environment is created inside the npm package directory
+4. The `aiguard` Python package is installed from PyPI into that venv
+5. The `aiproxy` / `aiguard` / `guard` commands delegate to the Python CLI
+
+No global Python packages are modified — everything stays isolated in the venv.
+
+## Upgrade
+
+```bash
+npm update -g aiproxy
+```
+
+## Uninstall
+
+```bash
+npm uninstall -g aiproxy
+```
+
+This removes the package and its bundled virtual environment.
+
+## Troubleshooting
+
+| Issue | Fix |
+|-------|-----|
+| `Python 3.11+ is required` | Install Python 3.11+ and ensure `python3` is on your PATH |
+| `guard binary not found` after install | Run `npm rebuild aiproxy` |
+| Permission errors on Linux | Avoid `sudo npm install -g`; configure npm prefix instead: `npm config set prefix ~/.npm-global` |
+
+## Publishing (maintainers)
+
+```bash
+cd deployments/npm
+# Bump version in package.json to match pyproject.toml
+npm publish
+```

package/bin/aiproxy.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+
+/**
+ * bin/aiproxy.js — Thin wrapper that delegates all commands to the
+ * Python `guard` CLI installed in the package's virtual environment.
+ *
+ * Usage:
+ *   aiproxy start          →  guard start
+ *   aiproxy shield list    →  guard shield list
+ *   aiguard --help         →  guard --help
+ *   guard --help           →  guard --help
+ */
+
+const { spawn } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const PACKAGE_DIR = path.resolve(__dirname, "..");
+const VENV_DIR = path.join(PACKAGE_DIR, ".venv");
+const IS_WIN = process.platform === "win32";
+
+function venvBin(name) {
+  return IS_WIN
+    ? path.join(VENV_DIR, "Scripts", `${name}.exe`)
+    : path.join(VENV_DIR, "bin", name);
+}
+
+// ---------------------------------------------------------------------------
+// Resolve the Python guard CLI
+// ---------------------------------------------------------------------------
+
+const guardBin = venvBin("guard");
+const pythonBin = venvBin("python");
+
+if (!fs.existsSync(guardBin) && !fs.existsSync(pythonBin)) {
+  console.error(
+    "❌  AIProxy Python environment not found.\n" +
+      "   Run `npm rebuild aiproxy` to reinstall, or check that Python 3.11+ is available.\n"
+  );
+  process.exit(1);
+}
+
+// Prefer the installed `guard` script; fall back to `python -m aiguard.cli.main`
+const useGuardBin = fs.existsSync(guardBin);
+const cmd = useGuardBin ? guardBin : pythonBin;
+const args = useGuardBin
+  ? process.argv.slice(2)
+  : ["-m", "aiguard.cli.main", ...process.argv.slice(2)];
+
+// ---------------------------------------------------------------------------
+// Spawn the Python process, forwarding stdio and exit code
+// ---------------------------------------------------------------------------
+
+const child = spawn(cmd, args, {
+  stdio: "inherit",
+  env: {
+    ...process.env,
+    // Ensure the venv's bin dir is first on PATH so sub-processes find
+    // the right Python (e.g., for shield logic modules).
+    PATH: `${path.dirname(guardBin)}${path.delimiter}${process.env.PATH || ""}`,
+    VIRTUAL_ENV: VENV_DIR,
+  },
+});
+
+child.on("error", (err) => {
+  console.error(`❌  Failed to start AIProxy: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("close", (code) => {
+  process.exit(code ?? 1);
+});

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "aigate",
+  "version": "0.1.0",
+  "description": "Anti-virus for AI — intercept prompt injections, PII leaks, and policy violations before they reach the model.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "ai",
+    "security",
+    "proxy",
+    "llm",
+    "prompt-injection",
+    "pii",
+    "guardrails",
+    "anthropic",
+    "openai",
+    "claude",
+    "cursor",
+    "aiproxy",
+    "aiguardian",
+    "aiguard"
+  ],
+  "homepage": "https://github.com/aibuildspace/aigate.git",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aibuildspace/aigate.git"
+  },
+  "license": "MIT",
+  "author": "Sean Preusse",
+  "bin": {
+    "aiproxy": "./bin/aiproxy.js",
+    "aiguard": "./bin/aiproxy.js",
+    "guard": "./bin/aiproxy.js"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "files": [
+    "bin/",
+    "postinstall.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
+}

package/postinstall.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+
+/**
+ * postinstall.js — Creates a self-contained Python virtual environment
+ * and installs the aiguard PyPI package into it.
+ *
+ * Requirements: Python 3.11+ must be available on the system.
+ */
+
+const { execSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const PACKAGE_DIR = __dirname;
+const VENV_DIR = path.join(PACKAGE_DIR, ".venv");
+const IS_WIN = process.platform === "win32";
+const MIN_PYTHON = [3, 11];
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function findPython() {
+  const candidates = IS_WIN
+    ? ["python", "python3", "py -3"]
+    : ["python3", "python"];
+
+  for (const cmd of candidates) {
+    try {
+      const version = execSync(`${cmd} --version 2>&1`, {
+        encoding: "utf-8",
+      }).trim();
+
+      const match = version.match(/Python (\d+)\.(\d+)\.(\d+)/);
+      if (!match) continue;
+
+      const major = parseInt(match[1], 10);
+      const minor = parseInt(match[2], 10);
+
+      if (
+        major > MIN_PYTHON[0] ||
+        (major === MIN_PYTHON[0] && minor >= MIN_PYTHON[1])
+      ) {
+        return { cmd, version: `${major}.${minor}.${match[3]}` };
+      }
+    } catch {
+      // not found — try next
+    }
+  }
+  return null;
+}
+
+function venvBin(name) {
+  return IS_WIN
+    ? path.join(VENV_DIR, "Scripts", `${name}.exe`)
+    : path.join(VENV_DIR, "bin", name);
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+function main() {
+  console.log("\n🛡️  AIProxy — installing Python backend …\n");
+
+  // 1. Locate Python
+  const py = findPython();
+  if (!py) {
+    console.error(
+      `\n❌  Python ${MIN_PYTHON.join(".")}+ is required but was not found on your PATH.\n` +
+        `   Install it from https://www.python.org/downloads/ and try again.\n`
+    );
+    process.exit(1);
+  }
+  console.log(`   Found ${py.cmd} (${py.version})`);
+
+  // 2. Create virtual environment (skip if already present and valid)
+  const venvPython = venvBin("python");
+  if (!fs.existsSync(venvPython)) {
+    console.log("   Creating virtual environment …");
+    execSync(`${py.cmd} -m venv "${VENV_DIR}"`, {
+      stdio: "inherit",
+      cwd: PACKAGE_DIR,
+    });
+  } else {
+    console.log("   Virtual environment already exists");
+  }
+
+  // 3. Upgrade pip silently then install aiguard
+  const pip = venvBin("pip");
+  console.log("   Upgrading pip …");
+  execSync(`"${pip}" install --upgrade pip --quiet`, {
+    stdio: "inherit",
+    cwd: PACKAGE_DIR,
+  });
+
+  console.log("   Installing aiguard from PyPI …");
+  execSync(`"${pip}" install --upgrade aiguard`, {
+    stdio: "inherit",
+    cwd: PACKAGE_DIR,
+  });
+
+  // 4. Verify installation
+  const guard = venvBin("guard");
+  if (fs.existsSync(guard)) {
+    console.log("\n✅  AIProxy installed successfully!");
+    console.log(
+      "   Run `aiproxy --help` or `guard --help` to get started.\n"
+    );
+  } else {
+    console.error(
+      "\n⚠️  Installation completed but the guard binary was not found."
+    );
+    console.error("   Try running: pip install aiguard\n");
+    process.exit(1);
+  }
+}
+
+main();