plugin-cluster-manager 1.1.7 → 1.1.11

package/src/client/utils/requestDedupInterceptor.ts

@@ -0,0 +1,213 @@
+import { APIClient } from '@nocobase/client';
+
+const CLIENT_CACHE_TTL_MS = 60 * 1000;
+const CACHE_KEY_PREFIX = 'nb_cache';
+const CACHE_VERSION_PREFIX = 'nb_cache_version';
+
+const pendingRequests = new Map<string, Promise<unknown>>();
+const wrappedClients = new WeakSet<APIClient>();
+
+interface RequestConfig {
+  url?: string;
+  method?: string;
+  resource?: string;
+  resourceOf?: unknown;
+  action?: string;
+  params?: unknown;
+  data?: unknown;
+}
+
+interface CacheScope {
+  prefix: string;
+  versionKey: string;
+}
+
+interface CacheEntry {
+  expiresAt: number;
+  scopeVersion: number;
+  response: unknown;
+}
+
+function getRequestInfo(config: string | RequestConfig) {
+  if (typeof config === 'string') {
+    return {
+      url: config,
+      method: 'get',
+      params: {},
+    };
+  }
+
+  const cfg = config as RequestConfig;
+  let url = cfg.url || '';
+  let method = (cfg.method || 'get').toLowerCase();
+  const params = cfg.params || {};
+
+  if (cfg.resource && cfg.action) {
+    const of = cfg.resourceOf;
+    let computedUrl = cfg.resource.split('.').join(of ? `/${encodeURIComponent(String(of))}/` : '/');
+    computedUrl += `:${cfg.action}`;
+    url = computedUrl;
+    method = ['get', 'list', 'listMeta', 'getJsonSchema'].includes(cfg.action) ? 'get' : 'post';
+  }
+
+  return { url, method, params };
+}
+
+function getStorage() {
+  try {
+    return typeof sessionStorage === 'undefined' ? null : sessionStorage;
+  } catch {
+    return null;
+  }
+}
+
+function stringifyParams(params: unknown) {
+  try {
+    return JSON.stringify(params || {});
+  } catch {
+    return '[unserializable]';
+  }
+}
+
+function isCacheableSchemaRequest(url: string) {
+  return url.includes('collections:listMeta') || url.includes('uiSchemas:getJsonSchema');
+}
+
+function getCacheScope(apiClient: APIClient): CacheScope {
+  const appName = apiClient.app?.getName() || 'main';
+  const role = apiClient.auth?.role || 'anonymous';
+  const token = apiClient.auth?.token || 'anonymous';
+  const safeToken = typeof token === 'string' ? token.slice(-8) : 'anonymous';
+  const scope = `${appName}:${safeToken}:${role}`;
+
+  return {
+    prefix: `${CACHE_KEY_PREFIX}:${scope}:`,
+    versionKey: `${CACHE_VERSION_PREFIX}:${scope}`,
+  };
+}
+
+function getScopeVersion(storage: Storage, scope: CacheScope) {
+  try {
+    const raw = storage.getItem(scope.versionKey);
+    const version = raw ? Number(raw) : 0;
+    return Number.isFinite(version) ? version : 0;
+  } catch {
+    return 0;
+  }
+}
+
+function clearByPrefix(storage: Storage, prefix: string) {
+  const keys: string[] = [];
+  for (let index = 0; index < storage.length; index += 1) {
+    const key = storage.key(index);
+    if (key?.startsWith(prefix)) {
+      keys.push(key);
+    }
+  }
+
+  for (const key of keys) {
+    storage.removeItem(key);
+  }
+}
+
+function bumpScopeVersion(apiClient: APIClient) {
+  const storage = getStorage();
+  if (!storage) return;
+
+  try {
+    const scope = getCacheScope(apiClient);
+    const nextVersion = getScopeVersion(storage, scope) + 1;
+    storage.setItem(scope.versionKey, String(nextVersion));
+    clearByPrefix(storage, scope.prefix);
+  } catch {
+    // Ignore storage failures; the network response remains authoritative.
+  }
+}
+
+function isSuccessfulResponse(response: unknown) {
+  const status =
+    response && typeof response === 'object' && 'status' in response
+      ? (response as { status?: unknown }).status
+      : undefined;
+  return typeof status !== 'number' || (status >= 200 && status < 400);
+}
+
+export function setupRequestDedupAndCache(apiClient: APIClient) {
+  if (!apiClient) return;
+  if (wrappedClients.has(apiClient)) return;
+  wrappedClients.add(apiClient);
+
+  const originalRequest = apiClient.request.bind(apiClient);
+
+  apiClient.request = async (config) => {
+    const { url, method, params } = getRequestInfo(config as string | RequestConfig);
+
+    if (method !== 'get') {
+      const response = await originalRequest(config);
+      if (isSuccessfulResponse(response)) {
+        bumpScopeVersion(apiClient);
+      }
+      return response;
+    }
+
+    // Only cache/deduplicate listMeta and uiSchemas to avoid altering standard operations
+    if (!url || !isCacheableSchemaRequest(url)) {
+      return originalRequest(config);
+    }
+
+    const storage = getStorage();
+    const scope = getCacheScope(apiClient);
+    const scopeVersion = storage ? getScopeVersion(storage, scope) : 0;
+    const paramsKey = stringifyParams(params);
+
+    const cacheKey = `${scope.prefix}v${scopeVersion}:${url}:${paramsKey}`;
+
+    if (storage) {
+      try {
+        const cached = storage.getItem(cacheKey);
+        if (cached) {
+          const entry = JSON.parse(cached) as CacheEntry;
+          if (entry.expiresAt > Date.now() && entry.scopeVersion === scopeVersion) {
+            return entry.response;
+          }
+          storage.removeItem(cacheKey);
+        }
+      } catch {
+        // Fallback to the network on sessionStorage or JSON failures.
+      }
+    }
+
+    const dedupKey = `${scope.prefix}v${scopeVersion}:${url}:${paramsKey}`;
+    if (pendingRequests.has(dedupKey)) {
+      return pendingRequests.get(dedupKey);
+    }
+
+    const promise = originalRequest(config).then(
+      (response) => {
+        pendingRequests.delete(dedupKey);
+
+        // 3. Cache successful responses
+        if (storage && response && response.status === 200 && response.data) {
+          try {
+            const entry: CacheEntry = {
+              expiresAt: Date.now() + CLIENT_CACHE_TTL_MS,
+              scopeVersion,
+              response,
+            };
+            storage.setItem(cacheKey, JSON.stringify(entry));
+          } catch {
+            // Ignore quota errors
+          }
+        }
+        return response;
+      },
+      (error) => {
+        pendingRequests.delete(dedupKey);
+        throw error;
+      },
+    );
+
+    pendingRequests.set(dedupKey, promise);
+    return promise;
+  };
+}

