synapsexcoder 6.0.0

package/dist/plugins/plugin-system.js.map

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

package/dist/profiler/cpu-profiler.d.ts

@@ -0,0 +1,53 @@
+/**
+ * CPU Profiler — Wall-clock and async-aware CPU profiling
+ *
+ * Phase 12: Performance Profiling — Tracks function timings, async operations,
+ * blocking operations, and provides call statistics with waterfall tracking.
+ */
+import type { BlockingOperation, CpuProfileResult } from "./profiler-types.js";
+export interface CpuProfilerOptions {
+    /** Threshold in ms for considering a function "slow" (default: 50) */
+    slowThresholdMs?: number;
+    /** Threshold in ms for blocking operations (default: 100) */
+    blockingThresholdMs?: number;
+    /** Maximum functions to track (default: 500) */
+    maxFunctions?: number;
+    /** Maximum async operations to track (default: 1000) */
+    maxAsyncOps?: number;
+}
+export declare class CpuProfiler {
+    private readonly functions;
+    private readonly asyncOps;
+    private readonly blockingOps;
+    private options;
+    private startTime;
+    private isRunning;
+    constructor(options?: CpuProfilerOptions);
+    start(): void;
+    stop(): CpuProfileResult;
+    get isActive(): boolean;
+    /**
+     * Record a function call timing. Call this at the end of a function.
+     */
+    recordFunctionCall(name: string, durationMs: number, isAsync?: boolean, location?: string): void;
+    /**
+     * Profile a synchronous function, returning its result.
+     */
+    profileSync<T>(name: string, fn: () => T, location?: string): T;
+    /**
+     * Profile an async function, returning its result.
+     */
+    profileAsync<T>(name: string, fn: () => Promise<T>, location?: string): Promise<T>;
+    /**
+     * Create a wrapped version of a function that auto-profiles.
+     */
+    wrap<F extends (...args: unknown[]) => unknown>(name: string, fn: F, location?: string): F;
+    /**
+     * Manually add a blocking operation detection.
+     */
+    addBlockingOp(type: BlockingOperation["type"], description: string, durationMs: number, location?: string): void;
+    private getResult;
+    private categorizeBlockingOp;
+    private suggestBlockingFix;
+}
+//# sourceMappingURL=cpu-profiler.d.ts.map

package/dist/profiler/cpu-profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpu-profiler.d.ts","sourceRoot":"","sources":["../../src/profiler/cpu-profiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAGV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IACtE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IACvD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,CAAC,EAAE,kBAAkB;IAcxC,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,gBAAgB;IAKxB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAMD;;OAEG;IACH,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAe,EACxB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IA6CP;;OAEG;IACH,WAAW,CAAC,CAAC,EACX,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,CAAC,EACX,QAAQ,CAAC,EAAE,MAAM,GAChB,CAAC;IAUJ;;OAEG;IACG,YAAY,CAAC,CAAC,EAClB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC;IAuBb;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAC5C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,EACL,QAAQ,CAAC,EAAE,MAAM,GAChB,CAAC;IAgBJ;;OAEG;IACH,aAAa,CACX,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAeP,OAAO,CAAC,SAAS;IAsCjB,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,kBAAkB;CAsB3B"}

package/dist/profiler/cpu-profiler.js

