localwp-mcp 0.1.0

package/dist/logs.d.ts

@@ -0,0 +1,144 @@
+import type { LogScope, SiteSelection } from "./types.js";
+export declare function clampLogLines(lines: number | undefined): number;
+export declare function collectLocalLogs(selection: SiteSelection, options?: {
+    scope?: LogScope;
+    lines?: number;
+}): Promise<{
+    scope: LogScope;
+    requestedLines: number;
+    site: {
+        id: string;
+        name: string;
+        status: string;
+        domain: string | undefined;
+        path: string;
+        wpRoot: string;
+        localVersion: string | undefined;
+        phpVersion: string | null;
+        mysqlVersion: string | null;
+        httpPort: number | null;
+        mysqlPort: number | null;
+    } | null;
+    siteLogs: ({
+        readable: boolean;
+        excerpt: null;
+        excerptLineCount: number;
+        truncatedExcerpt: boolean;
+        sizeBytes: null;
+        modifiedAt: null;
+        key: string;
+        label: string;
+        path: string;
+        source: "site" | "global";
+        format: "text" | "csv";
+    } | {
+        readable: boolean;
+        excerpt: string | null;
+        excerptLineCount: number;
+        truncatedExcerpt: boolean;
+        sizeBytes: number;
+        modifiedAt: string;
+        key: string;
+        label: string;
+        path: string;
+        source: "site" | "global";
+        format: "text" | "csv";
+    })[];
+    globalLogs: ({
+        readable: boolean;
+        excerpt: null;
+        excerptLineCount: number;
+        truncatedExcerpt: boolean;
+        sizeBytes: null;
+        modifiedAt: null;
+        key: string;
+        label: string;
+        path: string;
+        source: "site" | "global";
+        format: "text" | "csv";
+    } | {
+        readable: boolean;
+        excerpt: string | null;
+        excerptLineCount: number;
+        truncatedExcerpt: boolean;
+        sizeBytes: number;
+        modifiedAt: string;
+        key: string;
+        label: string;
+        path: string;
+        source: "site" | "global";
+        format: "text" | "csv";
+    })[];
+}>;
+export declare function summarizeLogAvailability(selection?: SiteSelection): Promise<{
+    site: {
+        id: string;
+        name: string;
+        status: string;
+        domain: string | undefined;
+        path: string;
+        wpRoot: string;
+        localVersion: string | undefined;
+        phpVersion: string | null;
+        mysqlVersion: string | null;
+        httpPort: number | null;
+        mysqlPort: number | null;
+    } | null;
+    siteLogs: ({
+        readable: boolean;
+        excerpt: null;
+        excerptLineCount: number;
+        truncatedExcerpt: boolean;
+        sizeBytes: null;
+        modifiedAt: null;
+        key: string;
+        label: string;
+        path: string;
+        source: "site" | "global";
+        format: "text" | "csv";
+    } | {
+        readable: boolean;
+        excerpt: string | null;
+        excerptLineCount: number;
+        truncatedExcerpt: boolean;
+        sizeBytes: number;
+        modifiedAt: string;
+        key: string;
+        label: string;
+        path: string;
+        source: "site" | "global";
+        format: "text" | "csv";
+    })[];
+    globalLogs: ({
+        readable: boolean;
+        excerpt: null;
+        excerptLineCount: number;
+        truncatedExcerpt: boolean;
+        sizeBytes: null;
+        modifiedAt: null;
+        key: string;
+        label: string;
+        path: string;
+        source: "site" | "global";
+        format: "text" | "csv";
+    } | {
+        readable: boolean;
+        excerpt: string | null;
+        excerptLineCount: number;
+        truncatedExcerpt: boolean;
+        sizeBytes: number;
+        modifiedAt: string;
+        key: string;
+        label: string;
+        path: string;
+        source: "site" | "global";
+        format: "text" | "csv";
+    })[];
+}>;
+export declare function readLastLines(filePath: string, lineCount: number): Promise<{
+    excerpt: string;
+    excerptLineCount: number;
+    truncated: boolean;
+    sizeBytes: number;
+    modifiedAt: string;
+}>;

package/dist/logs.js

