@qwickapps/server 1.6.0 → 1.6.1

package/src/plugins/profiles/profiles-plugin.ts

@@ -72,7 +72,7 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
   const debug = config.debug || false;
   const maxProfilesPerUser = config.maxProfilesPerUser || 10;
   const defaultFilterLevel = config.defaultFilterLevel || 'moderate';
-  const apiPrefix = config.api?.prefix || '/profiles';
+  const apiPrefix = config.api?.prefix || '/'; // Framework adds /profiles prefix automatically
 
   function log(message: string, data?: Record<string, unknown>) {
     if (debug) {

package/src/plugins/qwickbrain/QwickbrainManagementPage.test.tsx

@@ -0,0 +1,58 @@
+/**
+ * QwickbrainManagementPage Tests
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { render, screen, waitFor } from '@testing-library/react';
+import { QwickbrainManagementPage } from './QwickbrainManagementPage';
+
+describe('QwickbrainManagementPage', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('renders page title', () => {
+    (global.fetch as ReturnType<typeof vi.fn>).mockImplementation(
+      () => Promise.resolve({
+        ok: true,
+        json: async () => ([]),
+      })
+    );
+
+    render(<QwickbrainManagementPage apiPrefix="/api/qwickbrain" />);
+
+    expect(screen.getByText('QwickBrain AI Management')).toBeInTheDocument();
+  });
+
+  it('fetches repositories and stats on mount', async () => {
+    (global.fetch as ReturnType<typeof vi.fn>).mockImplementation(
+      () => Promise.resolve({
+        ok: true,
+        json: async () => ([]),
+      })
+    );
+
+    render(<QwickbrainManagementPage apiPrefix="/api/qwickbrain" />);
+
+    await waitFor(() => {
+      expect(global.fetch).toHaveBeenCalled();
+    });
+  });
+
+  it('renders with custom apiPrefix', async () => {
+    (global.fetch as ReturnType<typeof vi.fn>).mockImplementation(
+      () => Promise.resolve({
+        ok: true,
+        json: async () => ([]),
+      })
+    );
+
+    render(<QwickbrainManagementPage apiPrefix="/custom/qwickbrain" />);
+
+    await waitFor(() => {
+      expect(global.fetch).toHaveBeenCalled();
+    });
+  });
+});

package/src/plugins/qwickbrain/QwickbrainManagementPage.tsx

@@ -0,0 +1,126 @@
+/**
+ * QwickBrain Management Page Component
+ * Manage AI documents, repositories, and query analytics
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+import React, { useEffect, useState } from 'react';
+import { PluginManagementPage } from '@qwickapps/server/ui';
+import { DataTable, StatCard, type Column } from '@qwickapps/react-framework';
+
+export interface QwickbrainManagementPageProps {
+  apiPrefix?: string;
+}
+
+interface Repository {
+  id: string;
+  name: string;
+  owner: string;
+  status: 'indexed' | 'indexing' | 'failed';
+  document_count: number;
+  last_updated: string;
+}
+
+interface QwickbrainStats {
+  totalDocuments: number;
+  indexedRepositories: number;
+  queriesToday: number;
+  cacheHitRate: number;
+}
+
+export const QwickbrainManagementPage: React.FC<QwickbrainManagementPageProps> = ({
+  apiPrefix = '/api/qwickbrain',
+}) => {
+  const [repositories, setRepositories] = useState<Repository[]>([]);
+  const [stats, setStats] = useState<QwickbrainStats | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [statusFilter, setStatusFilter] = useState<string>('');
+
+  const fetchRepositories = async () => {
+    try {
+      const response = await fetch(`${apiPrefix}/repositories`);
+      if (!response.ok) throw new Error('Failed to fetch repositories');
+      const data = await response.json();
+      setRepositories(data);
+    } catch (error) {
+      console.error('Error fetching repositories:', error);
+    }
+  };
+
+  const fetchStats = async () => {
+    try {
+      const response = await fetch(`${apiPrefix}/stats`);
+      if (!response.ok) throw new Error('Failed to fetch stats');
+      const data = await response.json();
+      setStats(data);
+    } catch (error) {
+      console.error('Error fetching stats:', error);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    fetchRepositories();
+    fetchStats();
+  }, [apiPrefix]);
+
+  const columns: Column<Repository>[] = [
+    { key: 'name', label: 'Repository' },
+    { key: 'owner', label: 'Owner' },
+    { key: 'status', label: 'Status' },
+    { key: 'document_count', label: 'Documents' },
+  ];
+
+  const filteredRepositories = statusFilter
+    ? repositories.filter((r) => r.status === statusFilter)
+    : repositories;
+
+  return (
+    <PluginManagementPage title="QwickBrain AI Management">
+      <div className="grid grid-cols-1 md:grid-cols-4 gap-4 mb-6">
+        <StatCard
+            label="Total Documents"
+          value={stats?.totalDocuments ?? 0}
+        />
+        <StatCard
+            label="Indexed Repos"
+          value={stats?.indexedRepositories ?? 0}
+          status="healthy"
+        />
+        <StatCard
+            label="Queries Today"
+          value={stats?.queriesToday ?? 0}
+          status="info"
+        />
+        <StatCard
+            label="Cache Hit Rate"
+          value={stats?.cacheHitRate ? `${stats.cacheHitRate}%` : '0%'}
+          status="healthy"
+        />
+      </div>
+
+      <div className="mb-4">
+        <select
+          value={statusFilter}
+          onChange={(e) => setStatusFilter(e.target.value)}
+          className="px-4 py-2 border rounded"
+        >
+          <option value="">All Statuses</option>
+          <option value="indexed">Indexed</option>
+          <option value="indexing">Indexing</option>
+          <option value="failed">Failed</option>
+        </select>
+      </div>
+
+      <DataTable
+        columns={columns}
+        data={filteredRepositories}
+        loading={loading}
+      />
+    </PluginManagementPage>
+  );
+};
+
+export default QwickbrainManagementPage;

package/src/plugins/qwickbrain/QwickbrainStatusWidget.test.tsx

@@ -0,0 +1,109 @@
+/**
+ * QwickbrainStatusWidget Tests
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { render, screen, waitFor } from '@testing-library/react';
+import { QwickbrainStatusWidget } from './QwickbrainStatusWidget';
+
+describe('QwickbrainStatusWidget', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('renders loading state initially', () => {
+    (global.fetch as ReturnType<typeof vi.fn>).mockImplementation(
+      () => new Promise(() => {})
+    );
+
+    render(<QwickbrainStatusWidget apiPrefix="/api/qwickbrain" />);
+
+    expect(screen.getByText(/QwickBrain AI Loading/)).toBeInTheDocument();
+  });
+
+  it('fetches and displays stats successfully', async () => {
+    const mockStats = {
+      totalDocuments: 5000,
+      indexedRepositories: 25,
+      queriesToday: 150,
+      cacheHitRate: 85,
+      health: 'healthy' as const,
+    };
+
+    (global.fetch as ReturnType<typeof vi.fn>).mockResolvedValueOnce({
+      ok: true,
+      json: async () => mockStats,
+    });
+
+    render(<QwickbrainStatusWidget apiPrefix="/api/qwickbrain" />);
+
+    await waitFor(() => {
+      expect(screen.getByText('QwickBrain AI')).toBeInTheDocument();
+      expect(screen.getByText(/Documents: 5000/)).toBeInTheDocument();
+      expect(screen.getByText(/Repositories: 25/)).toBeInTheDocument();
+      expect(screen.getByText(/Queries Today: 150/)).toBeInTheDocument();
+      expect(screen.getByText(/Cache Hit Rate: 85%/)).toBeInTheDocument();
+    });
+
+    expect(global.fetch).toHaveBeenCalledWith('/api/qwickbrain/stats');
+  });
+
+  it('handles fetch error', async () => {
+    (global.fetch as ReturnType<typeof vi.fn>).mockRejectedValueOnce(
+      new Error('QwickBrain service error')
+    );
+
+    render(<QwickbrainStatusWidget apiPrefix="/api/qwickbrain" />);
+
+    await waitFor(() => {
+      expect(screen.getByText(/QwickBrain service error/)).toBeInTheDocument();
+    });
+  });
+
+  it('uses custom apiPrefix', async () => {
+    const mockStats = {
+      totalDocuments: 2000,
+      indexedRepositories: 10,
+      queriesToday: 50,
+      cacheHitRate: 75,
+      health: 'healthy' as const,
+    };
+
+    (global.fetch as ReturnType<typeof vi.fn>).mockResolvedValueOnce({
+      ok: true,
+      json: async () => mockStats,
+    });
+
+    render(<QwickbrainStatusWidget apiPrefix="/custom/qwickbrain" />);
+
+    await waitFor(() => {
+      expect(global.fetch).toHaveBeenCalledWith('/custom/qwickbrain/stats');
+    });
+  });
+
+  it('displays all QwickBrain metrics correctly', async () => {
+    const mockStats = {
+      totalDocuments: 10000,
+      indexedRepositories: 50,
+      queriesToday: 300,
+      cacheHitRate: 95,
+      health: 'healthy' as const,
+    };
+
+    (global.fetch as ReturnType<typeof vi.fn>).mockResolvedValueOnce({
+      ok: true,
+      json: async () => mockStats,
+    });
+
+    render(<QwickbrainStatusWidget apiPrefix="/api/qwickbrain" />);
+
+    await waitFor(() => {
+      expect(screen.getByText(/Documents: 10000/)).toBeInTheDocument();
+      expect(screen.getByText(/Repositories: 50/)).toBeInTheDocument();
+      expect(screen.getByText(/Queries Today: 300/)).toBeInTheDocument();
+      expect(screen.getByText(/Cache Hit Rate: 95%/)).toBeInTheDocument();
+    });
+  });
+});

package/src/plugins/qwickbrain/QwickbrainStatusWidget.tsx

@@ -0,0 +1,52 @@
+/**
+ * QwickbrainStatusWidget - Dashboard widget for QwickBrain AI overview
+ */
+
+import React, { useEffect, useState } from 'react';
+import { PluginStatusWidget } from '@qwickapps/server/ui';
+
+export interface QwickbrainStatusWidgetProps {
+  /** API endpoint prefix (default: '/api/qwickbrain') */
+  apiPrefix?: string;
+}
+
+export function QwickbrainStatusWidget({ apiPrefix = '/api/qwickbrain' }: QwickbrainStatusWidgetProps) {
+  const [stats, setStats] = useState<{
+    totalDocuments: number;
+    indexedRepositories: number;
+    queriesToday: number;
+    cacheHitRate: number;
+    health: 'healthy' | 'warning' | 'error';
+  } | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    fetch(`${apiPrefix}/stats`)
+      .then((res) => res.json())
+      .then((data) => {
+        setStats(data);
+        setLoading(false);
+      })
+      .catch((err) => {
+        setError(err.message);
+        setLoading(false);
+      });
+  }, [apiPrefix]);
+
+  return (
+    <PluginStatusWidget
+      title="QwickBrain AI"
+      stats={[
+        { label: 'Documents', value: stats?.totalDocuments ?? 0 },
+        { label: 'Repositories', value: stats?.indexedRepositories ?? 0 },
+        { label: 'Queries Today', value: stats?.queriesToday ?? 0 },
+        { label: 'Cache Hit Rate', value: stats?.cacheHitRate ? `${stats.cacheHitRate}%` : '0%' },
+      ]}
+      health={stats?.health ?? 'error'}
+      loading={loading}
+      error={error}
+      detailsPath="/cpanel/plugins/qwickbrain"
+    />
+  );
+}

