perf-skill 0.0.1 → 0.2.1

package/dist/utils/fs.js

@@ -0,0 +1,106 @@
+/**
+ * File system utilities for temporary file management
+ */
+import { writeFile, rm, readFile, mkdir } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, dirname } from "node:path";
+import { randomUUID } from "node:crypto";
+import { gunzipSync, gzipSync } from "node:zlib";
+import { isGzip } from "./limits.js";
+/**
+ * Generate a unique temporary file path
+ */
+export function getTempPath(prefix = "pprof", ext = ".pb.gz") {
+    return join(tmpdir(), `${prefix}-${randomUUID()}${ext}`);
+}
+/**
+ * Write data to a temporary file and return the path
+ */
+export async function writeToTemp(data, prefix = "pprof", ext = ".pb.gz") {
+    const tempPath = getTempPath(prefix, ext);
+    await writeFile(tempPath, data);
+    return tempPath;
+}
+/**
+ * Safely remove a file (ignores errors)
+ */
+export async function safeRemove(path) {
+    try {
+        await rm(path, { force: true });
+    }
+    catch {
+        // Ignore removal errors
+    }
+}
+/**
+ * Execute a function with a temporary file, ensuring cleanup
+ */
+export async function withTempFile(data, fn, prefix = "pprof", ext = ".pb.gz") {
+    const tempPath = await writeToTemp(data, prefix, ext);
+    try {
+        return await fn(tempPath);
+    }
+    finally {
+        await safeRemove(tempPath);
+    }
+}
+/**
+ * Read and decompress a gzipped file
+ */
+export async function readGzipFile(path, maxOutputBytes) {
+    const data = await readFile(path);
+    return decompressIfNeeded(data, maxOutputBytes);
+}
+/**
+ * Decompress data if gzipped
+ */
+export function decompressIfNeeded(data, maxOutputBytes) {
+    if (isGzip(data)) {
+        if (maxOutputBytes) {
+            return gunzipSync(data, { maxOutputLength: maxOutputBytes });
+        }
+        return gunzipSync(data);
+    }
+    return Buffer.from(data);
+}
+/**
+ * Compress data with gzip
+ */
+export function compressGzip(data) {
+    return gzipSync(data);
+}
+/**
+ * Pick a profile file extension based on compression
+ */
+export function getProfileExtension(data) {
+    return isGzip(data) ? ".pb.gz" : ".pb";
+}
+/**
+ * Ensure directory exists
+ */
+export async function ensureDir(path) {
+    const dir = dirname(path);
+    await mkdir(dir, { recursive: true });
+}
+/**
+ * Convert base64 to Buffer
+ */
+export function base64ToBuffer(base64) {
+    return Buffer.from(base64, "base64");
+}
+/**
+ * Convert Buffer to base64
+ */
+export function bufferToBase64(buffer) {
+    return Buffer.from(buffer).toString("base64");
+}
+/**
+ * Load profile from path or base64
+ */
+export async function loadProfile(input, encoding = "path") {
+    if (encoding === "base64") {
+        return base64ToBuffer(input);
+    }
+    return readFile(input);
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utilities module exports
+ */
+export { logger, setLogLevel, type LogLevel, } from "./logger.js";
+export { DEFAULT_LIMITS, resolveLimits, checkSizeLimit, checkCharLimit, formatBytes, formatDuration, withTimeout, isGzip, validateProfileExtension, } from "./limits.js";
+export { getTempPath, writeToTemp, safeRemove, withTempFile, readGzipFile, decompressIfNeeded, compressGzip, getProfileExtension, ensureDir, base64ToBuffer, bufferToBase64, loadProfile, } from "./fs.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,MAAM,EACN,WAAW,EACX,KAAK,QAAQ,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,EACd,WAAW,EACX,MAAM,EACN,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+/**
+ * Utilities module exports
+ */
+export { logger, setLogLevel, } from "./logger.js";
+export { DEFAULT_LIMITS, resolveLimits, checkSizeLimit, checkCharLimit, formatBytes, formatDuration, withTimeout, isGzip, validateProfileExtension, } from "./limits.js";
+export { getTempPath, writeToTemp, safeRemove, withTempFile, readGzipFile, decompressIfNeeded, compressGzip, getProfileExtension, ensureDir, base64ToBuffer, bufferToBase64, loadProfile, } from "./fs.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,MAAM,EACN,WAAW,GAEZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,EACd,WAAW,EACX,MAAM,EACN,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/utils/limits.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Resource limits and validation
+ */
+import type { ResourceLimits } from "../types.js";
+export declare const DEFAULT_LIMITS: Required<ResourceLimits>;
+/**
+ * Merge user limits with defaults
+ */
+export declare function resolveLimits(userLimits?: ResourceLimits): Required<ResourceLimits>;
+/**
+ * Check if a buffer exceeds size limit
+ */
+export declare function checkSizeLimit(data: Uint8Array | Buffer, maxBytes: number, label?: string): void;
+/**
+ * Check if content exceeds character limit
+ */
+export declare function checkCharLimit(content: string, maxChars: number, label?: string): void;
+/**
+ * Format bytes to human-readable string
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format duration in milliseconds
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Create a timeout promise
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, message?: string): Promise<T>;
+/**
+ * Gzip magic number check
+ */
+export declare function isGzip(data: Uint8Array | Buffer): boolean;
+/**
+ * Validate profile file extension
+ */
+export declare function validateProfileExtension(filename: string): void;
+//# sourceMappingURL=limits.d.ts.map

package/dist/utils/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/utils/limits.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,cAAc,CAMnD,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC,CAKnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAe,GACrB,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAkB,GACxB,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,MAA8B,GACtC,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU/D"}

package/dist/utils/limits.js

@@ -0,0 +1,86 @@
+/**
+ * Resource limits and validation
+ */
+// Default limits
+export const DEFAULT_LIMITS = {
+    maxProfileBytes: 50 * 1024 * 1024, // 50MB compressed
+    maxDecompressedBytes: 200 * 1024 * 1024, // 200MB uncompressed
+    maxMarkdownChars: 200_000, // 200k chars
+    maxSourceLinesPerFile: 50, // lines per source snippet
+    timeoutMs: 60_000, // 60 seconds
+};
+/**
+ * Merge user limits with defaults
+ */
+export function resolveLimits(userLimits) {
+    return {
+        ...DEFAULT_LIMITS,
+        ...userLimits,
+    };
+}
+/**
+ * Check if a buffer exceeds size limit
+ */
+export function checkSizeLimit(data, maxBytes, label = "file") {
+    if (data.length > maxBytes) {
+        throw new Error(`${label} size (${formatBytes(data.length)}) exceeds limit (${formatBytes(maxBytes)})`);
+    }
+}
+/**
+ * Check if content exceeds character limit
+ */
+export function checkCharLimit(content, maxChars, label = "content") {
+    if (content.length > maxChars) {
+        throw new Error(`${label} length (${content.length} chars) exceeds limit (${maxChars} chars)`);
+    }
+}
+/**
+ * Format bytes to human-readable string
+ */
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+/**
+ * Format duration in milliseconds
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    return `${(ms / 60_000).toFixed(1)}m`;
+}
+/**
+ * Create a timeout promise
+ */
+export function withTimeout(promise, ms, message = "Operation timed out") {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => {
+            setTimeout(() => reject(new Error(`${message} after ${formatDuration(ms)}`)), ms);
+        }),
+    ]);
+}
+/**
+ * Gzip magic number check
+ */
+export function isGzip(data) {
+    return data.length >= 2 && data[0] === 0x1f && data[1] === 0x8b;
+}
+/**
+ * Validate profile file extension
+ */
+export function validateProfileExtension(filename) {
+    const validExtensions = [".pb.gz", ".pprof", ".pb"];
+    const hasValidExt = validExtensions.some((ext) => filename.toLowerCase().endsWith(ext));
+    if (!hasValidExt) {
+        throw new Error(`Invalid profile file extension. Expected: ${validExtensions.join(", ")}`);
+    }
+}
+//# sourceMappingURL=limits.js.map

