rpg-encoder 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# rpg-encoder
+
+Semantic code graph for AI-assisted code understanding.
+
+Extracts entities from your codebase, resolves dependency edges, and lifts semantic features via LLM — producing a navigable graph optimized for AI coding tools.
+
+## MCP Server (Claude Code, Cursor, etc.)
+
+Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "rpg": {
+      "command": "npx",
+      "args": ["-y", "-p", "rpg-encoder", "rpg-mcp-server", "/path/to/your/project"]
+    }
+  }
+}
+```
+
+## CLI
+
+```bash
+npx -p rpg-encoder rpg-encoder build           # Build the graph
+npx -p rpg-encoder rpg-encoder build --lift     # Build with semantic lifting
+npx -p rpg-encoder rpg-encoder search "parse config"
+npx -p rpg-encoder rpg-encoder info
+```
+
+Or install globally:
+
+```bash
+npm install -g rpg-encoder
+rpg-encoder build
+rpg-mcp-server /path/to/project
+```
+
+## Documentation
+
+Full docs at [github.com/userFRM/rpg-encoder](https://github.com/userFRM/rpg-encoder).

package/bin/run-mcp.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+
+const ext = process.platform === "win32" ? ".exe" : "";
+const bin = path.join(__dirname, `rpg-mcp-server${ext}`);
+
+try {
+  execFileSync(bin, process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  if (err.status != null) process.exit(err.status);
+  throw err;
+}

package/bin/run.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+
+const ext = process.platform === "win32" ? ".exe" : "";
+const bin = path.join(__dirname, `rpg-encoder${ext}`);
+
+try {
+  execFileSync(bin, process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  if (err.status != null) process.exit(err.status);
+  throw err;
+}

package/install.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+
+const { execSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+
+const pkg = require("./package.json");
+const VERSION = `v${pkg.version}`;
+const REPO = "userFRM/rpg-encoder";
+const BIN_DIR = path.join(__dirname, "bin");
+
+function getTarget() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  if (platform === "darwin" && arch === "arm64") return "aarch64-apple-darwin";
+  if (platform === "darwin" && arch === "x64") return "x86_64-apple-darwin";
+  if (platform === "linux" && arch === "x64") return "x86_64-unknown-linux-gnu";
+  if (platform === "win32" && arch === "x64") return "x86_64-pc-windows-msvc";
+
+  throw new Error(
+    `Unsupported platform: ${platform}-${arch}. ` +
+      `Build from source: https://github.com/${REPO}#install`
+  );
+}
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const follow = (u) => {
+      https
+        .get(u, { headers: { "User-Agent": "rpg-encoder-npm" } }, (res) => {
+          if (
+            res.statusCode >= 300 &&
+            res.statusCode < 400 &&
+            res.headers.location
+          ) {
+            return follow(res.headers.location);
+          }
+          if (res.statusCode !== 200) {
+            return reject(new Error(`HTTP ${res.statusCode} for ${u}`));
+          }
+          const file = fs.createWriteStream(dest);
+          res.pipe(file);
+          file.on("finish", () => file.close(resolve));
+          file.on("error", reject);
+        })
+        .on("error", reject);
+    };
+    follow(url);
+  });
+}
+
+async function main() {
+  const target = getTarget();
+  const isWindows = process.platform === "win32";
+  const ext = isWindows ? "zip" : "tar.gz";
+  const archive = `rpg-encoder-${target}.${ext}`;
+  const url = `https://github.com/${REPO}/releases/download/${VERSION}/${archive}`;
+
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+
+  const tmpFile = path.join(BIN_DIR, archive);
+
+  console.log(`Downloading rpg-encoder ${VERSION} for ${target}...`);
+
+  try {
+    await download(url, tmpFile);
+
+    // Extract using system tar (available on macOS, Linux, and modern Windows)
+    if (isWindows) {
+      execSync(`tar -xf "${tmpFile}" -C "${BIN_DIR}"`, { stdio: "ignore" });
+    } else {
+      execSync(`tar -xzf "${tmpFile}" -C "${BIN_DIR}"`, { stdio: "ignore" });
+    }
+  } catch (err) {
+    console.error(`Failed to download pre-built binary: ${err.message}`);
+    console.error(`\nYou can build from source instead:`);
+    console.error(`  git clone https://github.com/${REPO}.git`);
+    console.error(`  cd rpg-encoder && cargo build --release`);
+    process.exit(1);
+  } finally {
+    // Clean up archive
+    if (fs.existsSync(tmpFile)) fs.unlinkSync(tmpFile);
+  }
+
+  // Make binaries executable
+  if (!isWindows) {
+    for (const bin of ["rpg-encoder", "rpg-mcp-server"]) {
+      const p = path.join(BIN_DIR, bin);
+      if (fs.existsSync(p)) fs.chmodSync(p, 0o755);
+    }
+  }
+
+  console.log("rpg-encoder installed successfully.");
+}
+
+main();

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "rpg-encoder",
+  "version": "0.1.0",
+  "description": "RPG-Encoder — semantic code graph for AI-assisted code understanding",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/userFRM/rpg-encoder"
+  },
+  "homepage": "https://github.com/userFRM/rpg-encoder",
+  "keywords": [
+    "mcp",
+    "code-analysis",
+    "semantic-search",
+    "llm",
+    "tree-sitter",
+    "program-graph"
+  ],
+  "bin": {
+    "rpg-encoder": "bin/run.js",
+    "rpg-mcp-server": "bin/run-mcp.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "README.md"
+  ]
+}