package/src/plugins/qwickbrain/index.ts

@@ -31,3 +31,9 @@ export type {
   QwickBrainConnectionStatus,
   MCPRateLimitConfig,
 } from './types.js';
+
+// UI Components
+export { QwickbrainStatusWidget } from './QwickbrainStatusWidget.js';
+export { QwickbrainManagementPage } from './QwickbrainManagementPage.js';
+export type { QwickbrainStatusWidgetProps } from './QwickbrainStatusWidget.js';
+export type { QwickbrainManagementPageProps } from './QwickbrainManagementPage.js';

package/src/plugins/qwickbrain/qwickbrain-plugin.ts

@@ -23,7 +23,6 @@ import type { AuthenticatedUser } from '../auth/types.js';
 let connectionStatus: QwickBrainConnectionStatus = {
   connected: false,
   lastCheck: new Date(),
-  tailscaleStatus: 'unknown',
 };
 
 // Health check interval
@@ -94,24 +93,6 @@ async function proxyToQwickBrain(
   }
 }
 
-/**
- * Check Tailscale connectivity status
- */
-async function checkTailscaleStatus(): Promise<'connected' | 'disconnected' | 'unknown'> {
-  try {
-    const { exec } = await import('child_process');
-    const { promisify } = await import('util');
-    const execAsync = promisify(exec);
-
-    const { stdout } = await execAsync('tailscale status --json', { timeout: 5000 });
-    const status = JSON.parse(stdout);
-
-    return status.BackendState === 'Running' ? 'connected' : 'disconnected';
-  } catch {
-    return 'unknown';
-  }
-}
-
 /**
  * Check QwickBrain connectivity
  */
