impreza-mcp 0.37.1 → 0.39.0

package/README.md

@@ -265,7 +265,7 @@ Static npm sites: choose build_strategy=node_npm_static with a Git/context sourc
 
 ## Status
 
-**Package version: 0.37.1.** The tool catalog covers app deployment plus account +
+**Package version: 0.38.0.** The tool catalog covers app deployment plus account +
 crypto balance, catalog + ordering, domains/DNS + registration, invoices, VPS
 lifecycle with snapshots and backups, dedicated / bare-metal servers, plan
 upgrades, and Titan / Google Workspace mailboxes — with a setup wizard that
@@ -636,3 +636,37 @@ Python deployments may select python_package_manager=uv@0.12.15 with python_pip,
 `impreza_prepare_image_promotion`, `impreza_get_image_promotion` and `impreza_apply_image_promotion` review an exact registry digest for an existing destination configuration. Apply requires the returned review digest and explicit confirmation. Destination variables and data remain local to that application.
 
 Project/environment tools organize existing applications with explicit component associations. They do not copy variables, create network connections or deploy workloads. See the [project environments guide](https://docs.imprezahost.com/project-environments.html).
+
+### Reviewed deployment workflows
+
+Version 0.38.0 adds environment configuration comparison, prepare/read/apply traffic
+switches and explicit branch previews with optional password protection. Compare
+returns variable names, never values. Traffic switches require a reviewed digest
+and confirmation, keep the source running, and require operator reconciliation if
+recovery cannot be verified. Protected preview credentials are shown once.
+Traffic switches and protected previews require agent 0.6.16 or newer. Existing
+servers update only at the customer's request. Assisted database restore is a REST
+workflow. See [project environments](https://docs.imprezahost.com/project-environments.html)
+and [deployment safety](https://docs.imprezahost.com/deployment-safety.html).
+
+### Basic Cloud VPS management
+
+Basic Cloud VPS supports status and allocated resources through `impreza_api_call`,
+and boot, graceful shutdown and reboot through `impreza_cloud_power`. Use the WHMCS
+service ID from `impreza_list_services`. Advanced Cloud infrastructure tools are
+no longer advertised; retired calls return `FEATURE_NOT_AVAILABLE`. Contact
+Impreza support for other infrastructure changes. Ordering and cancellation keep
+their normal account workflows. Application management through an enrolled agent
+is separate.
+
+
+## Configuration, metrics and recovery (0.39.0)
+
+Review application configuration with export/prepare/get/apply tools; inspect
+per-app metrics and alert rules; download backup parts and review/apply a
+PostgreSQL restore into a new database. Applying a review requires its digest
+and explicit confirmation; acceptance is queued work, not verified completion.
+The custom deploy and preparation tools also support `static_files` and
+`go_build`. Metrics and MariaDB bindings require agent 0.6.17 or newer.
+See [configuration, metrics and recovery](https://docs.imprezahost.com/customer-workflows.html)
+for permissions, examples and limits. No automatic server update occurs.

package/dist/customer-workflows.d.ts

@@ -0,0 +1,422 @@
+import type { ImprezaClient } from './client.js';
+export declare const CUSTOMER_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            deployment_id: {
+                type: string;
+                pattern: string;
+                description?: never;
+            };
+            document?: never;
+            config_plan_id?: never;
+            review_digest?: never;
+            confirm?: never;
+            minutes?: never;
+            rule_id?: never;
+            metric?: never;
+            threshold?: never;
+            duration_minutes?: never;
+            enabled?: never;
+            backup_id?: never;
+            target_binding_id?: never;
+            restore_plan_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint?: never;
+    };
+    title: string;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            deployment_id: {
+                type: string;
+                pattern: string;
+                description?: never;
+            };
+            document: {
+                type: string;
+                description: string;
+            };
+            config_plan_id?: never;
+            review_digest?: never;
+            confirm?: never;
+            minutes?: never;
+            rule_id?: never;
+            metric?: never;
+            threshold?: never;
+            duration_minutes?: never;
+            enabled?: never;
+            backup_id?: never;
+            target_binding_id?: never;
+            restore_plan_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    title: string;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            config_plan_id: {
+                type: string;
+                pattern: string;
+            };
+            deployment_id?: never;
+            document?: never;
+            review_digest?: never;
+            confirm?: never;
+            minutes?: never;
+            rule_id?: never;
+            metric?: never;
+            threshold?: never;
+            duration_minutes?: never;
+            enabled?: never;
+            backup_id?: never;
+            target_binding_id?: never;
+            restore_plan_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint?: never;
+    };
+    title: string;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            config_plan_id: {
+                type: string;
+                pattern: string;
+            };
+            review_digest: {
+                type: string;
+                pattern: string;
+            };
+            confirm: {
+                type: string;
+                const: boolean;
+            };
+            deployment_id?: never;
+            document?: never;
+            minutes?: never;
+            rule_id?: never;
+            metric?: never;
+            threshold?: never;
+            duration_minutes?: never;
+            enabled?: never;
+            backup_id?: never;
+            target_binding_id?: never;
+            restore_plan_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    title: string;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            deployment_id: {
+                type: string;
+                description: string;
+                pattern?: never;
+            };
+            minutes: {
+                type: string;
+                description: string;
+            };
+            document?: never;
+            config_plan_id?: never;
+            review_digest?: never;
+            confirm?: never;
+            rule_id?: never;
+            metric?: never;
+            threshold?: never;
+            duration_minutes?: never;
+            enabled?: never;
+            backup_id?: never;
+            target_binding_id?: never;
+            restore_plan_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint?: never;
+    };
+    title: string;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            deployment_id: {
+                type: string;
+                description: string;
+                pattern?: never;
+            };
+            document?: never;
+            config_plan_id?: never;
+            review_digest?: never;
+            confirm?: never;
+            minutes?: never;
+            rule_id?: never;
+            metric?: never;
+            threshold?: never;
+            duration_minutes?: never;
+            enabled?: never;
+            backup_id?: never;
+            target_binding_id?: never;
+            restore_plan_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint?: never;
+    };
+    title: string;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            deployment_id: {
+                type: string;
+                description: string;
+                pattern?: never;
+            };
+            rule_id: {
+                type: string;
+                description: string;
+            };
+            metric: {
+                type: string;
+                enum: string[];
+            };
+            threshold: {
+                type: string;
+                description: string;
+            };
+            duration_minutes: {
+                type: string;
+                description: string;
+            };
+            enabled: {
+                type: string;
+                description: string;
+            };
+            document?: never;
+            config_plan_id?: never;
+            review_digest?: never;
+            confirm?: never;
+            minutes?: never;
+            backup_id?: never;
+            target_binding_id?: never;
+            restore_plan_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    title: string;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            backup_id: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            target_binding_id: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            deployment_id?: never;
+            document?: never;
+            config_plan_id?: never;
+            review_digest?: never;
+            confirm?: never;
+            minutes?: never;
+            rule_id?: never;
+            metric?: never;
+            threshold?: never;
+            duration_minutes?: never;
+            enabled?: never;
+            restore_plan_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    title: string;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            restore_plan_id: {
+                type: string;
+                pattern: string;
+            };
+            deployment_id?: never;
+            document?: never;
+            config_plan_id?: never;
+            review_digest?: never;
+            confirm?: never;
+            minutes?: never;
+            rule_id?: never;
+            metric?: never;
+            threshold?: never;
+            duration_minutes?: never;
+            enabled?: never;
+            backup_id?: never;
+            target_binding_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint?: never;
+    };
+    title: string;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            restore_plan_id: {
+                type: string;
+                pattern: string;
+            };
+            review_digest: {
+                type: string;
+                pattern: string;
+            };
+            confirm: {
+                type: string;
+                const: boolean;
+            };
+            deployment_id?: never;
+            document?: never;
+            config_plan_id?: never;
+            minutes?: never;
+            rule_id?: never;
+            metric?: never;
+            threshold?: never;
+            duration_minutes?: never;
+            enabled?: never;
+            backup_id?: never;
+            target_binding_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    title: string;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            backup_id: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            deployment_id?: never;
+            document?: never;
+            config_plan_id?: never;
+            review_digest?: never;
+            confirm?: never;
+            minutes?: never;
+            rule_id?: never;
+            metric?: never;
+            threshold?: never;
+            duration_minutes?: never;
+            enabled?: never;
+            target_binding_id?: never;
+            restore_plan_id?: never;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint?: never;
+    };
+    title: string;
+})[];
+export declare function isCustomerTool(name: string): boolean;
+export declare function callCustomerTool(client: ImprezaClient, name: string, args: Record<string, unknown>): Promise<unknown>;