@polarityinc/paragon 0.0.9

package/LICENSE.md

@@ -0,0 +1,134 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2025 Polarity, Inc
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+MIT License
+
+Copyright (c) 2025-03-21 - 2025-05-30 Kujtim Hoxha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,206 @@
+# Paragon
+
+<p align="center">
+  <img width="450" alt="Paragon Logo" src="https://www.polarity.cc/paragon.png" />
+</p>
+
+<h3 align="center">The Best Code Review Agent in the World</h3>
+
+<p align="center">
+  Paragon catches more issues than any other tool, runs faster than competitors,<br/>
+  and maintains the highest security standards.
+</p>
+
+<p align="center">
+  <a href="https://polarity.cc/paragon"><strong>Learn more »</strong></a>
+</p>
+
+---
+
+## Why Paragon?
+
+Paragon doesn't just score higher on tests—it sets the standard for what autonomous code review can achieve.
+
+### 🎯 **81.2%** Issue Detection
+Catches more issues than any other code review tool in the world. From security vulnerabilities to performance bottlenecks, Paragon finds what others miss.
+
+*Highest accuracy on ReviewBenchLite benchmark*
+
+### ⚡ **3x** Faster Than Competitors
+The fastest code review agent in the world. Complete codebase analysis in minutes, not hours.
+
+### 🔒 Highest Security Standards
+SOC 2 compliant, enterprise-grade security, and zero-trust architecture. Paragon meets the highest security standards in the industry.
+
+### ✨ **6.2%** False Positive Rate
+World's most accurate code review agent. When Paragon flags an issue, it's real.
+
+---
+
+## Benchmark Results
+
+**ReviewBenchLite** - Accuracy comparison across leading code review agents:
+
+| Agent | Accuracy |
+|-------|----------|
+| **Paragon Deep** | **81.2%** |
+| Paragon Fast | 72.6% |
+| Greptile V3 | 65.8% |
+| Claude Code | 56.4% |
+| Cursor | 51.3% |
+| Codex | 44.4% |
+| CodeRabbit | 22.2% |
+
+---
+
+## What Paragon Can Do
+
+- ✅ **Catch All Security Flaws** - Comprehensive security scanning that identifies vulnerabilities before they reach production
+- 🏗️ **Identify Infrastructure Issues** - Detect misconfigurations, security gaps, and performance bottlenecks
+- 🚀 **Performance Optimization** - Advanced analysis that identifies bottlenecks, memory leaks, and inefficient algorithms
+- ⚡ **10x Faster Code Reviews** - Automated PR reviews that catch issues instantly
+- 🐛 **World's Best Bug Catcher** - Industry-leading bug detection for production environments
+- 🤖 **Fix AI Slop** - Instantly detect and fix low-quality AI-generated code
+
+---
+
+## Installation
+
+```bash
+npm install -g @polarityinc/paragon
+```
+
+---
+
+## Getting Started
+
+### 1. Authenticate
+
+```bash
+paragon auth login
+```
+
+You'll need your API key from [home.polarity.cc](https://home.polarity.cc).
+
+**Note:** Keep your API key secure. Do not share it publicly or commit it to version control.
+
+### 2. Start Using Paragon
+
+```bash
+paragon
+```
+
+---
+
+## Features
+
+### Session-Based Workflow
+Maintain multiple work sessions and contexts per project. Switch between tasks seamlessly.
+
+### LSP-Enhanced Analysis
+Paragon uses Language Server Protocol (LSP) for deep code understanding, just like your IDE.
+
+### Extensible via MCP
+Add capabilities through Model Context Protocol (`http`, `stdio`, and `sse` transports).
+
+### Works Everywhere
+First-class support in every terminal on macOS, Linux, Windows (PowerShell and WSL), FreeBSD, OpenBSD, and NetBSD.
+
+---
+
+## Configuration
+
+Paragon runs great with no configuration. For advanced usage, create a configuration file:
+
+**Locations** (in priority order):
+1. `.paragon.json` (project-local, hidden)
+2. `paragon.json` (project-local)
+3. `~/.config/paragon/paragon.json` (global)
+
+### Example Configuration
+
+```json
+{
+  "$schema": "https://polarity.cc/paragon.json",
+  "lsp": {
+    "go": {
+      "command": "gopls"
+    },
+    "typescript": {
+      "command": "typescript-language-server",
+      "args": ["--stdio"]
+    }
+  },
+  "mcp": {
+    "filesystem": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/path/to/mcp-server.js"],
+      "timeout": 120,
+      "disabled": false
+    },
+    "api-service": {
+      "type": "http",
+      "url": "https://example.com/mcp/",
+      "timeout": 120,
+      "disabled": false,
+      "headers": {
+        "Authorization": "Bearer your-token"
+      }
+    },
+    "streaming-service": {
+      "type": "sse",
+      "url": "https://example.com/mcp/sse",
+      "timeout": 120,
+      "disabled": false
+    }
+  }
+}
+```
+
+---
+
+## Impact
+
+### Real Results From Teams Worldwide
+
+- **93%** Faster PR Merge Time
+- **81.2%** Production Issues Found Before Deployment
+- **100M** Lines of Code Processed Per Month
+
+---
+
+## Enterprise
+
+Paragon offers enterprise-grade features for teams:
+
+- **SOC 2 Compliance** - Industry-leading security standards
+- **Self-Hosted Options** - Deploy on your infrastructure
+- **Priority Support** - Dedicated support team
+- **Custom Integrations** - Tailored to your workflow
+- **SLA Guarantees** - 99.9% uptime commitment
+
+[Book a demo →](https://polarity.cc/demo)
+
+---
+
+## License
+
+Paragon is proprietary software by [Polarity](https://polarity.cc).
+
+For inquiries, contact [sales@polarity.cc](mailto:sales@polarity.cc).
+
+---
+
+<p align="center">
+  <strong>Experience the world's best code review agent</strong><br/>
+  Join teams worldwide who trust Paragon—the fastest, most accurate, and most secure code review agent.
+</p>
+
+<p align="center">
+  <a href="https://home.polarity.cc/"><strong>Get Started →</strong></a> |
+  <a href="https://polarity.cc/contact"><strong>Book a Demo →</strong></a>
+</p>
+
+---
+

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@polarityinc/paragon",
+  "version": "0.0.9",
+  "description": "Paragon is the First AI QA Engineer and the Worlds best code reviewer.",
+  "author": "Polarity Inc.",
+  "private": false,
+  "homepage": "https://polarity.cc/paragon",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Polarityinc/polarity-binaries.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Polarityinc/polarity-binaries/issues"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "coding-assistant",
+    "terminal",
+    "tui",
+    "paragon",
+    "anthropic",
+    "openai",
+    "cli"
+  ],
+  "bin": {
+    "paragon": "./bin/paragon"
+  },
+  "scripts": {
+    "postinstall": "node scripts/npm-install.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/npm-install.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}

package/scripts/npm-install.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// Get version from package.json
+const packageJson = require('../package.json');
+const VERSION = packageJson.version;
+
+// Determine platform and architecture
+const PLATFORM_MAP = {
+  darwin: 'darwin',
+  linux: 'linux',
+  win32: 'windows'
+};
+
+const ARCH_MAP = {
+  x64: 'amd64',
+  arm64: 'arm64'
+};
+
+const platform = PLATFORM_MAP[process.platform];
+const arch = ARCH_MAP[process.arch];
+
+if (!platform || !arch) {
+  console.error(`Unsupported platform: ${process.platform}-${process.arch}`);
+  console.error('Supported: darwin-x64, darwin-arm64, linux-x64, linux-arm64, win32-x64, win32-arm64');
+  process.exit(1);
+}
+
+// Construct binary name and URL
+const binaryName = platform === 'windows'
+  ? `polarity-${platform}-${arch}.exe`
+  : `polarity-${platform}-${arch}`;
+
+const GITHUB_RELEASE_URL = `https://github.com/Polarityinc/polarity-binaries/releases/download/${VERSION}/${binaryName}`;
+
+// Create bin directory
+const binDir = path.join(__dirname, '..', 'bin');
+const binPath = path.join(binDir, platform === 'windows' ? 'paragon.exe' : 'paragon');
+
+if (!fs.existsSync(binDir)) {
+  fs.mkdirSync(binDir, { recursive: true });
+}
+
+console.log(`Installing Paragon v${VERSION} for ${platform}-${arch}...`);
+console.log(`Downloading from: ${GITHUB_RELEASE_URL}`);
+
+// Download binary
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+
+    https.get(url, (response) => {
+      // Handle redirects
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        file.close();
+        fs.unlinkSync(dest);
+        return downloadFile(response.headers.location, dest).then(resolve).catch(reject);
+      }
+
+      if (response.statusCode !== 200) {
+        file.close();
+        fs.unlinkSync(dest);
+        return reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+      }
+
+      response.pipe(file);
+
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    }).on('error', (err) => {
+      file.close();
+      fs.unlinkSync(dest);
+      reject(err);
+    });
+  });
+}
+
+// Check for ripgrep
+function checkRipgrep() {
+  try {
+    execSync('rg --version', { stdio: 'ignore' });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+// Install ripgrep automatically
+function installRipgrep() {
+  console.log('Installing ripgrep...');
+
+  try {
+    if (platform === 'darwin') {
+      // macOS - try brew
+      try {
+        execSync('brew --version', { stdio: 'ignore' });
+        console.log('Installing ripgrep via Homebrew...');
+        execSync('brew install ripgrep', { stdio: 'inherit' });
+        return true;
+      } catch (e) {
+        console.error('✗ Homebrew not found. Please install Homebrew first: https://brew.sh');
+        return false;
+      }
+    } else if (platform === 'linux') {
+      // Linux - try various package managers
+      // Try apt (Debian/Ubuntu)
+      try {
+        execSync('apt --version', { stdio: 'ignore' });
+        console.log('Installing ripgrep via apt...');
+        execSync('sudo apt update && sudo apt install -y ripgrep', { stdio: 'inherit' });
+        return true;
+      } catch (e) {
+        // Try dnf (Fedora)
+        try {
+          execSync('dnf --version', { stdio: 'ignore' });
+          console.log('Installing ripgrep via dnf...');
+          execSync('sudo dnf install -y ripgrep', { stdio: 'inherit' });
+          return true;
+        } catch (e2) {
+          // Try yum (RHEL/CentOS)
+          try {
+            execSync('yum --version', { stdio: 'ignore' });
+            console.log('Installing ripgrep via yum...');
+            execSync('sudo yum install -y ripgrep', { stdio: 'inherit' });
+            return true;
+          } catch (e3) {
+            console.error('✗ No supported package manager found (apt/dnf/yum)');
+            console.error('Please install ripgrep manually: https://github.com/BurntSushi/ripgrep');
+            return false;
+          }
+        }
+      }
+    } else if (platform === 'windows') {
+      // Windows - try choco first, then scoop
+      try {
+        execSync('choco --version', { stdio: 'ignore' });
+        console.log('Installing ripgrep via Chocolatey...');
+        execSync('choco install ripgrep -y', { stdio: 'inherit' });
+        return true;
+      } catch (e) {
+        try {
+          execSync('scoop --version', { stdio: 'ignore' });
+          console.log('Installing ripgrep via Scoop...');
+          execSync('scoop install ripgrep', { stdio: 'inherit' });
+          return true;
+        } catch (e2) {
+          console.error('✗ No supported package manager found (choco/scoop)');
+          console.error('Please install Chocolatey or Scoop first');
+          return false;
+        }
+      }
+    }
+  } catch (err) {
+    console.error('✗ Failed to install ripgrep:', err.message);
+    return false;
+  }
+}
+
+downloadFile(GITHUB_RELEASE_URL, binPath)
+  .then(() => {
+    // Make binary executable on Unix systems
+    if (platform !== 'windows') {
+      fs.chmodSync(binPath, 0o755);
+    }
+
+    console.log('✓ Paragon installed successfully!');
+
+    // Check and install ripgrep if needed
+    if (!checkRipgrep()) {
+      console.log('\nripgrep is required but not found.');
+      if (!installRipgrep()) {
+        console.log('\n⚠️  Warning: Paragon requires ripgrep to function properly');
+        console.log('Please install it manually: https://github.com/BurntSushi/ripgrep#installation');
+      } else {
+        console.log('✓ ripgrep installed successfully!');
+      }
+    }
+
+    console.log(`\nTo get started, run: paragon`);
+    console.log('For authentication, run: paragon auth login');
+  })
+  .catch((err) => {
+    console.error('✗ Installation failed:', err.message);
+    console.error('\nPlease try one of these alternatives:');
+    console.error('- Homebrew: brew install polarityinc/polarity/polarity');
+    console.error('- Direct download: https://github.com/Polarityinc/polarity-binaries/releases');
+    process.exit(1);
+  });