@dcyfr/ai 1.0.2 → 1.0.4

package/dist/ai/mcp/servers/shared/redis-client.js

@@ -0,0 +1,225 @@
+/**
+ * Upstash Redis client for MCP servers and main app
+ * Supports multi-environment setup with automatic key namespacing
+ *
+ * Environments:
+ * - Production: Dedicated database (no key prefix)
+ * - Preview: Shared database with preview:{PR}:* prefix
+ * - Development: Shared database with dev:{username}:* prefix
+ * - Test: In-memory fallback (no Redis)
+ *
+ * Upstash provides serverless Redis with HTTP-based REST API, perfect for
+ * Vercel Edge Functions and serverless deployments (no persistent connections needed)
+ */
+import { Redis } from '@upstash/redis';
+/**
+ * Upstash Redis client instance
+ * Lazy-initialized on first use to avoid connection in build/test environments
+ */
+let redisClient = null;
+/**
+ * Get environment-specific Redis credentials
+ * Returns null for test environment (uses in-memory fallback)
+ */
+function getRedisCredentials() {
+    const isProduction = process.env.NODE_ENV === 'production' && process.env.VERCEL_ENV === 'production';
+    const isPreview = process.env.VERCEL_ENV === 'preview';
+    const isDevelopment = process.env.NODE_ENV === 'development';
+    const isTest = process.env.NODE_ENV === 'test';
+    // Test environment: No Redis (in-memory fallback)
+    if (isTest) {
+        return null;
+    }
+    // Production: Use production credentials
+    if (isProduction) {
+        const url = process.env.UPSTASH_REDIS_REST_URL;
+        const token = process.env.UPSTASH_REDIS_REST_TOKEN;
+        if (!url || !token) {
+            console.error('❌ CRITICAL: Production Redis credentials missing');
+            return null;
+        }
+        return { url, token };
+    }
+    // Preview: Use preview credentials with production fallback
+    if (isPreview) {
+        const url = process.env.UPSTASH_REDIS_REST_URL_PREVIEW;
+        const token = process.env.UPSTASH_REDIS_REST_TOKEN_PREVIEW;
+        if (url && token) {
+            console.warn('Preview Redis connected (shared preview database)');
+            return { url, token };
+        }
+        // ✅ FIX: Check production credentials exist before using as fallback
+        const prodUrl = process.env.UPSTASH_REDIS_REST_URL;
+        const prodToken = process.env.UPSTASH_REDIS_REST_TOKEN;
+        if (prodUrl && prodToken) {
+            console.warn('⚠️ Preview Redis not configured, using production credentials (unsafe!)');
+            return { url: prodUrl, token: prodToken };
+        }
+        // No credentials available
+        console.error('❌ Preview Redis credentials missing (UPSTASH_REDIS_REST_URL_PREVIEW and UPSTASH_REDIS_REST_TOKEN_PREVIEW)');
+        return null;
+    }
+    // Development: Use shared preview database with key namespacing
+    // Graceful degradation: features disabled, no errors
+    if (isDevelopment) {
+        const url = process.env.UPSTASH_REDIS_REST_URL_PREVIEW;
+        const token = process.env.UPSTASH_REDIS_REST_TOKEN_PREVIEW;
+        if (url && token) {
+            console.warn('Development Redis connected (shared preview database)');
+            return { url, token };
+        }
+        // Graceful degradation: No warning in production logs
+        if (process.env.NODE_ENV !== 'test') {
+            console.warn('ℹ️ Development Redis not configured, analytics/caching disabled');
+        }
+        return null;
+    }
+    return null;
+}
+/**
+ * Get environment-specific key prefix for Redis isolation
+ *
+ * SIMPLIFIED ARCHITECTURE (2026-01-30):
+ * - Production: No prefix (dedicated database)
+ * - Everything else (Dev + Preview): 'preview:' prefix (SHARED)
+ *
+ * This allows dev and preview to share the same cached data,
+ * reducing complexity and ensuring consistency across environments.
+ *
+ * FIX (2026-02-01): More defensive production check to prevent prefix in production
+ */
+export function getRedisKeyPrefix() {
+    // ✅ DEFENSIVE: Multiple checks to ensure production is detected correctly
+    // Priority order: VERCEL_ENV (most reliable) > NODE_ENV (fallback)
+    const isProduction = process.env.VERCEL_ENV === 'production' ||
+        (process.env.NODE_ENV === 'production' &&
+            (!process.env.VERCEL_ENV || process.env.VERCEL_ENV !== 'preview'));
+    if (isProduction) {
+        return ''; // No prefix for production (dedicated database)
+    }
+    // ✅ SIMPLIFIED: All non-production environments share 'preview:' prefix
+    // This includes: local development, preview deployments, CI/CD
+    return 'preview:';
+}
+/**
+ * Get or create Upstash Redis client
+ * Returns null if Redis not configured (graceful degradation)
+ */
+function getRedisClient() {
+    const credentials = getRedisCredentials();
+    if (!credentials) {
+        // Graceful degradation: Redis not configured (expected in development/test)
+        // Only log once to avoid console spam during module initialization
+        if (!redisClient && process.env.NODE_ENV === 'development') {
+            console.warn('[Redis] No credentials configured (using fallback)', {
+                environment: getRedisEnvironment(),
+            });
+        }
+        return null;
+    }
+    if (!redisClient) {
+        console.warn('[Redis] Client initialized', {
+            environment: getRedisEnvironment(),
+            urlPrefix: credentials.url.substring(0, 30),
+            keyPrefix: getRedisKeyPrefix(),
+        });
+        redisClient = new Redis({
+            url: credentials.url,
+            token: credentials.token,
+        });
+    }
+    return redisClient;
+}
+/**
+ * Upstash Redis client with environment-aware key prefixing
+ * Auto-initializes on first use with environment credentials
+ *
+ * Compatible with standard Redis API:
+ * - get, set, setex, del
+ * - incr, zadd, zrange, lpush, lrange
+ * - All operations work via HTTP REST API
+ *
+ * Automatic key namespacing:
+ * - Production: no prefix (dedicated database)
+ * - Preview: preview:{PR}:key
+ * - Development: dev:{username}:key
+ */
+export const redis = new Proxy({}, {
+    get(_target, prop) {
+        const client = getRedisClient();
+        // Graceful degradation: return no-op functions when Redis unavailable
+        if (!client) {
+            if (prop === 'ping') {
+                return async () => {
+                    throw new Error('Redis not configured');
+                };
+            }
+            // Return generic no-op async function for method calls when Redis unavailable
+            // This prevents "redis.get is not a function" errors in tests and allows
+            // code to gracefully handle missing cache (receives null result).
+            return async (..._args) => null;
+        }
+        const value = client[prop];
+        if (typeof value === 'function') {
+            // Intercept methods that use keys and add environment prefix
+            const keyMethods = [
+                'get',
+                'set',
+                'setex',
+                'del',
+                'incr',
+                'decr',
+                'zadd',
+                'zrange',
+                'zrangebyscore',
+                'zrem',
+                'lpush',
+                'rpush',
+                'lrange',
+                'llen',
+                'hget',
+                'hset',
+                'hdel',
+                'hgetall',
+                'expire',
+                'ttl',
+                'exists',
+            ];
+            if (keyMethods.includes(prop)) {
+                return function (key, ...args) {
+                    const prefixedKey = getRedisKeyPrefix() + key;
+                    return value.call(client, prefixedKey, ...args);
+                };
+            }
+            return value.bind(client);
+        }
+        return value;
+    },
+});
+/**
+ * Get current Redis environment for debugging
+ * Returns: 'production' | 'preview' | 'development' | 'test' | 'unknown'
+ */
+export function getRedisEnvironment() {
+    if (process.env.NODE_ENV === 'test')
+        return 'test';
+    if (process.env.NODE_ENV === 'production' && process.env.VERCEL_ENV === 'production') {
+        return 'production';
+    }
+    if (process.env.VERCEL_ENV === 'preview')
+        return 'preview';
+    if (process.env.NODE_ENV === 'development')
+        return 'development';
+    return 'unknown';
+}
+/**
+ * Close Redis connection (for cleanup)
+ * Note: Upstash uses HTTP, so no persistent connection to close
+ * This is kept for API compatibility with previous implementation
+ */
+export async function closeRedisClient() {
+    // Upstash uses HTTP REST API, no persistent connection to close
+    // Just reset the client instance
+    redisClient = null;
+}
+//# sourceMappingURL=redis-client.js.map