@@ -0,0 +1,233 @@
+/**
+ * CPU Profiler — Wall-clock and async-aware CPU profiling
+ *
+ * Phase 12: Performance Profiling — Tracks function timings, async operations,
+ * blocking operations, and provides call statistics with waterfall tracking.
+ */
+import { performance } from "node:perf_hooks";
+// ============================================================================
+// CpuProfiler
+// ============================================================================
+export class CpuProfiler {
+    functions = new Map();
+    asyncOps = [];
+    blockingOps = [];
+    options;
+    startTime = 0;
+    isRunning = false;
+    constructor(options) {
+        this.options = {
+            slowThresholdMs: 50,
+            blockingThresholdMs: 100,
+            maxFunctions: 500,
+            maxAsyncOps: 1000,
+            ...options,
+        };
+    }
+    // ========================================================================
+    // Lifecycle
+    // ========================================================================
+    start() {
+        this.startTime = performance.now();
+        this.isRunning = true;
+        this.functions.clear();
+        this.asyncOps.length = 0;
+        this.blockingOps.length = 0;
+    }
+    stop() {
+        this.isRunning = false;
+        return this.getResult();
+    }
+    get isActive() {
+        return this.isRunning;
+    }
+    // ========================================================================
+    // Function Profiling
+    // ========================================================================
+    /**
+     * Record a function call timing. Call this at the end of a function.
+     */
+    recordFunctionCall(name, durationMs, isAsync = false, location) {
+        if (!this.isRunning)
+            return;
+        const existing = this.functions.get(name);
+        if (existing) {
+            existing.callCount++;
+            existing.totalTimeMs += durationMs;
+            existing.averageTimeMs = existing.totalTimeMs / existing.callCount;
+            existing.minTimeMs = Math.min(existing.minTimeMs, durationMs);
+            existing.maxTimeMs = Math.max(existing.maxTimeMs, durationMs);
+        }
+        else {
+            if (this.functions.size >= this.options.maxFunctions) {
+                // Evict least-called function
+                const leastCalled = [...this.functions.entries()].sort(([, a], [, b]) => a.callCount - b.callCount)[0];
+                if (leastCalled) {
+                    this.functions.delete(leastCalled[0]);
+                }
+            }
+            this.functions.set(name, {
+                name,
+                location,
+                callCount: 1,
+                totalTimeMs: durationMs,
+                averageTimeMs: durationMs,
+                minTimeMs: durationMs,
+                maxTimeMs: durationMs,
+                isAsync,
+            });
+        }
+        // Detect blocking operations
+        if (durationMs >= this.options.blockingThresholdMs && !isAsync) {
+            this.blockingOps.push({
+                type: this.categorizeBlockingOp(name, durationMs),
+                description: `Blocking call: ${name} took ${durationMs.toFixed(2)}ms`,
+                durationMs,
+                thresholdMs: this.options.blockingThresholdMs,
+                location,
+                suggestion: this.suggestBlockingFix(name, durationMs),
+            });
+        }
+    }
+    /**
+     * Profile a synchronous function, returning its result.
+     */
+    profileSync(name, fn, location) {
+        const start = performance.now();
+        try {
+            return fn();
+        }
+        finally {
+            const duration = performance.now() - start;
+            this.recordFunctionCall(name, duration, false, location);
+        }
+    }
+    /**
+     * Profile an async function, returning its result.
+     */
+    async profileAsync(name, fn, location) {
+        const start = performance.now();
+        let status = "resolved";
+        try {
+            return await fn();
+        }
+        catch (err) {
+            status = "rejected";
+            throw err;
+        }
+        finally {
+            const duration = performance.now() - start;
+            this.recordFunctionCall(name, duration, true, location);
+            if (this.asyncOps.length < this.options.maxAsyncOps) {
+                this.asyncOps.push({
+                    operation: name,
+                    startTime: start,
+                    duration,
+                    status,
+                    location,
+                });
+            }
+        }
+    }
+    /**
+     * Create a wrapped version of a function that auto-profiles.
+     */
+    wrap(name, fn, location) {
+        const isAsyncFn = fn.constructor?.name === "AsyncFunction";
+        if (isAsyncFn) {
+            return (async (...args) => {
+                return this.profileAsync(name, () => fn(...args), location);
+            });
+        }
+        return ((...args) => {
+            return this.profileSync(name, () => fn(...args), location);
+        });
+    }
+    // ========================================================================
+    // Blocking Operation Detection
+    // ========================================================================
+    /**
+     * Manually add a blocking operation detection.
+     */
+    addBlockingOp(type, description, durationMs, location) {
+        this.blockingOps.push({
+            type,
+            description,
+            durationMs,
+            thresholdMs: this.options.blockingThresholdMs,
+            location,
+            suggestion: this.suggestBlockingFix(description, durationMs),
+        });
+    }
+    // ========================================================================
+    // Result
+    // ========================================================================
+    getResult() {
+        const functionList = [...this.functions.values()];
+        const asyncOps = functionList.filter((f) => f.isAsync);
+        const syncOps = functionList.filter((f) => !f.isAsync);
+        const slowestFunctions = [...functionList]
+            .sort((a, b) => b.averageTimeMs - a.averageTimeMs)
+            .slice(0, 20);
+        const mostCalled = [...functionList]
+            .sort((a, b) => b.callCount - a.callCount)
+            .slice(0, 20);
+        const totalTime = functionList.reduce((s, f) => s + f.totalTimeMs, 0);
+        const avgTime = functionList.length > 0 ? totalTime / functionList.length : 0;
+        const peakTime = functionList.length > 0
+            ? Math.max(...functionList.map((f) => f.maxTimeMs))
+            : 0;
+        return {
+            totalFunctions: functionList.length,
+            totalAsyncOps: asyncOps.length,
+            totalSyncOps: syncOps.length,
+            slowestFunctions,
+            mostCalled,
+            asyncWaterfall: [...this.asyncOps]
+                .sort((a, b) => b.duration - a.duration)
+                .slice(0, 50),
+            blockingOps: [...this.blockingOps],
+            averageTimeMs: avgTime,
+            peakTimeMs: peakTime,
+        };
+    }
+    // ========================================================================
+    // Private Helpers
+    // ========================================================================
+    categorizeBlockingOp(name, _durationMs) {
+        const lower = name.toLowerCase();
+        if (lower.includes("readfile") || lower.includes("writefile") || lower.includes("readdir")) {
+            return "sync_io";
+        }
+        if (lower.includes("loop") || lower.includes("sort") || lower.includes("filter") || lower.includes("reduce")) {
+            return "long_loop";
+        }
+        if (lower.includes("compute") || lower.includes("hash") || lower.includes("encrypt") || lower.includes("parse")) {
+            return "heavy_compute";
+        }
+        return "blocking_wait";
+    }
+    suggestBlockingFix(name, _durationMs) {
+        const lower = name.toLowerCase();
+        if (lower.includes("readfile") || lower.includes("writefile")) {
+            return "Replace with async fs.promises API";
+        }
+        if (lower.includes("readdir")) {
+            return "Replace with async fs.promises.readdir";
+        }
+        if (lower.includes("sort")) {
+            return "Consider using a more efficient sorting algorithm or splitting work";
+        }
+        if (lower.includes("loop") || lower.includes("reduce")) {
+            return "Consider chunking the work or using worker threads";
+        }
+        if (lower.includes("parse")) {
+            return "Consider streaming parser for large inputs";
+        }
+        if (lower.includes("hash") || lower.includes("encrypt")) {
+            return "Consider moving to worker thread for heavy crypto operations";
+        }
+        return "Consider splitting into async chunks or using a worker thread";
+    }
+}
+//# sourceMappingURL=cpu-profiler.js.map

