localwp-mcp 0.1.4 → 0.1.5

package/README.md

@@ -153,21 +153,33 @@ Use:
 - `mysql_schema`
   Table listing and table description helpers
 
-### Back Up or Restore a Site
-
-Use:
-
-- `backup_site`
-- `db_export`
-- `db_import`
-- `restore_backup`
+### Back Up or Restore a Site
+
+Use:
+
+- `backup_site`
+- `list_backups`
+- `delete_backup`
+- `cleanup_backups`
+- `db_export`
+- `db_import`
+- `restore_backup`
 
 `backup_site` supports:
 
 - `database`
 - `full`
 
-The `full` backup format is folder-based and includes the site's `app`, `conf`, and `logs` directories plus a fresh SQL dump.
+The `full` backup format is folder-based and includes the site's `app`, `conf`, and `logs` directories plus a fresh SQL dump.
+
+If you want to manage backup storage over time:
+
+- `list_backups`
+  Shows the managed backup directories and SQL artifacts for a site.
+- `delete_backup`
+  Removes one managed backup artifact in `full-access`.
+- `cleanup_backups`
+  Cleans up older backups by age and/or retention count in `full-access`.
 
 ## Built-In Capabilities
 
@@ -189,11 +201,14 @@ The `full` backup format is folder-based and includes the site's `app`, `conf`,
 - `execute_wp_cli`
 - `mysql_query`
 - `mysql_execute`
-- `mysql_schema`
-- `db_export`
-- `db_import`
-- `backup_site`
-- `restore_backup`
+- `mysql_schema`
+- `db_export`
+- `db_import`
+- `backup_site`
+- `list_backups`
+- `delete_backup`
+- `cleanup_backups`
+- `restore_backup`
 
 ### MCP Resources
 
@@ -207,15 +222,22 @@ The `full` backup format is folder-based and includes the site's `app`, `conf`,
 - `diagnose_local_site`
 - `restore_local_site`
 
-## Platform Support
-
-`localwp-mcp` is designed for:
-
-- macOS
-- Windows
-- Linux
-
-It supports both current Local `lightning-services` layouts and older `site-binaries` layouts.
+## Platform Support
+
+`localwp-mcp` is designed for:
+
+- macOS
+- Windows
+- Linux
+
+It supports both current Local `lightning-services` layouts and older `site-binaries` layouts.
+
+Live validation has been completed on:
+
+- macOS
+- Windows
+
+Linux support is implemented in the code paths and tests, but has not yet been live-validated on a machine with LocalWP.
 
 ## Useful Environment Variables
 

package/dist/backup-management.d.ts

@@ -0,0 +1,121 @@
+import type { BackupArtifactCategory, BackupScope, SiteContext } from "./types.js";
+export declare const backupArtifactCategories: readonly ["full_backup", "database_backup", "pre_restore_backup", "database_export", "pre_import_backup", "sql_file"];
+interface BackupArtifact {
+    path: string;
+    absolutePath: string;
+    kind: "file" | "directory";
+    category: BackupArtifactCategory;
+    createdAt: string;
+    modifiedAt: string;
+    sizeBytes: number;
+    manifestPath: string | null;
+    manifestCreatedAt: string | null;
+    scope: BackupScope | null;
+}
+export declare function listManagedBackups(context: SiteContext, options?: {
+    rootPath?: string;
+}): 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;
+    };
+    selectionMethod: string | undefined;
+    accessProfile: import("./types.js").AccessProfile;
+    backupRoot: string;
+    artifacts: BackupArtifact[];
+}>;
+export declare function deleteManagedBackup(context: SiteContext, options: {
+    backupPath: string;
+    rootPath?: string;
+    missingOk?: boolean;
+}): Promise<{
+    targetPath: string;
+    deleted: boolean;
+    existedBefore: boolean;
+    missingOk: boolean;
+    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;
+    };
+    selectionMethod: string | undefined;
+    accessProfile: import("./types.js").AccessProfile;
+    backupRoot: string;
+    artifacts: BackupArtifact[];
+} | {
+    targetPath: string;
+    deleted: boolean;
+    existedBefore: boolean;
+    deletedArtifact: BackupArtifact;
+    missingOk: boolean;
+    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;
+    };
+    selectionMethod: string | undefined;
+    accessProfile: import("./types.js").AccessProfile;
+    backupRoot: string;
+    artifacts: BackupArtifact[];
+}>;
+export declare function cleanupManagedBackups(context: SiteContext, options?: {
+    rootPath?: string;
+    categories?: BackupArtifactCategory[];
+    olderThanDays?: number;
+    keepLatest?: number;
+    dryRun?: boolean;
+}): Promise<{
+    categories: BackupArtifactCategory[];
+    olderThanDays: number | null;
+    keepLatest: number | null;
+    dryRun: boolean;
+    deletedCount: number;
+    reclaimedBytesEstimate: number;
+    deletedArtifacts: BackupArtifact[];
+    candidateArtifacts: BackupArtifact[];
+    retainedArtifacts: BackupArtifact[];
+    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;
+    };
+    selectionMethod: string | undefined;
+    accessProfile: import("./types.js").AccessProfile;
+    backupRoot: string;
+    artifacts: BackupArtifact[];
+}>;
+export declare function resolveManagedBackupRoot(context: SiteContext, rootPath?: string): string;
+export {};