package/src/locale/en-US.json

@@ -91,5 +91,101 @@
   "Plugin force removed": "Plugin force removed",
   "Failed to load plugins": "Failed to load plugins",
   "Failed to force disable plugin": "Failed to force disable plugin",
-  "Failed to force remove plugin": "Failed to force remove plugin"
+  "Failed to force remove plugin": "Failed to force remove plugin",
+  "Nginx Cache": "Nginx Cache",
+  "Nginx configuration file found at": "Nginx configuration file found at",
+  "Nginx cache paths detected": "Nginx cache paths detected",
+  "Nginx is not detected on this node. You can still input a custom cache directory.": "Nginx is not detected on this node. You can still input a custom cache directory.",
+  "Clearing Method": "Clearing Method",
+  "Physical Files": "Physical Files",
+  "HTTP Purge Request": "HTTP Purge Request",
+  "Select Cache Path": "Select Cache Path",
+  "Custom Path": "Custom Path",
+  "Purge URL": "Purge URL",
+  "Headers (JSON)": "Headers (JSON)",
+  "Clear Nginx Cache": "Clear Nginx Cache",
+  "Are you sure you want to clear Nginx cache? This will permanently delete all files in this directory.": "Are you sure you want to clear Nginx cache? This will permanently delete all files in this directory.",
+  "Cache cleared successfully. Cleared {count} items.": "Cache cleared successfully. Cleared {count} items.",
+  "HTTP Purge request completed. Status: {status}": "HTTP Purge request completed. Status: {status}",
+  "Custom Cache Path": "Custom Cache Path",
+  "HTTP Method": "HTTP Method",
+  "Send Purge Request": "Send Purge Request",
+  "Please select or enter a cache path": "Please select or enter a cache path",
+  "Please enter a valid Purge URL": "Please enter a valid Purge URL",
+  "Nginx cache path is required": "Nginx cache path is required",
+  "Invalid headers JSON structure": "Invalid headers JSON structure",
+  "Nginx Cache Status": "Nginx Cache Status",
+  "Nginx is installed": "Nginx is installed",
+  "Nginx is NOT installed": "Nginx is NOT installed",
+  "Nginx cache clearing method": "Nginx cache clearing method",
+  "Execution Logs": "Execution Logs",
+  "Clear Nginx Cache?": "Clear Nginx Cache?",
+  "Rolling Restart": "Rolling Restart",
+  "Worker nodes only": "Worker nodes only",
+  "App nodes only": "App nodes only",
+  "Sandbox nodes only": "Sandbox nodes only",
+  "All nodes": "All nodes",
+  "Soft restart": "Soft restart",
+  "Hard restart": "Hard restart",
+  "Start rolling restart?": "Start rolling restart?",
+  "Nodes will receive restart commands one-by-one with the configured delay.": "Nodes will receive restart commands one-by-one with the configured delay.",
+  "Start": "Start",
+  "Rolling restart dispatched for {count} node(s)": "Rolling restart dispatched for {count} node(s)",
+  "Failed to dispatch rolling restart": "Failed to dispatch rolling restart",
+  "Cluster Drift": "Cluster Drift",
+  "No cluster drift detected": "No cluster drift detected",
+  "Cluster drift detected": "Cluster drift detected",
+  "Reference version": "Reference version",
+  "No reference version available": "No reference version available",
+  "Checked Nodes": "Checked Nodes",
+  "Version Drift": "Version Drift",
+  "Runtime Drift": "Runtime Drift",
+  "Package Drift": "Package Drift",
+  "Runtime": "Runtime",
+  "Role": "Role",
+  "Expected": "Expected",
+  "Actual": "Actual",
+  "Package Status": "Package Status",
+  "Missing Packages": "Missing Packages",
+  "No missing packages": "No missing packages",
+  "Legacy Multi-app Diagnostics": "Legacy Multi-app Diagnostics",
+  "No legacy multi-app risk detected": "No legacy multi-app risk detected",
+  "Legacy multi-app risk detected": "Legacy multi-app risk detected",
+  "Legacy app records": "Legacy app records",
+  "Deprecated multi-app manager is active. It runs apps in shared process memory and should not be used for production cluster isolation.": "Deprecated multi-app manager is active. It runs apps in shared process memory and should not be used for production cluster isolation.",
+  "Deprecated multi-app share collection is active. Avoid schema/table sharing for new cluster deployments.": "Deprecated multi-app share collection is active. Avoid schema/table sharing for new cluster deployments.",
+  "{count} legacy application record(s) were found in the applications collection.": "{count} legacy application record(s) were found in the applications collection.",
+  "App Supervisor is not enabled. Use it for new multi-application management instead of deprecated multi-app plugins.": "App Supervisor is not enabled. Use it for new multi-application management instead of deprecated multi-app plugins.",
+  "Doctor": "Doctor",
+  "Duration": "Duration",
+  "Start Doctor": "Start Doctor",
+  "Stop Doctor": "Stop Doctor",
+  "Download Report": "Download Report",
+  "Diagnostic session started": "Diagnostic session started",
+  "Diagnostic report is ready": "Diagnostic report is ready",
+  "Failed to load diagnostic status": "Failed to load diagnostic status",
+  "Failed to start diagnostic session": "Failed to start diagnostic session",
+  "Failed to stop diagnostic session": "Failed to stop diagnostic session",
+  "Failed to download diagnostic report": "Failed to download diagnostic report",
+  "Running": "Running",
+  "Run ID": "Run ID",
+  "Started At": "Started At",
+  "Finished At": "Finished At",
+  "Finish Reason": "Finish Reason",
+  "Report Status": "Report Status",
+  "Nodes": "Nodes",
+  "Errors": "Errors",
+  "Warnings": "Warnings",
+  "Plugin Drift": "Plugin Drift",
+  "Findings": "Findings",
+  "Node Log Distribution": "Node Log Distribution",
+  "Top Error Signatures": "Top Error Signatures",
+  "Level": "Level",
+  "Count": "Count",
+  "Signature": "Signature",
+  "Node": "Node",
+  "Log Files": "Log Files",
+  "Package": "Package",
+  "DB Version": "DB Version",
+  "Runtime Versions": "Runtime Versions"
 }

