matterbridge-lg-thinq-plugin 0.1.0

package/.claude/tools/read-log-server.cjs

@@ -0,0 +1,175 @@
+'use strict';
+
+// MCP stdio server — streams a (possibly huge) log file and returns only the
+// lines matching a keyword, capped. Avoids Read/Grep loading entire logs
+// (some run 100k+ lines) into context. Node built-ins only; no npm deps.
+
+const fs = require('fs');
+const readline = require('readline');
+
+const DEFAULT_MAX_LINES = 50;
+
+// ---------------------------------------------------------------------------
+// Transport helpers
+// ---------------------------------------------------------------------------
+
+function send(obj) {
+  process.stdout.write(JSON.stringify(obj) + '\n');
+}
+
+function sendResult(id, content) {
+  send({
+    jsonrpc: '2.0',
+    id,
+    result: {
+      content: [{ type: 'text', text: content }],
+    },
+  });
+}
+
+function sendError(id, code, message) {
+  send({
+    jsonrpc: '2.0',
+    id,
+    error: { code, message },
+  });
+}
+
+// ---------------------------------------------------------------------------
+// ReadLog tool implementation
+// ---------------------------------------------------------------------------
+
+async function readLog({ filePath, keyword, maxLines }) {
+  if (!filePath) {
+    return 'Error: "filePath" is required.';
+  }
+  if (!keyword) {
+    return 'Error: "keyword" is required.';
+  }
+  if (!fs.existsSync(filePath)) {
+    return `Error: file not found: ${filePath}`;
+  }
+
+  const cap = Number.isFinite(maxLines) && maxLines > 0 ? Math.floor(maxLines) : DEFAULT_MAX_LINES;
+
+  let pattern;
+  try {
+    pattern = new RegExp(keyword, 'i');
+  } catch (err) {
+    return `Error: invalid keyword regex: ${err.message}`;
+  }
+
+  const matches = [];
+  let total = 0;
+
+  await new Promise((resolve, reject) => {
+    const rl = readline.createInterface({
+      input: fs.createReadStream(filePath, { encoding: 'utf8' }),
+      crlfDelay: Infinity,
+    });
+    rl.on('line', (line) => {
+      if (pattern.test(line)) {
+        total += 1;
+        matches.push(line);
+        if (matches.length > cap) {
+          matches.shift();
+        }
+      }
+    });
+    rl.on('close', resolve);
+    rl.on('error', reject);
+  });
+
+  const header = `MATCHES: ${total} (showing last ${matches.length})`;
+  if (matches.length === 0) {
+    return header;
+  }
+  return `${header}\n${matches.join('\n')}`;
+}
+
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+
+const TOOL_DEFINITIONS = [
+  {
+    name: 'ReadLog',
+    description:
+      'Filter a log file by keyword without loading the whole file into context (some logs run 100k+ lines). Streams the file and returns only matching lines, capped to maxLines (default 50, showing the most recent matches). Only use when the user has provided the log file path AND confirmed the keyword for that specific request — log files only, never source code.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        filePath: { type: 'string', description: 'Path to the log file to search' },
+        keyword: { type: 'string', description: 'Case-insensitive keyword or regex to match against each line' },
+        maxLines: { type: 'number', description: 'Max matching lines to return (default 50, most recent first)' },
+      },
+      required: ['filePath', 'keyword'],
+    },
+  },
+];
+
+// ---------------------------------------------------------------------------
+// Request dispatcher
+// ---------------------------------------------------------------------------
+
+function handleRequest(req) {
+  const { id, method, params } = req;
+
+  // Notifications (no id) — no response
+  if (id === undefined || id === null) {
+    return;
+  }
+
+  if (method === 'initialize') {
+    send({
+      jsonrpc: '2.0',
+      id,
+      result: {
+        protocolVersion: '2024-11-05',
+        serverInfo: { name: 'read-log-server', version: '1.0.0' },
+        capabilities: { tools: {} },
+      },
+    });
+    return;
+  }
+
+  if (method === 'tools/list') {
+    send({
+      jsonrpc: '2.0',
+      id,
+      result: { tools: TOOL_DEFINITIONS },
+    });
+    return;
+  }
+
+  if (method === 'tools/call') {
+    const { name, arguments: args } = params || {};
+    if (name !== 'ReadLog') {
+      sendError(id, -32601, `Unknown tool: ${name}`);
+      return;
+    }
+    readLog(args || {})
+      .then((text) => sendResult(id, text))
+      .catch((err) => sendResult(id, `Error: ${err.message}`));
+    return;
+  }
+
+  sendError(id, -32601, `Method not found: ${method}`);
+}
+
+// ---------------------------------------------------------------------------
+// Main — read newline-delimited JSON from stdin
+// ---------------------------------------------------------------------------
+
+const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
+
+rl.on('line', (line) => {
+  const trimmed = line.trim();
+  if (!trimmed) return;
+  try {
+    const req = JSON.parse(trimmed);
+    handleRequest(req);
+  } catch (_) {
+    // Malformed JSON — ignore
+  }
+});

package/.github/codeql/codeql-config.yml

@@ -0,0 +1,14 @@
+name: CodeQL Config
+
+paths-ignore:
+  - '**/*.md'
+  - '**/*.json'
+  - '**/*.yml'
+  - '**/*.yaml'
+  - 'src/test/**'
+  - 'dist/**'
+  - 'node_modules/**'
+  - 'coverage/**'
+  - '**/*.spec.ts'
+  - '**/*.test.ts'
+  - 'web-for-testing/**'