package/dist/utils/limits.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Simple structured logger for observability
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export declare function setLogLevel(level: LogLevel): void;
+export declare const logger: {
+    debug: (message: string, meta?: Record<string, unknown>) => void;
+    info: (message: string, meta?: Record<string, unknown>) => void;
+    warn: (message: string, meta?: Record<string, unknown>) => void;
+    error: (message: string, meta?: Record<string, unknown>) => void;
+    /** Log with timing measurement */
+    time: <T>(label: string, fn: () => T) => T;
+    /** Create a child logger with default metadata */
+    child: (defaultMeta: Record<string, unknown>) => {
+        debug: (message: string, meta?: Record<string, unknown>) => void;
+        info: (message: string, meta?: Record<string, unknown>) => void;
+        warn: (message: string, meta?: Record<string, unknown>) => void;
+        error: (message: string, meta?: Record<string, unknown>) => void;
+    };
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAkB3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAuCD,eAAO,MAAM,MAAM;qBACA,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBACvC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBACtC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;qBACrC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEvD,kCAAkC;WAC3B,CAAC,SAAS,MAAM,MAAM,MAAM,CAAC,KAAG,CAAC;IAqBxC,kDAAkD;yBAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yBACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;wBAEvC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;wBAEtC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yBAErC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;CAG1D,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,82 @@
+/**
+ * Simple structured logger for observability
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let currentLevel = process.env.LOG_LEVEL || "info";
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+function shouldLog(level) {
+    return LOG_LEVELS[level] >= LOG_LEVELS[currentLevel];
+}
+function formatLog(entry) {
+    if (process.env.LOG_FORMAT === "json") {
+        return JSON.stringify(entry);
+    }
+    const { level, message, timestamp, ...rest } = entry;
+    const extras = Object.keys(rest).length > 0
+        ? ` ${JSON.stringify(rest)}`
+        : "";
+    return `[${timestamp}] ${level.toUpperCase()}: ${message}${extras}`;
+}
+function log(level, message, meta) {
+    if (!shouldLog(level))
+        return;
+    const entry = {
+        level,
+        message,
+        timestamp: new Date().toISOString(),
+        ...meta,
+    };
+    const output = formatLog(entry);
+    if (level === "error") {
+        console.error(output);
+    }
+    else if (level === "warn") {
+        console.warn(output);
+    }
+    else {
+        console.log(output);
+    }
+}
+export const logger = {
+    debug: (message, meta) => log("debug", message, meta),
+    info: (message, meta) => log("info", message, meta),
+    warn: (message, meta) => log("warn", message, meta),
+    error: (message, meta) => log("error", message, meta),
+    /** Log with timing measurement */
+    time: (label, fn) => {
+        const start = performance.now();
+        try {
+            const result = fn();
+            if (result instanceof Promise) {
+                return result.then((r) => {
+                    log("debug", `${label} completed`, { durationMs: Math.round(performance.now() - start) });
+                    return r;
+                }).catch((e) => {
+                    log("error", `${label} failed`, { durationMs: Math.round(performance.now() - start), error: String(e) });
+                    throw e;
+                });
+            }
+            log("debug", `${label} completed`, { durationMs: Math.round(performance.now() - start) });
+            return result;
+        }
+        catch (e) {
+            log("error", `${label} failed`, { durationMs: Math.round(performance.now() - start), error: String(e) });
+            throw e;
+        }
+    },
+    /** Create a child logger with default metadata */
+    child: (defaultMeta) => ({
+        debug: (message, meta) => log("debug", message, { ...defaultMeta, ...meta }),
+        info: (message, meta) => log("info", message, { ...defaultMeta, ...meta }),
+        warn: (message, meta) => log("warn", message, { ...defaultMeta, ...meta }),
+        error: (message, meta) => log("error", message, { ...defaultMeta, ...meta }),
+    }),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,IAAI,YAAY,GAAc,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,MAAM,CAAC;AAE3E,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QACzC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QAC5B,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,IAAI,SAAS,KAAK,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,GAAG,MAAM,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B;IAC3E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO;IAE9B,MAAM,KAAK,GAAa;QACtB,KAAK;QACL,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,IAAI;KACR,CAAC;IAEF,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAEhC,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;SAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;IACvF,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;IACrF,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;IACrF,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;IAEvF,kCAAkC;IAClC,IAAI,EAAE,CAAI,KAAa,EAAE,EAAW,EAAK,EAAE;QACzC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;YACpB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;oBACvB,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,YAAY,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;oBAC1F,OAAO,CAAC,CAAC;gBACX,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBACb,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACzG,MAAM,CAAC,CAAC;gBACV,CAAC,CAAM,CAAC;YACV,CAAC;YACD,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,YAAY,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1F,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzG,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,KAAK,EAAE,CAAC,WAAoC,EAAE,EAAE,CAAC,CAAC;QAChD,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CACzD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC;QACpD,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CACxD,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC;QACnD,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CACxD,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC;QACnD,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CACzD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC;KACrD,CAAC;CACH,CAAC"}

package/package.json

@@ -1,11 +1,75 @@
 {
   "name": "perf-skill",
-  "version": "0.0.1",
-  "description": "",
-  "main": "index.js",
+  "version": "0.2.1",
+  "description": "AI Skill for pprof profile analysis - convert .pb.gz to Markdown and generate structured performance recommendations",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "perf-skill": "dist/cli/main.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/server/http.js",
+    "cli": "node --import tsx src/cli/main.ts",
+    "test": "node --test --import tsx 'test/**/*.test.ts'",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist",
+    "update-prompts": "node --import tsx scripts/update-prompt-fixtures.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "pprof",
+    "profiling",
+    "performance",
+    "ai",
+    "llm",
+    "markdown",
+    "cpu",
+    "memory",
+    "heap",
+    "analysis"
+  ],
+  "author": "unadlib",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/skillsland/perf-skill.git"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@datadog/pprof": "^5.13.2",
+    "@fastify/cors": "^11.2.0",
+    "@fastify/helmet": "^13.0.2",
+    "@fastify/multipart": "^9.4.0",
+    "@fastify/rate-limit": "^10.3.0",
+    "commander": "^14.0.3",
+    "fastify": "^5.7.3",
+    "openai": "^6.17.0",
+    "pprof-format": "^2.2.1",
+    "pprof-to-md": "^0.2.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "eslint": "^9.39.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
   },
-  "author": "",
-  "license": "ISC"
+  "files": [
+    "dist",
+    "SKILL.md",
+    "README.md"
+  ]
 }