@argustest/argus 3.1.0

package/LICENSE

@@ -0,0 +1,113 @@
+ArgusTest — iOS Device Monitoring for AI Development
+PROPRIETARY SOFTWARE LICENSE AGREEMENT
+
+Copyright (c) 2026 Able Varghese. All Rights Reserved Worldwide.
+
+NOTICE: This is proprietary, trade-secret software. All intellectual property
+rights, including but not limited to patents, copyrights, trademarks, and trade
+secrets, are owned exclusively by Able Varghese, and any entity to which
+Able Varghese has transferred or assigned such rights, in which Able Varghese
+serves as a director and/or holds a majority ownership interest (collectively,
+"Owner"). References to "Owner" in this agreement shall include Able Varghese
+individually, his successors, assigns, heirs, and any such affiliated entity,
+whether currently existing or formed in the future.
+
+1. LICENSE GRANT
+   This software is licensed, not sold. Subject to payment of applicable fees
+   and compliance with these terms, the Owner grants you a limited,
+   non-exclusive, non-transferable, non-sublicensable, revocable license to
+   use this software solely for your internal business or personal purposes,
+   on the number of machines and devices specified in your subscription plan.
+
+2. OWNERSHIP AND INTELLECTUAL PROPERTY
+   The Owner retains all right, title, and interest in and to the software,
+   including all source code, object code, algorithms, data structures,
+   architecture, documentation, trade secrets, and all derivative works.
+   Nothing in this agreement transfers any ownership rights to you.
+
+3. STRICTLY PROHIBITED
+   You shall NOT, directly or indirectly, nor permit any third party to:
+   a) Reverse engineer, decompile, disassemble, or otherwise attempt to
+      derive the source code, algorithms, or data structures of the software;
+   b) Modify, adapt, translate, or create derivative works based on the software;
+   c) Copy, reproduce, distribute, republish, download, display, post, or
+      transmit the software in any form or by any means;
+   d) Rent, lease, lend, sell, sublicense, assign, or otherwise transfer
+      rights to the software;
+   e) Remove, alter, or obscure any proprietary notices, labels, or marks;
+   f) Circumvent, disable, or interfere with any license validation,
+      security features, or usage restrictions;
+   g) Share, publish, or disclose your license key to any third party;
+   h) Use the software to build a competing product or service;
+   i) Use the software beyond the scope of your licensed subscription plan;
+   j) Attempt to access, extract, or reconstruct any proprietary source code,
+      trade secrets, or confidential information from the compiled binaries;
+   k) Use automated tools to probe, scan, or test the license validation
+      system for vulnerabilities;
+   l) Redistribute the software binaries or any portion thereof.
+
+4. TRADE SECRET PROTECTION
+   The software contains valuable trade secrets and proprietary information
+   of the Owner. You acknowledge that any unauthorized disclosure, use, or
+   copying of the software or its components would cause irreparable harm
+   to the Owner. You agree to maintain the confidentiality of the software
+   using at least the same degree of care you use to protect your own
+   confidential information, but in no event less than reasonable care.
+
+5. LIQUIDATED DAMAGES
+   You acknowledge that unauthorized use, copying, distribution, reverse
+   engineering, or any violation of this agreement would cause substantial
+   and irreparable harm to the Owner, the exact amount of which would be
+   difficult to ascertain. Accordingly, you agree that in addition to any
+   other remedies available at law or in equity, the Owner shall be entitled
+   to liquidated damages of ONE HUNDRED MILLION UNITED STATES DOLLARS
+   (USD $100,000,000) for each material breach of this agreement, which you
+   acknowledge represents a reasonable estimate of the damages the Owner
+   would suffer. This liquidated damages provision shall not limit the
+   Owner's right to seek injunctive relief or actual damages where they
+   exceed this amount.
+
+6. INJUNCTIVE RELIEF
+   You acknowledge that any breach of this agreement would cause irreparable
+   injury to the Owner for which monetary damages would be inadequate. The
+   Owner shall be entitled to seek immediate injunctive relief, including
+   temporary restraining orders, preliminary injunctions, and permanent
+   injunctions, without the necessity of proving actual damages or posting
+   any bond.
+
+7. AUDIT RIGHTS
+   The Owner reserves the right to audit your use of the software to verify
+   compliance with this agreement. You agree to cooperate with any such audit
+   and provide reasonable access to relevant systems and records.
+
+8. TERMINATION
+   This license is effective until terminated. It terminates automatically if
+   you breach any term of this agreement. Upon termination, you must
+   immediately cease all use and destroy all copies of the software.
+   Sections 2, 3, 4, 5, 6, 7, 10, and 11 survive termination.
+
+9. NO WARRANTIES
+   THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+10. LIMITATION OF LIABILITY
+    IN NO EVENT SHALL THE OWNER BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
+    SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES ARISING FROM YOUR USE OF
+    THE SOFTWARE. THE OWNER'S TOTAL LIABILITY SHALL NOT EXCEED THE AMOUNT
+    YOU PAID FOR THE SOFTWARE IN THE TWELVE (12) MONTHS PRECEDING THE CLAIM.
+
+11. GOVERNING LAW AND JURISDICTION
+    This agreement shall be governed by the laws of the State of California,
+    United States, without regard to conflict of law principles. Any dispute
+    arising under this agreement shall be subject to the exclusive
+    jurisdiction of the federal and state courts located in California.
+    You consent to personal jurisdiction in such courts.
+
+12. ENTIRE AGREEMENT
+    This agreement constitutes the entire agreement between you and the Owner
+    regarding the software and supersedes all prior agreements. No amendment
+    shall be effective unless in writing and signed by the Owner.
+
+For full terms, visit: https://argustest.dev/terms
+Contact: legal@argustest.dev

