vibe-coding-mcp 2.3.0

package/dist/core/config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Configuration validation and management
+ */
+export interface ConfigStatus {
+    platform: string;
+    configured: boolean;
+    missing: string[];
+}
+export interface ConfigValidationResult {
+    valid: boolean;
+    platforms: ConfigStatus[];
+    warnings: string[];
+}
+/**
+ * Validates configuration for all platforms
+ */
+export declare function validateConfiguration(): ConfigValidationResult;
+/**
+ * Logs configuration status on startup
+ */
+export declare function logConfigurationStatus(): void;
+/**
+ * Gets configuration status for a specific platform
+ */
+export declare function getPlatformConfig(platform: string): ConfigStatus | undefined;
+/**
+ * Checks if a platform is properly configured
+ */
+export declare function isPlatformConfigured(platform: string): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgCD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,sBAAsB,CA6B9D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAe7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAG5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG9D"}

package/dist/core/config.js

@@ -0,0 +1,90 @@
+/**
+ * Configuration validation and management
+ */
+import { logger } from './logger.js';
+/**
+ * Platform configuration requirements
+ */
+const platformRequirements = {
+    notion: {
+        required: ['NOTION_API_KEY'],
+        optional: ['NOTION_DATABASE_ID']
+    },
+    'github-wiki': {
+        required: ['GITHUB_TOKEN', 'GITHUB_REPO'],
+        optional: []
+    },
+    obsidian: {
+        required: [],
+        optional: ['OBSIDIAN_VAULT_PATH']
+    },
+    confluence: {
+        required: ['CONFLUENCE_BASE_URL', 'CONFLUENCE_USERNAME', 'CONFLUENCE_API_TOKEN', 'CONFLUENCE_SPACE_KEY'],
+        optional: []
+    },
+    slack: {
+        required: [],
+        optional: ['SLACK_WEBHOOK_URL']
+    },
+    discord: {
+        required: [],
+        optional: ['DISCORD_WEBHOOK_URL']
+    }
+};
+/**
+ * Validates configuration for all platforms
+ */
+export function validateConfiguration() {
+    const platforms = [];
+    const warnings = [];
+    for (const [platform, requirements] of Object.entries(platformRequirements)) {
+        const missing = [];
+        for (const envVar of requirements.required) {
+            if (!process.env[envVar]) {
+                missing.push(envVar);
+            }
+        }
+        const configured = missing.length === 0;
+        platforms.push({
+            platform,
+            configured,
+            missing
+        });
+        if (!configured && requirements.required.length > 0) {
+            warnings.push(`${platform}: Missing required env vars: ${missing.join(', ')}`);
+        }
+    }
+    const valid = platforms.some(p => p.configured);
+    return { valid, platforms, warnings };
+}
+/**
+ * Logs configuration status on startup
+ */
+export function logConfigurationStatus() {
+    const result = validateConfiguration();
+    logger.info('Configuration validation complete', {
+        valid: result.valid,
+        configuredPlatforms: result.platforms.filter(p => p.configured).map(p => p.platform)
+    });
+    for (const warning of result.warnings) {
+        logger.warn(warning);
+    }
+    if (!result.valid) {
+        logger.warn('No platforms are fully configured. Some features may not work.');
+    }
+}
+/**
+ * Gets configuration status for a specific platform
+ */
+export function getPlatformConfig(platform) {
+    const result = validateConfiguration();
+    return result.platforms.find(p => p.platform === platform);
+}
+/**
+ * Checks if a platform is properly configured
+ */
+export function isPlatformConfigured(platform) {
+    const config = getPlatformConfig(platform);
+    return config?.configured ?? false;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/core/errors.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Custom error classes for structured error handling
+ */
+export type ErrorCode = 'VALIDATION_ERROR' | 'PLATFORM_ERROR' | 'NETWORK_ERROR' | 'AUTH_ERROR' | 'NOT_FOUND' | 'RATE_LIMIT' | 'INTERNAL_ERROR' | 'PARSE_ERROR' | 'TIMEOUT';
+export interface ErrorContext {
+    tool?: string;
+    platform?: string;
+    input?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export declare class ToolError extends Error {
+    readonly code: ErrorCode;
+    readonly context?: ErrorContext;
+    readonly cause?: Error;
+    readonly timestamp: string;
+    constructor(message: string, code: ErrorCode, context?: ErrorContext, cause?: Error);
+    toJSON(): Record<string, unknown>;
+    static fromError(error: unknown, code?: ErrorCode, context?: ErrorContext): ToolError;
+}
+export declare class ValidationError extends ToolError {
+    readonly field?: string;
+    readonly expected?: string;
+    readonly received?: string;
+    constructor(message: string, field?: string, expected?: string, received?: string, context?: ErrorContext);
+}
+export declare class PlatformError extends ToolError {
+    readonly platform: string;
+    readonly statusCode?: number;
+    constructor(message: string, platform: string, statusCode?: number, context?: ErrorContext, cause?: Error);
+}
+export declare class AuthError extends ToolError {
+    constructor(message: string, context?: ErrorContext, cause?: Error);
+}
+export declare class RateLimitError extends ToolError {
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number, context?: ErrorContext);
+}
+/**
+ * Wraps async function with error handling
+ */
+export declare function withErrorHandling<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, toolName: string): T;
+/**
+ * Creates a standardized error response for MCP
+ */
+export declare function createErrorResponse(error: unknown): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,SAAS,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,gBAAgB,GAChB,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvC,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;IAC9B,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,YAAY,EACtB,KAAK,CAAC,EAAE,KAAK;IAaf,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWjC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,SAA4B,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS;CAUxG;AAED,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY;CAQzB;AAED,qBAAa,aAAc,SAAQ,SAAS;IAC1C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,EACtB,KAAK,CAAC,EAAE,KAAK;CAOhB;AAED,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,KAAK;CAInE;AAED,qBAAa,cAAe,SAAQ,SAAS;IAC3C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAClF,EAAE,EAAE,CAAC,EACL,QAAQ,EAAE,MAAM,GACf,CAAC,CAQH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG;IACnD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC;CACf,CASA"}

