@dev-symphony/sym 0.1.0

package/README.md

@@ -0,0 +1,84 @@
+# Symphony MCP Server
+
+LLM-friendly convention linter for AI coding tools.
+
+## Installation
+
+### One-line MCP Setup
+
+```bash
+claude mcp add symphony npx @dev-symphony/sym@latest mcp
+```
+
+### Direct Installation
+
+```bash
+npm install -g @dev-symphony/sym
+```
+
+## Usage
+
+### MCP Configuration
+
+Add to your MCP config file:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%/Claude/claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "symphony": {
+      "command": "npx",
+      "args": ["-y", "@dev-symphony/sym@latest", "mcp"]
+    }
+  }
+}
+```
+
+### Available Tools
+
+**query_conventions**
+- Query project conventions by category, files, or languages
+- All parameters are optional
+
+**validate_code**
+- Validate code against defined conventions
+- Parameters: files (required)
+
+## Policy File
+
+Create `.sym/user-policy.json` in your project root:
+
+```json
+{
+  "version": "1.0.0",
+  "rules": [
+    {
+      "say": "Functions should be documented",
+      "category": "documentation"
+    },
+    {
+      "say": "Lines should be less than 100 characters",
+      "category": "formatting",
+      "params": { "max": 100 }
+    }
+  ]
+}
+```
+
+## Requirements
+
+- Node.js >= 16.0.0
+- Policy file: `.sym/user-policy.json`
+
+## Supported Platforms
+
+- macOS (Intel, Apple Silicon)
+- Linux (x64, ARM64)
+- Windows (x64)
+
+## License
+
+MIT

package/bin/sym.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+/**
+ * Get the platform-specific binary name
+ */
+function getPlatformBinary() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  const binaryMap = {
+    'darwin-arm64': 'sym-darwin-arm64',
+    'darwin-x64': 'sym-darwin-amd64',
+    'linux-x64': 'sym-linux-amd64',
+    'linux-arm64': 'sym-linux-arm64',
+    'win32-x64': 'sym-windows-amd64.exe',
+  };
+
+  const key = `${platform}-${arch}`;
+  const binaryName = binaryMap[key];
+
+  if (!binaryName) {
+    console.error(`Error: Unsupported platform: ${platform}-${arch}`);
+    console.error('Supported platforms:');
+    Object.keys(binaryMap).forEach(k => console.error(`  - ${k}`));
+    process.exit(1);
+  }
+
+  return path.join(__dirname, binaryName);
+}
+
+/**
+ * Main execution
+ */
+function main() {
+  const binaryPath = getPlatformBinary();
+
+  if (!fs.existsSync(binaryPath)) {
+    console.error(`Error: Binary not found at ${binaryPath}`);
+    console.error('');
+    console.error('This usually means the binary download failed during installation.');
+    console.error('Please try reinstalling:');
+    console.error('  npm uninstall @dev-symphony/sym');
+    console.error('  npm install @dev-symphony/sym');
+    console.error('');
+    console.error('If the problem persists, please report an issue at:');
+    console.error('  https://github.com/DevSymphony/sym-cli/issues');
+    process.exit(1);
+  }
+
+  // Make sure the binary is executable (Unix systems)
+  if (process.platform !== 'win32') {
+    try {
+      fs.chmodSync(binaryPath, '755');
+    } catch (err) {
+      // Ignore chmod errors, might not have permission
+    }
+  }
+
+  // Pass all arguments to the binary
+  const args = process.argv.slice(2);
+
+  const child = spawn(binaryPath, args, {
+    stdio: 'inherit',
+    windowsHide: true,
+  });
+
+  child.on('error', (err) => {
+    console.error(`Error executing binary: ${err.message}`);
+    process.exit(1);
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+    } else {
+      process.exit(code || 0);
+    }
+  });
+}
+
+main();

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@dev-symphony/sym",
+  "version": "0.1.0",
+  "description": "Symphony - LLM-friendly convention linter for AI coding assistants",
+  "keywords": [
+    "mcp",
+    "linter",
+    "conventions",
+    "llm",
+    "claude",
+    "ai-coding",
+    "code-quality"
+  ],
+  "bin": {
+    "sym": "./bin/sym.js"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DevSymphony/sym-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/DevSymphony/sym-cli/issues"
+  },
+  "homepage": "https://github.com/DevSymphony/sym-cli#readme",
+  "author": "DevSymphony",
+  "license": "MIT",
+  "dependencies": {
+    "https-proxy-agent": "^7.0.2"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}