@gesslar/fluffos-mcp 0.1.2 → 0.1.5

package/.github/workflows/Quality.yaml

@@ -0,0 +1,21 @@
+name: Quality
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "20 14 * * 1"
+
+jobs:
+  Quality:
+    permissions:
+      contents: read
+    uses: gesslar/Maint/.github/workflows/Quality.yaml@main
+    secrets: inherit
+    with:
+      package_manager: "auto"
+      perform_linting: "${{ vars.PERFORM_LINTING || 'yes' }}"
+      perform_testing: "${{ vars.PERFORM_TESTING || 'no' }}"

package/.github/workflows/Release.yaml

@@ -0,0 +1,16 @@
+name: Release
+
+on:
+  pull_request:
+    types: [closed]
+    branches: [main]
+
+jobs:
+  Release:
+    uses: gesslar/Maint/.github/workflows/Release.yaml@main
+    secrets: inherit
+    with:
+      package_manager: "auto"
+      quality_check: "Quality"
+    permissions:
+      contents: write

package/README.md

@@ -253,8 +253,8 @@ PRs welcome! This is a simple wrapper that can be extended with more FluffOS too
 
 ## Credits
 
-- **FluffOS Team** - For the amazing driver and CLI tools
-- [Model Context Protocol](https://modelcontextprotocol.io/) - Making this integration possible
+- [**FluffOS Team**](<https://github.com/fluffos/fluffos>) - For the amazing driver and CLI tools
+- [**Model Context Protocol**](<https://modelcontextprotocol.io/>) - Making this integration possible
 
 ## ~~License~~
 

package/eslint.config.js

@@ -1,167 +1,11 @@
-import js from "@eslint/js"
-import jsdoc from "eslint-plugin-jsdoc"
-import stylistic from "@stylistic/eslint-plugin"
-import globals from "globals"
+import uglify from "@gesslar/uglier"
 
 export default [
-  js.configs.recommended,
-  jsdoc.configs['flat/recommended'], {
-    name: "gesslar/uglier/ignores",
-    ignores: [],
-  }, {
-    name: "gesslar/uglier/languageOptions",
-    languageOptions: {
-      ecmaVersion: "latest",
-      sourceType: "module",
-      globals: {
-        ...globals.node,
-        fetch: "readonly",
-        Headers: "readonly",
-      },
-    },
-  },
-  // Add override for webview files to include browser globals
-  {
-    name: "gesslar/uglier/webview-env",
-    files: ["src/webview/**/*.{js,mjs,cjs}"],
-    languageOptions: {
-      globals: {
-        ...globals.browser,
-        acquireVsCodeApi: "readonly"
-      }
-    }
-  },
-  // Add override for .cjs files to treat as CommonJS
-  {
-    name: "gesslar/uglier/cjs-override",
-    files: ["src/**/*.cjs"],
-    languageOptions: {
-      sourceType: "script",
-      ecmaVersion: 2021
-    },
-  },
-  // Add override for .mjs files to treat as ES modules
-  {
-    name: "gesslar/uglier/mjs-override",
-    files: ["src/**/*.mjs"],
-    languageOptions: {
-      sourceType: "module",
-      ecmaVersion: 2021
-    }
-  },
-  {
-    name: "gesslar/uglier/lints-js",
-    files: ["{work,src}/**/*.{mjs,cjs,js}"],
-    plugins: {
-      "@stylistic": stylistic,
-    },
-    rules: {
-      "@stylistic/arrow-parens": ["error", "as-needed"],
-      "@stylistic/arrow-spacing": ["error", { before: true, after: true }],
-      "@stylistic/brace-style": ["error", "1tbs", {allowSingleLine: false}],
-      "@stylistic/nonblock-statement-body-position": ["error", "below"],
-      "@stylistic/padding-line-between-statements": [
-        "error",
-        {blankLine: "always",   prev: "if", next: "*"},
-        {blankLine: "always",   prev: "*", next: "return"},
-        {blankLine: "always",   prev: "while", next: "*"},
-        {blankLine: "always",   prev: "for", next: "*"},
-        {blankLine: "always",   prev: "switch", next: "*"},
-        {blankLine: "always",   prev: "do", next: "*"},
-        // {blankLine: "always",   prev: ["const", "let", "var"], next: "*"},
-        // {blankLine: "any",      prev: ["const", "let", "var"], next: ["const", "let", "var"]},
-        {blankLine: "always",   prev: "directive", next: "*" },
-        {blankLine: "any",      prev: "directive", next: "directive" },
-      ],
-      "@stylistic/eol-last": ["error", "always"],
-      "@stylistic/indent": ["error", 2, {
-        SwitchCase: 1 // Indents `case` statements one level deeper than `switch`
-      }],
-      "@stylistic/key-spacing": ["error", { beforeColon: false, afterColon: true }],
-      "@stylistic/keyword-spacing": ["error", {
-        before: false,
-        after: true,
-        overrides: {
-          // Control statements
-          return:  { before: true, after: true },
-          if:      { after: false },
-          else:    { before: true, after: true },
-          for:     { after: false },
-          while:   { before: true, after: false },
-          do:      { after: true },
-          switch:  { after: false },
-          case:    { before: true, after: true },
-          throw:   { before: true, after: false } ,
-
-          // Keywords
-          as:      { before: true, after: true },
-          of:      { before: true, after: true },
-          from:    { before: true, after: true },
-          async:   { before: true, after: true },
-          await:   { before: true, after: false },
-          class:   { before: true, after: true },
-          const:   { before: true, after: true },
-          let:     { before: true, after: true },
-          var:     { before: true, after: true },
-
-          // Exception handling
-          catch:   { before: true, after: true },
-          finally: { before: true, after: true },
-        }
-      }],
-      // Blocks
-      "@stylistic/space-before-blocks": ["error", "always"],
-      "@stylistic/max-len": ["warn", {
-        code: 80,
-        ignoreComments: true,
-        ignoreUrls: true,
-        ignoreStrings: true,
-        ignoreTemplateLiterals: true,
-        ignoreRegExpLiterals: true,
-        tabWidth: 2
-      }],
-      "@stylistic/no-tabs": "error",
-      "@stylistic/no-trailing-spaces": ["error"],
-      "@stylistic/object-curly-spacing": ["error", "never", {
-        objectsInObjects: false,
-        arraysInObjects: false
-      }],
-      "@stylistic/quotes": ["error", "double", {
-        avoidEscape: true,
-        allowTemplateLiterals: "always"
-      }],
-      "@stylistic/semi": ["error", "never"],
-      "@stylistic/space-before-function-paren": ["error", "never"],
-      "@stylistic/yield-star-spacing": ["error", { before: true, after: false }],
-      "constructor-super": "error",
-      "no-unexpected-multiline": "error",
-      "no-unused-vars": ["error", {
-        caughtErrors: "all",
-        caughtErrorsIgnorePattern: "^_+",
-        argsIgnorePattern: "^_+",
-        destructuredArrayIgnorePattern: "^_+",
-        varsIgnorePattern: "^_+"
-      }],
-      "no-useless-assignment": "error",
-      "prefer-const": "error",
-      "@stylistic/no-multiple-empty-lines": ["error", { max: 1 }],
-      "@stylistic/array-bracket-spacing": ["error", "never"],
-    }
-  },
-  {
-    name: "gesslar/uglier/lints-jsdoc",
-    files: ["{work,src}/**/*.{mjs,cjs,js}"],
-    plugins: {
-      jsdoc,
-    },
-    rules: {
-      "jsdoc/require-description": "error",
-      "jsdoc/tag-lines": ["error", "any", {"startLines":1}],
-      "jsdoc/require-jsdoc": ["error", { publicOnly: true }],
-      "jsdoc/check-tag-names": "error",
-      "jsdoc/check-types": "error",
-      "jsdoc/require-param-type": "error",
-      "jsdoc/require-returns-type": "error"
-    }
-  }
+  ...uglify({
+    with: [
+      "lints-js", // default files: ["**/*.{js,mjs,cjs}"]
+      "lints-jsdoc", // default files: ["**/*.{js,mjs,cjs}"]
+      "node", // default files: ["**/*.{js,mjs,cjs}"]
+    ]
+  })
 ]

package/package.json

@@ -1,22 +1,16 @@
 {
   "name": "@gesslar/fluffos-mcp",
-  "version": "0.1.2",
   "description": "MCP server for FluffOS driver tools - validate and disassemble LPC code",
-  "main": "src/index.js",
-  "type": "module",
-  "bin": {
-    "fluffos-mcp": "./src/index.js"
+  "author": {
+    "name": "gesslar",
+    "url": "https://gesslar.dev"
   },
-  "scripts": {
-    "start": "node src/index.js",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "submit": "npm publish --access public",
-    "update": "npx npm-check-updates -u && npm install",
-    "pr": "gt submit --publish --restack --ai -m",
-    "patch": "npm version patch",
-    "minor": "npm version minor",
-    "major": "npm version major"
+  "version": "0.1.5",
+  "license": "Unlicense",
+  "homepage": "https://github.com/gesslar/fluffos-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gesslar/fluffos-mcp.git"
   },
   "keywords": [
     "fluffos",
@@ -29,19 +23,30 @@
     "white",
     "cheddar"
   ],
-  "author": "gesslar",
-  "license": "Unlicense",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/gesslar/fluffos-mcp.git"
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "src/index.js",
+  "type": "module",
+  "bin": {
+    "fluffos-mcp": "./src/index.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.20.2"
+    "@modelcontextprotocol/sdk": "^1.25.1"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.0",
-    "@stylistic/eslint-plugin": "^5.5.0",
-    "eslint-plugin-jsdoc": "^61.1.11",
-    "globals": "^16.5.0"
+    "@gesslar/uglier": "^0.5.1",
+    "eslint": "^9.39.2"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "submit": "pnpm publish --access public --//registry.npmjs.org/:_authToken=\"${NPM_ACCESS_TOKEN}\"",
+    "update": "pnpm up --latest --recursive",
+    "pr": "gt submit -p --ai",
+    "patch": "pnpm version patch",
+    "minor": "pnpm version minor",
+    "major": "pnpm version major"
   }
-}
+}

package/.github/workflows/ci.yml

@@ -1,33 +0,0 @@
-name: Giddyup
-permissions:
-  contents: read
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  cowyboysounds:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [20.x, 22.x]
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run ESLint
-        run: npm run lint

package/index.js

@@ -1,306 +0,0 @@
-#!/usr/bin/env node
-
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} from "@modelcontextprotocol/sdk/types.js";
-import { spawn } from "child_process";
-import path from "path";
-import fs from "fs";
-
-class FluffOSMCPServer {
-  constructor() {
-    this.server = new Server(
-      {
-        name: "fluffos-mcp-server",
-        version: "0.1.0",
-      },
-      {
-        capabilities: {
-          tools: {},
-        },
-      }
-    );
-
-    this.binDir = process.env.FLUFFOS_BIN_DIR;
-    this.configFile = process.env.MUD_RUNTIME_CONFIG_FILE;
-    this.docsDir = process.env.FLUFFOS_DOCS_DIR;
-
-    if (!this.binDir) {
-      console.error("Error: FLUFFOS_BIN_DIR environment variable not set");
-      process.exit(1);
-    }
-
-    if (!this.configFile) {
-      console.error("Error: MUD_RUNTIME_CONFIG_FILE environment variable not set");
-      process.exit(1);
-    }
-
-    // Parse mudlib directory from config file
-    this.mudlibDir = this.parseMudlibDir();
-
-    console.error(`FluffOS bin directory: ${this.binDir}`);
-    console.error(`FluffOS config file: ${this.configFile}`);
-    console.error(`Mudlib directory: ${this.mudlibDir || "(not found in config)"}`);
-    
-    if (this.docsDir) {
-      console.error(`FluffOS docs directory: ${this.docsDir}`);
-    } else {
-      console.error(`FluffOS docs directory: not set (doc lookup disabled)`);
-    }
-
-    this.setupHandlers();
-  }
-
-  parseMudlibDir() {
-    try {
-      const configContent = fs.readFileSync(this.configFile, "utf8");
-      const match = configContent.match(/^mudlib directory\s*:\s*(.+)$/m);
-      if (match) {
-        return match[1].trim();
-      }
-    } catch (err) {
-      console.error(`Warning: Could not parse mudlib directory from config: ${err.message}`);
-    }
-    return null;
-  }
-
-  normalizePath(lpcFile) {
-    // If we have a mudlib directory and the file path is absolute and starts with mudlib dir,
-    // convert it to a relative path
-    if (this.mudlibDir && path.isAbsolute(lpcFile) && lpcFile.startsWith(this.mudlibDir)) {
-      // Remove mudlib directory prefix and leading slash
-      return lpcFile.substring(this.mudlibDir.length).replace(/^\/+/, "");
-    }
-    // Otherwise return as-is (already relative or not under mudlib)
-    return lpcFile;
-  }
-
-  setupHandlers() {
-    this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
-      tools: [
-        {
-          name: "fluffos_validate",
-          description:
-            "Validate an LPC file using the FluffOS driver's symbol tool. Compiles the file and reports success or failure with any compilation errors. Fast and lightweight check for code validity.",
-          inputSchema: {
-            type: "object",
-            properties: {
-              file: {
-                type: "string",
-                description: "Absolute path to the LPC file to validate",
-              },
-            },
-            required: ["file"],
-          },
-        },
-        {
-          name: "fluffos_disassemble",
-          description:
-            "Disassemble an LPC file to show compiled bytecode using lpcc. Returns detailed bytecode, function tables, strings, and disassembly. Useful for debugging and understanding how code compiles.",
-          inputSchema: {
-            type: "object",
-            properties: {
-              file: {
-                type: "string",
-                description: "Absolute path to the LPC file to disassemble",
-              },
-            },
-            required: ["file"],
-          },
-        },
-        ...(this.docsDir ? [{
-          name: "fluffos_doc_lookup",
-          description:
-            "Search FluffOS documentation for information about efuns, applies, concepts, etc. Searches markdown documentation files.",
-          inputSchema: {
-            type: "object",
-            properties: {
-              query: {
-                type: "string",
-                description: "Term to search for in documentation (e.g., 'call_out', 'mapping', 'socket')",
-              },
-            },
-            required: ["query"],
-          },
-        }] : []),
-      ],
-    }));
-
-    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-      const { name, arguments: args } = request.params;
-
-      try {
-        switch (name) {
-          case "fluffos_validate": {
-            const result = await this.runSymbol(args.file);
-            return {
-              content: [
-                {
-                  type: "text",
-                  text: result,
-                },
-              ],
-            };
-          }
-
-          case "fluffos_disassemble": {
-            const result = await this.runLpcc(args.file);
-            return {
-              content: [
-                {
-                  type: "text",
-                  text: result,
-                },
-              ],
-            };
-          }
-
-          case "fluffos_doc_lookup": {
-            if (!this.docsDir) {
-              throw new Error("Documentation lookup is not available (FLUFFOS_DOCS_DIR not set)");
-            }
-            const result = await this.searchDocs(args.query);
-            return {
-              content: [
-                {
-                  type: "text",
-                  text: result,
-                },
-              ],
-            };
-          }
-
-          default:
-            throw new Error(`Unknown tool: ${name}`);
-        }
-      } catch (error) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error: ${error.message}`,
-            },
-          ],
-          isError: true,
-        };
-      }
-    });
-  }
-
-  async runSymbol(lpcFile) {
-    return new Promise((resolve, reject) => {
-      const normalizedPath = this.normalizePath(lpcFile);
-      const symbolPath = path.join(this.binDir, "symbol");
-      const proc = spawn(symbolPath, [this.configFile, normalizedPath], {
-        cwd: path.dirname(this.configFile),
-      });
-
-      let stdout = "";
-      let stderr = "";
-
-      proc.stdout.on("data", (data) => {
-        stdout += data.toString();
-      });
-
-      proc.stderr.on("data", (data) => {
-        stderr += data.toString();
-      });
-
-      proc.on("close", (code) => {
-        const output = (stdout + stderr).trim();
-        
-        if (code === 0) {
-          resolve(`✓ File validated successfully\n\n${output}`);
-        } else {
-          resolve(`✗ Validation failed (exit code: ${code})\n\n${output}`);
-        }
-      });
-
-      proc.on("error", (err) => {
-        reject(new Error(`Failed to run symbol: ${err.message}`));
-      });
-    });
-  }
-
-  async runLpcc(lpcFile) {
-    return new Promise((resolve, reject) => {
-      const normalizedPath = this.normalizePath(lpcFile);
-      const lpccPath = path.join(this.binDir, "lpcc");
-      const proc = spawn(lpccPath, [this.configFile, normalizedPath], {
-        cwd: path.dirname(this.configFile),
-      });
-
-      let stdout = "";
-      let stderr = "";
-
-      proc.stdout.on("data", (data) => {
-        stdout += data.toString();
-      });
-
-      proc.stderr.on("data", (data) => {
-        stderr += data.toString();
-      });
-
-      proc.on("close", (code) => {
-        const output = (stdout + stderr).trim();
-        
-        if (code === 0) {
-          resolve(output);
-        } else {
-          resolve(`Error (exit code: ${code}):\n\n${output}`);
-        }
-      });
-
-      proc.on("error", (err) => {
-        reject(new Error(`Failed to run lpcc: ${err.message}`));
-      });
-    });
-  }
-
-  async searchDocs(query) {
-    return new Promise((resolve, reject) => {
-      const scriptPath = path.join(path.dirname(new URL(import.meta.url).pathname), "scripts", "search_docs.sh");
-      const proc = spawn(scriptPath, [this.docsDir, query]);
-
-      let stdout = "";
-      let stderr = "";
-
-      proc.stdout.on("data", (data) => {
-        stdout += data.toString();
-      });
-
-      proc.stderr.on("data", (data) => {
-        stderr += data.toString();
-      });
-
-      proc.on("close", (code) => {
-        if (code === 0) {
-          if (stdout.trim()) {
-            resolve(`Found documentation for "${query}":\n\n${stdout}`);
-          } else {
-            resolve(`No documentation found for "${query}".`);
-          }
-        } else {
-          resolve(`Error searching documentation:\n${stderr || stdout}`);
-        }
-      });
-
-      proc.on("error", (err) => {
-        reject(new Error(`Failed to search docs: ${err.message}`));
-      });
-    });
-  }
-
-  async run() {
-    const transport = new StdioServerTransport();
-    await this.server.connect(transport);
-
-    console.error("FluffOS MCP Server running on stdio");
-  }
-}
-
-const server = new FluffOSMCPServer();
-server.run().catch(console.error);