@orbit360.lk/bugtracker-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orbit Pvt Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+# BugTracker MCP server
+
+Gives an AI coding agent direct access to captured bug reports **and to your
+local server logs** — without your application exposing anything.
+
+This runs on your own machine. It is not deployed, not imported by the
+application under test, and not reachable from the network.
+
+```
+Chrome extension ──push──▶ bridge (127.0.0.1) ──▶ local store
+                                                     │
+your app's log files ────────read───────────────────▶│
+                                                     ▼
+                                          MCP ◀── Claude Code / Copilot / Cursor
+```
+
+---
+
+## Why this instead of an endpoint in your app
+
+The alternative is a route in your application that returns exceptions over
+HTTP. That works, but it means shipping code, a token, and a CORS allowlist into
+a project you may not want to touch.
+
+This server reads `storage/logs/laravel.log` — or any log you point it at —
+straight off the disk. No route, no token in your app, no CORS, nothing to
+review, nothing to accidentally leave enabled in production.
+
+---
+
+## Install
+
+```bash
+cd mcp-server
+npm install
+npm run build
+```
+
+## Configure
+
+Everything comes from the environment. Nothing is hardcoded, so the same binary
+serves whichever project you are working on.
+
+| Variable | Required | Purpose |
+|---|---|---|
+| `BUGTRACKER_BRIDGE_TOKEN` | **yes** | Shared secret. Generate it in the extension under **Integration → Local agent bridge**. |
+| `BUGTRACKER_LOG_PATHS` | for `find_logs` | Comma-separated files or directories the agent may read. An allowlist — nothing outside it is searchable. |
+| `BUGTRACKER_BRIDGE_PORT` | no | Loopback port. Default `4319`. |
+| `BUGTRACKER_DATA_DIR` | no | Where mirrored records are kept. Default `~/.bugtracker`. |
+
+The server refuses to start without a token rather than opening an
+unauthenticated port.
+
+## Register it with your agent
+
+**Claude Code** — `.mcp.json` in your project, or `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "bugtracker": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
+      "env": {
+        "BUGTRACKER_BRIDGE_TOKEN": "paste-the-token-here",
+        "BUGTRACKER_LOG_PATHS": "/path/to/your-app/storage/logs"
+      }
+    }
+  }
+}
+```
+
+**VS Code / Copilot** — the same block in `.vscode/mcp.json` under `servers`.
+
+**Cursor** — the same block in `~/.cursor/mcp.json`.
+
+Then in the extension: **Integration → Local agent bridge**, enable it, paste the
+same token, and press **Test connection**.
+
+---
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `list_projects` | Applications with captures, their record counts and modules. Start here. |
+| `list_bugs` | Records, newest first. Filter by project, module, status, type or free text. |
+| `get_bug` | The full AI-ready report for one record. |
+| `get_evidence` | Raw diagnostics — console, exceptions, every network request with bodies. |
+| `get_module_backlog` | Every open item in a module, ordered by priority, in one document. |
+| `find_logs` | Searches your local logs for a literal string. |
+| `find_logs_for_bug` | Takes a record id, pulls the correlation ids the browser saw, searches the logs for each. |
+| `mark_fixed` | Queues a status change the extension applies on its next sync. |
+
+`find_logs_for_bug` is the one that replaces the backend endpoint: it goes from a
+browser symptom to the server stack trace in a single call.
+
+### Try it
+
+> List the open bugs in the Orders module, then find the server logs for the
+> highest-priority one and tell me the root cause.
+
+---
+
+## What gets mirrored
+
+Record metadata, the rendered Markdown report, and the raw diagnostics.
+
+**Screenshots are not pushed** — they stay in the browser. Records are mirrored
+on save, edit and delete; use **Push all records** in the extension to backfill
+after enabling the bridge.
+
+---
+
+## Security
+
+- The bridge binds `127.0.0.1` explicitly. It is not reachable from your network.
+- Every endpoint except `/health` requires the bearer token, compared in constant time.
+- `find_logs` is confined to `BUGTRACKER_LOG_PATHS`. A path outside it is rejected,
+  including via `..` — the check resolves before comparing.
+- Files over 256 MB are skipped so a rotated log cannot hang the agent.
+- The token lives in your agent's config and the extension's settings. Treat that
+  config file the way you would an `.env`.
+
+Your captured records include URLs, request and response bodies, and console
+output from the applications you test. Redaction runs in the extension before
+anything is stored, but review **Settings → Redaction** before pointing an agent
+at production captures.
+
+---
+
+## Verify the install
+
+```bash
+node scripts/smoke.mjs
+```
+
+Starts the server on a scratch port, pushes a record through the bridge,
+exercises every tool over stdio, and checks that a path outside the allowlist is
+refused. All checks should pass.

