@skillsmith/core 0.5.5 → 0.5.6

package/dist/sync/SyncEngine.js

@@ -0,0 +1,341 @@
+/**
+ * SyncEngine - Core sync logic for registry synchronization
+ *
+ * Implements differential sync by comparing local database state with
+ * the live Skillsmith registry API. Fetches only changed skills based
+ * on updated_at timestamps.
+ */
+import { createHash } from 'crypto';
+/**
+ * Hash a content string using SHA-256 and return the hex digest.
+ *
+ * NOTE: Duplicated from packages/mcp-server/src/tools/install.conflict-helpers.ts
+ * to avoid a circular dependency (core → mcp-server). Implementation is identical.
+ * If the hashing algorithm is ever changed it must be updated in both locations.
+ */
+function hashContent(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex');
+}
+/**
+ * Sync engine for registry synchronization
+ */
+export class SyncEngine {
+    apiClient;
+    skillRepo;
+    syncConfigRepo;
+    syncHistoryRepo;
+    skillVersionRepo;
+    advisoryRepo;
+    constructor(apiClient, skillRepo, syncConfigRepo, syncHistoryRepo, skillVersionRepo, advisoryRepo) {
+        this.apiClient = apiClient;
+        this.skillRepo = skillRepo;
+        this.syncConfigRepo = syncConfigRepo;
+        this.syncHistoryRepo = syncHistoryRepo;
+        this.skillVersionRepo = skillVersionRepo;
+        this.advisoryRepo = advisoryRepo ?? null;
+    }
+    /**
+     * Stub: sync advisories from the registry.
+     *
+     * The server-side advisory endpoint does not exist yet. This method logs
+     * a diagnostic message and returns immediately. It will be wired to the
+     * actual endpoint in a future wave when the registry ships advisory data.
+     */
+    syncAdvisories() {
+        if (this.advisoryRepo) {
+            // Advisory sync endpoint not yet available server-side.
+            // This stub will be replaced when the endpoint ships.
+            console.debug('[skillsmith] Advisory sync: no endpoint configured yet');
+        }
+    }
+    /**
+     * Run sync operation
+     */
+    async sync(options = {}) {
+        const { force = false, dryRun = false, pageSize = 100, onProgress } = options;
+        const startTime = Date.now();
+        const errors = [];
+        let skillsAdded = 0;
+        let skillsUpdated = 0;
+        let skillsUnchanged = 0;
+        let totalProcessed = 0;
+        // Start history tracking (skip for dry run)
+        const runId = dryRun ? null : this.syncHistoryRepo.startRun();
+        try {
+            // Check if offline
+            if (this.apiClient.isOffline()) {
+                throw new Error('API client is in offline mode. Cannot sync.');
+            }
+            // Get last sync time for differential sync
+            const config = this.syncConfigRepo.getConfig();
+            const lastSyncAt = force ? null : config.lastSyncAt;
+            onProgress?.({
+                phase: 'connecting',
+                current: 0,
+                total: 0,
+                skillsProcessed: 0,
+                skillsChanged: 0,
+                message: 'Checking API health...',
+            });
+            // Health check
+            const health = await this.apiClient.checkHealth();
+            if (health.status === 'unhealthy') {
+                throw new Error('API is unhealthy. Try again later.');
+            }
+            onProgress?.({
+                phase: 'fetching',
+                current: 0,
+                total: 0,
+                skillsProcessed: 0,
+                skillsChanged: 0,
+                message: lastSyncAt ? `Fetching changes since ${lastSyncAt}` : 'Fetching all skills...',
+            });
+            // Fetch all skills from API with pagination
+            let offset = 0;
+            let hasMore = true;
+            const allSkills = [];
+            // API requires min 2 char query - use multiple broad queries to cover more skills
+            // These common terms appear in most skill names/descriptions
+            const searchQueries = ['git', 'code', 'dev', 'test', 'npm', 'api', 'cli', 'doc'];
+            const seenIds = new Set();
+            for (const searchQuery of searchQueries) {
+                offset = 0;
+                hasMore = true;
+                while (hasMore) {
+                    try {
+                        const response = await this.apiClient.search({
+                            query: searchQuery,
+                            limit: pageSize,
+                            offset,
+                        });
+                        const skills = response.data;
+                        // Deduplicate skills across queries
+                        for (const skill of skills) {
+                            if (!seenIds.has(skill.id)) {
+                                seenIds.add(skill.id);
+                                allSkills.push(skill);
+                            }
+                        }
+                        onProgress?.({
+                            phase: 'fetching',
+                            current: allSkills.length,
+                            total: 0, // Unknown total
+                            skillsProcessed: 0,
+                            skillsChanged: 0,
+                            message: `Fetched ${allSkills.length} skills...`,
+                        });
+                        // Check if there are more results
+                        hasMore = skills.length === pageSize;
+                        offset += pageSize;
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : String(error);
+                        errors.push(`Fetch error at offset ${offset}: ${message}`);
+                        // Continue with what we have if we got some results
+                        if (allSkills.length > 0) {
+                            hasMore = false;
+                        }
+                        else {
+                            throw error;
+                        }
+                    }
+                }
+            }
+            onProgress?.({
+                phase: 'comparing',
+                current: 0,
+                total: allSkills.length,
+                skillsProcessed: 0,
+                skillsChanged: 0,
+                message: 'Comparing with local database...',
+            });
+            // Filter for changed skills if doing differential sync
+            // SMI-1577: Handle optional updated_at field
+            // Skills without timestamps are skipped in differential sync (caught by full sync)
+            const skillsToProcess = lastSyncAt
+                ? allSkills.filter((skill) => {
+                    if (!skill.updated_at) {
+                        // Skip skills without timestamps in differential sync
+                        return false;
+                    }
+                    return new Date(skill.updated_at) > new Date(lastSyncAt);
+                })
+                : allSkills;
+            totalProcessed = allSkills.length;
+            onProgress?.({
+                phase: 'upserting',
+                current: 0,
+                total: skillsToProcess.length,
+                skillsProcessed: totalProcessed,
+                skillsChanged: skillsToProcess.length,
+                message: `Processing ${skillsToProcess.length} changed skills...`,
+            });
+            // Upsert changed skills
+            if (!dryRun && skillsToProcess.length > 0) {
+                const stats = await this.upsertSkills(skillsToProcess, (current) => {
+                    onProgress?.({
+                        phase: 'upserting',
+                        current,
+                        total: skillsToProcess.length,
+                        skillsProcessed: totalProcessed,
+                        skillsChanged: skillsToProcess.length,
+                        message: `Upserting skill ${current}/${skillsToProcess.length}...`,
+                    });
+                });
+                skillsAdded = stats.added;
+                skillsUpdated = stats.updated;
+                skillsUnchanged = stats.unchanged;
+            }
+            else if (dryRun) {
+                // In dry run, count what would be added/updated
+                for (const skill of skillsToProcess) {
+                    const existing = this.skillRepo.findById(skill.id);
+                    if (existing) {
+                        skillsUpdated++;
+                    }
+                    else {
+                        skillsAdded++;
+                    }
+                }
+                skillsUnchanged = allSkills.length - skillsToProcess.length;
+            }
+            else {
+                skillsUnchanged = allSkills.length;
+            }
+            const durationMs = Date.now() - startTime;
+            // Update sync state (skip for dry run)
+            if (!dryRun) {
+                const syncTimestamp = new Date().toISOString();
+                this.syncConfigRepo.setLastSync(syncTimestamp, skillsAdded + skillsUpdated);
+                if (runId) {
+                    if (errors.length > 0) {
+                        this.syncHistoryRepo.completeRunPartial(runId, { skillsAdded, skillsUpdated, skillsUnchanged }, errors.join('; '));
+                    }
+                    else {
+                        this.syncHistoryRepo.completeRun(runId, {
+                            skillsAdded,
+                            skillsUpdated,
+                            skillsUnchanged,
+                        });
+                    }
+                }
+            }
+            // Stub: advisory sync (no endpoint yet — logs diagnostic only)
+            if (!dryRun) {
+                this.syncAdvisories();
+            }
+            onProgress?.({
+                phase: 'complete',
+                current: skillsToProcess.length,
+                total: skillsToProcess.length,
+                skillsProcessed: totalProcessed,
+                skillsChanged: skillsAdded + skillsUpdated,
+                message: 'Sync complete',
+            });
+            return {
+                success: errors.length === 0,
+                skillsAdded,
+                skillsUpdated,
+                skillsUnchanged,
+                totalProcessed,
+                errors,
+                durationMs,
+                dryRun,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            errors.push(message);
+            // Record failure (skip for dry run)
+            if (!dryRun) {
+                this.syncConfigRepo.setLastSyncError(message);
+                if (runId) {
+                    this.syncHistoryRepo.failRun(runId, message);
+                }
+            }
+            return {
+                success: false,
+                skillsAdded,
+                skillsUpdated,
+                skillsUnchanged,
+                totalProcessed,
+                errors,
+                durationMs: Date.now() - startTime,
+                dryRun,
+            };
+        }
+    }
+    /**
+     * Upsert skills into local database
+     */
+    async upsertSkills(skills, onProgress) {
+        let added = 0;
+        let updated = 0;
+        let unchanged = 0;
+        for (let i = 0; i < skills.length; i++) {
+            const skill = skills[i];
+            const existing = this.skillRepo.findById(skill.id);
+            if (existing) {
+                // Check if actually changed
+                if (existing.updatedAt !== skill.updated_at) {
+                    this.skillRepo.update(skill.id, {
+                        name: skill.name,
+                        description: skill.description ?? undefined,
+                        author: skill.author ?? undefined,
+                        repoUrl: skill.repo_url ?? undefined,
+                        qualityScore: skill.quality_score ?? undefined,
+                        trustTier: skill.trust_tier,
+                        tags: skill.tags,
+                    });
+                    updated++;
+                    // Record version hash after successful update
+                    const contentProxy = JSON.stringify({
+                        id: skill.id,
+                        name: skill.name,
+                        description: skill.description ?? null,
+                        updated_at: skill.updated_at ?? null,
+                    });
+                    await this.skillVersionRepo.recordVersion(skill.id, hashContent(contentProxy));
+                }
+                else {
+                    unchanged++;
+                }
+            }
+            else {
+                this.skillRepo.create({
+                    id: skill.id,
+                    name: skill.name,
+                    description: skill.description ?? undefined,
+                    author: skill.author ?? undefined,
+                    repoUrl: skill.repo_url ?? undefined,
+                    qualityScore: skill.quality_score ?? undefined,
+                    trustTier: skill.trust_tier,
+                    tags: skill.tags,
+                });
+                added++;
+                // Record version hash after successful create
+                const contentProxy = JSON.stringify({
+                    id: skill.id,
+                    name: skill.name,
+                    description: skill.description ?? null,
+                    updated_at: skill.updated_at ?? null,
+                });
+                await this.skillVersionRepo.recordVersion(skill.id, hashContent(contentProxy));
+            }
+            onProgress?.(i + 1);
+        }
+        return { added, updated, unchanged };
+    }
+    /**
+     * Get sync status summary
+     */
+    getStatus() {
+        return {
+            config: this.syncConfigRepo.getConfig(),
+            lastRun: this.syncHistoryRepo.getLastSuccessful(),
+            isRunning: this.syncHistoryRepo.isRunning(),
+            isDue: this.syncConfigRepo.isSyncDue(),
+        };
+    }
+}
+//# sourceMappingURL=SyncEngine.js.map

package/dist/sync/SyncEngine.js.map

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

package/dist/sync/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sync Module - Registry synchronization
+ *
+ * Provides functionality for synchronizing the local skill database
+ * with the live Skillsmith registry.
+ */
+export { SyncConfigRepository, type SyncConfig, type SyncConfigUpdate, type SyncFrequency, FREQUENCY_INTERVALS, } from '../repositories/SyncConfigRepository.js';
+export { SyncHistoryRepository, type SyncHistoryEntry, type SyncStatus, type SyncRunResult, } from '../repositories/SyncHistoryRepository.js';
+export { SyncEngine, type SyncOptions, type SyncProgress, type SyncResult } from './SyncEngine.js';
+export { BackgroundSyncService, createBackgroundSyncService, type BackgroundSyncOptions, type BackgroundSyncState, } from './BackgroundSyncService.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,mBAAmB,GACpB,MAAM,yCAAyC,CAAA;AAEhD,OAAO,EACL,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,0CAA0C,CAAA;AAGjD,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGlG,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAA"}

package/dist/sync/index.js

@@ -0,0 +1,14 @@
+/**
+ * Sync Module - Registry synchronization
+ *
+ * Provides functionality for synchronizing the local skill database
+ * with the live Skillsmith registry.
+ */
+// Repositories
+export { SyncConfigRepository, FREQUENCY_INTERVALS, } from '../repositories/SyncConfigRepository.js';
+export { SyncHistoryRepository, } from '../repositories/SyncHistoryRepository.js';
+// Core sync engine
+export { SyncEngine } from './SyncEngine.js';
+// Background service
+export { BackgroundSyncService, createBackgroundSyncService, } from './BackgroundSyncService.js';
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAe;AACf,OAAO,EACL,oBAAoB,EAIpB,mBAAmB,GACpB,MAAM,yCAAyC,CAAA;AAEhD,OAAO,EACL,qBAAqB,GAItB,MAAM,0CAA0C,CAAA;AAEjD,mBAAmB;AACnB,OAAO,EAAE,UAAU,EAAwD,MAAM,iBAAiB,CAAA;AAElG,qBAAqB;AACrB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAG5B,MAAM,4BAA4B,CAAA"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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';
+export { initializePostHog, shutdownPostHog, flushPostHog, trackEvent, trackSkillSearch, trackSkillView, trackSkillInstall, trackApiError, identifyUser, isFeatureFlagEnabled, getPostHog, isPostHogEnabled, ALLOWED_TRAITS, type PostHogConfig, type SkillsmithEventType, type SkillEventProperties, type AllowedUserTraits, } from './posthog.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/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;AAGxB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAA;AAErB;;;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/telemetry/index.js

@@ -0,0 +1,34 @@
+/**
+ * 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';
+// PostHog exports (SMI-1184)
+export { initializePostHog, shutdownPostHog, flushPostHog, trackEvent, trackSkillSearch, trackSkillView, trackSkillInstall, trackApiError, identifyUser, isFeatureFlagEnabled, getPostHog, isPostHogEnabled, ALLOWED_TRAITS, } from './posthog.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/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,6BAA6B;AAC7B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,cAAc,GAKf,MAAM,cAAc,CAAA;AAErB;;;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/telemetry/metric-helpers.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Helper classes and utilities for Skillsmith Metrics
+ * @module @skillsmith/core/telemetry/metric-helpers
+ */
+import type { Counter, Gauge, Histogram, MetricLabels } from './metric-types.js';
+/**
+ * Dynamic import helper that bypasses TypeScript type checking (SMI-755)
+ */
+export declare function dynamicImport(moduleName: string): Promise<unknown>;
+/**
+ * Check if OpenTelemetry is available (SMI-755)
+ */
+export declare function checkOTelAvailability(): Promise<boolean>;
+/**
+ * No-op gauge implementation (used for gauges that track values locally)
+ */
+export declare class NoOpGauge implements Gauge {
+    private values;
+    set(value: number, labels?: MetricLabels): void;
+    getValue(labels?: MetricLabels): number;
+}
+/**
+ * In-memory counter for when OTEL is not available
+ */
+export declare class InMemoryCounter implements Counter {
+    private values;
+    add(value: number, labels?: MetricLabels): void;
+    increment(labels?: MetricLabels): void;
+    getValues(): Map<string, number>;
+}
+/**
+ * In-memory histogram for when OTEL is not available
+ */
+export declare class InMemoryHistogram implements Histogram {
+    private values;
+    private labeledValues;
+    record(value: number, labels?: MetricLabels): void;
+    getStats(): {
+        count: number;
+        sum: number;
+        mean: number;
+        p50: number;
+        p95: number;
+        p99: number;
+    };
+}
+//# sourceMappingURL=metric-helpers.d.ts.map

package/dist/telemetry/metric-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-helpers.d.ts","sourceRoot":"","sources":["../../src/telemetry/metric-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAKhF;;GAEG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAM9D;AAED;;GAEG;AACH,qBAAa,SAAU,YAAW,KAAK;IACrC,OAAO,CAAC,MAAM,CAA4B;IAE1C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAK/C,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;CAIxC;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,OAAO,CAAC,MAAM,CAA4B;IAE1C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAM/C,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAItC,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAGjC;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,aAAa,CAA8B;IAEnD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAUlD,QAAQ,IAAI;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;CAuBhG"}

package/dist/telemetry/metric-helpers.js

@@ -0,0 +1,96 @@
+/**
+ * Helper classes and utilities for Skillsmith Metrics
+ * @module @skillsmith/core/telemetry/metric-helpers
+ */
+/** Whether OpenTelemetry packages are available */
+let otelAvailable = null;
+/**
+ * Dynamic import helper that bypasses TypeScript type checking (SMI-755)
+ */
+export async function dynamicImport(moduleName) {
+    try {
+        const importFn = new Function('m', 'return import(m)');
+        return await importFn(moduleName);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if OpenTelemetry is available (SMI-755)
+ */
+export async function checkOTelAvailability() {
+    if (otelAvailable !== null)
+        return otelAvailable;
+    const result = await dynamicImport('@opentelemetry/api');
+    otelAvailable = result !== null;
+    return otelAvailable;
+}
+/**
+ * No-op gauge implementation (used for gauges that track values locally)
+ */
+export class NoOpGauge {
+    values = new Map();
+    set(value, labels) {
+        const key = labels ? JSON.stringify(labels) : '';
+        this.values.set(key, value);
+    }
+    getValue(labels) {
+        const key = labels ? JSON.stringify(labels) : '';
+        return this.values.get(key) ?? 0;
+    }
+}
+/**
+ * In-memory counter for when OTEL is not available
+ */
+export class InMemoryCounter {
+    values = new Map();
+    add(value, labels) {
+        const key = labels ? JSON.stringify(labels) : '';
+        const current = this.values.get(key) ?? 0;
+        this.values.set(key, current + value);
+    }
+    increment(labels) {
+        this.add(1, labels);
+    }
+    getValues() {
+        return new Map(this.values);
+    }
+}
+/**
+ * In-memory histogram for when OTEL is not available
+ */
+export class InMemoryHistogram {
+    values = [];
+    labeledValues = new Map();
+    record(value, labels) {
+        this.values.push(value);
+        if (labels) {
+            const key = JSON.stringify(labels);
+            const arr = this.labeledValues.get(key) ?? [];
+            arr.push(value);
+            this.labeledValues.set(key, arr);
+        }
+    }
+    getStats() {
+        if (this.values.length === 0) {
+            return { count: 0, sum: 0, mean: 0, p50: 0, p95: 0, p99: 0 };
+        }
+        const sorted = [...this.values].sort((a, b) => a - b);
+        const sum = sorted.reduce((acc, v) => acc + v, 0);
+        const mean = sum / sorted.length;
+        const percentile = (p) => {
+            const index = Math.ceil((p / 100) * sorted.length) - 1;
+            return sorted[Math.max(0, index)];
+        };
+        return {
+            count: sorted.length,
+            sum,
+            mean,
+            p50: percentile(50),
+            p95: percentile(95),
+            p99: percentile(99),
+        };
+    }
+}
+//# sourceMappingURL=metric-helpers.js.map

package/dist/telemetry/metric-helpers.js.map

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