package/src/locale/vi-VN.json

@@ -91,5 +91,102 @@
   "Plugin force removed": "Đã buộc xóa plugin",
   "Failed to load plugins": "Tải danh sách plugin thất bại",
   "Failed to force disable plugin": "Buộc tắt plugin thất bại",
-  "Failed to force remove plugin": "Buộc xóa plugin thất bại"
+  "Failed to force remove plugin": "Buộc xóa plugin thất bại",
+  "Nginx Cache": "Bộ nhớ đệm Nginx",
+  "Nginx configuration file found at": "Tìm thấy tệp cấu hình Nginx tại",
+  "Nginx cache paths detected": "Đường dẫn bộ nhớ đệm Nginx phát hiện được",
+  "Nginx is not detected on this node. You can still input a custom cache directory.": "Không phát hiện Nginx trên nút này. Bạn vẫn có thể nhập đường dẫn bộ nhớ đệm tùy chỉnh.",
+  "Clearing Method": "Phương thức xóa",
+  "Physical Files": "Tệp vật lý",
+  "HTTP Purge Request": "Yêu cầu HTTP Purge",
+  "Select Cache Path": "Chọn đường dẫn cache",
+  "Custom Path": "Đường dẫn tùy chỉnh",
+  "Purge URL": "Purge URL",
+  "Headers (JSON)": "Headers (JSON)",
+  "Clear Nginx Cache": "Xóa bộ nhớ đệm Nginx",
+  "Are you sure you want to clear Nginx cache? This will permanently delete all files in this directory.": "Bạn có chắc chắn muốn xóa bộ nhớ đệm Nginx? Hành động này sẽ xóa vĩnh viễn toàn bộ tệp trong thư mục.",
+  "Cache cleared successfully. Cleared {count} items.": "Xóa bộ nhớ đệm thành công. Đã dọn dẹp {count} mục.",
+  "HTTP Purge request completed. Status: {status}": "Yêu cầu HTTP Purge hoàn tất. Trạng thái: {status}",
+  "Custom Cache Path": "Đường dẫn Cache tùy chỉnh",
+  "HTTP Method": "Phương thức HTTP",
+  "Send Purge Request": "Gửi yêu cầu Purge",
+  "Please select or enter a cache path": "Vui lòng chọn hoặc nhập đường dẫn cache",
+  "Please enter a valid Purge URL": "Vui lòng nhập Purge URL hợp lệ",
+  "Nginx cache path is required": "Yêu cầu đường dẫn cache Nginx",
+  "Invalid headers JSON structure": "Cấu trúc JSON headers không hợp lệ",
+  "Nginx Cache Status": "Trạng thái bộ nhớ đệm Nginx",
+  "Nginx is installed": "Nginx đã được cài đặt",
+  "Nginx is NOT installed": "Nginx CHƯA được cài đặt",
+  "Nginx cache clearing method": "Phương thức xóa bộ nhớ đệm Nginx",
+  "Execution Logs": "Nhật ký thực thi",
+  "Clear Nginx Cache?": "Xóa bộ nhớ đệm Nginx?"
+  ,
+  "Rolling Restart": "Rolling Restart",
+  "Worker nodes only": "Worker nodes only",
+  "App nodes only": "App nodes only",
+  "Sandbox nodes only": "Sandbox nodes only",
+  "All nodes": "All nodes",
+  "Soft restart": "Soft restart",
+  "Hard restart": "Hard restart",
+  "Start rolling restart?": "Start rolling restart?",
+  "Nodes will receive restart commands one-by-one with the configured delay.": "Nodes will receive restart commands one-by-one with the configured delay.",
+  "Start": "Start",
+  "Rolling restart dispatched for {count} node(s)": "Rolling restart dispatched for {count} node(s)",
+  "Failed to dispatch rolling restart": "Failed to dispatch rolling restart",
+  "Cluster Drift": "Cluster Drift",
+  "No cluster drift detected": "No cluster drift detected",
+  "Cluster drift detected": "Cluster drift detected",
+  "Reference version": "Reference version",
+  "No reference version available": "No reference version available",
+  "Checked Nodes": "Checked Nodes",
+  "Version Drift": "Version Drift",
+  "Runtime Drift": "Runtime Drift",
+  "Package Drift": "Package Drift",
+  "Runtime": "Runtime",
+  "Role": "Role",
+  "Expected": "Expected",
+  "Actual": "Actual",
+  "Package Status": "Package Status",
+  "Missing Packages": "Missing Packages",
+  "No missing packages": "No missing packages",
+  "Legacy Multi-app Diagnostics": "Legacy Multi-app Diagnostics",
+  "No legacy multi-app risk detected": "No legacy multi-app risk detected",
+  "Legacy multi-app risk detected": "Legacy multi-app risk detected",
+  "Legacy app records": "Legacy app records",
+  "Deprecated multi-app manager is active. It runs apps in shared process memory and should not be used for production cluster isolation.": "Deprecated multi-app manager is active. It runs apps in shared process memory and should not be used for production cluster isolation.",
+  "Deprecated multi-app share collection is active. Avoid schema/table sharing for new cluster deployments.": "Deprecated multi-app share collection is active. Avoid schema/table sharing for new cluster deployments.",
+  "{count} legacy application record(s) were found in the applications collection.": "{count} legacy application record(s) were found in the applications collection.",
+  "App Supervisor is not enabled. Use it for new multi-application management instead of deprecated multi-app plugins.": "App Supervisor is not enabled. Use it for new multi-application management instead of deprecated multi-app plugins.",
+  "Doctor": "Doctor",
+  "Duration": "Duration",
+  "Start Doctor": "Start Doctor",
+  "Stop Doctor": "Stop Doctor",
+  "Download Report": "Download Report",
+  "Diagnostic session started": "Diagnostic session started",
+  "Diagnostic report is ready": "Diagnostic report is ready",
+  "Failed to load diagnostic status": "Failed to load diagnostic status",
+  "Failed to start diagnostic session": "Failed to start diagnostic session",
+  "Failed to stop diagnostic session": "Failed to stop diagnostic session",
+  "Failed to download diagnostic report": "Failed to download diagnostic report",
+  "Running": "Running",
+  "Run ID": "Run ID",
+  "Started At": "Started At",
+  "Finished At": "Finished At",
+  "Finish Reason": "Finish Reason",
+  "Report Status": "Report Status",
+  "Nodes": "Nodes",
+  "Errors": "Errors",
+  "Warnings": "Warnings",
+  "Plugin Drift": "Plugin Drift",
+  "Findings": "Findings",
+  "Node Log Distribution": "Node Log Distribution",
+  "Top Error Signatures": "Top Error Signatures",
+  "Level": "Level",
+  "Count": "Count",
+  "Signature": "Signature",
+  "Node": "Node",
+  "Log Files": "Log Files",
+  "Package": "Package",
+  "DB Version": "DB Version",
+  "Runtime Versions": "Runtime Versions"
 }

