@skillsmith/core 0.1.0

package/dist/src/errors/SkillsmithError.js

@@ -0,0 +1,194 @@
+/**
+ * Skillsmith Error Classes - SMI-881
+ *
+ * Custom error classes with proper cause chaining for better error propagation.
+ * Ensures stack traces and context are preserved through error handling layers.
+ */
+/**
+ * Base error class for all Skillsmith errors.
+ * Preserves cause chain and provides structured error information.
+ */
+export class SkillsmithError extends Error {
+    /** Error code for programmatic handling */
+    code;
+    /** Additional context about the error */
+    context;
+    constructor(message, options) {
+        super(message, { cause: options?.cause });
+        this.name = 'SkillsmithError';
+        this.code = options?.code ?? 'SKILLSMITH_ERROR';
+        this.context = options?.context;
+        // Capture stack trace excluding constructor
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+    /**
+     * Get the full error chain as an array
+     */
+    getErrorChain() {
+        const chain = [this];
+        let current = this.cause;
+        while (current instanceof Error) {
+            chain.push(current);
+            current = current.cause;
+        }
+        return chain;
+    }
+    /**
+     * Format error with full context for logging
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            context: this.context,
+            cause: this.cause instanceof Error ? this.cause.message : this.cause,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Network-related errors (fetch failures, timeouts, etc.)
+ */
+export class NetworkError extends SkillsmithError {
+    constructor(message, options) {
+        super(message, {
+            code: 'NETWORK_ERROR',
+            cause: options?.cause,
+            context: {
+                ...options?.context,
+                url: options?.url,
+                statusCode: options?.statusCode,
+            },
+        });
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * API-specific errors (rate limits, auth failures, etc.)
+ *
+ * Note: Rate limit detection includes both 429 (standard) and 403 (GitHub).
+ * GitHub returns 403 Forbidden for rate limit exceeded instead of 429.
+ * See: https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api
+ */
+export class ApiError extends SkillsmithError {
+    /** HTTP status code if applicable */
+    statusCode;
+    constructor(message, options) {
+        super(message, {
+            // Check both 429 (standard) and 403 (GitHub uses 403 for rate limits)
+            code: options?.statusCode === 429 || options?.statusCode === 403
+                ? 'RATE_LIMIT_ERROR'
+                : 'API_ERROR',
+            cause: options?.cause,
+            context: {
+                ...options?.context,
+                url: options?.url,
+                statusCode: options?.statusCode,
+            },
+        });
+        this.name = 'ApiError';
+        this.statusCode = options?.statusCode;
+    }
+    /**
+     * Check if this is a rate limit error
+     */
+    isRateLimitError() {
+        return this.statusCode === 429 || this.statusCode === 403;
+    }
+    /**
+     * Check if this is a not found error
+     */
+    isNotFoundError() {
+        return this.statusCode === 404;
+    }
+    /**
+     * Check if this is a server error (5xx)
+     */
+    isServerError() {
+        return this.statusCode !== undefined && this.statusCode >= 500;
+    }
+}
+/**
+ * Validation errors (invalid input, schema violations)
+ */
+export class ValidationError extends SkillsmithError {
+    /** Field that failed validation */
+    field;
+    constructor(message, options) {
+        super(message, {
+            code: 'VALIDATION_ERROR',
+            cause: options?.cause,
+            context: {
+                ...options?.context,
+                field: options?.field,
+            },
+        });
+        this.name = 'ValidationError';
+        this.field = options?.field;
+    }
+}
+/**
+ * Skill-related errors (not found, invalid structure, etc.)
+ */
+export class SkillError extends SkillsmithError {
+    /** Skill ID if applicable */
+    skillId;
+    constructor(message, options) {
+        super(message, {
+            code: 'SKILL_ERROR',
+            cause: options?.cause,
+            context: {
+                ...options?.context,
+                skillId: options?.skillId,
+            },
+        });
+        this.name = 'SkillError';
+        this.skillId = options?.skillId;
+    }
+}
+/**
+ * Configuration errors
+ */
+export class ConfigurationError extends SkillsmithError {
+    constructor(message, options) {
+        super(message, {
+            code: 'CONFIGURATION_ERROR',
+            cause: options?.cause,
+            context: options?.context,
+        });
+        this.name = 'ConfigurationError';
+    }
+}
+/**
+ * Wrap an unknown error in a SkillsmithError if not already one
+ */
+export function wrapError(error, message, options) {
+    if (error instanceof SkillsmithError) {
+        return error;
+    }
+    return new SkillsmithError(message, {
+        code: options?.code,
+        cause: error,
+        context: options?.context,
+    });
+}
+/**
+ * Extract error message from unknown error
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    return 'Unknown error';
+}
+/**
+ * Check if error is a specific type
+ */
+export function isSkillsmithError(error) {
+    return error instanceof SkillsmithError;
+}
+//# sourceMappingURL=SkillsmithError.js.map

package/dist/src/errors/SkillsmithError.js.map

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

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

@@ -0,0 +1,36 @@
+/**
+ * Error Classes Module - SMI-881
+ *
+ * Provides custom error classes with proper cause chaining for better error propagation.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   SkillsmithError,
+ *   ApiError,
+ *   NetworkError,
+ *   ValidationError,
+ *   SkillError,
+ *   ConfigurationError,
+ *   wrapError,
+ *   getErrorMessage
+ * } from '@skillsmith/core/errors'
+ *
+ * try {
+ *   const response = await fetch(url)
+ *   if (!response.ok) {
+ *     throw new ApiError('API request failed', {
+ *       statusCode: response.status,
+ *       url
+ *     })
+ *   }
+ * } catch (error) {
+ *   // Wrap unknown errors for consistent handling
+ *   throw wrapError(error, 'Failed to fetch data')
+ * }
+ * ```
+ *
+ * @module errors
+ */
+export { SkillsmithError, NetworkError, ApiError, ValidationError, SkillError, ConfigurationError, wrapError, getErrorMessage, isSkillsmithError, } from './SkillsmithError.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EACL,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,iBAAiB,GAClB,MAAM,sBAAsB,CAAA"}

package/dist/src/errors/index.js

@@ -0,0 +1,36 @@
+/**
+ * Error Classes Module - SMI-881
+ *
+ * Provides custom error classes with proper cause chaining for better error propagation.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   SkillsmithError,
+ *   ApiError,
+ *   NetworkError,
+ *   ValidationError,
+ *   SkillError,
+ *   ConfigurationError,
+ *   wrapError,
+ *   getErrorMessage
+ * } from '@skillsmith/core/errors'
+ *
+ * try {
+ *   const response = await fetch(url)
+ *   if (!response.ok) {
+ *     throw new ApiError('API request failed', {
+ *       statusCode: response.status,
+ *       url
+ *     })
+ *   }
+ * } catch (error) {
+ *   // Wrap unknown errors for consistent handling
+ *   throw wrapError(error, 'Failed to fetch data')
+ * }
+ * ```
+ *
+ * @module errors
+ */
+export { SkillsmithError, NetworkError, ApiError, ValidationError, SkillError, ConfigurationError, wrapError, getErrorMessage, isSkillsmithError, } from './SkillsmithError.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EACL,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,iBAAiB,GAClB,MAAM,sBAAsB,CAAA"}

package/dist/src/errors.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Skillsmith Error Code Taxonomy
+ * SMI-583: Structured error handling
+ */
+export type ErrorCategory = 'SKILL' | 'SEARCH' | 'CONFIG' | 'NETWORK' | 'VALIDATION' | 'INTERNAL';
+export declare const ErrorCodes: {
+    readonly SKILL_NOT_FOUND: "SKILL_NOT_FOUND";
+    readonly SKILL_INVALID_ID: "SKILL_INVALID_ID";
+    readonly SKILL_INSTALL_FAILED: "SKILL_INSTALL_FAILED";
+    readonly SKILL_PARSE_ERROR: "SKILL_PARSE_ERROR";
+    readonly SEARCH_QUERY_EMPTY: "SEARCH_QUERY_EMPTY";
+    readonly SEARCH_QUERY_INVALID: "SEARCH_QUERY_INVALID";
+    readonly SEARCH_INDEX_UNAVAILABLE: "SEARCH_INDEX_UNAVAILABLE";
+    readonly SEARCH_TIMEOUT: "SEARCH_TIMEOUT";
+    readonly CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
+    readonly CONFIG_INVALID: "CONFIG_INVALID";
+    readonly CONFIG_PERMISSION_DENIED: "CONFIG_PERMISSION_DENIED";
+    readonly NETWORK_UNREACHABLE: "NETWORK_UNREACHABLE";
+    readonly NETWORK_TIMEOUT: "NETWORK_TIMEOUT";
+    readonly NETWORK_RATE_LIMITED: "NETWORK_RATE_LIMITED";
+    readonly VALIDATION_REQUIRED_FIELD: "VALIDATION_REQUIRED_FIELD";
+    readonly VALIDATION_INVALID_TYPE: "VALIDATION_INVALID_TYPE";
+    readonly VALIDATION_OUT_OF_RANGE: "VALIDATION_OUT_OF_RANGE";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly INTERNAL_NOT_IMPLEMENTED: "INTERNAL_NOT_IMPLEMENTED";
+};
+export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+/**
+ * Structured error response format
+ */
+export interface ErrorResponse {
+    error: {
+        code: ErrorCode;
+        message: string;
+        suggestion?: string;
+        details?: Record<string, unknown>;
+    };
+}
+/**
+ * Error suggestions map for actionable feedback
+ */
+export declare const ErrorSuggestions: Partial<Record<ErrorCode, string>>;
+/**
+ * Custom error class for Skillsmith operations
+ */
+export declare class SkillsmithError extends Error {
+    readonly code: ErrorCode;
+    readonly suggestion?: string;
+    readonly details?: Record<string, unknown>;
+    constructor(code: ErrorCode, message: string, options?: {
+        suggestion?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+    /**
+     * Convert to structured error response
+     */
+    toResponse(): ErrorResponse;
+    /**
+     * Format for terminal display
+     */
+    toTerminalString(): string;
+}
+/**
+ * Create an error response from an unknown error
+ */
+export declare function createErrorResponse(error: unknown): ErrorResponse;
+/**
+ * Wrap a handler function with error boundary
+ */
+export declare function withErrorBoundary<T extends (...args: unknown[]) => Promise<unknown>>(handler: T, logError?: (error: unknown) => void): T;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,UAAU,CAAA;AAGd,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;CA+Bb,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,IAAI,EAAE,SAAS,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAClC,CAAA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAO/D,CAAA;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,IAAI,EAAE,SAAS,CAAA;IAC/B,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAG/C,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACjC,KAAK,CAAC,EAAE,KAAK,CAAA;KACd;IASH;;OAEG;IACH,UAAU,IAAI,aAAa;IAW3B;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAO3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAuBjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAClF,OAAO,EAAE,CAAC,EACV,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAClC,CAAC,CAeH"}

package/dist/src/errors.js

@@ -0,0 +1,123 @@
+/**
+ * Skillsmith Error Code Taxonomy
+ * SMI-583: Structured error handling
+ */
+// Specific error codes
+export const ErrorCodes = {
+    // Skill errors
+    SKILL_NOT_FOUND: 'SKILL_NOT_FOUND',
+    SKILL_INVALID_ID: 'SKILL_INVALID_ID',
+    SKILL_INSTALL_FAILED: 'SKILL_INSTALL_FAILED',
+    SKILL_PARSE_ERROR: 'SKILL_PARSE_ERROR',
+    // Search errors
+    SEARCH_QUERY_EMPTY: 'SEARCH_QUERY_EMPTY',
+    SEARCH_QUERY_INVALID: 'SEARCH_QUERY_INVALID',
+    SEARCH_INDEX_UNAVAILABLE: 'SEARCH_INDEX_UNAVAILABLE',
+    SEARCH_TIMEOUT: 'SEARCH_TIMEOUT',
+    // Config errors
+    CONFIG_NOT_FOUND: 'CONFIG_NOT_FOUND',
+    CONFIG_INVALID: 'CONFIG_INVALID',
+    CONFIG_PERMISSION_DENIED: 'CONFIG_PERMISSION_DENIED',
+    // Network errors
+    NETWORK_UNREACHABLE: 'NETWORK_UNREACHABLE',
+    NETWORK_TIMEOUT: 'NETWORK_TIMEOUT',
+    NETWORK_RATE_LIMITED: 'NETWORK_RATE_LIMITED',
+    // Validation errors
+    VALIDATION_REQUIRED_FIELD: 'VALIDATION_REQUIRED_FIELD',
+    VALIDATION_INVALID_TYPE: 'VALIDATION_INVALID_TYPE',
+    VALIDATION_OUT_OF_RANGE: 'VALIDATION_OUT_OF_RANGE',
+    // Internal errors
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    INTERNAL_NOT_IMPLEMENTED: 'INTERNAL_NOT_IMPLEMENTED',
+};
+/**
+ * Error suggestions map for actionable feedback
+ */
+export const ErrorSuggestions = {
+    SKILL_NOT_FOUND: 'Try searching with different keywords or check the skill ID spelling',
+    SKILL_INVALID_ID: 'Skill IDs should be in format "author/skill-name" or a valid UUID',
+    SEARCH_QUERY_EMPTY: 'Provide a search query with at least 2 characters',
+    SEARCH_INDEX_UNAVAILABLE: 'The search index is being updated. Please try again in a moment',
+    CONFIG_NOT_FOUND: 'Run "skillsmith init" to create the configuration file',
+    NETWORK_RATE_LIMITED: 'Wait a few minutes before trying again',
+};
+/**
+ * Custom error class for Skillsmith operations
+ */
+export class SkillsmithError extends Error {
+    code;
+    suggestion;
+    details;
+    constructor(code, message, options) {
+        super(message, { cause: options?.cause });
+        this.name = 'SkillsmithError';
+        this.code = code;
+        this.suggestion = options?.suggestion ?? ErrorSuggestions[code];
+        this.details = options?.details;
+    }
+    /**
+     * Convert to structured error response
+     */
+    toResponse() {
+        return {
+            error: {
+                code: this.code,
+                message: this.message,
+                suggestion: this.suggestion,
+                details: this.details,
+            },
+        };
+    }
+    /**
+     * Format for terminal display
+     */
+    toTerminalString() {
+        let output = `Error [${this.code}]: ${this.message}`;
+        if (this.suggestion) {
+            output += `\n  Suggestion: ${this.suggestion}`;
+        }
+        return output;
+    }
+}
+/**
+ * Create an error response from an unknown error
+ */
+export function createErrorResponse(error) {
+    if (error instanceof SkillsmithError) {
+        return error.toResponse();
+    }
+    if (error instanceof Error) {
+        return {
+            error: {
+                code: ErrorCodes.INTERNAL_ERROR,
+                message: error.message,
+                suggestion: 'An unexpected error occurred. Please try again or report this issue.',
+                details: { stack: error.stack },
+            },
+        };
+    }
+    return {
+        error: {
+            code: ErrorCodes.INTERNAL_ERROR,
+            message: String(error),
+            suggestion: 'An unexpected error occurred. Please try again.',
+        },
+    };
+}
+/**
+ * Wrap a handler function with error boundary
+ */
+export function withErrorBoundary(handler, logError) {
+    return (async (...args) => {
+        try {
+            return await handler(...args);
+        }
+        catch (error) {
+            logError?.(error);
+            throw error instanceof SkillsmithError
+                ? error
+                : new SkillsmithError(ErrorCodes.INTERNAL_ERROR, error instanceof Error ? error.message : String(error), { cause: error instanceof Error ? error : undefined });
+        }
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @skillsmith/core - Core functionality for skill discovery
+ */
+export declare const VERSION = "0.1.0";
+export { SCHEMA_VERSION, createDatabase, openDatabase, closeDatabase, initializeSchema, getSchemaVersion, runMigrations, runMigrationsSafe, } from './db/schema.js';
+export type { DatabaseType } from './db/schema.js';
+export { SkillRepository } from './repositories/SkillRepository.js';
+export { CacheRepository } from './repositories/CacheRepository.js';
+export { IndexerRepository } from './repositories/IndexerRepository.js';
+export type { IndexedSkill, UpsertResult, BatchUpsertResult, } from './repositories/IndexerRepository.js';
+export { SearchService } from './services/SearchService.js';
+export type { Skill, SkillCreateInput, SkillUpdateInput, PaginatedResults, SearchOptions, SearchResult, TrustTier, CacheEntry, } from './types/skill.js';
+export { HybridSearch } from './search/index.js';
+export type { HybridSearchOptions, SearchQuery, SearchResponse } from './search/index.js';
+export type { EmbeddingResult, SimilarityResult, EmbeddingServiceOptions, } from './embeddings/index.js';
+export { L1Cache, L2Cache, TieredCache } from './cache/index.js';
+export type { SearchCacheEntry, SearchResult as CachedSearchResult, CacheStats, TieredCacheOptions, } from './cache/index.js';
+export { SecurityScanner } from './security/index.js';
+export type { SecurityFinding, ScanReport, ScannerOptions } from './security/index.js';
+export { validateDbPath, validateDbPathOrThrow, isPathSafe, DEFAULT_ALLOWED_DIRS, } from './security/index.js';
+export type { PathValidationOptions, PathValidationResult } from './security/index.js';
+export { ErrorCodes, ErrorSuggestions, SkillsmithError, createErrorResponse, withErrorBoundary, type ErrorCategory, type ErrorCode, type ErrorResponse, } from './errors.js';
+/**
+ * Enhanced error classes with cause chaining (SMI-881)
+ *
+ * Error class versioning:
+ * - `SkillsmithError` (legacy): Simple error with code property
+ * - `SkillsmithErrorV2` (new): Enhanced with cause chaining, context object, getErrorChain() method
+ */
+export { SkillsmithError as SkillsmithErrorV2, NetworkError, ApiError, ValidationError, SkillError, ConfigurationError, wrapError, getErrorMessage, isSkillsmithError, } from './errors/index.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 './types.js';
+export { SkillParser, GitHubIndexer } from './indexer/index.js';
+export type { SkillFrontmatter, ParsedSkillMetadata, ValidationResult, SkillParserOptions, GitHubIndexerOptions, IndexResult, SkillMetadata, } from './indexer/index.js';
+export { SessionManager, DefaultCommandExecutor, SessionRecovery, createSessionRecovery, ActiveSessionContext, NullSessionContext, createSessionContext, isActiveContext, getSessionDuration, formatSessionDuration, getLatestCheckpoint, } from './session/index.js';
+export type { SessionOptions, MemoryResult, CommandExecutor, Checkpoint, SessionData, SessionContext, RecoveryStatus, RecoveryResult, RecoveryOptions, } from './session/index.js';
+export { BenchmarkRunner, SearchBenchmark, IndexBenchmark, runAllBenchmarks, formatReportAsJson, formatReportAsText, compareReports, validateSearchResults, validateIndexResults, SEARCH_TARGETS, INDEX_TARGETS, type BenchmarkConfig, type BenchmarkResult, type BenchmarkStats, type BenchmarkReport, type BenchmarkDefinition, type BenchmarkFn, type MemoryStats, type EnvironmentInfo, type ComparisonResult, type MetricComparison, type SearchBenchmarkConfig, type ValidationResult as BenchmarkValidationResult, type IndexBenchmarkConfig, type ThroughputResult, type SizeImpactResult, type IndexValidationResult, type CLIOptions, CacheBenchmark, EmbeddingBenchmark, CACHE_TARGETS, EMBEDDING_TARGETS, validateCacheResults, validateEmbeddingResults, type CacheBenchmarkConfig, type CacheValidationResult, type EmbeddingBenchmarkConfig, type EmbeddingValidationResult, } from './benchmarks/index.js';
+export { WebhookHandler, WebhookQueue, isSkillFile, extractSkillChanges, parseWebhookPayload, } from './webhooks/index.js';
+export type { WebhookEventType, RepositoryAction, GitUser, PushCommit, RepositoryOwner, WebhookRepository, WebhookSender, PushEventPayload, RepositoryEventPayload, PingEventPayload, WebhookPayload, ParsedWebhookEvent, SignatureVerificationResult, SkillFileChange, WebhookHandlerOptions, WebhookHandleResult, QueueItemType, QueuePriority, WebhookQueueItem, QueueProcessResult, QueueStats, WebhookQueueOptions, } from './webhooks/index.js';
+export { BaseSourceAdapter, SourceAdapterRegistry, SourceIndexer, defaultRegistry, isSourceAdapter, } from './sources/index.js';
+export type { ISourceAdapter, SourceType, SourceConfig, RateLimitConfig as SourceRateLimitConfig, SourceAuthConfig, SourceLocation, SourceRepository, SkillContent, SourceSearchOptions, SourceSearchResult, SkillIndexResult, BatchIndexResult, SourceHealth, SourceAdapterFactory, RegistryStats, ParsedSkillMetadata as SourceParsedSkillMetadata, ISkillParser, ISkillRepository, SourceIndexerOptions, } from './sources/index.js';
+export { QualityScorer, quickScore, scoreFromRepository } from './scoring/index.js';
+export type { QualityScoringInput, QualityScoreBreakdown, ScoringWeights } from './scoring/index.js';
+export { DailyIndexPipeline, createScheduledPipeline, runDailyIndex } from './pipeline/index.js';
+export type { PipelineStatus, PipelineSourceConfig, PipelineConfig, PipelineProgress, SourceResult, PipelineResult, } from './pipeline/index.js';
+export { SkillsmithTracer, getTracer, initializeTracing, shutdownTracing, traced, MetricsRegistry, getMetrics, initializeMetrics, timeAsync, timeSync, initializeTelemetry, shutdownTelemetry, LATENCY_BUCKETS, exportToPrometheus, getPrometheusMetrics, createPrometheusHandler, type TracerConfig, type SpanAttributes, type SpanWrapper, type MetricsConfig, type MetricLabels, type Counter, type Histogram, type Gauge, type MetricsSnapshot, type PrometheusExportOptions, } from './telemetry/index.js';
+export { CodebaseAnalyzer, type CodebaseContext, type ImportInfo, type ExportInfo, type FunctionInfo, type FrameworkInfo, type DependencyInfo, type AnalyzeOptions, } from './analysis/index.js';
+export { SkillMatcher, OverlapDetector, type MatchableSkill, type SkillMatchResult, type SkillMatcherOptions, type TriggerPhraseSkill, type OverlapResult, type FilteredSkillsResult, type OverlapDetectorOptions, } from './matching/index.js';
+export { RateLimiter, InMemoryRateLimitStorage, createRateLimiterFromPreset, RATE_LIMIT_PRESETS, type RateLimitConfig, type RateLimitResult, type RateLimitStorage, type RateLimitMetrics, } from './security/RateLimiter.js';
+export { TriggerDetector, ContextScorer, DEFAULT_FILE_TRIGGERS, DEFAULT_COMMAND_TRIGGERS, DEFAULT_ERROR_TRIGGERS, DEFAULT_PROJECT_TRIGGERS, type TriggerType, type FilePatternTrigger, type CommandTrigger, type ErrorTrigger, type ProjectTrigger, type DetectedTrigger, type TriggerDetectionOptions, type ContextScore, type ContextScoringWeights, type ContextScorerOptions, } from './triggers/index.js';
+export { ActivationManager, ZeroConfigActivator, type ActivationOptions, type ActivationResult, type SkillConfigSchema, type ConfigField, type ConfigStatus, type ZeroConfigOptions, } from './activation/index.js';
+export { initializeAnalyticsSchema, AnalyticsRepository, UsageAnalyticsService, ExperimentService, ROIDashboardService, anonymizeUserId, hashProjectContext, AnalyticsStorage, UsageTracker, } from './analytics/index.js';
+export type { UsageEvent, UsageEventInput, UsageEventType, Experiment, ExperimentInput, ExperimentStatus, ExperimentVariant, ExperimentAssignment, ExperimentOutcome, OutcomeInput, ExperimentAnalysis, ROIMetrics, ROIMetricType, ValueAttribution, AttributionType, ValueDimension, UsageAnalyticsSummary, ROIDashboard, ExportFormat, ExportOptions, SkillUsageEvent, SkillUsageOutcome, SkillMetrics, UsageTrackerOptions, MetricsAggregator, MetricsExporter, AggregationPeriod, GlobalMetrics, MetricsExport, } from './analytics/index.js';
+export { initializeQuarantineSchema, hasQuarantineTable, migrateQuarantineSchema, QUARANTINE_SEVERITY_POLICIES, type QuarantineSeverity, type QuarantineReviewStatus, } from './db/quarantine-schema.js';
+export { QuarantineRepository, type QuarantineEntry, type QuarantineCreateInput, type QuarantineUpdateInput, type QuarantineQueryFilter, type PaginatedQuarantineResults, type QuarantineStats, type ReviewDecision, } from './repositories/QuarantineRepository.js';
+export { AuditLogger, MIN_RETENTION_DAYS, MAX_RETENTION_DAYS, type AuditEventType, type AuditActor, type AuditResult, type AuditLogEntry, type AuditQueryFilter, type AuditLoggerConfig, type AuditStats, } from './security/AuditLogger.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,OAAO,UAAU,CAAA;AAG9B,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AACvE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,GAClB,MAAM,qCAAqC,CAAA;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAG3D,YAAY,EACV,KAAK,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AASzF,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAChE,YAAY,EACV,gBAAgB,EAChB,YAAY,IAAI,kBAAkB,EAClC,UAAU,EACV,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGtF,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAGtF,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,aAAa,CAAA;AAEpB;;;;;;GAMG;AACH,OAAO,EACL,eAAe,IAAI,iBAAiB,EACpC,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAA;AAG1B,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,YAAY,CAAA;AAGnB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC/D,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,aAAa,GACd,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,IAAI,yBAAyB,EAClD,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EAEf,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,2BAA2B,EAC3B,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,cAAc,EACd,UAAU,EACV,YAAY,EACZ,eAAe,IAAI,qBAAqB,EACxC,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,mBAAmB,IAAI,yBAAyB,EAChD,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACnF,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGpG,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAChG,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,MAAM,EACN,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAEf,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,WAAW,EACX,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,2BAA2B,CAAA;AAGlC,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EAEnB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GACb,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,aAAa,EAEb,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EAEnB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,wCAAwC,CAAA;AAG/C,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAChB,MAAM,2BAA2B,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,73 @@
+/**
+ * @skillsmith/core - Core functionality for skill discovery
+ */
+// Version
+export const VERSION = '0.1.0';
+// Database (SMI-577, SMI-974)
+export { SCHEMA_VERSION, createDatabase, openDatabase, closeDatabase, initializeSchema, getSchemaVersion, runMigrations, runMigrationsSafe, } from './db/schema.js';
+// Repositories (SMI-578, SMI-628)
+export { SkillRepository } from './repositories/SkillRepository.js';
+export { CacheRepository } from './repositories/CacheRepository.js';
+export { IndexerRepository } from './repositories/IndexerRepository.js';
+// Services (SMI-579)
+export { SearchService } from './services/SearchService.js';
+// Search
+export { HybridSearch } from './search/index.js';
+// Cache
+export { L1Cache, L2Cache, TieredCache } from './cache/index.js';
+// Security
+export { SecurityScanner } from './security/index.js';
+// SMI-898: Path Traversal Protection
+export { validateDbPath, validateDbPathOrThrow, isPathSafe, DEFAULT_ALLOWED_DIRS, } from './security/index.js';
+// Error handling (SMI-583)
+export { ErrorCodes, ErrorSuggestions, SkillsmithError, createErrorResponse, withErrorBoundary, } from './errors.js';
+/**
+ * Enhanced error classes with cause chaining (SMI-881)
+ *
+ * Error class versioning:
+ * - `SkillsmithError` (legacy): Simple error with code property
+ * - `SkillsmithErrorV2` (new): Enhanced with cause chaining, context object, getErrorChain() method
+ */
+export { SkillsmithError as SkillsmithErrorV2, NetworkError, ApiError, ValidationError, SkillError, ConfigurationError, wrapError, getErrorMessage, isSkillsmithError, } from './errors/index.js';
+// MCP types (SMI-581, SMI-582)
+export { TrustTierDescriptions, } from './types.js';
+// Indexer (SMI-628)
+export { SkillParser, GitHubIndexer } from './indexer/index.js';
+// Session Management (SMI-641)
+export { SessionManager, DefaultCommandExecutor, SessionRecovery, createSessionRecovery, ActiveSessionContext, NullSessionContext, createSessionContext, isActiveContext, getSessionDuration, formatSessionDuration, getLatestCheckpoint, } from './session/index.js';
+// Benchmarks (SMI-632)
+export { BenchmarkRunner, SearchBenchmark, IndexBenchmark, runAllBenchmarks, formatReportAsJson, formatReportAsText, compareReports, validateSearchResults, validateIndexResults, SEARCH_TARGETS, INDEX_TARGETS, 
+// SMI-738: Cache and embedding benchmarks
+CacheBenchmark, EmbeddingBenchmark, CACHE_TARGETS, EMBEDDING_TARGETS, validateCacheResults, validateEmbeddingResults, } from './benchmarks/index.js';
+// Webhooks (SMI-645)
+export { WebhookHandler, WebhookQueue, isSkillFile, extractSkillChanges, parseWebhookPayload, } from './webhooks/index.js';
+// Source Adapters (SMI-589)
+export { BaseSourceAdapter, SourceAdapterRegistry, SourceIndexer, defaultRegistry, isSourceAdapter, } from './sources/index.js';
+// Quality Scoring (SMI-592)
+export { QualityScorer, quickScore, scoreFromRepository } from './scoring/index.js';
+// Pipeline (SMI-593)
+export { DailyIndexPipeline, createScheduledPipeline, runDailyIndex } from './pipeline/index.js';
+// Telemetry (SMI-739)
+export { SkillsmithTracer, getTracer, initializeTracing, shutdownTracing, traced, MetricsRegistry, getMetrics, initializeMetrics, timeAsync, timeSync, initializeTelemetry, shutdownTelemetry, LATENCY_BUCKETS, 
+// SMI-1018: Prometheus metrics export
+exportToPrometheus, getPrometheusMetrics, createPrometheusHandler, } from './telemetry/index.js';
+// Codebase Analysis (SMI-600)
+export { CodebaseAnalyzer, } from './analysis/index.js';
+// Skill Matching (SMI-602, SMI-604)
+export { SkillMatcher, OverlapDetector, } from './matching/index.js';
+// Security (SMI-730)
+export { RateLimiter, InMemoryRateLimitStorage, createRateLimiterFromPreset, RATE_LIMIT_PRESETS, } from './security/RateLimiter.js';
+// Trigger System (Phase 4)
+export { TriggerDetector, ContextScorer, DEFAULT_FILE_TRIGGERS, DEFAULT_COMMAND_TRIGGERS, DEFAULT_ERROR_TRIGGERS, DEFAULT_PROJECT_TRIGGERS, } from './triggers/index.js';
+// Skill Activation (Phase 4)
+export { ActivationManager, ZeroConfigActivator, } from './activation/index.js';
+// Analytics (Phase 4: Epic 3 & Epic 4)
+export { initializeAnalyticsSchema, AnalyticsRepository, UsageAnalyticsService, ExperimentService, ROIDashboardService, 
+// SMI-914: Skill usage event tracking
+anonymizeUserId, hashProjectContext, AnalyticsStorage, UsageTracker, } from './analytics/index.js';
+// Quarantine Management (SMI-865)
+export { initializeQuarantineSchema, hasQuarantineTable, migrateQuarantineSchema, QUARANTINE_SEVERITY_POLICIES, } from './db/quarantine-schema.js';
+export { QuarantineRepository, } from './repositories/QuarantineRepository.js';
+// Audit Logging (SMI-733)
+export { AuditLogger, MIN_RETENTION_DAYS, MAX_RETENTION_DAYS, } from './security/AuditLogger.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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