package/README.md

@@ -0,0 +1,56 @@
+# ArgusTest - iOS Device Monitoring for AI Development
+
+MCP (Model Context Protocol) server for real-time iOS device monitoring, screenshots, and error tracking. Designed for Claude Code and AI-powered development workflows.
+
+## Install
+
+```bash
+npm install -g @argustest/argus
+```
+
+## Quick Start
+
+```bash
+# Activate with your license key
+argus-mcp --license-activate YOUR-LICENSE-KEY
+```
+
+Subscribe at [argustest.dev/pricing](https://argustest.dev/pricing) to get your license key.
+
+## Claude Code MCP Configuration
+
+Add to your Claude Code MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "argus": {
+      "command": "argus-mcp"
+    }
+  }
+}
+```
+
+## Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `device_status` | Check connected device state |
+| `device_list_errors` | List recent device errors |
+| `device_capture_screenshot` | Capture device screenshot |
+| `device_get_crash_logs` | List available crash logs |
+| `device_read_crash_log` | Read crash log contents |
+
+## Requirements
+
+- macOS 12.0+
+- Physical iOS device connected via USB (or Simulator)
+- `libimobiledevice` (`brew install libimobiledevice`)
+
+## License
+
+Commercial software. Subscribe at [argustest.dev/pricing](https://argustest.dev/pricing).
+
+## Support
+
+Visit [argustest.dev/support](https://argustest.dev/support) for help.

package/bin/argus-mcp.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * ArgusTest MCP Server Launcher
+ *
+ * Thin Node.js wrapper that launches the native Nuitka-compiled binary.
+ * The actual binary is downloaded during `npm install` by postinstall.js.
+ */
+
+"use strict";
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const BINARY_NAME = "argus-mcp";
+const nativePath = path.join(__dirname, "..", "native", BINARY_NAME);
+
+if (!fs.existsSync(nativePath)) {
+  console.error("ERROR: ArgusTest native binary not found.");
+  console.error("");
+  console.error("Try reinstalling: npm install -g @argustest/argus");
+  console.error("");
+  console.error("If the problem persists, visit: https://argustest.dev/support");
+  process.exit(1);
+}
+
+try {
+  execFileSync(nativePath, process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  // execFileSync throws on non-zero exit — propagate the exit code
+  process.exit(err.status || 1);
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@argustest/argus",
+  "version": "3.1.0",
+  "description": "iOS Device Monitoring for AI Development - MCP Server for Claude Code",
+  "bin": {
+    "argus-mcp": "./bin/argus-mcp.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "ios",
+    "device",
+    "testing",
+    "monitoring",
+    "claude",
+    "ai",
+    "xcode",
+    "mobile",
+    "argus"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://argustest.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AbleVarghese/homebrew-tap"
+  },
+  "bugs": {
+    "url": "https://argustest.dev/support"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "native/.gitkeep",
+    "LICENSE",
+    "README.md"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,235 @@
+#!/usr/bin/env node
+/**
+ * ArgusTest postinstall script
+ *
+ * Downloads the correct native binary for the current platform and architecture.
+ * Runs automatically after `npm install @argustest/argus`.
+ *
+ * Pattern used by: esbuild, turbo, SWC, protobuf
+ */
+
+"use strict";
+
+const https = require("https");
+const http = require("http");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const os = require("os");
+const zlib = require("zlib");
+
+// Release configuration
+const pkg = require("../package.json");
+const VERSION = pkg.version;
+const GITHUB_OWNER = "AbleVarghese";
+const GITHUB_REPO = "homebrew-tap";
+const BASE_URL = `https://github.com/${GITHUB_OWNER}/${GITHUB_REPO}/releases/download/v${VERSION}`;
+
+// Binary names
+const BINARY_NAME = "argus-mcp";
+const NATIVE_DIR = path.join(__dirname, "..", "native");
+
+function getPlatformArch() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  if (platform !== "darwin") {
+    console.error(`ERROR: ArgusTest only supports macOS. Detected: ${platform}`);
+    console.error("Visit https://argustest.dev for platform support updates.");
+    process.exit(1);
+  }
+
+  // Map Node.js arch names to our naming convention
+  const archMap = {
+    arm64: "arm64",
+    x64: "x86_64",
+  };
+
+  const mappedArch = archMap[arch];
+  if (!mappedArch) {
+    console.error(`ERROR: Unsupported architecture: ${arch}`);
+    console.error("ArgusTest supports arm64 (Apple Silicon) and x64 (Intel).");
+    process.exit(1);
+  }
+
+  return { platform, arch: mappedArch };
+}
+
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const makeRequest = (requestUrl, redirectCount) => {
+      if (redirectCount > 5) {
+        reject(new Error("Too many redirects"));
+        return;
+      }
+
+      const protocol = requestUrl.startsWith("https") ? https : http;
+      protocol
+        .get(requestUrl, (res) => {
+          // Handle redirects (GitHub Releases uses 302)
+          if (res.statusCode === 301 || res.statusCode === 302) {
+            makeRequest(res.headers.location, redirectCount + 1);
+            return;
+          }
+
+          if (res.statusCode !== 200) {
+            reject(
+              new Error(`Download failed: HTTP ${res.statusCode} from ${requestUrl}`)
+            );
+            return;
+          }
+
+          const file = fs.createWriteStream(dest);
+          res.pipe(file);
+          file.on("finish", () => {
+            file.close(resolve);
+          });
+          file.on("error", (err) => {
+            fs.unlink(dest, () => {});
+            reject(err);
+          });
+        })
+        .on("error", reject);
+    };
+
+    makeRequest(url, 0);
+  });
+}
+
+async function extractTarGz(archivePath, destDir) {
+  // Use system tar (available on macOS)
+  execSync(`tar -xzf "${archivePath}" -C "${destDir}"`, {
+    stdio: "pipe",
+  });
+}
+
+async function tryDownload(arch, tempDir) {
+  const archiveName = `argus-macos-${arch}-${VERSION}.tar.gz`;
+  const downloadUrl = `${BASE_URL}/${archiveName}`;
+  const archivePath = path.join(tempDir, archiveName);
+
+  console.log(`Downloading from ${downloadUrl}...`);
+  await downloadFile(downloadUrl, archivePath);
+  return { archivePath, arch };
+}
+
+async function main() {
+  const { arch } = getPlatformArch();
+
+  console.log(`ArgusTest v${VERSION} - Installing for macOS ${arch}...`);
+
+  // Create native directory
+  fs.mkdirSync(NATIVE_DIR, { recursive: true });
+
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "argustest-"));
+
+  try {
+    // Download binary — strict architecture match, NO cross-architecture fallback.
+    // arm64 users get arm64, x86_64 users get x86_64. Never cross-delivered.
+    let archivePath;
+    try {
+      const result = await tryDownload(arch, tempDir);
+      archivePath = result.archivePath;
+    } catch (err) {
+      // Binary for this architecture is not available.
+      // Do NOT fall back to a different architecture under any circumstances.
+      console.error("");
+      console.error(`WARNING: ArgusTest ${arch} binary is not yet available.`);
+      console.error(`  ${err.message}`);
+      console.error("");
+      console.error("This can happen if:");
+      console.error("  - The release was just published and the CI build is still in progress (~10 min)");
+      console.error("  - No internet connection or GitHub is unreachable");
+      console.error("  - GitHub rate limiting");
+      console.error("");
+      console.error("To retry after the binary becomes available:");
+      console.error("  npm rebuild @argustest/argus");
+      console.error("");
+      console.error("Manual install: https://argustest.dev/docs/install");
+      // Do NOT exit with error — npm install must succeed so user can retry later.
+      // The binary simply won't be present; bin/argus-mcp.js handles that at runtime.
+      return;
+    }
+
+    // Extract
+    console.log("Extracting...");
+    const extractDir = path.join(tempDir, "extract");
+    fs.mkdirSync(extractDir, { recursive: true });
+    await extractTarGz(archivePath, extractDir);
+
+    // Find the binary (might be in a subdirectory like argus-macos-arm64-3.1.0/bin/)
+    const possiblePaths = [
+      path.join(extractDir, "bin", BINARY_NAME),
+      path.join(
+        extractDir,
+        `argus-macos-${arch}-${VERSION}`,
+        "bin",
+        BINARY_NAME
+      ),
+    ];
+
+    let binarySource = null;
+    for (const p of possiblePaths) {
+      if (fs.existsSync(p)) {
+        binarySource = p;
+        break;
+      }
+    }
+
+    if (!binarySource) {
+      // Try recursive search
+      const findResult = execSync(
+        `find "${extractDir}" -name "${BINARY_NAME}" -type f 2>/dev/null`
+      )
+        .toString()
+        .trim();
+      if (findResult) {
+        binarySource = findResult.split("\n")[0];
+      }
+    }
+
+    if (!binarySource) {
+      throw new Error(
+        `Binary '${BINARY_NAME}' not found in downloaded archive`
+      );
+    }
+
+    // Copy binary to native directory
+    const destPath = path.join(NATIVE_DIR, BINARY_NAME);
+    fs.copyFileSync(binarySource, destPath);
+    fs.chmodSync(destPath, 0o755);
+
+    console.log(`ArgusTest v${VERSION} installed successfully for macOS ${arch}!`);
+    console.log("");
+    console.log("  Get started:");
+    console.log("    1. Subscribe at: https://argustest.dev/pricing");
+    console.log("    2. argus-mcp --license-activate YOUR-KEY");
+    console.log("    3. argus-mcp --license-status");
+    console.log("");
+  } catch (err) {
+    console.error("");
+    console.error(`ERROR: Failed to install ArgusTest binary.`);
+    console.error(`  ${err.message}`);
+    console.error("");
+    console.error("Possible causes:");
+    console.error("  - No internet connection");
+    console.error("  - Release not yet available for your architecture");
+    console.error("  - GitHub rate limiting");
+    console.error("");
+    console.error("Manual install: https://argustest.dev/docs/install");
+    // Don't exit with error — npm install should still succeed
+    // The binary just won't be available until manually installed
+    console.error(
+      "WARNING: ArgusTest binary not installed. Run `npm rebuild @argustest/argus` to retry."
+    );
+  } finally {
+    // Cleanup temp files
+    try {
+      fs.rmSync(tempDir, { recursive: true, force: true });
+    } catch {
+      // Best effort cleanup
+    }
+  }
+}
+
+main();