package/dist/bridge.js

@@ -0,0 +1,112 @@
+/**
+ * Loopback ingest endpoint.
+ *
+ * The extension cannot be queried — it has no server — so it pushes instead.
+ * This binds to 127.0.0.1 only and requires a bearer token, so it is reachable
+ * from the browser on this machine and from nothing else. Nothing here is ever
+ * exposed to the application under test.
+ */
+import { createServer } from 'node:http';
+import { timingSafeEqual } from 'node:crypto';
+/** A capture with diagnostics is large; anything past this is malformed. */
+const MAX_BODY_BYTES = 32 * 1024 * 1024;
+function authorised(request, token) {
+    const header = request.headers.authorization ?? '';
+    const supplied = header.startsWith('Bearer ') ? header.slice(7) : '';
+    if (supplied.length !== token.length)
+        return false;
+    return timingSafeEqual(Buffer.from(supplied), Buffer.from(token));
+}
+function readBody(request) {
+    return new Promise((resolve, reject) => {
+        let size = 0;
+        const chunks = [];
+        request.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > MAX_BODY_BYTES) {
+                reject(new Error('Payload too large'));
+                request.destroy();
+                return;
+            }
+            chunks.push(chunk);
+        });
+        request.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        request.on('error', reject);
+    });
+}
+function json(response, status, body) {
+    const payload = JSON.stringify(body);
+    response.writeHead(status, {
+        'content-type': 'application/json',
+        'content-length': Buffer.byteLength(payload),
+    });
+    response.end(payload);
+}
+export function startBridge(options) {
+    const { port, token, store } = options;
+    const log = options.onLog ?? (() => { });
+    const server = createServer((request, response) => {
+        /*
+         * The caller is an extension service worker, so every request is
+         * cross-origin and preflighted. Reflecting the origin is safe here because
+         * the token is the actual gate and the socket only listens on loopback.
+         */
+        const origin = request.headers.origin;
+        if (origin) {
+            response.setHeader('access-control-allow-origin', origin);
+            response.setHeader('access-control-allow-headers', 'authorization, content-type');
+            response.setHeader('access-control-allow-methods', 'GET, POST, OPTIONS');
+            response.setHeader('vary', 'origin');
+        }
+        if (request.method === 'OPTIONS') {
+            response.writeHead(204);
+            response.end();
+            return;
+        }
+        const url = new URL(request.url ?? '/', 'http://127.0.0.1');
+        if (url.pathname === '/health' && request.method === 'GET') {
+            json(response, 200, { ok: true, records: store.size });
+            return;
+        }
+        if (!authorised(request, token)) {
+            json(response, 401, { error: 'Bad or missing bearer token.' });
+            return;
+        }
+        void handle(request, response, url, store, log).catch((error) => {
+            json(response, 500, { error: error instanceof Error ? error.message : 'Bridge error' });
+        });
+    });
+    return new Promise((resolve, reject) => {
+        server.once('error', reject);
+        // Explicitly loopback: the default would listen on every interface.
+        server.listen(port, '127.0.0.1', () => {
+            log(`bridge listening on http://127.0.0.1:${port}`);
+            resolve(() => new Promise((done) => {
+                server.close(() => done());
+            }));
+        });
+    });
+}
+async function handle(request, response, url, store, log) {
+    if (url.pathname === '/records' && request.method === 'POST') {
+        const body = JSON.parse(await readBody(request));
+        const records = Array.isArray(body.records) ? body.records.filter((r) => r?.id) : [];
+        const total = await store.upsert(records);
+        log(`received ${records.length} record(s), ${total} held`);
+        json(response, 200, { ok: true, received: records.length, total });
+        return;
+    }
+    if (url.pathname === '/records/delete' && request.method === 'POST') {
+        const body = JSON.parse(await readBody(request));
+        const removed = await store.remove(Array.isArray(body.ids) ? body.ids : []);
+        json(response, 200, { ok: true, removed });
+        return;
+    }
+    // The extension polls this to learn about changes an agent made.
+    if (url.pathname === '/pending' && request.method === 'GET') {
+        json(response, 200, { operations: await store.drainPending() });
+        return;
+    }
+    json(response, 404, { error: 'Unknown endpoint' });
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -0,0 +1,35 @@
+/**
+ * Configuration, entirely from the environment.
+ *
+ * Nothing here is hardcoded into a project: the token, the port and the log
+ * paths all come from the shell that launched the server, so the same binary
+ * serves whichever application the developer happens to be working on.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+function list(value) {
+    return (value ?? '')
+        .split(/[,;]/)
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+}
+export function loadConfig() {
+    const token = process.env.BUGTRACKER_BRIDGE_TOKEN?.trim() ?? '';
+    return {
+        port: Number.parseInt(process.env.BUGTRACKER_BRIDGE_PORT ?? '4319', 10) || 4319,
+        token,
+        dataDir: process.env.BUGTRACKER_DATA_DIR?.trim() || join(homedir(), '.bugtracker'),
+        logPaths: list(process.env.BUGTRACKER_LOG_PATHS),
+        projectRoots: list(process.env.BUGTRACKER_PROJECT_ROOTS),
+    };
+}
+/** Fails fast with instructions rather than starting an unauthenticated bridge. */
+export function requireToken(config) {
+    if (config.token)
+        return;
+    throw new Error('BUGTRACKER_BRIDGE_TOKEN is not set.\n\n' +
+        'Generate one in the extension under Settings → AI agent bridge, then start\n' +
+        'this server with it in the environment. Without a token the bridge would\n' +
+        'accept records from anything else running on this machine.');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAqBjC,SAAS,IAAI,CAAC,KAAyB;IACrC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SACjB,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAEhE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI;QAC/E,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC;QAClF,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAChD,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO;IACzB,MAAM,IAAI,KAAK,CACb,yCAAyC;QACvC,8EAA8E;QAC9E,4EAA4E;QAC5E,4DAA4D,CAC/D,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+/**
+ * MCP server for the AI Bug & Feature Tracker.
+ *
+ * Runs on the developer's own machine. It is not deployed, not imported by the
+ * application under test, and not reachable from the network — which is the
+ * whole point: an agent can be handed real bug reports and real server logs
+ * without the application exposing an endpoint to anybody.
+ *
+ * Two halves:
+ *   - a loopback bridge the browser extension pushes captures into
+ *   - this MCP surface, which the agent queries over stdio
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { loadConfig, requireToken } from './config.js';
+import { Store } from './store.js';
+import { startBridge } from './bridge.js';
+import { findInLogs } from './logs.js';
+const config = loadConfig();
+requireToken(config);
+const store = new Store(config.dataDir);
+/** MCP speaks over stdout, so every diagnostic has to go to stderr. */
+const log = (message) => process.stderr.write(`[bugtracker-mcp] ${message}\n`);
+function text(body) {
+    return { content: [{ type: 'text', text: body }] };
+}
+function summarise(record) {
+    const severity = record.severity ? `/${record.severity}` : '';
+    return [
+        `- **${record.title}**`,
+        `  id: \`${record.id}\` · ${record.type} · ${record.priority}${severity} · ${record.status}`,
+        `  project: ${record.projectName ?? 'Unassigned'} · module: ${record.module || '—'}`,
+        `  ${record.url}`,
+    ].join('\n');
+}
+const server = new McpServer({
+    name: 'bugtracker',
+    version: '0.1.0',
+});
+/* ------------------------------------------------------------- discovery */
+server.registerTool('list_projects', {
+    title: 'List projects',
+    description: 'Applications that have captured bug reports, with how many records and which modules each contains. Start here to find out what is available.',
+    inputSchema: {},
+}, () => {
+    const projects = store.projects();
+    if (!projects.length) {
+        return text('No records yet. The browser extension pushes them here as they are captured — ' +
+            'check that the bridge is enabled in its settings.');
+    }
+    return text(projects
+        .map((p) => `- **${p.name}** (\`${p.id}\`) — ${p.records} record(s)\n  modules: ${p.modules.join(', ') || '—'}`)
+        .join('\n'));
+});
+server.registerTool('list_bugs', {
+    title: 'List bugs and feature requests',
+    description: 'Captured records, newest first. Filter by project, module, status or type. Returns summaries — call get_bug for the full report.',
+    inputSchema: {
+        project: z.string().optional().describe('Project id or name'),
+        module: z.string().optional().describe('Module name, e.g. "Orders"'),
+        status: z.enum(['new', 'in_progress', 'done', 'archived']).optional(),
+        type: z.enum(['bug', 'feature']).optional(),
+        search: z.string().optional().describe('Free text over title, module, URL and tags'),
+        limit: z.number().int().min(1).max(100).optional().default(25),
+    },
+}, ({ project, module, status, type, search, limit }) => {
+    const found = store.list({
+        ...(project ? { project } : {}),
+        ...(module ? { module } : {}),
+        ...(status ? { status } : {}),
+        ...(type ? { type } : {}),
+        ...(search ? { search } : {}),
+    });
+    if (!found.length)
+        return text('No records matched those filters.');
+    const shown = found.slice(0, limit);
+    const more = found.length > shown.length ? `\n\n…and ${found.length - shown.length} more.` : '';
+    return text(`${found.length} record(s):\n\n${shown.map(summarise).join('\n\n')}${more}`);
+});
+/* ----------------------------------------------------------------- detail */
+server.registerTool('get_bug', {
+    title: 'Get the full report for one record',
+    description: 'The complete AI-ready report: task brief, tester narrative, environment, server exceptions, console, failed requests, and the application source files implicated by the stack traces.',
+    inputSchema: { id: z.string().describe('Record id from list_bugs') },
+}, ({ id }) => {
+    const record = store.get(id);
+    if (!record)
+        return text(`No record with id \`${id}\`. Call list_bugs to see what exists.`);
+    return text(record.markdown);
+});
+server.registerTool('get_evidence', {
+    title: 'Get raw diagnostics for one record',
+    description: 'The unformatted capture: console entries, JS exceptions, server-side exceptions, every network request with bodies, and the navigation trail. Use when the report has been summarised too far.',
+    inputSchema: { id: z.string() },
+}, ({ id }) => {
+    const record = store.get(id);
+    if (!record)
+        return text(`No record with id \`${id}\`.`);
+    if (!record.evidence)
+        return text('No raw diagnostics were pushed for this record.');
+    return text('```json\n' + JSON.stringify(record.evidence, null, 2) + '\n```');
+});
+server.registerTool('get_module_backlog', {
+    title: 'Get every open item for one module',
+    description: 'All bugs and improvements for a module in one document, ordered by priority. Use this to clear a module in a single pass rather than fixing one issue at a time.',
+    inputSchema: {
+        module: z.string().describe('Module name'),
+        project: z.string().optional(),
+        includeDone: z.boolean().optional().default(false),
+    },
+}, ({ module, project, includeDone }) => {
+    const all = store
+        .list({ module, ...(project ? { project } : {}) })
+        .filter((r) => includeDone || (r.status !== 'done' && r.status !== 'archived'));
+    if (!all.length)
+        return text(`Nothing open in module "${module}".`);
+    const rank = { critical: 0, high: 1, medium: 2, low: 3 };
+    const ordered = [...all].sort((a, b) => (rank[a.priority] ?? 9) - (rank[b.priority] ?? 9) ||
+        (a.type === b.type ? 0 : a.type === 'bug' ? -1 : 1));
+    const table = [
+        '| id | type | priority | title |',
+        '| --- | --- | --- | --- |',
+        ...ordered.map((r) => `| \`${r.id}\` | ${r.type} | ${r.priority} | ${r.title.replace(/\|/g, '\\|')} |`),
+    ];
+    return text([
+        `# Module backlog: ${module}`,
+        '',
+        `${ordered.length} open item(s). Read the whole list before changing anything —`,
+        'items in one module routinely share a root cause.',
+        '',
+        ...table,
+        '',
+        '---',
+        '',
+        ...ordered.map((r) => `${r.markdown}\n\n---\n`),
+    ].join('\n'));
+});
+/* -------------------------------------------------------------- local logs */
+server.registerTool('find_logs', {
+    title: 'Search local server logs',
+    description: 'Searches log files on this machine for a literal string — normally the correlation id from a failed request in a bug report. This reads the developer’s own disk; the application under test exposes nothing.',
+    inputSchema: {
+        query: z
+            .string()
+            .describe('Literal string to find, e.g. the request/trace id from a report'),
+        paths: z
+            .array(z.string())
+            .optional()
+            .describe('Restrict to specific files inside the configured log paths'),
+    },
+}, async ({ query, paths }) => {
+    const result = await findInLogs(query, config.logPaths, paths ?? []);
+    if (!result.matches.length) {
+        const why = result.skipped.length
+            ? `\n\nSkipped:\n${result.skipped.map((s) => `- ${s.file}: ${s.reason}`).join('\n')}`
+            : '';
+        return text(`No log lines contain "${query}".${why}\n\n` +
+            (config.logPaths.length
+                ? `Searched: ${result.filesSearched.join(', ') || 'nothing readable'}`
+                : 'Set BUGTRACKER_LOG_PATHS to the log files this server may read.'));
+    }
+    const body = result.matches
+        .map((m) => `${m.file}:${m.line}\n${m.text}`)
+        .join('\n\n');
+    return text(`${result.matches.length} matching line(s)${result.truncated ? ' (truncated)' : ''}:\n\n` +
+        '```\n' +
+        body +
+        '\n```');
+});
+server.registerTool('find_logs_for_bug', {
+    title: 'Find the server logs behind a bug',
+    description: 'Takes a record id, pulls the correlation ids the browser captured on its failed requests, and searches the local logs for each. The fastest path from a browser symptom to a server stack trace.',
+    inputSchema: { id: z.string() },
+}, async ({ id }) => {
+    const record = store.get(id);
+    if (!record)
+        return text(`No record with id \`${id}\`.`);
+    const ids = record.requestIds ?? [];
+    if (!ids.length) {
+        return text('This capture carries no correlation id, so there is nothing to search on.\n\n' +
+            'The extension reads X-Request-Id, traceparent, CF-Ray, X-Amzn-Trace-Id, ' +
+            'X-Vercel-Id and similar. If none of those reaches the browser, the server ' +
+            'is not emitting one.');
+    }
+    const sections = [];
+    for (const requestId of ids.slice(0, 5)) {
+        const result = await findInLogs(requestId, config.logPaths);
+        sections.push(result.matches.length
+            ? `## \`${requestId}\`\n\n\`\`\`\n${result.matches
+                .map((m) => `${m.file}:${m.line}\n${m.text}`)
+                .join('\n\n')}\n\`\`\``
+            : `## \`${requestId}\`\n\nNo matching log lines.`);
+    }
+    return text(sections.join('\n\n'));
+});
+/* ------------------------------------------------------------- write back */
+server.registerTool('mark_fixed', {
+    title: 'Mark a record as fixed',
+    description: 'Queues a status change for the extension to apply next time it syncs. Use once a fix is committed, so the tester sees it and does not refile it.',
+    inputSchema: {
+        id: z.string(),
+        note: z.string().optional().describe('What you changed, for the tester'),
+    },
+}, async ({ id, note }) => {
+    const record = store.get(id);
+    if (!record)
+        return text(`No record with id \`${id}\`.`);
+    await store.queue({ recordId: id, op: 'set-status', value: 'done', ...(note ? { note } : {}) });
+    return text(`Queued "${record.title}" as done. The extension applies this the next time it syncs.`);
+});
+/* ------------------------------------------------------------------- boot */
+async function main() {
+    await store.load();
+    log(`loaded ${store.size} record(s) from ${config.dataDir}`);
+    await startBridge({ port: config.port, token: config.token, store, onLog: log });
+    if (!config.logPaths.length) {
+        log('BUGTRACKER_LOG_PATHS is not set — find_logs will return nothing.');
+    }
+    await server.connect(new StdioServerTransport());
+    log('MCP server ready on stdio');
+}
+main().catch((error) => {
+    process.stderr.write(`[bugtracker-mcp] failed to start: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/logs.js

@@ -0,0 +1,130 @@
+/**
+ * Local log search.
+ *
+ * This is the reason the MCP server is worth running: it removes the need for
+ * the application to expose anything at all. Instead of asking the app for its
+ * exception over HTTP, the agent asks this process, which reads the log file
+ * off the developer's own disk.
+ *
+ * Access is restricted to paths the developer listed in the environment. An
+ * agent that asks for a request id must not be able to walk out of the project
+ * and read whatever it likes.
+ */
+import { createReadStream } from 'node:fs';
+import { stat, readdir } from 'node:fs/promises';
+import { createInterface } from 'node:readline';
+import { isAbsolute, join, resolve, sep } from 'node:path';
+/** Reading a multi-gigabyte rotated log would hang the agent. */
+const MAX_FILE_BYTES = 256 * 1024 * 1024;
+const MAX_MATCHES = 200;
+const MAX_LINE_CHARS = 4000;
+/** True when `candidate` is inside one of the allowed roots. */
+function isAllowed(candidate, roots) {
+    const target = resolve(candidate);
+    return roots.some((root) => {
+        const allowed = resolve(root);
+        return target === allowed || target.startsWith(allowed + sep);
+    });
+}
+/** Expands configured paths into concrete files, one level deep for directories. */
+async function collectFiles(paths) {
+    const files = [];
+    const skipped = [];
+    for (const path of paths) {
+        try {
+            const info = await stat(path);
+            if (info.isDirectory()) {
+                for (const entry of await readdir(path, { withFileTypes: true })) {
+                    if (!entry.isFile())
+                        continue;
+                    if (!/\.(log|txt|out)$/i.test(entry.name))
+                        continue;
+                    files.push(join(path, entry.name));
+                }
+                continue;
+            }
+            if (info.size > MAX_FILE_BYTES) {
+                skipped.push({ file: path, reason: `larger than ${MAX_FILE_BYTES / 1024 / 1024} MB` });
+                continue;
+            }
+            files.push(path);
+        }
+        catch (error) {
+            skipped.push({ file: path, reason: error instanceof Error ? error.message : 'unreadable' });
+        }
+    }
+    return { files, skipped };
+}
+async function searchFile(file, needle, matches) {
+    const stream = createReadStream(file, { encoding: 'utf8' });
+    const lines = createInterface({ input: stream, crlfDelay: Infinity });
+    let lineNumber = 0;
+    try {
+        for await (const line of lines) {
+            lineNumber++;
+            if (!line.includes(needle))
+                continue;
+            matches.push({
+                file,
+                line: lineNumber,
+                text: line.length > MAX_LINE_CHARS ? `${line.slice(0, MAX_LINE_CHARS)}…` : line,
+            });
+            if (matches.length >= MAX_MATCHES)
+                break;
+        }
+    }
+    finally {
+        lines.close();
+        stream.destroy();
+    }
+}
+/**
+ * Searches the configured logs for a literal string — normally a request id.
+ *
+ * @param extraPaths Caller-supplied paths, honoured only if they sit inside the
+ *   configured allowlist.
+ */
+export async function findInLogs(needle, configuredPaths, extraPaths = []) {
+    if (!needle.trim()) {
+        return { matches: [], filesSearched: [], skipped: [], truncated: false };
+    }
+    if (configuredPaths.length === 0) {
+        return {
+            matches: [],
+            filesSearched: [],
+            skipped: [{ file: '(none configured)', reason: 'BUGTRACKER_LOG_PATHS is not set' }],
+            truncated: false,
+        };
+    }
+    const requested = extraPaths.length ? extraPaths : configuredPaths;
+    const allowed = [];
+    const skipped = [];
+    for (const path of requested) {
+        const absolute = isAbsolute(path) ? path : resolve(path);
+        if (isAllowed(absolute, configuredPaths))
+            allowed.push(absolute);
+        else
+            skipped.push({ file: path, reason: 'outside BUGTRACKER_LOG_PATHS' });
+    }
+    const { files, skipped: unreadable } = await collectFiles(allowed);
+    const matches = [];
+    const searched = [];
+    for (const file of files) {
+        if (matches.length >= MAX_MATCHES)
+            break;
+        try {
+            await searchFile(file, needle, matches);
+            searched.push(file);
+        }
+        catch (error) {
+            unreadable.push({ file, reason: error instanceof Error ? error.message : 'read failed' });
+        }
+    }
+    return {
+        matches,
+        filesSearched: searched,
+        skipped: [...skipped, ...unreadable],
+        truncated: matches.length >= MAX_MATCHES,
+    };
+}
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"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"}

package/dist/store.js

@@ -0,0 +1,128 @@
+/**
+ * The local mirror of what the extension has captured.
+ *
+ * A JSON file rather than a database on purpose: the working set is a few
+ * hundred records, the whole thing has to survive being inspected by hand, and
+ * a native SQLite build is a poor trade for an install every developer on the
+ * team has to do.
+ */
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const EMPTY = { version: 1, records: [], pending: [] };
+export class Store {
+    dataDir;
+    data = EMPTY;
+    file;
+    /** Serialises writes so two concurrent pushes cannot interleave. */
+    writing = Promise.resolve();
+    constructor(dataDir) {
+        this.dataDir = dataDir;
+        this.file = join(dataDir, 'records.json');
+    }
+    async load() {
+        try {
+            const raw = await readFile(this.file, 'utf8');
+            const parsed = JSON.parse(raw);
+            this.data = {
+                version: 1,
+                records: Array.isArray(parsed.records) ? parsed.records : [],
+                pending: Array.isArray(parsed.pending) ? parsed.pending : [],
+            };
+        }
+        catch {
+            // Missing or corrupt: start clean rather than refusing to run.
+            this.data = { ...EMPTY, records: [], pending: [] };
+        }
+    }
+    persist() {
+        // Write to a temp file and rename, so a crash mid-write cannot truncate it.
+        this.writing = this.writing.then(async () => {
+            await mkdir(this.dataDir, { recursive: true });
+            const temp = `${this.file}.tmp`;
+            await writeFile(temp, JSON.stringify(this.data, null, 2), 'utf8');
+            await rename(temp, this.file);
+        });
+        return this.writing;
+    }
+    async upsert(records) {
+        for (const record of records) {
+            const index = this.data.records.findIndex((r) => r.id === record.id);
+            if (index >= 0)
+                this.data.records[index] = record;
+            else
+                this.data.records.push(record);
+        }
+        await this.persist();
+        return this.data.records.length;
+    }
+    async remove(ids) {
+        const before = this.data.records.length;
+        const doomed = new Set(ids);
+        this.data.records = this.data.records.filter((r) => !doomed.has(r.id));
+        this.data.pending = this.data.pending.filter((p) => !doomed.has(p.recordId));
+        await this.persist();
+        return before - this.data.records.length;
+    }
+    list(filter) {
+        const needle = filter.search?.trim().toLowerCase();
+        return this.data.records
+            .filter((r) => {
+            if (filter.project && !matchesProject(r, filter.project))
+                return false;
+            if (filter.module && r.module.toLowerCase() !== filter.module.toLowerCase())
+                return false;
+            if (filter.status && r.status !== filter.status)
+                return false;
+            if (filter.type && r.type !== filter.type)
+                return false;
+            if (needle) {
+                const hay = `${r.title} ${r.module} ${r.url} ${r.tags.join(' ')}`.toLowerCase();
+                if (!hay.includes(needle))
+                    return false;
+            }
+            return true;
+        })
+            .sort((a, b) => b.createdAt - a.createdAt);
+    }
+    get(id) {
+        return this.data.records.find((r) => r.id === id);
+    }
+    projects() {
+        const byProject = new Map();
+        for (const record of this.data.records) {
+            const key = record.projectId ?? 'unassigned';
+            const entry = byProject.get(key) ?? {
+                name: record.projectName ?? 'Unassigned',
+                records: 0,
+                modules: new Set(),
+            };
+            entry.records++;
+            if (record.module)
+                entry.modules.add(record.module);
+            byProject.set(key, entry);
+        }
+        return [...byProject.entries()]
+            .map(([id, v]) => ({ id, name: v.name, records: v.records, modules: [...v.modules].sort() }))
+            .sort((a, b) => b.records - a.records);
+    }
+    async queue(op) {
+        this.data.pending.push({ ...op, id: `${Date.now()}-${this.data.pending.length}`, queuedAt: Date.now() });
+        await this.persist();
+    }
+    /** Returns queued operations and clears them; the extension calls this once. */
+    async drainPending() {
+        const pending = this.data.pending;
+        this.data.pending = [];
+        await this.persist();
+        return pending;
+    }
+    get size() {
+        return this.data.records.length;
+    }
+}
+function matchesProject(record, query) {
+    const q = query.toLowerCase();
+    return (record.projectId?.toLowerCase() === q ||
+        (record.projectName ?? 'unassigned').toLowerCase() === q);
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@orbit360.lk/bugtracker-mcp",
+  "version": "0.1.0",
+  "description": "Local MCP server exposing captured bug reports and local server logs to an AI coding agent.",
+  "author": "Orbit Pvt Ltd <orbit.to.us@gmail.com> (https://orbit360.lk/)",
+  "license": "MIT",
+  "homepage": "https://orbit360.lk/",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "bugtracker-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "smoke": "node scripts/smoke.mjs",
+    "prepublishOnly": "npm run build && npm run smoke"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "bug-tracker",
+    "qa",
+    "ai-agent"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "typescript": "^5.9.3"
+  }
+}