package/dist/backup-management.js

@@ -0,0 +1,211 @@
+import { lstat, readFile, readdir, rm } from "fs/promises";
+import path from "path";
+import { config } from "./config.js";
+import { summarizeSite } from "./local-sites.js";
+import { isReadablePath } from "./process-utils.js";
+export const backupArtifactCategories = [
+    "full_backup",
+    "database_backup",
+    "pre_restore_backup",
+    "database_export",
+    "pre_import_backup",
+    "sql_file",
+];
+export async function listManagedBackups(context, options = {}) {
+    const backupRoot = resolveManagedBackupRoot(context, options.rootPath);
+    if (!(await isReadablePath(backupRoot))) {
+        return {
+            site: summarizeSite(context.site),
+            selectionMethod: context.selectionMethod,
+            accessProfile: config.profile,
+            backupRoot,
+            artifacts: [],
+        };
+    }
+    const artifacts = await discoverBackupArtifacts(backupRoot);
+    return {
+        site: summarizeSite(context.site),
+        selectionMethod: context.selectionMethod,
+        accessProfile: config.profile,
+        backupRoot,
+        artifacts,
+    };
+}
+export async function deleteManagedBackup(context, options) {
+    const inventory = await listManagedBackups(context, {
+        rootPath: options.rootPath,
+    });
+    const normalizedBackupPath = normalizeBackupRelativePath(options.backupPath);
+    const artifact = inventory.artifacts.find((candidate) => candidate.path === normalizedBackupPath);
+    if (!artifact) {
+        if (options.missingOk) {
+            return {
+                ...inventory,
+                targetPath: normalizedBackupPath,
+                deleted: false,
+                existedBefore: false,
+                missingOk: true,
+            };
+        }
+        throw new Error(`No managed backup artifact matched '${options.backupPath}' under '${inventory.backupRoot}'.`);
+    }
+    await rm(artifact.absolutePath, { recursive: true, force: false });
+    return {
+        ...inventory,
+        targetPath: artifact.path,
+        deleted: true,
+        existedBefore: true,
+        deletedArtifact: artifact,
+        missingOk: options.missingOk ?? false,
+    };
+}
+export async function cleanupManagedBackups(context, options = {}) {
+    if (options.olderThanDays === undefined && options.keepLatest === undefined) {
+        throw new Error("cleanup_backups requires olderThanDays, keepLatest, or both.");
+    }
+    const inventory = await listManagedBackups(context, {
+        rootPath: options.rootPath,
+    });
+    const categories = new Set(options.categories || backupArtifactCategories);
+    const eligibleArtifacts = inventory.artifacts.filter((artifact) => categories.has(artifact.category));
+    const keepLatest = options.keepLatest ? Math.max(options.keepLatest, 0) : 0;
+    const thresholdMs = options.olderThanDays !== undefined
+        ? Date.now() - options.olderThanDays * 24 * 60 * 60 * 1000
+        : null;
+    const retainedPaths = new Set(eligibleArtifacts.slice(0, keepLatest).map((artifact) => artifact.path));
+    const cleanupCandidates = eligibleArtifacts.filter((artifact) => {
+        if (retainedPaths.has(artifact.path)) {
+            return false;
+        }
+        if (thresholdMs === null) {
+            return true;
+        }
+        return Date.parse(artifact.createdAt) < thresholdMs;
+    });
+    if (!options.dryRun) {
+        for (const artifact of cleanupCandidates) {
+            await rm(artifact.absolutePath, { recursive: true, force: false });
+        }
+    }
+    return {
+        ...inventory,
+        categories: Array.from(categories),
+        olderThanDays: options.olderThanDays ?? null,
+        keepLatest: options.keepLatest ?? null,
+        dryRun: options.dryRun ?? false,
+        deletedCount: options.dryRun ? 0 : cleanupCandidates.length,
+        reclaimedBytesEstimate: cleanupCandidates.reduce((total, artifact) => total + artifact.sizeBytes, 0),
+        deletedArtifacts: options.dryRun ? [] : cleanupCandidates,
+        candidateArtifacts: cleanupCandidates,
+        retainedArtifacts: eligibleArtifacts.filter((artifact) => retainedPaths.has(artifact.path)),
+    };
+}
+export function resolveManagedBackupRoot(context, rootPath) {
+    if (rootPath) {
+        return path.resolve(rootPath);
+    }
+    if (config.backupsDirOverride) {
+        return path.resolve(config.backupsDirOverride);
+    }
+    return path.join(context.site.absolutePath, "localwp-mcp-backups");
+}
+async function discoverBackupArtifacts(backupRoot) {
+    const entries = await readdir(backupRoot, { withFileTypes: true });
+    const artifacts = [];
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        const absoluteEntryPath = path.join(backupRoot, entry.name);
+        if (entry.isDirectory()) {
+            const manifestPath = path.join(absoluteEntryPath, "manifest.json");
+            if (await isReadablePath(manifestPath)) {
+                artifacts.push(await buildBackupDirectoryArtifact(backupRoot, absoluteEntryPath));
+                continue;
+            }
+            if (entry.name === "database-exports" || entry.name === "pre-import") {
+                artifacts.push(...(await collectSqlFileArtifacts(backupRoot, absoluteEntryPath, entry.name === "pre-import" ? "pre_import_backup" : "database_export")));
+            }
+            continue;
+        }
+        if (entry.isFile() && path.extname(entry.name).toLowerCase() === ".sql") {
+            artifacts.push(await buildSqlFileArtifact(backupRoot, absoluteEntryPath, "sql_file"));
+        }
+    }
+    return artifacts.sort((left, right) => Date.parse(right.createdAt) - Date.parse(left.createdAt) ||
+        left.path.localeCompare(right.path));
+}
+async function collectSqlFileArtifacts(backupRoot, directoryPath, category) {
+    const sqlArtifacts = [];
+    const entries = await readdir(directoryPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const absoluteEntryPath = path.join(directoryPath, entry.name);
+        if (entry.isDirectory()) {
+            sqlArtifacts.push(...(await collectSqlFileArtifacts(backupRoot, absoluteEntryPath, category)));
+            continue;
+        }
+        if (entry.isFile() && path.extname(entry.name).toLowerCase() === ".sql") {
+            sqlArtifacts.push(await buildSqlFileArtifact(backupRoot, absoluteEntryPath, category));
+        }
+    }
+    return sqlArtifacts;
+}
+async function buildBackupDirectoryArtifact(backupRoot, absolutePath) {
+    const manifestPath = path.join(absolutePath, "manifest.json");
+    const manifest = await readManifest(manifestPath);
+    const stats = await lstat(absolutePath);
+    return {
+        path: normalizeBackupRelativePath(path.relative(backupRoot, absolutePath)),
+        absolutePath,
+        kind: "directory",
+        category: inferDirectoryCategory(absolutePath, manifest.scope),
+        createdAt: manifest.createdAt || stats.mtime.toISOString(),
+        modifiedAt: stats.mtime.toISOString(),
+        sizeBytes: await calculatePathSize(absolutePath),
+        manifestPath,
+        manifestCreatedAt: manifest.createdAt || null,
+        scope: manifest.scope || null,
+    };
+}
+async function buildSqlFileArtifact(backupRoot, absolutePath, category) {
+    const stats = await lstat(absolutePath);
+    return {
+        path: normalizeBackupRelativePath(path.relative(backupRoot, absolutePath)),
+        absolutePath,
+        kind: "file",
+        category,
+        createdAt: stats.mtime.toISOString(),
+        modifiedAt: stats.mtime.toISOString(),
+        sizeBytes: stats.size,
+        manifestPath: null,
+        manifestCreatedAt: null,
+        scope: null,
+    };
+}
+async function readManifest(manifestPath) {
+    const raw = await readFile(manifestPath, "utf8");
+    return JSON.parse(raw);
+}
+function inferDirectoryCategory(absolutePath, scope) {
+    const directoryName = path.basename(absolutePath).toLowerCase();
+    if (directoryName.includes("pre-restore")) {
+        return "pre_restore_backup";
+    }
+    if (scope === "full") {
+        return "full_backup";
+    }
+    return "database_backup";
+}
+async function calculatePathSize(absolutePath) {
+    const stats = await lstat(absolutePath);
+    if (!stats.isDirectory()) {
+        return stats.size;
+    }
+    const entries = await readdir(absolutePath, { withFileTypes: true });
+    let total = 0;
+    for (const entry of entries) {
+        total += await calculatePathSize(path.join(absolutePath, entry.name));
+    }
+    return total;
+}
+function normalizeBackupRelativePath(relativePath) {
+    return relativePath.replaceAll(path.sep, "/");
+}
+//# sourceMappingURL=backup-management.js.map

