common-qa-mcp 0.1.0

package/dist/vendor/logger.js

@@ -0,0 +1,174 @@
+/**
+ * Simple logger utility for Walnut Agent
+ * Logs to console AND to a file for easy review.
+ *
+ * Log file location (in order of priority):
+ *   1. WALNUT_LOG_FILE env var (absolute or relative path)
+ *   2. Default: ./logs/walnut-agent.log (relative to process.cwd())
+ *
+ * The log file is created automatically. Logs are appended on each run.
+ */
+import fs from 'fs';
+import path from 'path';
+// --- Credential redaction (module-level singleton) ---
+let _credentialValues = new Set();
+/**
+ * Register credential values that should be redacted from all log output.
+ * Call this after extracting credentials from tool calls.
+ */
+export function setCredentialValues(values) {
+    _credentialValues = values;
+}
+/** Replace any tracked credential values with ***REDACTED*** in a log line. */
+function redactCredentials(line) {
+    if (_credentialValues.size === 0)
+        return line;
+    let result = line;
+    for (const cred of _credentialValues) {
+        if (cred && cred.length > 0) {
+            const escaped = cred.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            result = result.replace(new RegExp(escaped, 'g'), '***REDACTED***');
+        }
+    }
+    return result;
+}
+// --- File logging setup (singleton) ---
+let logFilePath = null;
+let logFileReady = false;
+function ensureLogFile() {
+    if (logFileReady)
+        return logFilePath;
+    logFileReady = true;
+    try {
+        const envPath = process.env['WALNUT_LOG_FILE'];
+        logFilePath = envPath || path.join(process.cwd(), 'logs', 'walnut-agent.log');
+        // Ensure directory exists
+        const dir = path.dirname(logFilePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Write a session separator on startup
+        const separator = `\n${'='.repeat(80)}\n  Walnut Agent Log — Session started at ${new Date().toISOString()}\n${'='.repeat(80)}\n\n`;
+        fs.appendFileSync(logFilePath, separator, 'utf8');
+        return logFilePath;
+    }
+    catch {
+        // If file logging fails (e.g., permissions), fall back to console-only
+        logFilePath = null;
+        return null;
+    }
+}
+function writeToFile(line) {
+    const filePath = ensureLogFile();
+    if (!filePath)
+        return;
+    try {
+        fs.appendFileSync(filePath, line + '\n', 'utf8');
+    }
+    catch {
+        // Silently ignore file write errors — console logging still works
+    }
+}
+export function createLogger(namespace) {
+    const timestamp = () => new Date().toISOString();
+    // Format arguments for better logging
+    const formatArgs = (...args) => {
+        return args.map(arg => {
+            if (arg instanceof Error) {
+                return `${arg.message}\n${arg.stack}`;
+            }
+            if (typeof arg === 'object') {
+                try {
+                    return JSON.stringify(arg, null, 2);
+                }
+                catch (e) {
+                    return String(arg);
+                }
+            }
+            return arg;
+        });
+    };
+    const formatLine = (level, message, ...args) => {
+        const parts = [message, ...formatArgs(...args)];
+        return `[${timestamp()}] [${namespace}] ${level}: ${parts.join(' ')}`;
+    };
+    return {
+        info: (message, ...args) => {
+            const line = redactCredentials(formatLine('INFO', message, ...args));
+            console.log(line);
+            writeToFile(line);
+        },
+        error: (message, ...args) => {
+            const line = redactCredentials(formatLine('ERROR', message, ...args));
+            console.error(line);
+            writeToFile(line);
+        },
+        warn: (message, ...args) => {
+            const line = redactCredentials(formatLine('WARN', message, ...args));
+            console.warn(line);
+            writeToFile(line);
+        },
+        debug: (message, ...args) => {
+            if (process.env['DEBUG']) {
+                const line = redactCredentials(formatLine('DEBUG', message, ...args));
+                console.debug(line);
+                writeToFile(line);
+            }
+        },
+    };
+}
+/** Returns the path to the current log file (or null if file logging is disabled) */
+export function getLogFilePath() {
+    return ensureLogFile();
+}
+/**
+ * Current byte size of the log file (0 if file logging is off). Snapshot this at
+ * execution start, then pass it to readLogSince() at completion to capture exactly
+ * the verbose lines written during that execution — used to ship cloud-runner
+ * per-execution debug logs to S3 (local desktop already keeps the same file on disk).
+ */
+export function currentLogOffset() {
+    const filePath = ensureLogFile();
+    if (!filePath)
+        return 0;
+    try {
+        return fs.statSync(filePath).size;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Read the log file from `sinceOffset` to end, capped to the last `maxBytes` (keeps
+ * the tail — the most recent, most relevant lines — if the slice is huge). Returns
+ * '' when file logging is off or on any read error (best-effort — never throws).
+ */
+export function readLogSince(sinceOffset, maxBytes = 2 * 1024 * 1024) {
+    const filePath = ensureLogFile();
+    if (!filePath)
+        return '';
+    try {
+        const size = fs.statSync(filePath).size;
+        let start = Math.max(0, Math.min(sinceOffset, size));
+        let length = size - start;
+        if (length <= 0)
+            return '';
+        if (length > maxBytes) {
+            start = size - maxBytes; // keep the tail
+            length = maxBytes;
+        }
+        const fd = fs.openSync(filePath, 'r');
+        try {
+            const buf = Buffer.alloc(length);
+            fs.readSync(fd, buf, 0, length, start);
+            return buf.toString('utf8');
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/vendor/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/vendor/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AASxB,wDAAwD;AACxD,IAAI,iBAAiB,GAAgB,IAAI,GAAG,EAAE,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,iBAAiB,GAAG,MAAM,CAAC;AAC7B,CAAC;AAED,+EAA+E;AAC/E,SAAS,iBAAiB,CAAC,IAAY;IACrC,IAAI,iBAAiB,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YAC5D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yCAAyC;AACzC,IAAI,WAAW,GAAkB,IAAI,CAAC;AACtC,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,SAAS,aAAa;IACpB,IAAI,YAAY;QAAE,OAAO,WAAW,CAAC;IACrC,YAAY,GAAG,IAAI,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/C,WAAW,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;QAE9E,0BAA0B;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,uCAAuC;QACvC,MAAM,SAAS,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,6CAA6C,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC;QACpI,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAElD,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,WAAW,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,CAAC;QACH,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEjD,sCAAsC;IACtC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACpB,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;gBACzB,OAAO,GAAG,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC;YACxC,CAAC;YACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACtC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;QACpE,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAChD,OAAO,IAAI,SAAS,EAAE,MAAM,SAAS,KAAK,KAAK,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACxE,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;YACxC,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;YACzC,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpB,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;YACxC,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;YACzC,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;gBACtE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACpB,WAAW,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,cAAc;IAC5B,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC;IACxB,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI;IAC1E,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;QACxC,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;QACrD,IAAI,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;QAC1B,IAAI,MAAM,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAC3B,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;YACtB,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC,gBAAgB;YACzC,MAAM,GAAG,QAAQ,CAAC;QACpB,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACvC,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "common-qa-mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Common QA MCP — one product-neutral MCP that routes test-case lifecycle requests to Walnut or SimplifyQA for any AI client. Launch over stdio via npx; install the Walnut QA agent with `init-agents`.",
+  "bin": {
+    "common-qa-mcp": "dist/cli.js"
+  },
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "author": "Walnut Team",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.devopsark.com/walnut/common-mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "qa",
+    "testing",
+    "test-automation",
+    "test-cases",
+    "walnut",
+    "simplifyqa",
+    "ai-agent"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "start:http": "node dist/httpMain.js",
+    "dev": "tsx src/cli.ts",
+    "dev:http": "tsx watch src/httpMain.ts",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "express": "^5.1.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.4",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.19.42",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.9",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.2"
+  }
+}