@redstone-md/nodule 0.1.0

package/bin/install.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * Nodule — postinstall script.
+ *
+ * Downloads the platform-appropriate Nodule binary from the latest GitHub
+ * Release. Falls back to `go install` if download fails.
+ */
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawnSync } = require('child_process');
+
+const GITHUB_REPO = 'redstone-md/nodule';
+const BIN_DIR = __dirname;
+
+function getTarget() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  let goos, goarch, ext = '';
+
+  switch (platform) {
+    case 'linux':   goos = 'linux';   break;
+    case 'darwin':  goos = 'darwin';  break;
+    case 'win32':   goos = 'windows'; ext = '.exe'; break;
+    default:
+      console.warn('nodule: unsupported platform ' + platform + ', skipping download');
+      console.warn('nodule: install manually: go install github.com/redstone-md/nodule/cmd/nodule@latest');
+      return null;
+  }
+
+  switch (arch) {
+    case 'x64':     goarch = 'amd64'; break;
+    case 'arm64':   goarch = 'arm64'; break;
+    case 'ia32':    goarch = '386';   break;
+    default:
+      console.warn('nodule: unsupported arch ' + arch + ', skipping download');
+      return null;
+  }
+
+  const assetName = 'nodule-' + goos + '-' + goarch + ext;
+  return { goos: goos, goarch: goarch, ext: ext, assetName: assetName };
+}
+
+function fetchLatestReleaseTag() {
+  return new Promise(function(resolve, reject) {
+    var url = 'https://api.github.com/repos/' + GITHUB_REPO + '/releases/latest';
+    https.get(url, { headers: { 'User-Agent': 'nodule-installer' } }, function(res) {
+      if (res.statusCode !== 200) {
+        return reject(new Error('GitHub API returned ' + res.statusCode));
+      }
+      var body = '';
+      res.on('data', function(chunk) { body += chunk; });
+      res.on('end', function() {
+        try { resolve(JSON.parse(body)); }
+        catch (e) { reject(e); }
+      });
+    }).on('error', reject);
+  });
+}
+
+function downloadAsset(url, destPath) {
+  return new Promise(function(resolve, reject) {
+    var file = fs.createWriteStream(destPath);
+    https.get(url, { headers: { 'User-Agent': 'nodule-installer' } }, function(res) {
+      if (res.statusCode === 301 || res.statusCode === 302) {
+        file.close();
+        fs.unlinkSync(destPath);
+        return downloadAsset(res.headers.location, destPath).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) {
+        file.close();
+        fs.unlinkSync(destPath);
+        return reject(new Error('Download failed: HTTP ' + res.statusCode));
+      }
+      res.pipe(file);
+      file.on('finish', function() { file.close(resolve); });
+    }).on('error', function(err) {
+      file.close();
+      try { fs.unlinkSync(destPath); } catch (e) {}
+      reject(err);
+    });
+  });
+}
+
+async function main() {
+  var target = getTarget();
+  if (!target) return;
+
+  var destPath = path.join(BIN_DIR, 'nodule-' + target.goos + '-' + target.goarch + target.ext);
+
+  if (fs.existsSync(destPath)) {
+    console.log('nodule: binary already present, skipping download');
+    return;
+  }
+
+  console.log('nodule: downloading binary for ' + target.goos + '/' + target.goarch + '...');
+
+  try {
+    var release = await fetchLatestReleaseTag();
+    var asset = (release.assets || []).find(function(a) { return a.name === target.assetName; });
+    if (!asset) {
+      throw new Error('asset ' + target.assetName + ' not found in release ' + release.tag_name);
+    }
+
+    await downloadAsset(asset.browser_download_url, destPath);
+
+    if (target.goos !== 'windows') {
+      fs.chmodSync(destPath, 0o755);
+    }
+
+    console.log('nodule: installed ' + release.tag_name);
+  } catch (err) {
+    console.warn('nodule: could not download binary (' + err.message + ')');
+    console.warn('nodule: falling back to go install...');
+
+    var result = spawnSync('go', [
+      'install', 'github.com/' + GITHUB_REPO + '/cmd/nodule@latest'
+    ], { stdio: 'inherit' });
+
+    if (result.status !== 0) {
+      console.warn('nodule: go install failed. Install manually:');
+      console.warn('         go install github.com/redstone-md/nodule/cmd/nodule@latest');
+    } else {
+      console.log('nodule: installed via go install (ensure $GOPATH/bin is in PATH)');
+    }
+  }
+}
+
+main();

package/bin/nodule.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/**
+ * Nodule — binary launcher.
+ *
+ * Runs the platform-specific Nodule MCP server binary with stdio passthrough.
+ * This is a thin wrapper: the Go binary handles all MCP protocol logic.
+ *
+ * All environment variables (NODULE_LLM_PROVIDER, NODULE_API_KEY, etc.)
+ * are inherited from the parent process — Nodule is fully BYOM/BYOK.
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+
+function getBinaryPath() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  let goos, ext = '';
+  switch (platform) {
+    case 'linux':   goos = 'linux'; break;
+    case 'darwin':  goos = 'darwin'; break;
+    case 'win32':   goos = 'windows'; ext = '.exe'; break;
+    default: throw new Error(`unsupported platform: ${platform}`);
+  }
+
+  let goarch;
+  switch (arch) {
+    case 'x64':   goarch = 'amd64'; break;
+    case 'arm64': goarch = 'arm64'; break;
+    case 'ia32':  goarch = '386'; break;
+    default: throw new Error(`unsupported arch: ${arch}`);
+  }
+
+  const binaryName = `nodule-${goos}-${goarch}${ext}`;
+  return path.join(__dirname, binaryName);
+}
+
+function main() {
+  let binaryPath = getBinaryPath();
+
+  // If the platform binary doesn't exist, try PATH lookup (go install case)
+  if (!fs.existsSync(binaryPath)) {
+    const isWindows = os.platform() === 'win32';
+    binaryPath = isWindows ? 'nodule.exe' : 'nodule';
+  }
+
+  const child = spawn(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+    env: process.env,
+  });
+
+  child.on('error', (err) => {
+    if (err.code === 'ENOENT') {
+      process.stderr.write(
+        'nodule: binary not found. Reinstall with `npm install nodule` or `go install github.com/redstone-md/nodule/cmd/nodule@latest`\n'
+      );
+    } else {
+      process.stderr.write(`nodule: ${err.message}\n`);
+    }
+    process.exit(1);
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+    } else {
+      process.exit(code ?? 1);
+    }
+  });
+}
+
+main();

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@redstone-md/nodule",
+  "version": "0.1.0",
+  "description": "Local MCP server providing a bounce_idea tool for independent LLM-based code critique (BYOM/BYOK)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/redstone-md/nodule.git",
+    "directory": "npm"
+  },
+  "homepage": "https://github.com/redstone-md/nodule#readme",
+  "bugs": {
+    "url": "https://github.com/redstone-md/nodule/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "llm",
+    "ai",
+    "code-review",
+    "critic",
+    "gemini",
+    "openai",
+    "ollama"
+  ],
+  "bin": {
+    "nodule": "bin/nodule.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/install.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}