agnix 0.7.0

package/README.md

@@ -0,0 +1,88 @@
+# agnix
+
+Linter for AI agent configurations. Validates SKILL.md, CLAUDE.md, hooks, MCP, and more.
+
+**100 rules** | **Real-time validation** | **Auto-fix** | **Multi-tool support**
+
+## Installation
+
+```bash
+npm install -g agnix
+```
+
+Or run directly with npx:
+
+```bash
+npx agnix .
+```
+
+## Usage
+
+### Command Line
+
+```bash
+# Lint current directory
+agnix .
+
+# Lint specific file
+agnix CLAUDE.md
+
+# Auto-fix issues
+agnix --fix .
+
+# JSON output
+agnix --format json .
+
+# Target specific tool
+agnix --target cursor .
+```
+
+### Node.js API
+
+```javascript
+const agnix = require('agnix');
+
+// Async lint
+const result = await agnix.lint('./');
+console.log(result);
+
+// Sync run
+const { stdout, exitCode } = agnix.runSync(['--version']);
+
+// Get version
+console.log(agnix.version());
+```
+
+## Supported Files
+
+| File | Tool |
+|------|------|
+| `SKILL.md` | Claude Code |
+| `CLAUDE.md`, `AGENTS.md` | Claude Code, Codex |
+| `.claude/settings.json` | Claude Code |
+| `plugin.json` | Claude Code |
+| `*.mcp.json` | All |
+| `.github/copilot-instructions.md` | GitHub Copilot |
+| `.cursor/rules/*.mdc` | Cursor |
+
+## Options
+
+```
+-t, --target <tool>    Target tool (ClaudeCode, Cursor, Copilot, CodexCli)
+-f, --format <format>  Output format (text, json, sarif)
+    --fix              Auto-fix issues
+-q, --quiet            Only show errors
+-v, --verbose          Show detailed output
+    --version          Show version
+-h, --help             Show help
+```
+
+## Links
+
+- [GitHub Repository](https://github.com/avifenesh/agnix)
+- [Validation Rules](https://github.com/avifenesh/agnix/blob/main/knowledge-base/VALIDATION-RULES.md)
+- [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=avifenesh.agnix)
+
+## License
+
+MIT OR Apache-2.0

package/bin/agnix

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+const binDir = __dirname;
+const binaryName = os.platform() === 'win32' ? 'agnix-binary.exe' : 'agnix-binary';
+const binaryPath = path.join(binDir, binaryName);
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  shell: false,
+});
+
+child.on('error', (err) => {
+  if (err.code === 'ENOENT') {
+    console.error('agnix binary not found. Try reinstalling:');
+    console.error('  npm install -g agnix');
+  } else {
+    console.error(`Failed to run agnix: ${err.message}`);
+  }
+  process.exit(1);
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/index.js

@@ -0,0 +1,123 @@
+/**
+ * agnix - Node.js API
+ *
+ * Programmatic access to the agnix linter.
+ */
+
+const { spawn, spawnSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+const binDir = path.join(__dirname, 'bin');
+const binaryName = os.platform() === 'win32' ? 'agnix-binary.exe' : 'agnix-binary';
+const binaryPath = path.join(binDir, binaryName);
+
+/**
+ * Run agnix synchronously and return the result.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {object} options - Options passed to spawnSync
+ * @returns {{ stdout: string, stderr: string, exitCode: number }}
+ */
+function runSync(args = [], options = {}) {
+  const result = spawnSync(binaryPath, args, {
+    encoding: 'utf-8',
+    ...options,
+  });
+
+  if (result.error) {
+    throw result.error;
+  }
+
+  return {
+    stdout: result.stdout || '',
+    stderr: result.stderr || '',
+    exitCode: result.status || 0,
+  };
+}
+
+/**
+ * Run agnix asynchronously and return a promise.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {object} options - Options passed to spawn
+ * @returns {Promise<{ stdout: string, stderr: string, exitCode: number }>}
+ */
+function run(args = [], options = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(binaryPath, args, options);
+    let stdout = '';
+    let stderr = '';
+
+    if (child.stdout) {
+      child.stdout.on('data', (data) => {
+        stdout += data.toString();
+      });
+    }
+
+    if (child.stderr) {
+      child.stderr.on('data', (data) => {
+        stderr += data.toString();
+      });
+    }
+
+    child.on('error', reject);
+
+    child.on('close', (code) => {
+      resolve({
+        stdout,
+        stderr,
+        exitCode: code || 0,
+      });
+    });
+  });
+}
+
+/**
+ * Lint files and return diagnostics as JSON.
+ *
+ * @param {string} target - Path to file or directory to lint
+ * @param {object} options - Lint options
+ * @param {string} options.target - Target tool (ClaudeCode, Cursor, etc.)
+ * @param {string} options.format - Output format (json, sarif)
+ * @returns {Promise<object>} - Parsed JSON diagnostics
+ */
+async function lint(target, options = {}) {
+  const args = ['--format', 'json'];
+
+  if (options.target) {
+    args.push('--target', options.target);
+  }
+
+  args.push(target);
+
+  const result = await run(args);
+
+  try {
+    return JSON.parse(result.stdout);
+  } catch {
+    return {
+      files: [],
+      summary: { errors: 0, warnings: 0, fixable: 0 },
+      raw: result.stdout,
+    };
+  }
+}
+
+/**
+ * Get agnix version.
+ *
+ * @returns {string} - Version string
+ */
+function version() {
+  const result = runSync(['--version']);
+  return result.stdout.trim();
+}
+
+module.exports = {
+  run,
+  runSync,
+  lint,
+  version,
+  binaryPath,
+};

package/install.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const os = require('os');
+
+const GITHUB_REPO = 'avifenesh/agnix';
+const VERSION = require('./package.json').version;
+
+/**
+ * Get platform-specific asset name and binary name.
+ */
+function getPlatformInfo() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  const mapping = {
+    'darwin-arm64': {
+      asset: 'agnix-aarch64-apple-darwin.tar.gz',
+      extractedName: 'agnix',
+      binary: 'agnix-binary',
+    },
+    'darwin-x64': {
+      // x64 Mac uses ARM binary via Rosetta 2
+      asset: 'agnix-aarch64-apple-darwin.tar.gz',
+      extractedName: 'agnix',
+      binary: 'agnix-binary',
+    },
+    'linux-x64': {
+      asset: 'agnix-x86_64-unknown-linux-gnu.tar.gz',
+      extractedName: 'agnix',
+      binary: 'agnix-binary',
+    },
+    'linux-arm64': {
+      // ARM Linux not yet available, try x64 with emulation
+      asset: 'agnix-x86_64-unknown-linux-gnu.tar.gz',
+      extractedName: 'agnix',
+      binary: 'agnix-binary',
+    },
+    'win32-x64': {
+      asset: 'agnix-x86_64-pc-windows-msvc.zip',
+      extractedName: 'agnix.exe',
+      binary: 'agnix-binary.exe',
+    },
+  };
+
+  const key = `${platform}-${arch}`;
+  const info = mapping[key];
+
+  if (!info) {
+    console.error(`Unsupported platform: ${platform}-${arch}`);
+    console.error('Supported platforms: darwin-arm64, darwin-x64, linux-x64, win32-x64');
+    process.exit(1);
+  }
+
+  return info;
+}
+
+/**
+ * Download a file from URL, following redirects.
+ */
+function downloadFile(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(destPath);
+
+    const request = https.get(url, (response) => {
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        const redirectUrl = response.headers.location;
+        if (redirectUrl) {
+          file.close();
+          fs.unlinkSync(destPath);
+          downloadFile(redirectUrl, destPath).then(resolve).catch(reject);
+          return;
+        }
+      }
+
+      if (response.statusCode !== 200) {
+        file.close();
+        reject(new Error(`Download failed with status ${response.statusCode}`));
+        return;
+      }
+
+      response.pipe(file);
+
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    });
+
+    request.on('error', (err) => {
+      file.close();
+      fs.unlinkSync(destPath);
+      reject(err);
+    });
+
+    file.on('error', (err) => {
+      fs.unlinkSync(destPath);
+      reject(err);
+    });
+  });
+}
+
+/**
+ * Extract archive based on platform.
+ */
+function extractArchive(archivePath, destDir) {
+  const platform = os.platform();
+
+  if (platform === 'win32') {
+    // Use PowerShell to extract zip
+    execSync(
+      `powershell -Command "Expand-Archive -Path '${archivePath}' -DestinationPath '${destDir}' -Force"`,
+      { stdio: 'inherit' }
+    );
+  } else {
+    // Use tar for .tar.gz
+    execSync(`tar -xzf "${archivePath}" -C "${destDir}"`, { stdio: 'inherit' });
+  }
+}
+
+async function main() {
+  const platformInfo = getPlatformInfo();
+  const binDir = path.join(__dirname, 'bin');
+  const binaryPath = path.join(binDir, platformInfo.binary);
+  const extractedPath = path.join(binDir, platformInfo.extractedName);
+
+  // Skip if binary already exists
+  if (fs.existsSync(binaryPath)) {
+    console.log('agnix binary already installed');
+    return;
+  }
+
+  // Ensure bin directory exists
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  const downloadUrl = `https://github.com/${GITHUB_REPO}/releases/download/v${VERSION}/${platformInfo.asset}`;
+  const archivePath = path.join(binDir, platformInfo.asset);
+
+  console.log(`Downloading agnix v${VERSION} for ${os.platform()}-${os.arch()}...`);
+
+  try {
+    await downloadFile(downloadUrl, archivePath);
+    console.log('Extracting...');
+    extractArchive(archivePath, binDir);
+
+    // Clean up archive
+    fs.unlinkSync(archivePath);
+
+    // Rename extracted binary to avoid conflict with wrapper script
+    if (fs.existsSync(extractedPath) && extractedPath !== binaryPath) {
+      fs.renameSync(extractedPath, binaryPath);
+    }
+
+    // Make binary executable on Unix
+    if (os.platform() !== 'win32') {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    // Verify binary exists
+    if (!fs.existsSync(binaryPath)) {
+      throw new Error('Binary not found after extraction');
+    }
+
+    console.log('agnix installed successfully');
+  } catch (error) {
+    console.error(`Failed to install agnix: ${error.message}`);
+    console.error('');
+    console.error('You can install manually:');
+    console.error('  cargo install agnix-cli');
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "agnix",
+  "version": "0.7.0",
+  "description": "Linter for AI agent configurations. Validates SKILL.md, CLAUDE.md, hooks, MCP, and more.",
+  "keywords": [
+    "agent",
+    "linter",
+    "claude",
+    "claude-code",
+    "mcp",
+    "model-context-protocol",
+    "skills",
+    "validation",
+    "cursor",
+    "copilot",
+    "codex",
+    "ai"
+  ],
+  "homepage": "https://github.com/avifenesh/agnix",
+  "bugs": {
+    "url": "https://github.com/avifenesh/agnix/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/avifenesh/agnix.git"
+  },
+  "license": "MIT OR Apache-2.0",
+  "author": "Avi Fenesh <avifenesh@gmail.com>",
+  "bin": {
+    "agnix": "bin/agnix"
+  },
+  "main": "index.js",
+  "files": [
+    "bin/",
+    "install.js",
+    "index.js",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node install.js",
+    "test": "node test/test.js"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}