parallel-agents 0.2.0

package/README.md

@@ -0,0 +1,31 @@
+# parallel-agents
+
+Parallel multi-agent pipeline for code analysis and transformation, powered by Claude.
+
+This is the **npm wrapper** for the Python `parallel-agents` package. It auto-installs the Python package and delegates all commands to it.
+
+## Prerequisites
+
+- **Python 3.11+** must be installed and on your PATH
+- **Claude Code CLI** must be installed and authenticated
+
+## Usage
+
+```bash
+# Via npx (no install needed)
+npx parallel-agents run --repo ./my-project "Fix security issues"
+
+# Or install globally
+npm install -g parallel-agents
+parallel-agents run --repo ./project "Review code quality"
+parallel-agents workers
+```
+
+## How it works
+
+This package is a thin Node.js wrapper that:
+1. Checks for Python 3.11+
+2. Installs `parallel-agents` from PyPI if not present
+3. Forwards all CLI arguments to the Python CLI
+
+For full documentation, see the [Python package on PyPI](https://pypi.org/project/parallel-agents/).

package/bin/cli.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+
+/**
+ * parallel-agents npm wrapper
+ *
+ * Thin wrapper that delegates to the Python `parallel-agents` CLI.
+ * Ensures Python + pip package are available, then forwards all arguments.
+ */
+
+const { spawn, execSync } = require("child_process");
+const path = require("path");
+
+const PYPI_PACKAGE = "parallel-agents";
+const CLI_COMMAND = "parallel-agents";
+
+function findPython() {
+  const candidates = ["python3", "python"];
+  for (const cmd of candidates) {
+    try {
+      const version = execSync(`${cmd} --version 2>&1`, {
+        encoding: "utf-8",
+      }).trim();
+      const major = parseInt(version.split(" ")[1].split(".")[0], 10);
+      const minor = parseInt(version.split(" ")[1].split(".")[1], 10);
+      if (major === 3 && minor >= 11) {
+        return cmd;
+      }
+    } catch {
+      // not found, try next
+    }
+  }
+  return null;
+}
+
+function isPipPackageInstalled(python) {
+  try {
+    execSync(`${python} -m pip show ${PYPI_PACKAGE} 2>&1`, {
+      encoding: "utf-8",
+      stdio: "pipe",
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function installPipPackage(python) {
+  console.log(`Installing ${PYPI_PACKAGE} via pip...`);
+  try {
+    execSync(`${python} -m pip install ${PYPI_PACKAGE}`, {
+      stdio: "inherit",
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function findCLI(python) {
+  // Try direct command first
+  try {
+    execSync(`${CLI_COMMAND} --help`, { stdio: "pipe" });
+    return CLI_COMMAND;
+  } catch {
+    // Fall back to python -m
+    return null;
+  }
+}
+
+function main() {
+  const python = findPython();
+  if (!python) {
+    console.error(
+      "Error: Python 3.11+ is required but not found.\n" +
+        "Install Python from https://python.org or via your package manager."
+    );
+    process.exit(1);
+  }
+
+  if (!isPipPackageInstalled(python)) {
+    if (!installPipPackage(python)) {
+      console.error(
+        `Error: Failed to install ${PYPI_PACKAGE}.\n` +
+          `Try manually: ${python} -m pip install ${PYPI_PACKAGE}`
+      );
+      process.exit(1);
+    }
+  }
+
+  // Forward all args to the Python CLI
+  const args = process.argv.slice(2);
+  const directCLI = findCLI(python);
+
+  let child;
+  if (directCLI) {
+    child = spawn(directCLI, args, { stdio: "inherit" });
+  } else {
+    child = spawn(python, ["-m", "parallel_agents.main", ...args], {
+      stdio: "inherit",
+    });
+  }
+
+  child.on("exit", (code) => {
+    process.exit(code || 0);
+  });
+
+  child.on("error", (err) => {
+    console.error(`Failed to start parallel-agents: ${err.message}`);
+    process.exit(1);
+  });
+}
+
+main();

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "parallel-agents",
+  "version": "0.2.0",
+  "description": "Parallel multi-agent pipeline for code analysis and transformation, powered by Claude",
+  "keywords": [
+    "ai",
+    "agents",
+    "claude",
+    "code-analysis",
+    "parallel",
+    "multi-agent",
+    "llm",
+    "security",
+    "code-review"
+  ],
+  "license": "MIT",
+  "author": "parallel-agents contributors",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ErenAri/pa"
+  },
+  "bin": {
+    "parallel-agents": "./bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.js"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script: check Python availability and install the pip package.
+ */
+
+const { execSync } = require("child_process");
+
+const PYPI_PACKAGE = "parallel-agents";
+
+function findPython() {
+  for (const cmd of ["python3", "python"]) {
+    try {
+      const version = execSync(`${cmd} --version 2>&1`, {
+        encoding: "utf-8",
+      }).trim();
+      const parts = version.split(" ")[1].split(".");
+      if (parseInt(parts[0]) === 3 && parseInt(parts[1]) >= 11) {
+        return cmd;
+      }
+    } catch {
+      // continue
+    }
+  }
+  return null;
+}
+
+const python = findPython();
+if (!python) {
+  console.warn(
+    `\n⚠️  Python 3.11+ not found. parallel-agents requires Python.\n` +
+      `   Install from https://python.org then run:\n` +
+      `   ${python || "python3"} -m pip install ${PYPI_PACKAGE}\n`
+  );
+  process.exit(0); // don't fail npm install
+}
+
+try {
+  execSync(`${python} -m pip show ${PYPI_PACKAGE}`, { stdio: "pipe" });
+  console.log(`✓ ${PYPI_PACKAGE} Python package already installed`);
+} catch {
+  console.log(`Installing ${PYPI_PACKAGE} Python package...`);
+  try {
+    execSync(`${python} -m pip install ${PYPI_PACKAGE}`, { stdio: "inherit" });
+    console.log(`✓ ${PYPI_PACKAGE} installed successfully`);
+  } catch {
+    console.warn(
+      `\n⚠️  Failed to auto-install ${PYPI_PACKAGE}. Run manually:\n` +
+        `   ${python} -m pip install ${PYPI_PACKAGE}\n`
+    );
+  }
+}