@@ -0,0 +1,208 @@
+import { open, readdir, stat } from "fs/promises";
+import path from "path";
+import { config } from "./config.js";
+import { buildSiteContext, summarizeSite } from "./local-sites.js";
+import { isReadablePath } from "./process-utils.js";
+const MAX_TAIL_BYTES = 256 * 1024;
+const globalLogPattern = /^local-(?:lightning(?:-verbose)?|by-flywheel)\d*\.log$/i;
+export function clampLogLines(lines) {
+    if (!lines) {
+        return config.defaultLogTailLines;
+    }
+    return Math.min(Math.max(lines, 1), config.maxLogTailLines);
+}
+export async function collectLocalLogs(selection, options = {}) {
+    const scope = options.scope || "site";
+    const lines = clampLogLines(options.lines);
+    const includeSite = scope === "site" || scope === "all";
+    const includeGlobal = scope === "global" || scope === "all";
+    const context = includeSite ? await buildSiteContext(selection) : null;
+    const siteLogs = context
+        ? await describeLogFiles(buildSiteLogCandidates(context), lines, true)
+        : [];
+    const globalLogs = includeGlobal
+        ? await describeLogFiles(await buildGlobalLogCandidates(), lines, true)
+        : [];
+    return {
+        scope,
+        requestedLines: lines,
+        site: context ? summarizeSite(context.site) : null,
+        siteLogs,
+        globalLogs,
+    };
+}
+export async function summarizeLogAvailability(selection = {}) {
+    let context = null;
+    try {
+        context = await buildSiteContext(selection);
+    }
+    catch {
+        context = null;
+    }
+    const [siteLogs, globalLogs] = await Promise.all([
+        context
+            ? describeLogFiles(buildSiteLogCandidates(context), 0, false)
+            : Promise.resolve([]),
+        describeLogFiles(await buildGlobalLogCandidates(), 0, false),
+    ]);
+    return {
+        site: context ? summarizeSite(context.site) : null,
+        siteLogs,
+        globalLogs,
+    };
+}
+export async function readLastLines(filePath, lineCount) {
+    const handle = await open(filePath, "r");
+    try {
+        const fileStats = await stat(filePath);
+        const bytesToRead = Math.min(fileStats.size, MAX_TAIL_BYTES);
+        const start = Math.max(0, fileStats.size - bytesToRead);
+        const buffer = Buffer.alloc(bytesToRead);
+        if (bytesToRead > 0) {
+            await handle.read(buffer, 0, bytesToRead, start);
+        }
+        const raw = buffer.toString("utf8");
+        const lines = raw.split(/\r?\n/);
+        if (start > 0 && lines.length > 0) {
+            lines.shift();
+        }
+        if (lines[lines.length - 1] === "") {
+            lines.pop();
+        }
+        const excerptLines = lineCount > 0 ? lines.slice(-lineCount) : [];
+        return {
+            excerpt: excerptLines.join("\n"),
+            excerptLineCount: excerptLines.length,
+            truncated: fileStats.size > bytesToRead || lines.length > lineCount,
+            sizeBytes: fileStats.size,
+            modifiedAt: fileStats.mtime.toISOString(),
+        };
+    }
+    finally {
+        await handle.close();
+    }
+}
+function buildSiteLogCandidates(context) {
+    return [
+        {
+            key: "wp_debug_log",
+            label: "WordPress Debug Log",
+            path: path.join(context.wpRoot, "wp-content", "debug.log"),
+            source: "site",
+            format: "text",
+        },
+        {
+            key: "php_error_log",
+            label: "PHP Error Log",
+            path: path.join(context.site.absolutePath, "logs", "php", "error.log"),
+            source: "site",
+            format: "text",
+        },
+        {
+            key: "php_fpm_log",
+            label: "PHP-FPM Log",
+            path: path.join(context.site.absolutePath, "logs", "php", "php-fpm.log"),
+            source: "site",
+            format: "text",
+        },
+        {
+            key: "nginx_error_log",
+            label: "Site Nginx Error Log",
+            path: path.join(context.site.absolutePath, "logs", "nginx", "error.log"),
+            source: "site",
+            format: "text",
+        },
+        {
+            key: "runtime_nginx_error_log",
+            label: "Runtime Nginx Error Log",
+            path: path.join(context.runtimeDir, "nginx", "logs", "error.log"),
+            source: "site",
+            format: "text",
+        },
+        {
+            key: "mysql_general_log",
+            label: "MySQL General Log",
+            path: path.join(context.runtimeDir, "mysql", "data", "mysql", "general_log.CSV"),
+            source: "site",
+            format: "csv",
+        },
+        {
+            key: "mysql_slow_log",
+            label: "MySQL Slow Log",
+            path: path.join(context.runtimeDir, "mysql", "data", "mysql", "slow_log.CSV"),
+            source: "site",
+            format: "csv",
+        },
+    ];
+}
+async function buildGlobalLogCandidates() {
+    const logDirectory = getGlobalLogDirectory();
+    if (!(await isReadablePath(logDirectory))) {
+        return [
+            {
+                key: "local_log_directory",
+                label: "Local Global Log Directory",
+                path: logDirectory,
+                source: "global",
+                format: "text",
+            },
+        ];
+    }
+    const entries = await readdir(logDirectory, { withFileTypes: true });
+    const logFiles = entries
+        .filter((entry) => entry.isFile() && globalLogPattern.test(entry.name))
+        .map((entry) => entry.name)
+        .sort((left, right) => right.localeCompare(left));
+    return logFiles.map((fileName) => ({
+        key: `global_${fileName.replace(/[^a-z0-9]+/gi, "_").toLowerCase()}`,
+        label: `Local App Log: ${fileName}`,
+        path: path.join(logDirectory, fileName),
+        source: "global",
+        format: "text",
+    }));
+}
+async function describeLogFiles(candidates, lines, includeContent) {
+    return Promise.all(candidates.map(async (candidate) => {
+        const readable = await isReadablePath(candidate.path);
+        if (!readable) {
+            return {
+                ...candidate,
+                readable: false,
+                excerpt: null,
+                excerptLineCount: 0,
+                truncatedExcerpt: false,
+                sizeBytes: null,
+                modifiedAt: null,
+            };
+        }
+        const summary = includeContent && lines > 0
+            ? await readLastLines(candidate.path, lines)
+            : await describeFile(candidate.path);
+        return {
+            ...candidate,
+            readable: true,
+            excerpt: includeContent && lines > 0 ? summary.excerpt : null,
+            excerptLineCount: summary.excerptLineCount,
+            truncatedExcerpt: summary.truncated,
+            sizeBytes: summary.sizeBytes,
+            modifiedAt: summary.modifiedAt,
+        };
+    }));
+}
+async function describeFile(filePath) {
+    const fileStats = await stat(filePath);
+    return {
+        excerpt: "",
+        excerptLineCount: 0,
+        truncated: false,
+        sizeBytes: fileStats.size,
+        modifiedAt: fileStats.mtime.toISOString(),
+    };
+}
+function getGlobalLogDirectory() {
+    if (config.platform === "darwin") {
+        return path.join(config.homeDir, "Library", "Logs");
+    }
+    return config.localAppSupportDir;
+}
+//# 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/mysql.d.ts