package/dist/profiler/cpu-profiler.js.map

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

package/dist/profiler/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Performance Profiler — Barrel Exports
+ *
+ * Phase 12: Performance Profiling — Integrated performance profiler
+ * for CPU, memory, and query analysis with multi-format report generation.
+ */
+export type { ProfilerConfig, ProfileResult, CpuProfileResult, ProfiledFunction, AsyncProfileEntry, BlockingOperation, MemoryProfileResult, MemorySnapshot, MemoryLeakSuspect, AllocationHotspot, QueryProfileResult, SlowQuery, NPlusOneDetection, DuplicateQuery, TimelineEntry, ReportFormat, ExportOptions, } from "./profiler-types.js";
+export { createDefaultProfilerConfig, calculateRiskLevel, createEmptyProfileResult, } from "./profiler-types.js";
+export type { CpuProfilerOptions } from "./cpu-profiler.js";
+export { CpuProfiler } from "./cpu-profiler.js";
+export type { MemoryProfilerOptions } from "./memory-profiler.js";
+export { MemoryProfiler } from "./memory-profiler.js";
+export type { QueryProfilerOptions } from "./query-profiler.js";
+export { QueryProfiler } from "./query-profiler.js";
+export { ReportGenerator } from "./report-generator.js";
+import { CpuProfiler } from "./cpu-profiler.js";
+import { MemoryProfiler } from "./memory-profiler.js";
+import { QueryProfiler } from "./query-profiler.js";
+import { ReportGenerator } from "./report-generator.js";
+import type { ProfilerConfig, ProfileResult, ReportFormat } from "./profiler-types.js";
+/**
+ * Run a full performance profile session.
+ */
+export declare function runProfile(config?: ProfilerConfig, format?: ReportFormat): Promise<{
+    result: ProfileResult;
+    report: string;
+}>;
+/**
+ * Generate profile recommendations based on results.
+ */
+export declare function generateRecommendations(result: ProfileResult): string[];
+export declare function createCpuProfiler(): CpuProfiler;
+export declare function createMemoryProfiler(): MemoryProfiler;
+export declare function createQueryProfiler(): QueryProfiler;
+export declare function createReportGenerator(options?: Partial<import("./profiler-types.js").ExportOptions>): ReportGenerator;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/profiler/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,YAAY,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,qBAAqB,CAAC;AAI7B;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,CAAC,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAwDpD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAkDvE;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD;AAED,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,qBAAqB,EAAE,aAAa,CAAC,GAC7D,eAAe,CAEjB"}

