@skillsmith/core 0.1.0

package/dist/src/sources/shared.js

@@ -0,0 +1,191 @@
+/**
+ * Shared Source Adapter Utilities - SMI-879
+ *
+ * Consolidates duplicated code patterns from GitHub, GitLab, and RawUrl adapters.
+ * Provides common utilities for content decoding, error handling, and response processing.
+ */
+import { ApiError } from '../errors/SkillsmithError.js';
+/**
+ * Standard skill file paths to search for
+ */
+export const SKILL_FILE_PATHS = [
+    'SKILL.md',
+    'skill.md',
+    '.claude/SKILL.md',
+    '.claude/skill.md',
+    'docs/SKILL.md',
+    'docs/skill.md',
+];
+/**
+ * Decode base64 encoded content (used by GitHub and GitLab APIs)
+ *
+ * Previously duplicated in:
+ * - GitHubSourceAdapter.ts:356-367
+ * - GitLabSourceAdapter.ts:376-386
+ *
+ * @param content - The encoded content string
+ * @param encoding - The encoding type ('base64' or 'text')
+ * @returns Decoded string content
+ */
+export function decodeBase64Content(content, encoding) {
+    if (encoding === 'base64') {
+        // Remove any newlines that might be in the base64 string
+        const base64 = content.replace(/\n/g, '');
+        // Use Buffer in Node.js environment
+        if (typeof Buffer !== 'undefined') {
+            return Buffer.from(base64, 'base64').toString('utf-8');
+        }
+        // Fallback for browser environment
+        // atob() decodes to Latin-1, so we need to convert to UTF-8 manually
+        const binaryStr = atob(base64);
+        const bytes = new Uint8Array(binaryStr.length);
+        for (let i = 0; i < binaryStr.length; i++) {
+            bytes[i] = binaryStr.charCodeAt(i);
+        }
+        return new TextDecoder('utf-8').decode(bytes);
+    }
+    return content;
+}
+/**
+ * Check if an HTTP status code indicates a rate limit error
+ *
+ * @param status - HTTP status code
+ * @returns true if rate limit error
+ */
+export function isRateLimitStatus(status) {
+    return status === 403 || status === 429;
+}
+/**
+ * Check if an HTTP status code indicates a server error (retryable)
+ *
+ * @param status - HTTP status code
+ * @returns true if server error
+ */
+export function isServerError(status) {
+    return status >= 500 && status < 600;
+}
+/**
+ * Check if an HTTP status code indicates not found
+ *
+ * @param status - HTTP status code
+ * @returns true if not found
+ */
+export function isNotFoundStatus(status) {
+    return status === 404;
+}
+/**
+ * Handle API response errors with proper error wrapping
+ *
+ * Previously duplicated error handling in:
+ * - GitHubSourceAdapter.ts:166-170, 309-313
+ * - GitLabSourceAdapter.ts:164-168, 324-328
+ * - RawUrlSourceAdapter.ts:113-114, 248-249
+ *
+ * @param response - Fetch Response object
+ * @param context - Context for error message (e.g., "GitHub API", "GitLab API")
+ * @throws ApiError with appropriate code and context
+ */
+export async function handleApiError(response, context, options) {
+    const status = response.status;
+    if (isRateLimitStatus(status)) {
+        throw new ApiError(`${context} rate limit exceeded`, {
+            statusCode: status,
+            url: options?.url,
+            context: {
+                retryAfter: response.headers.get('Retry-After'),
+                rateLimitRemaining: response.headers.get('X-RateLimit-Remaining'),
+                rateLimitReset: response.headers.get('X-RateLimit-Reset'),
+            },
+        });
+    }
+    if (isNotFoundStatus(status)) {
+        throw new ApiError(`${context} resource not found`, {
+            statusCode: status,
+            url: options?.url,
+        });
+    }
+    // Try to get error message from response body
+    let errorBody;
+    try {
+        errorBody = await response.text();
+    }
+    catch {
+        // Ignore body parsing errors
+    }
+    throw new ApiError(`${context} error: ${status}`, {
+        statusCode: status,
+        url: options?.url,
+        context: {
+            statusText: response.statusText,
+            body: errorBody?.slice(0, 500), // Truncate long bodies
+        },
+    });
+}
+/**
+ * Check response and throw appropriate error if not OK
+ *
+ * @param response - Fetch Response object
+ * @param context - Context for error message
+ * @throws ApiError if response is not OK
+ */
+export async function assertResponseOk(response, context, options) {
+    if (!response.ok) {
+        await handleApiError(response, context, options);
+    }
+}
+/**
+ * Parse rate limit headers from response
+ *
+ * @param response - Fetch Response object
+ * @returns Rate limit info or null if not available
+ */
+export function parseRateLimitHeaders(response) {
+    const remaining = response.headers.get('X-RateLimit-Remaining');
+    const limit = response.headers.get('X-RateLimit-Limit');
+    const reset = response.headers.get('X-RateLimit-Reset');
+    return {
+        remaining: remaining ? parseInt(remaining, 10) : null,
+        limit: limit ? parseInt(limit, 10) : null,
+        reset: reset ? new Date(parseInt(reset, 10) * 1000) : null,
+    };
+}
+/**
+ * Extract default branch from repository data
+ *
+ * @param item - API response with branch info
+ * @param defaultValue - Default value if not found
+ */
+export function extractDefaultBranch(item, defaultValue = 'main') {
+    return item.default_branch ?? item.defaultBranch ?? defaultValue;
+}
+/**
+ * Build pagination parameters for API requests
+ *
+ * @param page - Page number (1-indexed)
+ * @param perPage - Items per page
+ * @returns URL search params string
+ */
+export function buildPaginationParams(page, perPage) {
+    return `page=${page}&per_page=${perPage}`;
+}
+/**
+ * Safely parse JSON response with error handling
+ *
+ * @param response - Fetch Response object
+ * @param context - Context for error message
+ * @returns Parsed JSON data
+ */
+export async function parseJsonResponse(response, context) {
+    try {
+        return (await response.json());
+    }
+    catch (error) {
+        throw new ApiError(`Failed to parse ${context} response`, {
+            cause: error,
+            context: {
+                contentType: response.headers.get('Content-Type'),
+            },
+        });
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/src/sources/shared.js.map

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

package/dist/src/sources/types.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Source Adapter Types
+ * Core type definitions for the skill source adapter architecture
+ */
+/**
+ * Supported source types
+ */
+export type SourceType = 'github' | 'gitlab' | 'local' | 'raw-url' | 'registry' | 'custom';
+/**
+ * Source adapter configuration
+ */
+export interface SourceConfig {
+    /** Unique identifier for this source instance */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Source type */
+    type: SourceType;
+    /** Base URL for API requests */
+    baseUrl: string;
+    /** Whether this source is enabled */
+    enabled: boolean;
+    /** Rate limiting configuration */
+    rateLimit?: RateLimitConfig;
+    /** Authentication configuration */
+    auth?: SourceAuthConfig;
+    /** Additional source-specific options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Rate limiting configuration
+ */
+export interface RateLimitConfig {
+    /** Maximum requests per window */
+    maxRequests: number;
+    /** Window duration in milliseconds */
+    windowMs: number;
+    /** Minimum delay between requests in milliseconds */
+    minDelayMs: number;
+}
+/**
+ * Authentication configuration
+ */
+export interface SourceAuthConfig {
+    /** Auth type */
+    type: 'token' | 'basic' | 'oauth' | 'none';
+    /** Token or credentials (should be loaded from env) */
+    credentials?: string;
+}
+/**
+ * Location of a skill within a source
+ */
+export interface SourceLocation {
+    /** Repository owner/namespace */
+    owner?: string;
+    /** Repository name (optional for local/raw-url sources) */
+    repo?: string;
+    /** Branch or ref (default: main/master) */
+    branch?: string;
+    /** Path to skill file (default: SKILL.md) */
+    path?: string;
+}
+/**
+ * Repository information from a source
+ */
+export interface SourceRepository {
+    /** Unique identifier within the source */
+    id: string;
+    /** Repository name */
+    name: string;
+    /** Full URL to the repository */
+    url: string;
+    /** Repository description */
+    description: string | null;
+    /** Owner/namespace */
+    owner: string;
+    /** Default branch */
+    defaultBranch: string;
+    /** Star/like count */
+    stars: number;
+    /** Fork count */
+    forks: number;
+    /** Topics/tags */
+    topics: string[];
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** License identifier */
+    license: string | null;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Raw skill content fetched from source
+ */
+export interface SkillContent {
+    /** Raw content of the skill file */
+    rawContent: string;
+    /** Content hash for change detection */
+    sha: string;
+    /** Location where content was found */
+    location: SourceLocation;
+    /** File path within repository */
+    filePath: string;
+    /** Content encoding */
+    encoding: 'utf-8' | 'base64';
+    /** Last modification timestamp (for local sources) */
+    lastModified?: string;
+}
+/**
+ * Search options for querying sources
+ */
+export interface SourceSearchOptions {
+    /** Search query string */
+    query?: string;
+    /** Topic/tag filters */
+    topics?: string[];
+    /** Minimum star count */
+    minStars?: number;
+    /** Language filter */
+    language?: string;
+    /** Maximum results to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Sort field */
+    sortBy?: 'updated' | 'stars' | 'name' | 'created';
+    /** Sort direction */
+    sortOrder?: 'asc' | 'desc';
+    /** Additional filters */
+    filters?: Record<string, unknown>;
+}
+/**
+ * Result of a search operation
+ */
+export interface SourceSearchResult {
+    /** Found repositories */
+    repositories: SourceRepository[];
+    /** Total count (may be estimated) */
+    totalCount: number;
+    /** Whether more results are available */
+    hasMore: boolean;
+    /** Cursor for next page (if applicable) */
+    nextCursor?: string;
+}
+/**
+ * Result of indexing a single skill
+ */
+export interface SkillIndexResult {
+    /** Whether indexing succeeded */
+    success: boolean;
+    /** Repository URL */
+    repoUrl: string;
+    /** Skill ID if created/updated */
+    skillId?: string;
+    /** Action taken */
+    action: 'created' | 'updated' | 'unchanged' | 'failed';
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Result of a batch indexing operation
+ */
+export interface BatchIndexResult {
+    /** Source identifier */
+    sourceId: string;
+    /** Total repositories processed */
+    total: number;
+    /** Successfully indexed */
+    indexed: number;
+    /** Created new skills */
+    created: number;
+    /** Updated existing skills */
+    updated: number;
+    /** Unchanged (SHA match) */
+    unchanged: number;
+    /** Failed to index */
+    failed: number;
+    /** Individual results */
+    results: SkillIndexResult[];
+    /** Errors encountered */
+    errors: string[];
+    /** Duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * Source health status
+ */
+export interface SourceHealth {
+    /** Whether the source is reachable */
+    healthy: boolean;
+    /** Last successful check timestamp */
+    lastCheck: string;
+    /** Response time in milliseconds */
+    responseTimeMs: number;
+    /** Rate limit remaining (if applicable) */
+    rateLimitRemaining?: number;
+    /** Rate limit reset time */
+    rateLimitReset?: string;
+    /** Error message if unhealthy */
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/sources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sources/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAA;AAE1F;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB;IAClB,IAAI,EAAE,UAAU,CAAA;IAChB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,kCAAkC;IAClC,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,mCAAmC;IACnC,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;IAC1C,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAA;IACV,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,6BAA6B;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,kBAAkB;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,uCAAuC;IACvC,QAAQ,EAAE,cAAc,CAAA;IACxB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,uBAAuB;IACvB,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC5B,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB;IACjB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;IACjD,qBAAqB;IACrB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IAC1B,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,YAAY,EAAE,gBAAgB,EAAE,CAAA;IAChC,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;IACtD,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,yBAAyB;IACzB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAA;IACtB,2CAA2C;IAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/src/sources/types.js

@@ -0,0 +1,6 @@
+/**
+ * Source Adapter Types
+ * Core type definitions for the skill source adapter architecture
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/sources/types.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * SMI-739: Telemetry Module Exports
+ *
+ * Provides OpenTelemetry tracing and metrics for Skillsmith:
+ * - Distributed tracing for request flows
+ * - Custom metrics for performance monitoring
+ * - Graceful fallback when tracing is disabled
+ */
+export { SkillsmithTracer, getTracer, initializeTracing, shutdownTracing, traced, type TracerConfig, type SpanAttributes, type SpanWrapper, } from './tracer.js';
+export { MetricsRegistry, getMetrics, initializeMetrics, timeAsync, timeSync, LATENCY_BUCKETS, type MetricsConfig, type MetricLabels, type Counter, type Histogram, type Gauge, type MetricsSnapshot, } from './metrics.js';
+export { exportToPrometheus, getPrometheusMetrics, createPrometheusHandler, type PrometheusExportOptions, } from './prometheus.js';
+/**
+ * Initialize all telemetry (tracing + metrics)
+ * Call this at application startup
+ */
+export declare function initializeTelemetry(config?: {
+    tracing?: import('./tracer.js').TracerConfig;
+    metrics?: import('./metrics.js').MetricsConfig;
+}): Promise<void>;
+/**
+ * Shutdown all telemetry
+ * Call this at application shutdown
+ */
+export declare function shutdownTelemetry(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,MAAM,EACN,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,eAAe,GACrB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAA;AAExB;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,CAAC,EAAE;IACjD,OAAO,CAAC,EAAE,OAAO,aAAa,EAAE,YAAY,CAAA;IAC5C,OAAO,CAAC,EAAE,OAAO,cAAc,EAAE,aAAa,CAAA;CAC/C,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGvD"}

package/dist/src/telemetry/index.js

@@ -0,0 +1,32 @@
+/**
+ * SMI-739: Telemetry Module Exports
+ *
+ * Provides OpenTelemetry tracing and metrics for Skillsmith:
+ * - Distributed tracing for request flows
+ * - Custom metrics for performance monitoring
+ * - Graceful fallback when tracing is disabled
+ */
+// Tracer exports
+export { SkillsmithTracer, getTracer, initializeTracing, shutdownTracing, traced, } from './tracer.js';
+// Metrics exports
+export { MetricsRegistry, getMetrics, initializeMetrics, timeAsync, timeSync, LATENCY_BUCKETS, } from './metrics.js';
+// Prometheus exports (SMI-1018)
+export { exportToPrometheus, getPrometheusMetrics, createPrometheusHandler, } from './prometheus.js';
+/**
+ * Initialize all telemetry (tracing + metrics)
+ * Call this at application startup
+ */
+export async function initializeTelemetry(config) {
+    const { initializeTracing } = await import('./tracer.js');
+    const { initializeMetrics } = await import('./metrics.js');
+    await Promise.all([initializeTracing(config?.tracing), initializeMetrics(config?.metrics)]);
+}
+/**
+ * Shutdown all telemetry
+ * Call this at application shutdown
+ */
+export async function shutdownTelemetry() {
+    const { shutdownTracing } = await import('./tracer.js');
+    await shutdownTracing();
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iBAAiB;AACjB,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,MAAM,GAIP,MAAM,aAAa,CAAA;AAEpB,kBAAkB;AAClB,OAAO,EACL,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,eAAe,GAOhB,MAAM,cAAc,CAAA;AAErB,gCAAgC;AAChC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GAExB,MAAM,iBAAiB,CAAA;AAExB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAGzC;IACC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;IACzD,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;IAE1D,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;AAC7F,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;IACvD,MAAM,eAAe,EAAE,CAAA;AACzB,CAAC"}

package/dist/src/telemetry/metrics.d.ts

@@ -0,0 +1,171 @@
+/**
+ * SMI-739: Custom Metrics Registration
+ * SMI-755: Graceful fallback when OpenTelemetry unavailable
+ *
+ * Provides metrics collection for Skillsmith operations:
+ * - Request latency histograms
+ * - Cache hit/miss counters
+ * - Error rate counters
+ * - Active operations gauges
+ *
+ * Configuration:
+ * - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP endpoint for metrics export
+ * - SKILLSMITH_TELEMETRY_ENABLED: Master switch for all telemetry (default: auto)
+ * - SKILLSMITH_METRICS_ENABLED: Enable/disable metrics (default: true if endpoint set)
+ *
+ * Graceful Fallback:
+ * - If OpenTelemetry packages are not installed, uses in-memory implementations
+ * - Metrics APIs remain functional for local statistics
+ */
+/**
+ * Metric types
+ */
+export type MetricType = 'counter' | 'histogram' | 'gauge';
+/**
+ * Metrics configuration
+ */
+export interface MetricsConfig {
+    /** Service name for metrics (default: skillsmith) */
+    serviceName?: string;
+    /** OTLP endpoint URL */
+    endpoint?: string;
+    /** Export interval in ms (default: 60000) */
+    exportIntervalMs?: number;
+    /** Enable console export for debugging (default: false) */
+    consoleExport?: boolean;
+}
+/**
+ * Histogram bucket boundaries for latency metrics
+ */
+export declare const LATENCY_BUCKETS: number[];
+/**
+ * Metric labels/attributes
+ */
+export interface MetricLabels {
+    [key: string]: string | number | boolean;
+}
+/**
+ * Counter metric interface
+ */
+export interface Counter {
+    /** Add a value to the counter */
+    add(value: number, labels?: MetricLabels): void;
+    /** Increment by 1 */
+    increment(labels?: MetricLabels): void;
+}
+/**
+ * Histogram metric interface
+ */
+export interface Histogram {
+    /** Record a value */
+    record(value: number, labels?: MetricLabels): void;
+}
+/**
+ * Gauge metric interface
+ */
+export interface Gauge {
+    /** Set the gauge value */
+    set(value: number, labels?: MetricLabels): void;
+    /** Get the current value (if tracked) */
+    getValue(labels?: MetricLabels): number;
+}
+/**
+ * Skillsmith Metrics Registry
+ */
+export declare class MetricsRegistry {
+    private counters;
+    private histograms;
+    private gauges;
+    private enabled;
+    private initialized;
+    private config;
+    readonly mcpRequestLatency: Histogram;
+    readonly mcpRequestCount: Counter;
+    readonly mcpErrorCount: Counter;
+    readonly dbQueryLatency: Histogram;
+    readonly dbQueryCount: Counter;
+    readonly cacheHits: Counter;
+    readonly cacheMisses: Counter;
+    readonly cacheSize: Gauge;
+    readonly embeddingLatency: Histogram;
+    readonly embeddingCount: Counter;
+    readonly searchLatency: Histogram;
+    readonly searchCount: Counter;
+    readonly activeOperations: Gauge;
+    constructor(config?: MetricsConfig);
+    /**
+     * Initialize metrics collection
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if metrics are enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Create a counter metric
+     */
+    createCounter(name: string, _options?: {
+        description?: string;
+        unit?: string;
+    }): Counter;
+    /**
+     * Create a histogram metric
+     */
+    createHistogram(name: string, _options?: {
+        description?: string;
+        unit?: string;
+        buckets?: number[];
+    }): Histogram;
+    /**
+     * Create a gauge metric
+     */
+    createGauge(name: string, _options?: {
+        description?: string;
+        unit?: string;
+    }): Gauge;
+    /**
+     * Get current cache hit ratio
+     */
+    getCacheHitRatio(): number;
+    /**
+     * Get all metrics as a snapshot
+     */
+    getSnapshot(): MetricsSnapshot;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+}
+/**
+ * Metrics snapshot for export
+ */
+export interface MetricsSnapshot {
+    timestamp: string;
+    counters: Record<string, number>;
+    histograms: Record<string, {
+        count: number;
+        sum: number;
+        mean: number;
+        p50: number;
+        p95: number;
+        p99: number;
+    }>;
+    gauges: Record<string, number>;
+}
+/**
+ * Get the default metrics registry
+ */
+export declare function getMetrics(): MetricsRegistry;
+/**
+ * Initialize the default metrics registry
+ */
+export declare function initializeMetrics(config?: MetricsConfig): Promise<MetricsRegistry>;
+/**
+ * Helper: Time an async operation and record to histogram
+ */
+export declare function timeAsync<T>(histogram: Histogram, fn: () => Promise<T>, labels?: MetricLabels): Promise<T>;
+/**
+ * Helper: Time a sync operation and record to histogram
+ */
+export declare function timeSync<T>(histogram: Histogram, fn: () => T, labels?: MetricLabels): T;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/src/telemetry/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/telemetry/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA4BH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,UAA6D,CAAA;AAEzF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,iCAAiC;IACjC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAC/C,qBAAqB;IACrB,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,0BAA0B;IAC1B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAC/C,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;CACxC;AAkFD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,MAAM,CAAyB;IAGvC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,CAAA;IACrC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAA;IAClC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAA;IACzB,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAA;IACpC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAA;gBAEpB,MAAM,GAAE,aAAkB;IAoFtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCjC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAWxF;;OAEG;IACH,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACrE,SAAS;IAWZ;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK;IAWpF;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAuB1B;;OAEG;IACH,WAAW,IAAI,eAAe;IAmC9B;;OAEG;IACH,KAAK,IAAI,IAAI;CAYd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CACpF,CAAA;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAKD;;GAEG;AACH,wBAAgB,UAAU,IAAI,eAAe,CAK5C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAOxF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,CAAC,CAQvF"}