@@ -0,0 +1,17 @@
+import type { SiteContext } from "./types.js";
+export declare function ensureMysqlReady(context: SiteContext): Promise<void>;
+export declare function executeMysqlStatement(context: SiteContext, sql: string, maxRows: number): Promise<{
+    columns: string[];
+    rows: Record<string, unknown>[];
+    totalRows: number;
+    returnedRows: number;
+    truncated: boolean;
+    stderr: string | null;
+}>;
+export declare function validateSafeSqlQuery(sql: string): string;
+export declare function validateFullAccessSql(sql: string): string;
+export declare function normalizeSqlStatement(sql: string): string;
+export declare function getSqlVerb(sql: string): string;
+export declare function buildListTablesSql(databaseName: string): string;
+export declare function buildDescribeTableSql(databaseName: string, tableName: string): string;
+export declare function clampMaxRows(maxRows: number | undefined): number;

package/dist/mysql.js

@@ -0,0 +1,229 @@
+import { config } from "./config.js";
+import { assertReadable, spawnCommand } from "./process-utils.js";
+const mysqlReadOnlyVerbs = new Set([
+    "SELECT",
+    "SHOW",
+    "DESCRIBE",
+    "DESC",
+    "EXPLAIN",
+]);
+export async function ensureMysqlReady(context) {
+    if (context.site.status !== "running") {
+        throw new Error(`The Local site '${context.site.name}' is not running. Start it in Local before using MySQL tools.`);
+    }
+    if (context.mysqlSocket) {
+        await assertReadable(context.mysqlSocket, `MySQL socket is not available for site '${context.site.name}'`);
+    }
+    else if (!context.mysqlPort) {
+        throw new Error(`No MySQL socket or TCP port is available for site '${context.site.name}'.`);
+    }
+}
+export async function executeMysqlStatement(context, sql, maxRows) {
+    const args = [
+        `--defaults-file=${context.mysqlDefaultsFile}`,
+        "--batch",
+        "--default-character-set=utf8mb4",
+        `--execute=${sql}`,
+    ];
+    if (context.mysqlSocket) {
+        args.push("--protocol=SOCKET", `--socket=${context.mysqlSocket}`);
+    }
+    else {
+        args.push("--protocol=TCP", `--host=${context.mysqlHost || config.defaultMysqlHost}`);
+        if (context.mysqlPort) {
+            args.push(`--port=${context.mysqlPort}`);
+        }
+    }
+    args.push(context.database);
+    const result = await spawnCommand(context.mysql.binaryPath, args, {
+        cwd: context.wpRoot,
+        env: process.env,
+    });
+    if (result.timedOut) {
+        throw new Error(`MySQL query timed out after ${config.defaultTimeoutMs / 1000}s for site '${context.site.name}'.`);
+    }
+    if (result.exitCode !== 0) {
+        throw new Error([
+            `MySQL exited with code ${result.exitCode} for site '${context.site.name}'.`,
+            result.stderr,
+            result.stdout,
+        ]
+            .filter(Boolean)
+            .join("\n\n"));
+    }
+    const parsed = parseMysqlBatchOutput(result.stdout, maxRows);
+    return {
+        columns: parsed.columns,
+        rows: parsed.rows,
+        totalRows: parsed.totalRows,
+        returnedRows: parsed.rows.length,
+        truncated: parsed.truncated,
+        stderr: result.stderr || null,
+    };
+}
+export function validateSafeSqlQuery(sql) {
+    const normalizedSql = normalizeSqlStatement(sql);
+    const verb = getSqlVerb(normalizedSql);
+    if (!mysqlReadOnlyVerbs.has(verb)) {
+        throw new Error("The 'safe' profile only allows SELECT, SHOW, DESCRIBE, DESC, and EXPLAIN.");
+    }
+    return normalizedSql;
+}
+export function validateFullAccessSql(sql) {
+    return normalizeSqlStatement(sql);
+}
+export function normalizeSqlStatement(sql) {
+    const normalizedSql = stripLeadingSqlComments(sql)
+        .replace(/;+\s*$/, "")
+        .trim();
+    if (!normalizedSql) {
+        throw new Error("SQL statement cannot be empty.");
+    }
+    if (normalizedSql.includes(";")) {
+        throw new Error("Only a single SQL statement is allowed.");
+    }
+    if (/\bINTO\s+OUTFILE\b/i.test(normalizedSql) ||
+        /\bINTO\s+DUMPFILE\b/i.test(normalizedSql) ||
+        /\bLOAD_FILE\s*\(/i.test(normalizedSql) ||
+        /\bLOAD\s+DATA\b/i.test(normalizedSql)) {
+        throw new Error("File read/write SQL features are blocked.");
+    }
+    return normalizedSql;
+}
+export function getSqlVerb(sql) {
+    const firstToken = sql.match(/^[A-Za-z]+/);
+    if (!firstToken) {
+        throw new Error("The SQL statement must start with a SQL verb.");
+    }
+    return firstToken[0].toUpperCase();
+}
+export function buildListTablesSql(databaseName) {
+    return [
+        "SELECT",
+        "  TABLE_NAME,",
+        "  TABLE_TYPE,",
+        "  ENGINE,",
+        "  TABLE_ROWS,",
+        "  CREATE_TIME,",
+        "  UPDATE_TIME",
+        "FROM INFORMATION_SCHEMA.TABLES",
+        `WHERE TABLE_SCHEMA = '${escapeSqlLiteral(databaseName)}'`,
+        "ORDER BY TABLE_NAME",
+    ].join(" ");
+}
+export function buildDescribeTableSql(databaseName, tableName) {
+    return [
+        "SELECT",
+        "  COLUMN_NAME,",
+        "  COLUMN_TYPE,",
+        "  IS_NULLABLE,",
+        "  COLUMN_DEFAULT,",
+        "  COLUMN_KEY,",
+        "  EXTRA",
+        "FROM INFORMATION_SCHEMA.COLUMNS",
+        `WHERE TABLE_SCHEMA = '${escapeSqlLiteral(databaseName)}'`,
+        `  AND TABLE_NAME = '${escapeSqlLiteral(tableName)}'`,
+        "ORDER BY ORDINAL_POSITION",
+    ].join(" ");
+}
+export function clampMaxRows(maxRows) {
+    if (!maxRows) {
+        return config.defaultMaxRows;
+    }
+    return Math.min(Math.max(maxRows, 1), config.maxMaxRows);
+}
+function parseMysqlBatchOutput(output, maxRows) {
+    const trimmed = output.trim();
+    if (!trimmed) {
+        return {
+            columns: [],
+            rows: [],
+            totalRows: 0,
+            truncated: false,
+        };
+    }
+    const lines = trimmed.split(/\r?\n/);
+    const header = lines.shift();
+    if (!header) {
+        return {
+            columns: [],
+            rows: [],
+            totalRows: 0,
+            truncated: false,
+        };
+    }
+    const columns = header.split("\t").map((value) => decodeMysqlHeader(value));
+    const rawRows = lines
+        .filter((line) => line.length > 0)
+        .map((line) => line.split("\t").map(decodeMysqlValue));
+    const truncated = rawRows.length > maxRows;
+    const limitedRows = rawRows.slice(0, maxRows);
+    const rows = limitedRows.map((values) => {
+        const row = {};
+        columns.forEach((column, index) => {
+            row[column] = values[index] ?? null;
+        });
+        return row;
+    });
+    return {
+        columns,
+        rows,
+        totalRows: rawRows.length,
+        truncated,
+    };
+}
+function decodeMysqlValue(value) {
+    if (value === "NULL") {
+        return null;
+    }
+    return value.replace(/\\([0btnrZ\\])/g, (_, token) => {
+        switch (token) {
+            case "0":
+                return "\0";
+            case "b":
+                return "\b";
+            case "t":
+                return "\t";
+            case "n":
+                return "\n";
+            case "r":
+                return "\r";
+            case "Z":
+                return "\x1a";
+            case "\\":
+                return "\\";
+            default:
+                return token;
+        }
+    });
+}
+function decodeMysqlHeader(value) {
+    return decodeMysqlValue(value) ?? "";
+}
+function stripLeadingSqlComments(sql) {
+    let result = sql.trimStart();
+    while (result) {
+        if (result.startsWith("/*")) {
+            const endIndex = result.indexOf("*/");
+            if (endIndex === -1) {
+                throw new Error("SQL contains an unterminated block comment.");
+            }
+            result = result.slice(endIndex + 2).trimStart();
+            continue;
+        }
+        if (result.startsWith("--") || result.startsWith("#")) {
+            const newlineIndex = result.indexOf("\n");
+            result =
+                newlineIndex === -1
+                    ? ""
+                    : result.slice(newlineIndex + 1).trimStart();
+            continue;
+        }
+        break;
+    }
+    return result;
+}
+function escapeSqlLiteral(value) {
+    return String(value).replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+//# sourceMappingURL=mysql.js.map

package/dist/mysql.js.map

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

package/dist/permissions.d.ts

@@ -0,0 +1,4 @@
+import type { AccessProfile } from "./types.js";
+export declare function assertAllowedWpFlags(args: string[]): void;
+export declare function assertWpCliPermissions(args: string[]): void;
+export declare function assertWpCliPermissionsForProfile(profile: AccessProfile, args: string[]): void;