package/dist/core/errors.js

@@ -0,0 +1,99 @@
+/**
+ * Custom error classes for structured error handling
+ */
+export class ToolError extends Error {
+    code;
+    context;
+    cause;
+    timestamp;
+    constructor(message, code, context, cause) {
+        super(message);
+        this.name = 'ToolError';
+        this.code = code;
+        this.context = context;
+        this.cause = cause;
+        this.timestamp = new Date().toISOString();
+        // Maintains proper stack trace for where error was thrown
+        Error.captureStackTrace?.(this, ToolError);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            context: this.context,
+            timestamp: this.timestamp,
+            cause: this.cause?.message
+        };
+    }
+    static fromError(error, code = 'INTERNAL_ERROR', context) {
+        if (error instanceof ToolError) {
+            return error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        const cause = error instanceof Error ? error : undefined;
+        return new ToolError(message, code, context, cause);
+    }
+}
+export class ValidationError extends ToolError {
+    field;
+    expected;
+    received;
+    constructor(message, field, expected, received, context) {
+        super(message, 'VALIDATION_ERROR', { ...context, field, expected, received });
+        this.name = 'ValidationError';
+        this.field = field;
+        this.expected = expected;
+        this.received = received;
+    }
+}
+export class PlatformError extends ToolError {
+    platform;
+    statusCode;
+    constructor(message, platform, statusCode, context, cause) {
+        super(message, 'PLATFORM_ERROR', { ...context, platform, statusCode }, cause);
+        this.name = 'PlatformError';
+        this.platform = platform;
+        this.statusCode = statusCode;
+    }
+}
+export class AuthError extends ToolError {
+    constructor(message, context, cause) {
+        super(message, 'AUTH_ERROR', context, cause);
+        this.name = 'AuthError';
+    }
+}
+export class RateLimitError extends ToolError {
+    retryAfter;
+    constructor(message, retryAfter, context) {
+        super(message, 'RATE_LIMIT', { ...context, retryAfter });
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Wraps async function with error handling
+ */
+export function withErrorHandling(fn, toolName) {
+    return (async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            throw ToolError.fromError(error, 'INTERNAL_ERROR', { tool: toolName });
+        }
+    });
+}
+/**
+ * Creates a standardized error response for MCP
+ */
+export function createErrorResponse(error) {
+    const toolError = error instanceof ToolError
+        ? error
+        : ToolError.fromError(error);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(toolError.toJSON(), null, 2) }],
+        isError: true
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoBH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClB,IAAI,CAAY;IAChB,OAAO,CAAgB;IACvB,KAAK,CAAS;IACd,SAAS,CAAS;IAElC,YACE,OAAe,EACf,IAAe,EACf,OAAsB,EACtB,KAAa;QAEb,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE1C,0DAA0D;QAC1D,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,KAAc,EAAE,OAAkB,gBAAgB,EAAE,OAAsB;QACzF,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAEzD,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5B,KAAK,CAAU;IACf,QAAQ,CAAU;IAClB,QAAQ,CAAU;IAElC,YACE,OAAe,EACf,KAAc,EACd,QAAiB,EACjB,QAAiB,EACjB,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1B,QAAQ,CAAS;IACjB,UAAU,CAAU;IAEpC,YACE,OAAe,EACf,QAAgB,EAChB,UAAmB,EACnB,OAAsB,EACtB,KAAa;QAEb,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,SAAS;IACtC,YAAY,OAAe,EAAE,OAAsB,EAAE,KAAa;QAChE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3B,UAAU,CAAU;IAEpC,YAAY,OAAe,EAAE,UAAmB,EAAE,OAAsB;QACtE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAK,EACL,QAAgB;IAEhB,OAAO,CAAC,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;QACnC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CAAM,CAAC;AACV,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAIhD,MAAM,SAAS,GAAG,KAAK,YAAY,SAAS;QAC1C,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAE/B,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Structured logging utility for MCP server
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogContext {
+    tool?: string;
+    platform?: string;
+    sessionId?: string;
+    requestId?: string;
+    duration?: number;
+    [key: string]: unknown;
+}
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    context?: LogContext;
+    error?: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+}
+declare class Logger {
+    private minLevel;
+    private static levelPriority;
+    setLevel(level: LogLevel): void;
+    private shouldLog;
+    private formatEntry;
+    private log;
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error, context?: LogContext): void;
+    /**
+     * Creates a child logger with preset context
+     */
+    child(defaultContext: LogContext): ChildLogger;
+    /**
+     * Measures and logs execution time
+     */
+    time<T>(label: string, fn: () => Promise<T>, context?: LogContext): Promise<T>;
+}
+declare class ChildLogger {
+    private parent;
+    private defaultContext;
+    constructor(parent: Logger, defaultContext: LogContext);
+    private mergeContext;
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error, context?: LogContext): void;
+}
+export declare const logger: Logger;
+export declare function createToolLogger(toolName: string): ChildLogger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,cAAM,MAAM;IACV,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,MAAM,CAAC,aAAa,CAK1B;IAEF,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,GAAG;IAgCX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjE;;OAEG;IACH,KAAK,CAAC,cAAc,EAAE,UAAU,GAAG,WAAW;IAI9C;;OAEG;IACG,IAAI,CAAC,CAAC,EACV,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,CAAC,CAAC;CAad;AAED,cAAM,WAAW;IAEb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,cAAc;gBADd,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,UAAU;IAGpC,OAAO,CAAC,YAAY;IAIpB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;CAGlE;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC;AAGnC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAE9D"}