package/src/locale/zh-CN.json

@@ -91,5 +91,102 @@
   "Plugin force removed": "插件已强制移除",
   "Failed to load plugins": "加载插件失败",
   "Failed to force disable plugin": "强制禁用插件失败",
-  "Failed to force remove plugin": "强制移除插件失败"
+  "Failed to force remove plugin": "强制移除插件失败",
+  "Nginx Cache": "Nginx 缓存",
+  "Nginx configuration file found at": "已找到 Nginx 配置文件于",
+  "Nginx cache paths detected": "检测到的 Nginx 缓存路径",
+  "Nginx is not detected on this node. You can still input a custom cache directory.": "此节点未检测到 Nginx。您仍可以输入自定义缓存目录。",
+  "Clearing Method": "清除方式",
+  "Physical Files": "物理文件",
+  "HTTP Purge Request": "HTTP Purge 请求",
+  "Select Cache Path": "选择缓存路径",
+  "Custom Path": "自定义路径",
+  "Purge URL": "Purge URL",
+  "Headers (JSON)": "Headers (JSON)",
+  "Clear Nginx Cache": "清除 Nginx 缓存",
+  "Are you sure you want to clear Nginx cache? This will permanently delete all files in this directory.": "确定要清除 Nginx 缓存吗？这将永久删除该目录下的所有文件。",
+  "Cache cleared successfully. Cleared {count} items.": "缓存清除成功。已清除 {count} 项。",
+  "HTTP Purge request completed. Status: {status}": "HTTP Purge 请求已完成。状态：{status}",
+  "Custom Cache Path": "自定义缓存路径",
+  "HTTP Method": "HTTP 方法",
+  "Send Purge Request": "发送 Purge 请求",
+  "Please select or enter a cache path": "请选择或输入缓存路径",
+  "Please enter a valid Purge URL": "请输入有效的 Purge URL",
+  "Nginx cache path is required": "必须提供 Nginx 缓存路径",
+  "Invalid headers JSON structure": "Headers JSON 结构无效",
+  "Nginx Cache Status": "Nginx 缓存状态",
+  "Nginx is installed": "Nginx 已安装",
+  "Nginx is NOT installed": "Nginx 未安装",
+  "Nginx cache clearing method": "Nginx 缓存清除方式",
+  "Execution Logs": "执行日志",
+  "Clear Nginx Cache?": "清除 Nginx 缓存？"
+,
+  "Rolling Restart": "Rolling Restart",
+  "Worker nodes only": "Worker nodes only",
+  "App nodes only": "App nodes only",
+  "Sandbox nodes only": "Sandbox nodes only",
+  "All nodes": "All nodes",
+  "Soft restart": "Soft restart",
+  "Hard restart": "Hard restart",
+  "Start rolling restart?": "Start rolling restart?",
+  "Nodes will receive restart commands one-by-one with the configured delay.": "Nodes will receive restart commands one-by-one with the configured delay.",
+  "Start": "Start",
+  "Rolling restart dispatched for {count} node(s)": "Rolling restart dispatched for {count} node(s)",
+  "Failed to dispatch rolling restart": "Failed to dispatch rolling restart",
+  "Cluster Drift": "Cluster Drift",
+  "No cluster drift detected": "No cluster drift detected",
+  "Cluster drift detected": "Cluster drift detected",
+  "Reference version": "Reference version",
+  "No reference version available": "No reference version available",
+  "Checked Nodes": "Checked Nodes",
+  "Version Drift": "Version Drift",
+  "Runtime Drift": "Runtime Drift",
+  "Package Drift": "Package Drift",
+  "Runtime": "Runtime",
+  "Role": "Role",
+  "Expected": "Expected",
+  "Actual": "Actual",
+  "Package Status": "Package Status",
+  "Missing Packages": "Missing Packages",
+  "No missing packages": "No missing packages",
+  "Legacy Multi-app Diagnostics": "Legacy Multi-app Diagnostics",
+  "No legacy multi-app risk detected": "No legacy multi-app risk detected",
+  "Legacy multi-app risk detected": "Legacy multi-app risk detected",
+  "Legacy app records": "Legacy app records",
+  "Deprecated multi-app manager is active. It runs apps in shared process memory and should not be used for production cluster isolation.": "Deprecated multi-app manager is active. It runs apps in shared process memory and should not be used for production cluster isolation.",
+  "Deprecated multi-app share collection is active. Avoid schema/table sharing for new cluster deployments.": "Deprecated multi-app share collection is active. Avoid schema/table sharing for new cluster deployments.",
+  "{count} legacy application record(s) were found in the applications collection.": "{count} legacy application record(s) were found in the applications collection.",
+  "App Supervisor is not enabled. Use it for new multi-application management instead of deprecated multi-app plugins.": "App Supervisor is not enabled. Use it for new multi-application management instead of deprecated multi-app plugins.",
+  "Doctor": "Doctor",
+  "Duration": "Duration",
+  "Start Doctor": "Start Doctor",
+  "Stop Doctor": "Stop Doctor",
+  "Download Report": "Download Report",
+  "Diagnostic session started": "Diagnostic session started",
+  "Diagnostic report is ready": "Diagnostic report is ready",
+  "Failed to load diagnostic status": "Failed to load diagnostic status",
+  "Failed to start diagnostic session": "Failed to start diagnostic session",
+  "Failed to stop diagnostic session": "Failed to stop diagnostic session",
+  "Failed to download diagnostic report": "Failed to download diagnostic report",
+  "Running": "Running",
+  "Run ID": "Run ID",
+  "Started At": "Started At",
+  "Finished At": "Finished At",
+  "Finish Reason": "Finish Reason",
+  "Report Status": "Report Status",
+  "Nodes": "Nodes",
+  "Errors": "Errors",
+  "Warnings": "Warnings",
+  "Plugin Drift": "Plugin Drift",
+  "Findings": "Findings",
+  "Node Log Distribution": "Node Log Distribution",
+  "Top Error Signatures": "Top Error Signatures",
+  "Level": "Level",
+  "Count": "Count",
+  "Signature": "Signature",
+  "Node": "Node",
+  "Log Files": "Log Files",
+  "Package": "Package",
+  "DB Version": "DB Version",
+  "Runtime Versions": "Runtime Versions"
 }