package/dist/profiler/index.js

@@ -0,0 +1,122 @@
+/**
+ * Performance Profiler — Barrel Exports
+ *
+ * Phase 12: Performance Profiling — Integrated performance profiler
+ * for CPU, memory, and query analysis with multi-format report generation.
+ */
+export { createDefaultProfilerConfig, calculateRiskLevel, createEmptyProfileResult, } from "./profiler-types.js";
+export { CpuProfiler } from "./cpu-profiler.js";
+export { MemoryProfiler } from "./memory-profiler.js";
+export { QueryProfiler } from "./query-profiler.js";
+// ============================================================================
+// Report Generator
+// ============================================================================
+export { ReportGenerator } from "./report-generator.js";
+// ============================================================================
+// Convenience API
+// ============================================================================
+import { CpuProfiler } from "./cpu-profiler.js";
+import { MemoryProfiler } from "./memory-profiler.js";
+import { QueryProfiler } from "./query-profiler.js";
+import { ReportGenerator } from "./report-generator.js";
+import { createEmptyProfileResult } from "./profiler-types.js";
+import { performance } from "node:perf_hooks";
+/**
+ * Run a full performance profile session.
+ */
+export async function runProfile(config, format) {
+    const cpu = new CpuProfiler();
+    const memory = new MemoryProfiler();
+    const queries = new QueryProfiler();
+    const result = createEmptyProfileResult(config);
+    result.startTime = performance.now();
+    cpu.start();
+    memory.start();
+    queries.start();
+    result.timeline.push({
+        timestamp: performance.now(),
+        type: "custom",
+        label: "Profiling started",
+    });
+    // Run for configured duration
+    const duration = result.config.maxDurationMs;
+    await new Promise((resolve) => {
+        const checkInterval = setInterval(() => {
+            // Collect CPU sample
+            result.timeline.push({
+                timestamp: performance.now(),
+                type: "cpu_sample",
+                label: "Sample",
+            });
+        }, result.config.sampleIntervalMs);
+        setTimeout(() => {
+            clearInterval(checkInterval);
+            resolve();
+        }, duration);
+    });
+    result.timeline.push({
+        timestamp: performance.now(),
+        type: "custom",
+        label: "Profiling ended",
+    });
+    // Stop profilers
+    result.cpu = cpu.stop();
+    result.memory = memory.stop();
+    result.queries = queries.stop();
+    result.endTime = performance.now();
+    result.duration = result.endTime - result.startTime;
+    // Generate recommendations
+    result.recommendations = generateRecommendations(result);
+    // Generate report
+    const generator = new ReportGenerator();
+    const report = generator.generate(result, format);
+    return { result, report };
+}
+/**
+ * Generate profile recommendations based on results.
+ */
+export function generateRecommendations(result) {
+    const recommendations = [];
+    // CPU recommendations
+    if (result.cpu.blockingOps.length > 0) {
+        recommendations.push(`Fix ${result.cpu.blockingOps.length} blocking operations to improve responsiveness`);
+    }
+    if (result.cpu.averageTimeMs > 100) {
+        recommendations.push("High average CPU time — consider optimizing hot functions or using caching");
+    }
+    // Memory recommendations
+    if (result.memory.riskLevel === "critical" || result.memory.riskLevel === "high") {
+        recommendations.push(`Memory risk level is ${result.memory.riskLevel} — investigate ${result.memory.leakSuspects.length} leak suspects`);
+    }
+    if (result.memory.growthRateMbPerSec > 5) {
+        recommendations.push(`Memory growing at ${result.memory.growthRateMbPerSec.toFixed(1)} MB/s — check for leaks or unbounded caches`);
+    }
+    // Query recommendations
+    if (result.queries.nPlusOneDetections.length > 0) {
+        recommendations.push(`Fix ${result.queries.nPlusOneDetections.length} N+1 query patterns with JOINs or eager loading`);
+    }
+    if (result.queries.slowestQueries.some((q) => q.needsIndex)) {
+        recommendations.push(`Add database indexes for ${result.queries.slowestQueries.filter((q) => q.needsIndex).length} slow query patterns`);
+    }
+    if (result.queries.duplicateDetections.length > 0) {
+        recommendations.push(`Cache results for ${result.queries.duplicateDetections.length} duplicate query patterns to save ${result.queries.duplicateDetections.reduce((s, d) => s + d.wastedTimeMs, 0).toFixed(0)}ms`);
+    }
+    // General recommendations
+    if (recommendations.length === 0) {
+        recommendations.push("No significant performance issues detected — profile looks healthy");
+    }
+    return recommendations;
+}
+export function createCpuProfiler() {
+    return new CpuProfiler();
+}
+export function createMemoryProfiler() {
+    return new MemoryProfiler();
+}
+export function createQueryProfiler() {
+    return new QueryProfiler();
+}
+export function createReportGenerator(options) {
+    return new ReportGenerator(options);
+}
+//# sourceMappingURL=index.js.map