package/dist/core/logger.js

@@ -0,0 +1,114 @@
+/**
+ * Structured logging utility for MCP server
+ */
+class Logger {
+    minLevel = 'info';
+    static levelPriority = {
+        debug: 0,
+        info: 1,
+        warn: 2,
+        error: 3
+    };
+    setLevel(level) {
+        this.minLevel = level;
+    }
+    shouldLog(level) {
+        return Logger.levelPriority[level] >= Logger.levelPriority[this.minLevel];
+    }
+    formatEntry(entry) {
+        return JSON.stringify(entry);
+    }
+    log(level, message, context, error) {
+        if (!this.shouldLog(level))
+            return;
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            context
+        };
+        if (error) {
+            entry.error = {
+                name: error.name,
+                message: error.message,
+                stack: error.stack
+            };
+        }
+        const formatted = this.formatEntry(entry);
+        switch (level) {
+            case 'error':
+                console.error(formatted);
+                break;
+            case 'warn':
+                console.warn(formatted);
+                break;
+            default:
+                console.log(formatted);
+        }
+    }
+    debug(message, context) {
+        this.log('debug', message, context);
+    }
+    info(message, context) {
+        this.log('info', message, context);
+    }
+    warn(message, context) {
+        this.log('warn', message, context);
+    }
+    error(message, error, context) {
+        this.log('error', message, context, error);
+    }
+    /**
+     * Creates a child logger with preset context
+     */
+    child(defaultContext) {
+        return new ChildLogger(this, defaultContext);
+    }
+    /**
+     * Measures and logs execution time
+     */
+    async time(label, fn, context) {
+        const start = Date.now();
+        try {
+            const result = await fn();
+            const duration = Date.now() - start;
+            this.info(`${label} completed`, { ...context, duration });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - start;
+            this.error(`${label} failed`, error, { ...context, duration });
+            throw error;
+        }
+    }
+}
+class ChildLogger {
+    parent;
+    defaultContext;
+    constructor(parent, defaultContext) {
+        this.parent = parent;
+        this.defaultContext = defaultContext;
+    }
+    mergeContext(context) {
+        return { ...this.defaultContext, ...context };
+    }
+    debug(message, context) {
+        this.parent.debug(message, this.mergeContext(context));
+    }
+    info(message, context) {
+        this.parent.info(message, this.mergeContext(context));
+    }
+    warn(message, context) {
+        this.parent.warn(message, this.mergeContext(context));
+    }
+    error(message, error, context) {
+        this.parent.error(message, error, this.mergeContext(context));
+    }
+}
+// Singleton instance
+export const logger = new Logger();
+// Convenience function to create tool-specific logger
+export function createToolLogger(toolName) {
+    return logger.child({ tool: toolName });
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"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"}