package/.github/workflows/build.yml

@@ -0,0 +1,54 @@
+name: Build, lint and test
+
+permissions:
+  contents: read
+  pull-requests: read
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    types: [opened, synchronize, reopened, edited]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  vitest:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: [24.x, 25.x]
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          registry-url: 'https://registry.npmjs.org/'
+
+      - name: Clean cache
+        run: npm cache clean --force
+
+      - name: Verify Node.js and Npm versions
+        run: node -v && npm -v
+
+      - name: Install dependencies
+        run: npm ci && npm run precondition && npm run deepClean && npm install && npm link matterbridge
+
+      - name: Lint the project
+        run: npm run lint
+
+      - name: Test the project
+        run: npm run test
+
+      - name: Build (optional)
+        run: npm run build

package/.github/workflows/codeql.yml

@@ -0,0 +1,59 @@
+name: CodeQL Analysis
+
+permissions:
+  contents: read
+  security-events: write
+  actions: read
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: '0 4 * * 1'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  analyze:
+    name: Analyze (javascript-typescript)
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v4
+        with:
+          languages: javascript-typescript
+          queries: security-extended
+          config-file: .github/codeql/codeql-config.yml
+
+      - name: Setup Node (LTS)
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Pre build steps
+        run: |
+          npm run precondition
+          npm run deepClean
+          npm link matterbridge
+
+      - name: Build
+        run: npm run build
+
+      - name: Analyze
+        uses: github/codeql-action/analyze@v4
+        with:
+          category: '/language:javascript-typescript'

package/.github/workflows/coverage.yml

@@ -0,0 +1,70 @@
+name: Analyze code coverage
+
+permissions:
+  contents: read
+  pull-requests: read
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    types: [opened, synchronize, reopened, edited]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          registry-url: 'https://registry.npmjs.org/'
+
+      - name: Clean cache
+        run: npm cache clean --force
+
+      - name: Verify Node.js version
+        run: node -v
+
+      - name: Verify Npm version
+        run: npm -v
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install dependencies
+        run: npm run precondition && npm run deepClean && npm install && npm link matterbridge
+
+      - name: Lint the project
+        run: npm run lint
+
+      - name: Test the project
+        run: npm run test:report
+
+      - name: Upload test results to Codecov
+        if: ${{ !cancelled() }}
+        uses: codecov/codecov-action@v5
+        with:
+          report_type: test_results
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+      - name: Test with coverage
+        run: npm run test -- --coverage
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: RinDevJunior/matterbridge-lg-thinq-plugin
+
+      - name: Build (optional)
+        run: npm run build

package/.github/workflows/publish.yml

@@ -0,0 +1,103 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [created]
+
+concurrency:
+  group: npm-publish
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+  id-token: write # needed for npm trusted publishing (OIDC)
+  actions: read
+
+jobs:
+  publish-release:
+    name: Publish release to npm
+    if: github.event.release.prerelease == false
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          ref: main
+
+      - name: Setup Node.js 24.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          cache: npm
+
+      - name: Verify Node.js version
+        run: node -v
+
+      - name: Verify Npm version
+        run: npm -v
+
+      - name: Clone matterbridge repo branch main
+        run: npm run precondition
+
+      - name: Install plugin dependencies
+        run: npm ci --no-fund --no-audit
+
+      - name: Link matterbridge in the project
+        run: npm link matterbridge --no-fund --no-audit
+
+      - name: Build the plugin
+        run: npm run build
+
+      - name: Lint the plugin
+        run: npm run lint
+
+      - name: Test the plugin
+        run: npm run test
+
+      - name: Publish to npm with trusted publishing / OIDC
+        run: npm publish --provenance --access public --tag latest
+
+  publish-release-candidate:
+    name: Publish release candidate to npm
+    if: github.event.release.prerelease == true
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.tag_name }}
+
+      - name: Setup Node.js 24.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          cache: npm
+
+      - name: Verify Node.js version
+        run: node -v
+
+      - name: Verify Npm version
+        run: npm -v
+
+      - name: Install matterbridge
+        run: npm run precondition
+
+      - name: Install plugin dependencies
+        run: npm ci --no-fund --no-audit
+
+      - name: Link matterbridge in the project
+        run: npm link matterbridge --no-fund --no-audit
+
+      - name: Build the plugin
+        run: npm run build
+
+      - name: Lint the plugin
+        run: npm run lint
+
+      - name: Test the plugin
+        run: npm run test
+
+      - name: Publish to npm with trusted publishing / OIDC
+        run: npm publish --provenance --access public --tag dev

package/.mcp.json

@@ -0,0 +1,34 @@
+{
+	"mcpServers": {
+		"codegraph": {
+			"type": "stdio",
+			"command": "codegraph",
+			"args": ["serve", "--mcp"]
+		},
+		"glob-grep": {
+			"type": "stdio",
+			"command": "node",
+			"args": [".claude/tools/glob-grep-server.cjs"]
+		},
+		"cli-runner": {
+			"type": "stdio",
+			"command": "node",
+			"args": [".claude/tools/cli-runner-server.cjs"]
+		},
+		"read-log": {
+			"type": "stdio",
+			"command": "node",
+			"args": [".claude/tools/read-log-server.cjs"]
+		},
+		"discord-send": {
+			"type": "stdio",
+			"command": "node",
+			"args": [".claude/tools/discord-send-server.cjs"]
+		},
+		"github-release": {
+			"type": "stdio",
+			"command": "node",
+			"args": [".claude/tools/github-release-server.cjs"]
+		}
+	}
+}