@@ -297,6 +278,18 @@ export function createQwickBrainPlugin(config: QwickBrainPluginConfig): Plugin {
     configurable: {
       slug: true,  // Allow users to customize slug via UI
     },
+    scopes: [
+      {
+        name: 'qwickbrain:read',
+        description: 'Read access to MCP tools list, status, and health information',
+        category: 'read' as const,
+      },
+      {
+        name: 'qwickbrain:execute',
+        description: 'Execute MCP tools (search_codebase, explain_function, etc.)',
+        category: 'write' as const,
+      },
+    ],
 
     async onStart(_pluginConfig: PluginConfig, registry: PluginRegistry): Promise<void> {
       log('Starting QwickBrain plugin');
@@ -327,7 +320,6 @@ export function createQwickBrainPlugin(config: QwickBrainPluginConfig): Plugin {
       }, 300000); // 5 minutes
 
       // Initial health check
-      const tailscaleStatus = await checkTailscaleStatus();
       const healthResult = await checkQwickBrainHealth(config.qwickbrainUrl, timeout);
 
       connectionStatus = {
@@ -335,14 +327,12 @@ export function createQwickBrainPlugin(config: QwickBrainPluginConfig): Plugin {
         lastCheck: new Date(),
         latencyMs: healthResult.latencyMs,
         error: healthResult.error,
-        tailscaleStatus,
       };
 
       log('Initial connection status', connectionStatus as unknown as Record<string, unknown>);
 
       // Set up periodic health check
       healthCheckInterval = setInterval(async () => {
-        const tsStatus = await checkTailscaleStatus();
         const health = await checkQwickBrainHealth(config.qwickbrainUrl, timeout);
 
         connectionStatus = {
@@ -350,7 +340,6 @@ export function createQwickBrainPlugin(config: QwickBrainPluginConfig): Plugin {
           lastCheck: new Date(),
           latencyMs: health.latencyMs,
           error: health.error,
-          tailscaleStatus: tsStatus,
         };
       }, 30000); // Check every 30 seconds
 
@@ -368,17 +357,6 @@ export function createQwickBrainPlugin(config: QwickBrainPluginConfig): Plugin {
         },
       });
 
-      registry.registerHealthCheck({
-        name: 'qwickbrain-tailscale',
-        type: 'custom',
-        check: async () => {
-          const status = await checkTailscaleStatus();
-          return {
-            healthy: status === 'connected',
-            status,
-          };
-        },
-      });
 
       // Add API routes if enabled
       if (apiEnabled) {
@@ -392,7 +370,6 @@ export function createQwickBrainPlugin(config: QwickBrainPluginConfig): Plugin {
               connected: connectionStatus.connected,
               lastCheck: connectionStatus.lastCheck.toISOString(),
               latencyMs: connectionStatus.latencyMs,
-              tailscaleStatus: connectionStatus.tailscaleStatus,
               error: connectionStatus.error,
             });
           },