package/dist/backup-management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-management.js","sourceRoot":"","sources":["../src/backup-management.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOpD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,aAAa;IACb,iBAAiB;IACjB,oBAAoB;IACpB,iBAAiB;IACjB,mBAAmB;IACnB,UAAU;CAC0C,CAAC;AAqBvD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAoB,EACpB,UAEI,EAAE;IAEN,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvE,IAAI,CAAC,CAAC,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;YACjC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,aAAa,EAAE,MAAM,CAAC,OAAO;YAC7B,UAAU;YACV,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAE5D,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;QACjC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,aAAa,EAAE,MAAM,CAAC,OAAO;QAC7B,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAoB,EACpB,OAIC;IAED,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE;QAClD,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CAAC;IACH,MAAM,oBAAoB,GAAG,2BAA2B,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CACvC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,oBAAoB,CACvD,CAAC;IAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,OAAO;gBACL,GAAG,SAAS;gBACZ,UAAU,EAAE,oBAAoB;gBAChC,OAAO,EAAE,KAAK;gBACd,aAAa,EAAE,KAAK;gBACpB,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CACb,uCAAuC,OAAO,CAAC,UAAU,YAAY,SAAS,CAAC,UAAU,IAAI,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAEnE,OAAO;QACL,GAAG,SAAS;QACZ,UAAU,EAAE,QAAQ,CAAC,IAAI;QACzB,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,QAAQ;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAoB,EACpB,UAMI,EAAE;IAEN,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE;QAClD,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,wBAAwB,CAAC,CAAC;IAC3E,MAAM,iBAAiB,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAChE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAClC,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,WAAW,GACf,OAAO,CAAC,aAAa,KAAK,SAAS;QACjC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QAC1D,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CACxE,CAAC;IACF,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC9D,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;YACzC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,SAAS;QACZ,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;QAClC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;QAC5C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM;QAC3D,sBAAsB,EAAE,iBAAiB,CAAC,MAAM,CAC9C,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,GAAG,QAAQ,CAAC,SAAS,EAC/C,CAAC,CACF;QACD,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB;QACzD,kBAAkB,EAAE,iBAAiB;QACrC,iBAAiB,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CACvD,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CACjC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAoB,EACpB,QAAiB;IAEjB,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;AACrE,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,UAAkB;IACvD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,SAAS,GAAqB,EAAE,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5D,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;YAEnE,IAAI,MAAM,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;gBACvC,SAAS,CAAC,IAAI,CAAC,MAAM,4BAA4B,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC;gBAClF,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACrE,SAAS,CAAC,IAAI,CACZ,GAAG,CAAC,MAAM,uBAAuB,CAC/B,UAAU,EACV,iBAAiB,EACjB,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,CACtE,CAAC,CACH,CAAC;YACJ,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YACxE,SAAS,CAAC,IAAI,CAAC,MAAM,oBAAoB,CAAC,UAAU,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC,IAAI,CACnB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CACtC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,UAAkB,EAClB,aAAqB,EACrB,QAAgC;IAEhC,MAAM,YAAY,GAAqB,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/D,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,uBAAuB,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC/F,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YACxE,YAAY,CAAC,IAAI,CACf,MAAM,oBAAoB,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,4BAA4B,CACzC,UAAkB,EAClB,YAAoB;IAEpB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;IAExC,OAAO;QACL,IAAI,EAAE,2BAA2B,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC1E,YAAY;QACZ,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,sBAAsB,CAAC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC;QAC9D,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;QAC1D,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;QACrC,SAAS,EAAE,MAAM,iBAAiB,CAAC,YAAY,CAAC;QAChD,YAAY;QACZ,iBAAiB,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;QAC7C,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI;KAC9B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,UAAkB,EAClB,YAAoB,EACpB,QAAgC;IAEhC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;IAExC,OAAO;QACL,IAAI,EAAE,2BAA2B,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC1E,YAAY;QACZ,IAAI,EAAE,MAAM;QACZ,QAAQ;QACR,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;QACpC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;QACrC,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,IAAI;QACvB,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,YAAoB;IAC9C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;AAClD,CAAC;AAED,SAAS,sBAAsB,CAC7B,YAAoB,EACpB,KAA8B;IAE9B,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAEhE,IAAI,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1C,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,YAAoB;IACnD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;IAExC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,IAAI,MAAM,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,2BAA2B,CAAC,YAAoB;IACvD,OAAO,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC"}