package/dist/profiler/index.js.map

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

package/dist/profiler/memory-profiler.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Memory Profiler — Memory usage tracking and leak detection
+ *
+ * Phase 12: Performance Profiling — Collects memory snapshots, detects
+ * growth patterns, identifies leak suspects, and tracks allocation hotspots.
+ */
+import type { MemorySnapshot, MemoryProfileResult } from "./profiler-types.js";
+export interface MemoryProfilerOptions {
+    /** Sample interval in ms (default: 500) */
+    sampleIntervalMs?: number;
+    /** Maximum number of snapshots (default: 200) */
+    maxSnapshots?: number;
+    /** Memory growth threshold for warnings (MB/s) (default: 2) */
+    growthThresholdMbPerSec?: number;
+    /** Leak detection window in ms (default: 10000) */
+    leakDetectionWindowMs?: number;
+}
+export declare class MemoryProfiler {
+    private readonly snapshots;
+    private readonly leakSuspects;
+    private readonly allocationHotspots;
+    private options;
+    private startTime;
+    private isRunning;
+    private sampleIntervalId;
+    private previousSnapshot;
+    private growthRate;
+    private gcEvents;
+    constructor(options?: MemoryProfilerOptions);
+    start(): void;
+    stop(): MemoryProfileResult;
+    get isActive(): boolean;
+    takeSnapshot(): MemorySnapshot | null;
+    /**
+     * Record an allocation hotspot detected by external analysis.
+     */
+    recordAllocationHotspot(fn: string, location: string, percentAllocations: number, allocationCount: number, suggestion: string): void;
+    /**
+     * Add a memory leak suspect.
+     */
+    addLeakSuspect(pattern: string, description: string, confidence: number, location?: string, suggestion?: string): void;
+    private detectLeaks;
+    private getResult;
+}
+//# sourceMappingURL=memory-profiler.d.ts.map

package/dist/profiler/memory-profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-profiler.d.ts","sourceRoot":"","sources":["../../src/profiler/memory-profiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,KAAK,EACV,cAAc,EAGd,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAO7B,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mDAAmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,gBAAgB,CAA+C;IACvE,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAa;gBAEjB,OAAO,CAAC,EAAE,qBAAqB;IAc3C,KAAK,IAAI,IAAI;IAmBb,IAAI,IAAI,mBAAmB;IAc3B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAMD,YAAY,IAAI,cAAc,GAAG,IAAI;IA+BrC;;OAEG;IACH,uBAAuB,CACrB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,MAAM,EAC1B,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,GACjB,IAAI;IAUP;;OAEG;IACH,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAcP,OAAO,CAAC,WAAW;IAiEnB,OAAO,CAAC,SAAS;CA0BlB"}