@skillsmith/mcp-server 0.1.0

package/dist/src/context.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview MCP Server Tool Context - Database initialization and shared services
+ * @module @skillsmith/mcp-server/context
+ * @see SMI-792: Add database initialization to MCP server
+ * @see SMI-898: Path traversal protection for DB_PATH
+ *
+ * Provides shared context for MCP tool handlers including:
+ * - SQLite database connection with FTS5 search
+ * - SearchService for skill discovery
+ * - SkillRepository for CRUD operations
+ * - Secure path validation for database paths
+ *
+ * @example
+ * // Initialize context at server startup
+ * const context = createToolContext();
+ *
+ * // Pass to tool handlers
+ * const result = await executeSearch(input, context);
+ */
+import type { Database as DatabaseType } from 'better-sqlite3';
+import { SearchService, SkillRepository } from '@skillsmith/core';
+/**
+ * Shared context for MCP tool handlers
+ */
+export interface ToolContext {
+    /** SQLite database connection */
+    db: DatabaseType;
+    /** Search service with FTS5/BM25 */
+    searchService: SearchService;
+    /** Skill repository for CRUD operations */
+    skillRepository: SkillRepository;
+}
+/**
+ * Options for creating tool context
+ */
+export interface ToolContextOptions {
+    /** Custom database path (defaults to ~/.skillsmith/skills.db) */
+    dbPath?: string;
+    /** Search cache TTL in seconds (default: 300) */
+    searchCacheTtl?: number;
+}
+/**
+ * Get the default database path
+ * Respects SKILLSMITH_DB_PATH environment variable
+ *
+ * @see SMI-898: Path traversal protection
+ * - Validates SKILLSMITH_DB_PATH against path traversal attacks
+ * - Rejects paths with ".." traversal sequences
+ * - Ensures path is within allowed directories
+ *
+ * @throws Error if SKILLSMITH_DB_PATH contains path traversal attempt
+ */
+export declare function getDefaultDbPath(): string;
+/**
+ * Create the shared tool context with database and services
+ *
+ * @param options - Configuration options
+ * @returns Initialized tool context
+ *
+ * @see SMI-898: Path traversal protection
+ * - Custom dbPath is validated for path traversal attacks
+ * - Rejects paths with ".." or outside allowed directories
+ *
+ * @example
+ * // With default path (~/.skillsmith/skills.db)
+ * const context = createToolContext();
+ *
+ * @example
+ * // With custom path (must be in allowed directory)
+ * const context = createToolContext({ dbPath: '~/.skillsmith/custom.db' });
+ *
+ * @example
+ * // For testing with in-memory database
+ * const context = createToolContext({ dbPath: ':memory:' });
+ *
+ * @throws Error if dbPath contains path traversal attempt
+ */
+export declare function createToolContext(options?: ToolContextOptions): ToolContext;
+/**
+ * Close the tool context and release resources
+ *
+ * @param context - Tool context to close
+ */
+export declare function closeToolContext(context: ToolContext): void;
+/**
+ * Get or create the global tool context
+ * Uses singleton pattern for MCP server lifecycle
+ *
+ * Note: Options are only applied on first call. Subsequent calls
+ * return the cached context and ignore any options.
+ *
+ * @param options - Configuration options (only used on first call)
+ * @returns The global tool context
+ */
+export declare function getToolContext(options?: ToolContextOptions): ToolContext;
+/**
+ * Reset the global context (for testing)
+ */
+export declare function resetToolContext(): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/src/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAkB,aAAa,EAAE,eAAe,EAAkB,MAAM,kBAAkB,CAAA;AAEjG;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,EAAE,EAAE,YAAY,CAAA;IAChB,oCAAoC;IACpC,aAAa,EAAE,aAAa,CAAA;IAC5B,2CAA2C;IAC3C,eAAe,EAAE,eAAe,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAqBzC;AAYD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CA0C/E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAE3D;AAKD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAUxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}

package/dist/src/context.js