@@ -615,7 +592,6 @@ export function createQwickBrainPlugin(config: QwickBrainPluginConfig): Plugin {
       connectionStatus = {
         connected: false,
         lastCheck: new Date(),
-        tailscaleStatus: 'unknown',
       };
 
       log('QwickBrain plugin stopped');

package/src/plugins/qwickbrain/types.ts

@@ -119,7 +119,6 @@ export interface QwickBrainConnectionStatus {
   lastCheck: Date;
   latencyMs?: number;
   error?: string;
-  tailscaleStatus?: 'connected' | 'disconnected' | 'unknown';
 }
 
 /**

package/src/plugins/rate-limit/RateLimitManagementPage.test.tsx

@@ -0,0 +1,58 @@
+/**
+ * RateLimitManagementPage Tests
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { render, screen, waitFor } from '@testing-library/react';
+import { RateLimitManagementPage } from './RateLimitManagementPage';
+
+describe('RateLimitManagementPage', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('renders page title', () => {
+    (global.fetch as ReturnType<typeof vi.fn>).mockImplementation(
+      () => Promise.resolve({
+        ok: true,
+        json: async () => ([]),
+      })
+    );
+
+    render(<RateLimitManagementPage apiPrefix="/api/rate-limit" />);
+
+    expect(screen.getByText('Rate Limiting Management')).toBeInTheDocument();
+  });
+
+  it('fetches rules and stats on mount', async () => {
+    (global.fetch as ReturnType<typeof vi.fn>).mockImplementation(
+      () => Promise.resolve({
+        ok: true,
+        json: async () => ([]),
+      })
+    );
+
+    render(<RateLimitManagementPage apiPrefix="/api/rate-limit" />);
+
+    await waitFor(() => {
+      expect(global.fetch).toHaveBeenCalled();
+    });
+  });
+
+  it('renders with custom apiPrefix', async () => {
+    (global.fetch as ReturnType<typeof vi.fn>).mockImplementation(
+      () => Promise.resolve({
+        ok: true,
+        json: async () => ([]),
+      })
+    );
+
+    render(<RateLimitManagementPage apiPrefix="/custom/rate-limit" />);
+
+    await waitFor(() => {
+      expect(global.fetch).toHaveBeenCalled();
+    });
+  });
+});

package/src/plugins/rate-limit/RateLimitManagementPage.tsx

@@ -0,0 +1,127 @@
+/**
+ * Rate Limit Management Page Component
+ * Manage rate limiting rules and monitor request patterns
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+import React, { useEffect, useState } from 'react';
+import { PluginManagementPage } from '@qwickapps/server/ui';
+import { DataTable, StatCard, type Column } from '@qwickapps/react-framework';
+
+export interface RateLimitManagementPageProps {
+  apiPrefix?: string;
+}
+
+interface RateLimitRule {
+  id: string;
+  name: string;
+  endpoint: string;
+  limit: number;
+  window: string;
+  status: 'active' | 'inactive';
+  hits_today: number;
+}
+
+interface RateLimitStats {
+  totalRequests: number;
+  blockedRequests: number;
+  activeRules: number;
+  requestsToday: number;
+}
+
+export const RateLimitManagementPage: React.FC<RateLimitManagementPageProps> = ({
+  apiPrefix = '/api/rate-limit',
+}) => {
+  const [rules, setRules] = useState<RateLimitRule[]>([]);
+  const [stats, setStats] = useState<RateLimitStats | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [statusFilter, setStatusFilter] = useState<string>('');
+
+  const fetchRules = async () => {
+    try {
+      const response = await fetch(`${apiPrefix}/rules`);
+      if (!response.ok) throw new Error('Failed to fetch rules');
+      const data = await response.json();
+      setRules(data);
+    } catch (error) {
+      console.error('Error fetching rules:', error);
+    }
+  };
+
+  const fetchStats = async () => {
+    try {
+      const response = await fetch(`${apiPrefix}/stats`);
+      if (!response.ok) throw new Error('Failed to fetch stats');
+      const data = await response.json();
+      setStats(data);
+    } catch (error) {
+      console.error('Error fetching stats:', error);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    fetchRules();
+    fetchStats();
+  }, [apiPrefix]);
+
+  const columns: Column<RateLimitRule>[] = [
+    { key: 'name', label: 'Rule Name' },
+    { key: 'endpoint', label: 'Endpoint' },
+    { key: 'limit', label: 'Limit' },
+    { key: 'window', label: 'Window' },
+    { key: 'status', label: 'Status' },
+  ];
+
+  const filteredRules = statusFilter
+    ? rules.filter((r) => r.status === statusFilter)
+    : rules;
+
+  return (
+    <PluginManagementPage title="Rate Limiting Management">
+      <div className="grid grid-cols-1 md:grid-cols-4 gap-4 mb-6">
+        <StatCard
+            label="Total Requests"
+          value={stats?.totalRequests ?? 0}
+        />
+        <StatCard
+            label="Blocked Requests"
+          value={stats?.blockedRequests ?? 0}
+          status="warning"
+        />
+        <StatCard
+            label="Active Rules"
+          value={stats?.activeRules ?? 0}
+          status="healthy"
+        />
+        <StatCard
+            label="Requests Today"
+          value={stats?.requestsToday ?? 0}
+          status="info"
+        />
+      </div>
+
+      <div className="mb-4">
+        <select
+          value={statusFilter}
+          onChange={(e) => setStatusFilter(e.target.value)}
+          className="px-4 py-2 border rounded"
+        >
+          <option value="">All Statuses</option>
+          <option value="active">Active</option>
+          <option value="inactive">Inactive</option>
+        </select>
+      </div>
+
+      <DataTable
+        columns={columns}
+        data={filteredRules}
+        loading={loading}
+      />
+    </PluginManagementPage>
+  );
+};
+
+export default RateLimitManagementPage;