package/src/server/__tests__/doctor.test.ts

@@ -0,0 +1,53 @@
+import { createMockServer, MockServer } from '@nocobase/test';
+import PluginClusterManagerServer from '../plugin';
+
+describe('plugin-cluster-manager doctor', () => {
+  let app: MockServer;
+
+  beforeEach(async () => {
+    app = await createMockServer({
+      plugins: ['error-handler', PluginClusterManagerServer],
+      acl: false,
+    });
+  });
+
+  afterEach(async () => {
+    await app?.destroy();
+  });
+
+  it('runs one diagnostic session at a time and produces a downloadable report', async () => {
+    const agent = app.agent();
+
+    const started = await agent.resource('clusterManagerDoctor').start({
+      values: { durationMs: 10000 },
+    });
+    expect(started.status).toBe(200);
+    expect(started.body.data.status).toBe('running');
+    expect(started.body.data.runId).toBeTruthy();
+
+    const rejected = await agent.resource('clusterManagerDoctor').start({
+      values: { durationMs: 10000 },
+    });
+    expect(rejected.status).toBe(409);
+
+    const stopped = await agent.resource('clusterManagerDoctor').stop({
+      values: { runId: started.body.data.runId },
+    });
+    expect(stopped.status).toBe(200);
+    expect(stopped.body.data.status).toBe('finished');
+    expect(stopped.body.data.report.summary.nodes).toBeGreaterThan(0);
+    expect(stopped.body.data.report.runId).toBe(started.body.data.runId);
+
+    const report = await agent.resource('clusterManagerDoctor').report({
+      runId: started.body.data.runId,
+    });
+    expect(report.status).toBe(200);
+    expect(report.body.data.report.summary).toBeTruthy();
+
+    const download = await agent.resource('clusterManagerDoctor').download({
+      runId: started.body.data.runId,
+    });
+    expect(download.status).toBe(200);
+    expect(download.headers['content-type']).toContain('application/json');
+  });
+});