@@ -0,0 +1,157 @@
+/**
+ * @fileoverview MCP Server Tool Context - Database initialization and shared services
+ * @module @skillsmith/mcp-server/context
+ * @see SMI-792: Add database initialization to MCP server
+ * @see SMI-898: Path traversal protection for DB_PATH
+ *
+ * Provides shared context for MCP tool handlers including:
+ * - SQLite database connection with FTS5 search
+ * - SearchService for skill discovery
+ * - SkillRepository for CRUD operations
+ * - Secure path validation for database paths
+ *
+ * @example
+ * // Initialize context at server startup
+ * const context = createToolContext();
+ *
+ * // Pass to tool handlers
+ * const result = await executeSearch(input, context);
+ */
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { mkdirSync, existsSync } from 'fs';
+import { createDatabase, SearchService, SkillRepository, validateDbPath } from '@skillsmith/core';
+/**
+ * Get the default database path
+ * Respects SKILLSMITH_DB_PATH environment variable
+ *
+ * @see SMI-898: Path traversal protection
+ * - Validates SKILLSMITH_DB_PATH against path traversal attacks
+ * - Rejects paths with ".." traversal sequences
+ * - Ensures path is within allowed directories
+ *
+ * @throws Error if SKILLSMITH_DB_PATH contains path traversal attempt
+ */
+export function getDefaultDbPath() {
+    const envPath = process.env.SKILLSMITH_DB_PATH;
+    if (envPath) {
+        // SMI-898: Validate environment variable path for path traversal
+        const validation = validateDbPath(envPath, {
+            allowInMemory: true,
+            allowTempDir: true,
+        });
+        if (!validation.valid) {
+            throw new Error(`Invalid SKILLSMITH_DB_PATH: ${validation.error}. ` +
+                'Path must be within ~/.skillsmith, ~/.claude, or temp directories.');
+        }
+        return validation.resolvedPath;
+    }
+    return join(homedir(), '.skillsmith', 'skills.db');
+}
+/**
+ * Ensure the database directory exists
+ */
+function ensureDbDirectory(dbPath) {
+    const dir = dirname(dbPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Create the shared tool context with database and services
+ *
+ * @param options - Configuration options
+ * @returns Initialized tool context
+ *
+ * @see SMI-898: Path traversal protection
+ * - Custom dbPath is validated for path traversal attacks
+ * - Rejects paths with ".." or outside allowed directories
+ *
+ * @example
+ * // With default path (~/.skillsmith/skills.db)
+ * const context = createToolContext();
+ *
+ * @example
+ * // With custom path (must be in allowed directory)
+ * const context = createToolContext({ dbPath: '~/.skillsmith/custom.db' });
+ *
+ * @example
+ * // For testing with in-memory database
+ * const context = createToolContext({ dbPath: ':memory:' });
+ *
+ * @throws Error if dbPath contains path traversal attempt
+ */
+export function createToolContext(options = {}) {
+    let dbPath;
+    if (options.dbPath) {
+        // SMI-898: Validate custom path for path traversal
+        const validation = validateDbPath(options.dbPath, {
+            allowInMemory: true,
+            allowTempDir: true,
+        });
+        if (!validation.valid) {
+            throw new Error(`Invalid database path: ${validation.error}. ` +
+                'Path must be within ~/.skillsmith, ~/.claude, or temp directories.');
+        }
+        dbPath = validation.resolvedPath;
+    }
+    else {
+        dbPath = getDefaultDbPath();
+    }
+    // Ensure directory exists (skip for in-memory)
+    if (dbPath !== ':memory:') {
+        ensureDbDirectory(dbPath);
+    }
+    // Create database with schema
+    const db = createDatabase(dbPath);
+    // Initialize services
+    const searchService = new SearchService(db, {
+        cacheTtl: options.searchCacheTtl ?? 300,
+    });
+    const skillRepository = new SkillRepository(db);
+    return {
+        db,
+        searchService,
+        skillRepository,
+    };
+}
+/**
+ * Close the tool context and release resources
+ *
+ * @param context - Tool context to close
+ */
+export function closeToolContext(context) {
+    context.db.close();
+}
+// Singleton context for the MCP server
+let globalContext = null;
+/**
+ * Get or create the global tool context
+ * Uses singleton pattern for MCP server lifecycle
+ *
+ * Note: Options are only applied on first call. Subsequent calls
+ * return the cached context and ignore any options.
+ *
+ * @param options - Configuration options (only used on first call)
+ * @returns The global tool context
+ */
+export function getToolContext(options) {
+    if (!globalContext) {
+        globalContext = createToolContext(options);
+    }
+    else if (options) {
+        // Warn if options are provided after context is already created
+        console.warn('[skillsmith] getToolContext called with options after context was already initialized. Options ignored.');
+    }
+    return globalContext;
+}
+/**
+ * Reset the global context (for testing)
+ */
+export function resetToolContext() {
+    if (globalContext) {
+        closeToolContext(globalContext);
+        globalContext = null;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/src/context.js.map

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

package/dist/src/core-shim.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Core package shim for testing
+ * Re-exports only the modules needed by MCP server, avoiding heavy dependencies like ONNX
+ */
+export { ErrorCodes, ErrorSuggestions, SkillsmithError, createErrorResponse, withErrorBoundary, type ErrorCategory, type ErrorCode, type ErrorResponse, } from '../../core/src/errors.js';
+export { TrustTierDescriptions, type TrustTier as MCPTrustTier, type SkillCategory, type ScoreBreakdown, type Skill as MCPSkill, type SkillSearchResult, type SearchFilters, type SearchResponse as MCPSearchResponse, type GetSkillResponse, } from '../../core/src/types.js';
+//# sourceMappingURL=core-shim.d.ts.map

package/dist/src/core-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-shim.d.ts","sourceRoot":"","sources":["../../src/core-shim.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EACL,qBAAqB,EACrB,KAAK,SAAS,IAAI,YAAY,EAC9B,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,KAAK,IAAI,QAAQ,EACtB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,cAAc,IAAI,iBAAiB,EACxC,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAA"}

package/dist/src/core-shim.js

@@ -0,0 +1,9 @@
+/**
+ * Core package shim for testing
+ * Re-exports only the modules needed by MCP server, avoiding heavy dependencies like ONNX
+ */
+// Error handling
+export { ErrorCodes, ErrorSuggestions, SkillsmithError, createErrorResponse, withErrorBoundary, } from '../../core/src/errors.js';
+// MCP types
+export { TrustTierDescriptions, } from '../../core/src/types.js';
+//# sourceMappingURL=core-shim.js.map

package/dist/src/core-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-shim.js","sourceRoot":"","sources":["../../src/core-shim.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iBAAiB;AACjB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GAIlB,MAAM,0BAA0B,CAAA;AAEjC,YAAY;AACZ,OAAO,EACL,qBAAqB,GAStB,MAAM,yBAAyB,CAAA"}

package/dist/src/health/healthCheck.d.ts

@@ -0,0 +1,88 @@
+/**
+ * SMI-740: Health Check Endpoint Handler
+ *
+ * Provides a simple health check endpoint that returns:
+ * - status: "ok" | "degraded" | "unhealthy"
+ * - uptime: number (seconds)
+ * - version: string
+ *
+ * This endpoint should always return quickly and not perform
+ * expensive operations like database queries.
+ */
+/**
+ * Health check response
+ */
+export interface HealthResponse {
+    /** Current health status */
+    status: 'ok' | 'degraded' | 'unhealthy';
+    /** Process uptime in seconds */
+    uptime: number;
+    /** Application version */
+    version: string;
+    /** Timestamp of the health check */
+    timestamp: string;
+    /** Optional additional info */
+    info?: Record<string, unknown>;
+}
+/**
+ * Health check configuration
+ */
+export interface HealthCheckConfig {
+    /** Application version (default: from package.json or '0.0.0') */
+    version?: string;
+    /** Custom health check function */
+    customCheck?: () => Promise<{
+        healthy: boolean;
+        info?: Record<string, unknown>;
+    }>;
+}
+/**
+ * Health Check Handler
+ *
+ * Provides lightweight health check functionality that can be used
+ * with any HTTP framework or MCP tool.
+ */
+export declare class HealthCheck {
+    private readonly version;
+    private readonly customCheck?;
+    constructor(config?: HealthCheckConfig);
+    /**
+     * Perform health check
+     *
+     * This is a lightweight check that should return quickly.
+     * For deep health checks including dependencies, use ReadinessCheck.
+     */
+    check(): Promise<HealthResponse>;
+    /**
+     * Get uptime in seconds
+     */
+    getUptime(): number;
+    /**
+     * Get version
+     */
+    getVersion(): string;
+    /**
+     * Check if the service is healthy (for simple boolean checks)
+     */
+    isHealthy(): Promise<boolean>;
+}
+/**
+ * Get the default health check instance
+ */
+export declare function getHealthCheck(): HealthCheck;
+/**
+ * Create a new health check instance with custom configuration
+ */
+export declare function createHealthCheck(config: HealthCheckConfig): HealthCheck;
+/**
+ * Perform a quick health check using the default instance
+ */
+export declare function checkHealth(): Promise<HealthResponse>;
+/**
+ * Format health response for HTTP (includes status code)
+ */
+export declare function formatHealthResponse(response: HealthResponse): {
+    statusCode: number;
+    body: HealthResponse;
+};
+//# sourceMappingURL=healthCheck.d.ts.map

package/dist/src/health/healthCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthCheck.d.ts","sourceRoot":"","sources":["../../../src/health/healthCheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,CAAA;IACvC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;CAClF;AAOD;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAqE;gBAEtF,MAAM,GAAE,iBAAsB;IAK1C;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC;IAgCtC;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAIpC;AAKD;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAExE;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,CAE3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG;IAC9D,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,cAAc,CAAA;CACrB,CAOA"}

package/dist/src/health/healthCheck.js

@@ -0,0 +1,117 @@
+/**
+ * SMI-740: Health Check Endpoint Handler
+ *
+ * Provides a simple health check endpoint that returns:
+ * - status: "ok" | "degraded" | "unhealthy"
+ * - uptime: number (seconds)
+ * - version: string
+ *
+ * This endpoint should always return quickly and not perform
+ * expensive operations like database queries.
+ */
+/**
+ * Process start time for uptime calculation
+ */
+const processStartTime = Date.now();
+/**
+ * Health Check Handler
+ *
+ * Provides lightweight health check functionality that can be used
+ * with any HTTP framework or MCP tool.
+ */
+export class HealthCheck {
+    version;
+    customCheck;
+    constructor(config = {}) {
+        this.version = config.version ?? process.env.npm_package_version ?? '0.1.0';
+        this.customCheck = config.customCheck;
+    }
+    /**
+     * Perform health check
+     *
+     * This is a lightweight check that should return quickly.
+     * For deep health checks including dependencies, use ReadinessCheck.
+     */
+    async check() {
+        const uptimeMs = Date.now() - processStartTime;
+        const uptimeSeconds = Math.floor(uptimeMs / 1000);
+        const response = {
+            status: 'ok',
+            uptime: uptimeSeconds,
+            version: this.version,
+            timestamp: new Date().toISOString(),
+        };
+        // Run custom check if provided
+        if (this.customCheck) {
+            try {
+                const result = await this.customCheck();
+                if (!result.healthy) {
+                    response.status = 'degraded';
+                }
+                if (result.info) {
+                    response.info = result.info;
+                }
+            }
+            catch (error) {
+                response.status = 'degraded';
+                response.info = {
+                    customCheckError: error instanceof Error ? error.message : 'Unknown error',
+                };
+            }
+        }
+        return response;
+    }
+    /**
+     * Get uptime in seconds
+     */
+    getUptime() {
+        return Math.floor((Date.now() - processStartTime) / 1000);
+    }
+    /**
+     * Get version
+     */
+    getVersion() {
+        return this.version;
+    }
+    /**
+     * Check if the service is healthy (for simple boolean checks)
+     */
+    async isHealthy() {
+        const result = await this.check();
+        return result.status === 'ok';
+    }
+}
+// Default health check instance
+let defaultHealthCheck = null;
+/**
+ * Get the default health check instance
+ */
+export function getHealthCheck() {
+    if (!defaultHealthCheck) {
+        defaultHealthCheck = new HealthCheck();
+    }
+    return defaultHealthCheck;
+}
+/**
+ * Create a new health check instance with custom configuration
+ */
+export function createHealthCheck(config) {
+    return new HealthCheck(config);
+}
+/**
+ * Perform a quick health check using the default instance
+ */
+export async function checkHealth() {
+    return getHealthCheck().check();
+}
+/**
+ * Format health response for HTTP (includes status code)
+ */
+export function formatHealthResponse(response) {
+    const statusCode = response.status === 'ok' ? 200 : response.status === 'degraded' ? 200 : 503;
+    return {
+        statusCode,
+        body: response,
+    };
+}
+//# sourceMappingURL=healthCheck.js.map

package/dist/src/health/healthCheck.js.map

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

package/dist/src/health/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SMI-740: Health Check Module Exports
+ *
+ * Provides health and readiness check endpoints for the MCP server:
+ * - /health: Quick liveness check
+ * - /ready: Deep readiness check with dependency verification
+ */
+export { HealthCheck, getHealthCheck, createHealthCheck, checkHealth, formatHealthResponse, type HealthResponse, type HealthCheckConfig, } from './healthCheck.js';
+export { ReadinessCheck, getReadinessCheck, createReadinessCheck, checkReadiness, configureReadinessCheck, formatReadinessResponse, type ReadinessResponse, type ReadinessCheckConfig, type DependencyCheck, } from './readinessCheck.js';
+/**
+ * Combined health and readiness check response
+ */
+export interface HealthAndReadiness {
+    health: import('./healthCheck.js').HealthResponse;
+    readiness: import('./readinessCheck.js').ReadinessResponse;
+}
+/**
+ * Perform both health and readiness checks
+ */
+export declare function checkAll(): Promise<HealthAndReadiness>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/health/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/health/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAA;AAE5B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,kBAAkB,EAAE,cAAc,CAAA;IACjD,SAAS,EAAE,OAAO,qBAAqB,EAAE,iBAAiB,CAAA;CAC3D;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAO5D"}

package/dist/src/health/index.js

@@ -0,0 +1,21 @@
+/**
+ * SMI-740: Health Check Module Exports
+ *
+ * Provides health and readiness check endpoints for the MCP server:
+ * - /health: Quick liveness check
+ * - /ready: Deep readiness check with dependency verification
+ */
+// Health check exports
+export { HealthCheck, getHealthCheck, createHealthCheck, checkHealth, formatHealthResponse, } from './healthCheck.js';
+// Readiness check exports
+export { ReadinessCheck, getReadinessCheck, createReadinessCheck, checkReadiness, configureReadinessCheck, formatReadinessResponse, } from './readinessCheck.js';
+/**
+ * Perform both health and readiness checks
+ */
+export async function checkAll() {
+    const { checkHealth } = await import('./healthCheck.js');
+    const { checkReadiness } = await import('./readinessCheck.js');
+    const [health, readiness] = await Promise.all([checkHealth(), checkReadiness()]);
+    return { health, readiness };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/health/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,oBAAoB,GAGrB,MAAM,kBAAkB,CAAA;AAEzB,0BAA0B;AAC1B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,uBAAuB,GAIxB,MAAM,qBAAqB,CAAA;AAU5B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;IACxD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAA;IAE9D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,CAAA;IAEhF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AAC9B,CAAC"}