package/dist/server.d.ts

@@ -1,2 +1,3 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function resolveServerVersion(): string;
 export declare function createServer(): McpServer;

package/dist/server.js

@@ -1,13 +1,32 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerPrompts } from "./prompts.js";
 import { registerResources } from "./resources.js";
 import { registerTools } from "./tools/index.js";
 const SERVER_NAME = "localwp-mcp";
-const SERVER_VERSION = process.env.npm_package_version || "0.1.0";
+export function resolveServerVersion() {
+    if (process.env.npm_package_version) {
+        return process.env.npm_package_version;
+    }
+    const currentFilePath = fileURLToPath(import.meta.url);
+    const packageJsonPath = path.resolve(path.dirname(currentFilePath), "..", "package.json");
+    try {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+        if (typeof packageJson.version === "string" && packageJson.version.trim()) {
+            return packageJson.version;
+        }
+    }
+    catch {
+        // Fall through to the hard-coded safety net below.
+    }
+    return "0.1.0";
+}
 export function createServer() {
     const server = new McpServer({
         name: SERVER_NAME,
-        version: SERVER_VERSION,
+        version: resolveServerVersion(),
     }, {
         capabilities: {
             prompts: {},

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,GAAG,aAAa,CAAC;AAClC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;AAElE,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,EACD;QACE,YAAY,EAAE;YACZ,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtB,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC,MAAM,UAAU,oBAAoB;IAClC,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACzC,CAAC;IAED,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IAE1F,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CACb,CAAC;QAE3B,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1E,OAAO,WAAW,CAAC,OAAO,CAAC;QAC7B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,oBAAoB,EAAE;KAChC,EACD;QACE,YAAY,EAAE;YACZ,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/cleanup-backups.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCleanupBackupsTool(server: McpServer): void;

package/dist/tools/cleanup-backups.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { backupArtifactCategories, cleanupManagedBackups, } from "../backup-management.js";
+import { config } from "../config.js";
+import { buildSiteContext } from "../local-sites.js";
+import { createErrorToolResult, createJsonToolResult } from "../results.js";
+import { siteSelectorSchema } from "../tool-schemas.js";
+export function registerCleanupBackupsTool(server) {
+    server.registerTool("cleanup_backups", {
+        description: "Deletes managed backup artifacts for the selected LocalWP site based on age and/or retention. Requires the 'full-access' profile.",
+        inputSchema: {
+            ...siteSelectorSchema,
+            rootPath: z
+                .string()
+                .optional()
+                .describe("Optional custom backup root directory to clean. If omitted, the site's managed localwp-mcp backup root is used."),
+            categories: z
+                .array(z.enum(backupArtifactCategories))
+                .optional()
+                .describe("Optional backup categories to target, such as full_backup, pre_restore_backup, or database_export."),
+            olderThanDays: z
+                .number()
+                .nonnegative()
+                .optional()
+                .describe("Delete only artifacts older than this many days. Use 0 to target everything older than now."),
+            keepLatest: z
+                .number()
+                .int()
+                .nonnegative()
+                .optional()
+                .describe("Keep this many newest matching artifacts and clean up older ones beyond that retention count."),
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe("When true, only report which artifacts would be deleted without deleting them."),
+        },
+    }, async ({ siteId, siteName, rootPath, categories, olderThanDays, keepLatest, dryRun, }) => {
+        try {
+            if (config.profile !== "full-access") {
+                throw new Error("cleanup_backups requires LOCALWP_MCP_PROFILE=full-access.");
+            }
+            const context = await buildSiteContext({ siteId, siteName });
+            return createJsonToolResult(await cleanupManagedBackups(context, {
+                rootPath,
+                categories,
+                olderThanDays,
+                keepLatest,
+                dryRun,
+            }));
+        }
+        catch (error) {
+            return createErrorToolResult(error);
+        }
+    });
+}
+//# sourceMappingURL=cleanup-backups.js.map

package/dist/tools/cleanup-backups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-backups.js","sourceRoot":"","sources":["../../src/tools/cleanup-backups.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,mIAAmI;QACrI,WAAW,EAAE;YACX,GAAG,kBAAkB;YACrB,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,iHAAiH,CAClH;YACH,UAAU,EAAE,CAAC;iBACV,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;iBACvC,QAAQ,EAAE;iBACV,QAAQ,CACP,oGAAoG,CACrG;YACH,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,WAAW,EAAE;iBACb,QAAQ,EAAE;iBACV,QAAQ,CACP,6FAA6F,CAC9F;YACH,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,WAAW,EAAE;iBACb,QAAQ,EAAE;iBACV,QAAQ,CACP,+FAA+F,CAChG;YACH,MAAM,EAAE,CAAC;iBACN,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,gFAAgF,CACjF;SACJ;KACF,EACD,KAAK,EAAE,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,aAAa,EACb,UAAU,EACV,MAAM,GACP,EAAE,EAAE;QACH,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7D,OAAO,oBAAoB,CACzB,MAAM,qBAAqB,CAAC,OAAO,EAAE;gBACnC,QAAQ;gBACR,UAAU;gBACV,aAAa;gBACb,UAAU;gBACV,MAAM;aACP,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/delete-backup.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDeleteBackupTool(server: McpServer): void;

package/dist/tools/delete-backup.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { deleteManagedBackup } from "../backup-management.js";
+import { config } from "../config.js";
+import { buildSiteContext } from "../local-sites.js";
+import { createErrorToolResult, createJsonToolResult } from "../results.js";
+import { siteSelectorSchema } from "../tool-schemas.js";
+export function registerDeleteBackupTool(server) {
+    server.registerTool("delete_backup", {
+        description: "Deletes one managed backup artifact for the selected LocalWP site. Requires the 'full-access' profile.",
+        inputSchema: {
+            ...siteSelectorSchema,
+            backupPath: z
+                .string()
+                .min(1)
+                .describe("Relative backup path from list_backups, for example 'woo-full-20260401-162738-restore-test' or 'pre-import/woo-before-import-20260401-120000.sql'."),
+            rootPath: z
+                .string()
+                .optional()
+                .describe("Optional custom backup root directory if the artifact lives outside the default managed backup root."),
+            missingOk: z
+                .boolean()
+                .optional()
+                .describe("When true, return success even if the requested artifact is already gone."),
+        },
+    }, async ({ siteId, siteName, backupPath, rootPath, missingOk }) => {
+        try {
+            if (config.profile !== "full-access") {
+                throw new Error("delete_backup requires LOCALWP_MCP_PROFILE=full-access.");
+            }
+            const context = await buildSiteContext({ siteId, siteName });
+            return createJsonToolResult(await deleteManagedBackup(context, { backupPath, rootPath, missingOk }));
+        }
+        catch (error) {
+            return createErrorToolResult(error);
+        }
+    });
+}
+//# sourceMappingURL=delete-backup.js.map

package/dist/tools/delete-backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-backup.js","sourceRoot":"","sources":["../../src/tools/delete-backup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,wGAAwG;QAC1G,WAAW,EAAE;YACX,GAAG,kBAAkB;YACrB,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,oJAAoJ,CACrJ;YACH,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,sGAAsG,CACvG;YACH,SAAS,EAAE,CAAC;iBACT,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,2EAA2E,CAC5E;SACJ;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE;QAC9D,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;YAC7E,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7D,OAAO,oBAAoB,CACzB,MAAM,mBAAmB,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CACxE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/index.js

@@ -1,8 +1,11 @@
 import { registerBackupSiteTool } from "./backup-site.js";
+import { registerCleanupBackupsTool } from "./cleanup-backups.js";
 import { registerDbExportTool } from "./db-export.js";
 import { registerDbImportTool } from "./db-import.js";
+import { registerDeleteBackupTool } from "./delete-backup.js";
 import { registerDeleteSiteFileTool } from "./delete-site-file.js";
 import { registerExecuteWpCliTool } from "./execute-wp-cli.js";
+import { registerListBackupsTool } from "./list-backups.js";
 import { registerListSiteFilesTool } from "./list-site-files.js";
 import { registerLocalDoctorTool } from "./local-doctor.js";
 import { registerLocalEnvironmentCheckTool } from "./local-environment-check.js";
@@ -34,6 +37,9 @@ export function registerTools(server) {
     registerWriteSiteFileTool(server);
     registerDeleteSiteFileTool(server);
     registerBackupSiteTool(server);
+    registerListBackupsTool(server);
+    registerDeleteBackupTool(server);
+    registerCleanupBackupsTool(server);
     registerDbExportTool(server);
     registerDbImportTool(server);
     registerRestoreBackupTool(server);

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAC1C,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAC1C,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/tools/list-backups.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerListBackupsTool(server: McpServer): void;

package/dist/tools/list-backups.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { listManagedBackups } from "../backup-management.js";
+import { buildSiteContext } from "../local-sites.js";
+import { createErrorToolResult, createJsonToolResult } from "../results.js";
+import { siteSelectorSchema } from "../tool-schemas.js";
+export function registerListBackupsTool(server) {
+    server.registerTool("list_backups", {
+        description: "Lists backup directories and SQL export artifacts managed for the selected LocalWP site.",
+        inputSchema: {
+            ...siteSelectorSchema,
+            rootPath: z
+                .string()
+                .optional()
+                .describe("Optional custom backup root directory to inspect. If omitted, the site's managed localwp-mcp backup root is used."),
+        },
+        annotations: {
+            readOnlyHint: true,
+        },
+    }, async ({ siteId, siteName, rootPath }) => {
+        try {
+            const context = await buildSiteContext({ siteId, siteName });
+            return createJsonToolResult(await listManagedBackups(context, { rootPath }));
+        }
+        catch (error) {
+            return createErrorToolResult(error);
+        }
+    });
+}
+//# sourceMappingURL=list-backups.js.map

package/dist/tools/list-backups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-backups.js","sourceRoot":"","sources":["../../src/tools/list-backups.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,0FAA0F;QAC5F,WAAW,EAAE;YACX,GAAG,kBAAkB;YACrB,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,mHAAmH,CACpH;SACJ;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;SACnB;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7D,OAAO,oBAAoB,CACzB,MAAM,kBAAkB,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAChD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 export type AccessProfile = "safe" | "full-access";
 export type LogScope = "site" | "global" | "all";
 export type BackupScope = "database" | "full";
+export type BackupArtifactCategory = "full_backup" | "database_backup" | "pre_restore_backup" | "database_export" | "pre_import_backup" | "sql_file";
 export type LocalSiteStatus = "running" | "halted" | "unknown" | string;
 export interface LocalSiteServices {
     nginx?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "localwp-mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "A LocalWP-aware MCP server for WordPress developers with simple safe and full-access profiles, logs, doctor diagnostics, SQL access, backups, restore flows, MCP resources/prompts, and site-aware WP-CLI.",
   "type": "module",
   "packageManager": "pnpm@10.32.1",