package/dist/ai/mcp/servers/shared/redis-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-client.js","sourceRoot":"","sources":["../../../../../packages/ai/mcp/servers/shared/redis-client.ts"],"names":[],"mappings":"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"}

package/dist/ai/mcp/servers/shared/types.d.ts

@@ -0,0 +1,292 @@
+/**
+ * Shared TypeScript types for MCP servers
+ * Used across Analytics, Design Token, and Content Manager MCPs
+ */
+export interface MCPContext {
+    sessionId?: string;
+    requestId?: string;
+    session?: Record<string, unknown>;
+}
+export interface MCPError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+export type TimeRange = "1h" | "24h" | "7d" | "30d" | "all";
+export interface PageViewData {
+    path: string;
+    views: number;
+    timeRange: TimeRange;
+    trend?: {
+        direction: "up" | "down" | "stable";
+        percentage: number;
+    };
+}
+export interface TrendingContent {
+    path: string;
+    title?: string;
+    views: number;
+    rank: number;
+}
+export interface EngagementMetric {
+    type: "click" | "share" | "interaction";
+    count: number;
+    path?: string;
+}
+export interface ActivityLog {
+    id: string;
+    type: string;
+    timestamp: number;
+    data: Record<string, unknown>;
+}
+export interface Milestone {
+    id: string;
+    title: string;
+    description: string;
+    achievedAt: number;
+    category: string;
+    isTest?: boolean;
+}
+export interface AnalyticsSummary {
+    totalViews: number;
+    topPages: TrendingContent[];
+    recentActivity: ActivityLog[];
+    milestones: Milestone[];
+    generatedAt: number;
+}
+export type TokenCategory = "spacing" | "typography" | "colors" | "containerWidths" | "breakpoints" | "animation";
+export interface TokenViolation {
+    line: number;
+    column?: number;
+    hardcodedValue: string;
+    suggestedToken: string;
+    category: TokenCategory;
+    severity: "error" | "warning";
+}
+export interface TokenValidationResult {
+    isValid: boolean;
+    compliance: number;
+    violations: TokenViolation[];
+    totalChecks: number;
+}
+export interface TokenSuggestion {
+    tokenName: string;
+    tokenValue: string;
+    category: TokenCategory;
+    confidence: number;
+    usage: string;
+}
+export interface TokenUsage {
+    tokenName: string;
+    category: TokenCategory;
+    files: string[];
+    count: number;
+}
+export interface ComplianceReport {
+    overall: number;
+    byCategory: Record<TokenCategory, number>;
+    totalViolations: number;
+    recentViolations: TokenViolation[];
+    trend: {
+        direction: "improving" | "declining" | "stable";
+        changePercent: number;
+    };
+}
+export type ContentType = "blog" | "project";
+export interface ContentMetadata {
+    title: string;
+    description?: string;
+    date: string;
+    author?: string;
+    tags?: string[];
+    category?: string;
+    readingTime?: number;
+    wordCount?: number;
+}
+export interface ContentItem {
+    filePath: string;
+    type: ContentType;
+    slug: string;
+    metadata: ContentMetadata;
+    excerpt?: string;
+}
+export interface ContentAnalysis {
+    filePath: string;
+    metadata: ContentMetadata;
+    wordCount: number;
+    readingTime: number;
+    topics: string[];
+    links: {
+        internal: number;
+        external: number;
+    };
+    headings: {
+        h1: number;
+        h2: number;
+        h3: number;
+    };
+}
+export interface RelatedContent {
+    content: ContentItem;
+    relevanceScore: number;
+    sharedTopics: string[];
+}
+export interface TopicTaxonomy {
+    topic: string;
+    count: number;
+    relatedTopics: string[];
+    contentItems: ContentItem[];
+}
+export interface SearchResult {
+    content: ContentItem;
+    matches: {
+        field: "title" | "description" | "body";
+        snippet: string;
+    }[];
+    score: number;
+}
+export interface CacheEntry<T> {
+    data: T;
+    cachedAt: number;
+    ttl: number;
+}
+export interface CacheOptions {
+    ttl: number;
+    key: string;
+}
+/**
+ * Author information from Semantic Scholar
+ */
+export interface ScholarAuthor {
+    authorId: string;
+    name: string;
+    affiliations?: string[];
+    homepage?: string;
+    paperCount?: number;
+    citationCount?: number;
+    hIndex?: number;
+    url?: string;
+}
+/**
+ * Paper information from Semantic Scholar
+ */
+export interface ScholarPaper {
+    paperId: string;
+    corpusId?: number;
+    title: string;
+    abstract?: string;
+    venue?: string;
+    year?: number;
+    publicationDate?: string;
+    citationCount?: number;
+    influentialCitationCount?: number;
+    referenceCount?: number;
+    authors?: ScholarAuthor[];
+    fieldsOfStudy?: string[];
+    openAccessPdf?: {
+        url: string;
+        status: string;
+    };
+    externalIds?: {
+        DOI?: string;
+        ArXiv?: string;
+        MAG?: string;
+        ACL?: string;
+        PubMed?: string;
+        CorpusId?: number;
+    };
+    url?: string;
+    tldr?: {
+        model: string;
+        text: string;
+    };
+}
+/**
+ * Citation context from Semantic Scholar
+ */
+export interface ScholarCitation {
+    citingPaper: ScholarPaper;
+    contexts?: string[];
+    intents?: string[];
+    isInfluential?: boolean;
+}
+/**
+ * Reference information from Semantic Scholar
+ */
+export interface ScholarReference {
+    citedPaper: ScholarPaper;
+    contexts?: string[];
+    intents?: string[];
+    isInfluential?: boolean;
+}
+/**
+ * Search result from Semantic Scholar paper search
+ */
+export interface ScholarSearchResult {
+    total: number;
+    offset: number;
+    next?: number;
+    data: ScholarPaper[];
+}
+/**
+ * Bulk search result with pagination token
+ */
+export interface ScholarBulkSearchResult {
+    total?: number;
+    token?: string;
+    data: ScholarPaper[];
+}
+/**
+ * Author search result
+ */
+export interface ScholarAuthorSearchResult {
+    total: number;
+    offset: number;
+    next?: number;
+    data: ScholarAuthor[];
+}
+/**
+ * Paper recommendation
+ */
+export interface ScholarRecommendation {
+    recommendedPapers: ScholarPaper[];
+}
+/**
+ * Query parameters for paper search
+ */
+export interface ScholarSearchParams {
+    query: string;
+    fields?: string[];
+    year?: string;
+    publicationTypes?: string[];
+    openAccessPdf?: boolean;
+    minCitationCount?: number;
+    venue?: string;
+    fieldsOfStudy?: string[];
+    limit?: number;
+    offset?: number;
+    token?: string;
+}
+/**
+ * Cache statistics for Semantic Scholar MCP
+ */
+export interface ScholarCacheStats {
+    papers: {
+        total: number;
+        valid: number;
+        expired: number;
+    };
+    searches: {
+        total: number;
+        valid: number;
+        expired: number;
+    };
+    authors: {
+        total: number;
+        valid: number;
+        expired: number;
+    };
+    hitRate: number;
+    missRate: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/mcp/servers/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/ai/mcp/servers/shared/types.ts"],"names":[],"mappings":"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"}

package/dist/ai/mcp/servers/shared/types.js

@@ -0,0 +1,6 @@
+/**
+ * Shared TypeScript types for MCP servers
+ * Used across Analytics, Design Token, and Content Manager MCPs
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai/mcp/servers/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/ai/mcp/servers/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/ai/mcp/servers/shared/utils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared utilities for MCP servers
+ * Common functions used across Analytics, Design Token, and Content Manager MCPs
+ */
+import type { MCPError } from "./types";
+export declare class MCPToolError extends Error {
+    code: string;
+    details?: unknown | undefined;
+    constructor(code: string, message: string, details?: unknown | undefined);
+    toJSON(): MCPError;
+}
+export declare function handleToolError(error: unknown): string;
+export declare function isProduction(): boolean;
+export declare function isDevelopment(): boolean;
+export declare function getEnvironment(): "production" | "preview" | "development";
+/**
+ * Filters out test/demo data in production environments
+ */
+export declare function filterProductionData<T extends {
+    isTest?: boolean;
+}>(items: T[]): T[];
+/**
+ * Warns if using fallback/demo data in production
+ */
+export declare function warnProductionFallback(dataSource: string): void;
+export declare function getTimeRangeMs(range: "1h" | "24h" | "7d" | "30d" | "all"): number;
+export declare function isWithinTimeRange(timestamp: number, range: "1h" | "24h" | "7d" | "30d" | "all"): boolean;
+export declare function sanitizePath(path: string): string;
+export declare function extractSlug(filePath: string): string;
+export declare function calculateReadingTime(wordCount: number): number;
+export declare function dedupe<T>(items: T[]): T[];
+export declare function sortByProperty<T>(items: T[], property: keyof T, direction?: "asc" | "desc"): T[];
+export declare function limitResults<T>(items: T[], limit?: number): T[];
+export declare function isValidUrl(url: string): boolean;
+export declare function isValidPath(path: string): boolean;
+export declare function measurePerformance<T>(operation: () => Promise<T>, label: string): Promise<{
+    result: T;
+    durationMs: number;
+}>;
+export declare function logToolExecution(toolName: string, params: Record<string, unknown>, success: boolean, durationMs?: number): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/ai/mcp/servers/shared/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../packages/ai/mcp/servers/shared/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAMxC,qBAAa,YAAa,SAAQ,KAAK;IAE5B,IAAI,EAAE,MAAM;IAEZ,OAAO,CAAC,EAAE,OAAO;gBAFjB,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;IAM1B,MAAM,IAAI,QAAQ;CAOnB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtD;AAMD,wBAAgB,YAAY,IAAI,OAAO,CAKtC;AAED,wBAAgB,aAAa,IAAI,OAAO,CAKvC;AAED,wBAAgB,cAAc,IAAI,YAAY,GAAG,SAAS,GAAG,aAAa,CASzE;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EACjE,KAAK,EAAE,CAAC,EAAE,GACT,CAAC,EAAE,CAOL;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAM/D;AAMD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GACzC,MAAM,CAiBR;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GACzC,OAAO,CAOT;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI9D;AAMD,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEzC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,MAAM,CAAC,EACjB,SAAS,GAAE,KAAK,GAAG,MAAe,GACjC,CAAC,EAAE,CAiBL;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAG/D;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjD;AAMD,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAY5C;AAMD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAKN"}