perf-skill 0.0.1 → 0.2.1

package/dist/skill/manifest.js

@@ -0,0 +1,231 @@
+/**
+ * Skill manifest for AI platform integration
+ */
+/**
+ * Full skill manifest with JSON schemas
+ */
+export const SKILL_MANIFEST = {
+    name: "pprof_ai_analyzer",
+    description: "Convert pprof .pb.gz profiles to Markdown and generate AI-powered performance recommendations. Supports CPU and heap profiling analysis, profile comparison/diff, and actionable optimization suggestions.",
+    version: "1.0.0",
+    inputSchema: {
+        type: "object",
+        oneOf: [
+            {
+                title: "Analyze Single Profile",
+                properties: {
+                    action: { type: "string", const: "analyze" },
+                    profile_base64: {
+                        type: "string",
+                        description: "Base64 encoded pprof profile (.pb.gz)",
+                    },
+                    profile_path: {
+                        type: "string",
+                        description: "Path to pprof profile file",
+                    },
+                    format: {
+                        type: "string",
+                        enum: ["summary", "detailed", "adaptive"],
+                        default: "adaptive",
+                    },
+                    profile_type: {
+                        type: "string",
+                        enum: ["cpu", "heap", "auto"],
+                        default: "auto",
+                    },
+                    max_hotspots: {
+                        type: "integer",
+                        minimum: 1,
+                        maximum: 50,
+                        default: 10,
+                    },
+                    include_source: {
+                        type: "boolean",
+                        default: false,
+                    },
+                    mode: {
+                        type: "string",
+                        enum: ["convert-only", "analyze"],
+                        default: "analyze",
+                        description: "convert-only skips LLM analysis",
+                    },
+                    context: {
+                        type: "object",
+                        properties: {
+                            service_name: { type: "string" },
+                            scenario: { type: "string" },
+                            target_slo: { type: "string" },
+                            env: { type: "string" },
+                            recent_changes: { type: "string" },
+                        },
+                    },
+                },
+                required: [],
+                oneOf: [
+                    { required: ["profile_base64"] },
+                    { required: ["profile_path"] },
+                ],
+            },
+            {
+                title: "Diff Two Profiles",
+                properties: {
+                    action: { type: "string", const: "diff" },
+                    base_profile_base64: { type: "string" },
+                    base_profile_path: { type: "string" },
+                    current_profile_base64: { type: "string" },
+                    current_profile_path: { type: "string" },
+                    format: {
+                        type: "string",
+                        enum: ["diff-summary", "diff-detailed", "diff-adaptive"],
+                        default: "diff-adaptive",
+                    },
+                    normalize: {
+                        type: "string",
+                        enum: ["none", "scale-to-base-total", "per-second"],
+                        default: "scale-to-base-total",
+                    },
+                    max_regressions: {
+                        type: "integer",
+                        minimum: 1,
+                        maximum: 20,
+                        default: 10,
+                    },
+                    max_improvements: {
+                        type: "integer",
+                        minimum: 1,
+                        maximum: 20,
+                        default: 5,
+                    },
+                },
+                required: ["action"],
+            },
+        ],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            markdown: {
+                type: "string",
+                description: "Full markdown report",
+            },
+            profile_meta: {
+                type: "object",
+                properties: {
+                    type: { type: "string", enum: ["cpu", "heap"] },
+                    duration_sec: { type: "number" },
+                    samples: { type: "integer" },
+                    sample_type: { type: "string" },
+                    unit: { type: "string" },
+                },
+            },
+            hotspots: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        rank: { type: "integer" },
+                        function: { type: "string" },
+                        self_pct: { type: "number" },
+                        cum_pct: { type: "number" },
+                        location: { type: "string" },
+                        call_path: { type: "array", items: { type: "string" } },
+                    },
+                    required: ["rank", "function"],
+                },
+            },
+            recommendations: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        title: { type: "string" },
+                        rationale: { type: "string" },
+                        steps: { type: "array", items: { type: "string" } },
+                        expected_impact: { type: "string", enum: ["high", "medium", "low"] },
+                        risk: { type: "string", enum: ["high", "medium", "low"] },
+                        confidence: { type: "number", minimum: 0, maximum: 1 },
+                    },
+                    required: ["title", "rationale", "steps", "expected_impact", "risk", "confidence"],
+                },
+            },
+            next_steps: {
+                type: "array",
+                items: { type: "string" },
+            },
+            // Diff-specific fields
+            regressions: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        rank: { type: "integer" },
+                        function: { type: "string" },
+                        delta_self: { type: "number" },
+                        delta_self_pct: { type: "number" },
+                        change_type: { type: "string", enum: ["regression", "improvement", "new", "removed"] },
+                    },
+                },
+            },
+            improvements: {
+                type: "array",
+                items: {
+                    type: "object",
+                },
+            },
+            summary: {
+                type: "array",
+                items: { type: "string" },
+                description: "Executive summary points for diff",
+            },
+        },
+        required: ["markdown", "hotspots"],
+    },
+};
+/**
+ * Get manifest as JSON string
+ */
+export function getManifestJson() {
+    return JSON.stringify(SKILL_MANIFEST, null, 2);
+}
+/**
+ * Get simplified manifest for function calling
+ */
+export function getFunctionCallingManifest() {
+    return {
+        name: "analyze_pprof_profile",
+        description: SKILL_MANIFEST.description,
+        parameters: {
+            type: "object",
+            properties: {
+                profile_base64: {
+                    type: "string",
+                    description: "Base64 encoded pprof profile (.pb.gz)",
+                },
+                format: {
+                    type: "string",
+                    enum: ["summary", "detailed", "adaptive"],
+                    description: "Output format (default: adaptive)",
+                },
+                profile_type: {
+                    type: "string",
+                    enum: ["cpu", "heap", "auto"],
+                    description: "Profile type (default: auto-detect)",
+                },
+                max_hotspots: {
+                    type: "integer",
+                    description: "Maximum hotspots to show (default: 10)",
+                },
+                service_name: {
+                    type: "string",
+                    description: "Name of the service being profiled",
+                },
+                scenario: {
+                    type: "string",
+                    description: "Scenario context (e.g., 'load test', 'production incident')",
+                },
+            },
+            required: ["profile_base64"],
+        },
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/skill/manifest.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Core types for perf-skill
+ */
+export type ProfileType = "cpu" | "heap" | "auto";
+export type OutputFormat = "summary" | "detailed" | "adaptive";
+export type DiffFormat = "diff-summary" | "diff-detailed" | "diff-adaptive";
+export type NormalizeMode = "none" | "scale-to-base-total" | "per-second";
+export interface ConvertOptions {
+    /** Output format: summary, detailed, or adaptive */
+    format?: OutputFormat;
+    /** Profile type: cpu, heap, or auto-detect */
+    profileType?: ProfileType;
+    /** Maximum number of hotspots to include */
+    maxHotspots?: number;
+    /** Source directory for code context */
+    sourceDir?: string;
+    /** Include source code in output */
+    includeSource?: boolean;
+}
+export interface LLMConfig {
+    provider: "openai" | "azure-openai" | "anthropic" | "custom";
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+    maxTokens?: number;
+    temperature?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    timeoutMs?: number;
+}
+export interface AnalysisContext {
+    /** Service or application name */
+    serviceName?: string;
+    /** Scenario description (e.g., load test, production, specific API) */
+    scenario?: string;
+    /** Target SLO (e.g., p99 < 100ms) */
+    targetSLO?: string;
+    /** Environment (prod, staging, dev) */
+    env?: string;
+    /** Recent changes or deployment info */
+    recentChanges?: string;
+}
+export interface ResourceLimits {
+    /** Maximum profile file size in bytes (compressed) */
+    maxProfileBytes?: number;
+    /** Maximum decompressed profile size in bytes */
+    maxDecompressedBytes?: number;
+    /** Maximum markdown output characters */
+    maxMarkdownChars?: number;
+    /** Maximum source lines per file */
+    maxSourceLinesPerFile?: number;
+    /** Processing timeout in milliseconds */
+    timeoutMs?: number;
+}
+export interface AnalyzeOptions extends ConvertOptions {
+    /** Mode: convert-only skips LLM, analyze includes recommendations */
+    mode?: "convert-only" | "analyze";
+    /** LLM configuration */
+    llm?: LLMConfig;
+    /** Analysis context */
+    context?: AnalysisContext;
+    /** Resource limits */
+    limits?: ResourceLimits;
+    /** Redact sensitive information */
+    redact?: boolean;
+}
+export interface DiffOptions extends Omit<ConvertOptions, "format"> {
+    /** Diff output format */
+    format?: DiffFormat | OutputFormat;
+    /** Normalization mode for comparison */
+    normalize?: NormalizeMode;
+    /** Maximum regressions to show */
+    maxRegressions?: number;
+    /** Maximum improvements to show */
+    maxImprovements?: number;
+    /** Minimum absolute delta to report */
+    minAbsoluteDelta?: number;
+    /** Minimum percentage delta to report */
+    minPercentDelta?: number;
+    /** Disable inline frame expansion */
+    noInlines?: boolean;
+    /** Resource limits */
+    limits?: ResourceLimits;
+}
+export interface Hotspot {
+    /** Rank by impact */
+    rank: number;
+    /** Function name */
+    function: string;
+    /** Self percentage (flat) */
+    selfPct?: number;
+    /** Cumulative percentage */
+    cumPct?: number;
+    /** Self value (samples/bytes) */
+    selfValue?: number;
+    /** Cumulative value */
+    cumValue?: number;
+    /** Source location (file:line) */
+    location?: string;
+    /** Call path from root to this function */
+    callPath?: string[];
+    /** Callers of this function */
+    callers?: string[];
+    /** Callees of this function */
+    callees?: string[];
+}
+export interface Recommendation {
+    /** Short title */
+    title: string;
+    /** Explanation with evidence from report */
+    rationale: string;
+    /** Concrete action steps */
+    steps: string[];
+    /** Expected performance impact */
+    expectedImpact: "high" | "medium" | "low";
+    /** Implementation risk */
+    risk: "high" | "medium" | "low";
+    /** Confidence level 0-1 */
+    confidence: number;
+    /** Related hotspot ranks */
+    relatedHotspots?: number[];
+}
+export interface ProfileMeta {
+    type?: "cpu" | "heap";
+    /** Duration in seconds (for CPU profiles) */
+    durationSec?: number;
+    /** Total samples */
+    samples?: number;
+    /** Total value (samples for CPU, bytes for heap) */
+    totalValue?: number;
+    /** Sample type (e.g., "samples", "cpu", "alloc_space") */
+    sampleType?: string;
+    /** Value unit */
+    unit?: string;
+}
+export interface AnalyzeResult {
+    /** Profile metadata */
+    profileMeta?: ProfileMeta;
+    /** Final markdown report (may include LLM appendix) */
+    markdown: string;
+    /** Extracted hotspots */
+    hotspots: Hotspot[];
+    /** LLM-generated recommendations (if mode=analyze) */
+    recommendations?: Recommendation[];
+    /** Suggested next steps for validation */
+    nextSteps?: string[];
+    /** Raw outputs for debugging */
+    raw?: {
+        /** Original pprof-to-md output */
+        pprofToMdMarkdown: string;
+        /** Raw LLM JSON response */
+        llmJson?: unknown;
+        /** LLM parse errors if any */
+        llmErrors?: string[];
+    };
+    /** Processing metrics */
+    metrics?: {
+        convertMs: number;
+        llmMs?: number;
+        totalMs: number;
+        profileBytes: number;
+        markdownChars: number;
+    };
+}
+export interface DiffHotspot extends Hotspot {
+    /** Delta in self value */
+    deltaSelf: number;
+    /** Delta in cumulative value */
+    deltaCum: number;
+    /** Delta as percentage of base */
+    deltaSelfPct: number;
+    deltaCumPct: number;
+    /** Base profile values */
+    baseSelf?: number;
+    baseCum?: number;
+    baseSelfPct?: number;
+    baseCumPct?: number;
+    /** Current profile values */
+    currentSelf?: number;
+    currentCum?: number;
+    currentSelfPct?: number;
+    currentCumPct?: number;
+    /** Change type */
+    changeType: "regression" | "improvement" | "new" | "removed";
+}
+export interface DiffCallPath {
+    /** Full path from root to leaf */
+    path: string[];
+    /** Delta value */
+    deltaValue: number;
+    /** Base value */
+    baseValue?: number;
+    /** Current value */
+    currentValue?: number;
+}
+export interface DiffResult {
+    /** Base profile metadata */
+    baseMeta?: ProfileMeta;
+    /** Current profile metadata */
+    currentMeta?: ProfileMeta;
+    /** Markdown diff report */
+    markdown: string;
+    /** Top regressions (functions that got worse) */
+    regressions: DiffHotspot[];
+    /** Top improvements (functions that got better) */
+    improvements: DiffHotspot[];
+    /** New functions (not in base) */
+    newFunctions?: DiffHotspot[];
+    /** Removed functions (not in current) */
+    removedFunctions?: DiffHotspot[];
+    /** Executive summary points */
+    summary: string[];
+    /** Key regression call paths */
+    regressionPaths?: DiffCallPath[];
+    /** LLM recommendations if requested */
+    recommendations?: Recommendation[];
+    /** Processing metrics */
+    metrics?: {
+        parseBaseMs: number;
+        parseCurrentMs: number;
+        diffMs: number;
+        llmMs?: number;
+        totalMs: number;
+    };
+}
+export interface SkillManifest {
+    name: string;
+    description: string;
+    version: string;
+    inputSchema: object;
+    outputSchema: object;
+}
+export interface AnalyzeRequest {
+    /** Base64 encoded profile or file path */
+    profile: string;
+    /** Profile encoding type */
+    profileEncoding?: "base64" | "path";
+    /** Analysis options */
+    options?: AnalyzeOptions;
+}
+export interface DiffRequest {
+    /** Base profile (base64 or path) */
+    baseProfile: string;
+    /** Current profile (base64 or path) */
+    currentProfile: string;
+    /** Profile encoding type */
+    profileEncoding?: "base64" | "path";
+    /** Diff options */
+    options?: DiffOptions & AnalyzeOptions;
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types for perf-skill
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/fs.d.ts

@@ -0,0 +1,52 @@
+/**
+ * File system utilities for temporary file management
+ */
+/**
+ * Generate a unique temporary file path
+ */
+export declare function getTempPath(prefix?: string, ext?: string): string;
+/**
+ * Write data to a temporary file and return the path
+ */
+export declare function writeToTemp(data: Uint8Array | Buffer, prefix?: string, ext?: string): Promise<string>;
+/**
+ * Safely remove a file (ignores errors)
+ */
+export declare function safeRemove(path: string): Promise<void>;
+/**
+ * Execute a function with a temporary file, ensuring cleanup
+ */
+export declare function withTempFile<T>(data: Uint8Array | Buffer, fn: (path: string) => Promise<T>, prefix?: string, ext?: string): Promise<T>;
+/**
+ * Read and decompress a gzipped file
+ */
+export declare function readGzipFile(path: string, maxOutputBytes?: number): Promise<Buffer>;
+/**
+ * Decompress data if gzipped
+ */
+export declare function decompressIfNeeded(data: Uint8Array | Buffer, maxOutputBytes?: number): Buffer;
+/**
+ * Compress data with gzip
+ */
+export declare function compressGzip(data: Uint8Array | Buffer): Buffer;
+/**
+ * Pick a profile file extension based on compression
+ */
+export declare function getProfileExtension(data: Uint8Array | Buffer): ".pb.gz" | ".pb";
+/**
+ * Ensure directory exists
+ */
+export declare function ensureDir(path: string): Promise<void>;
+/**
+ * Convert base64 to Buffer
+ */
+export declare function base64ToBuffer(base64: string): Buffer;
+/**
+ * Convert Buffer to base64
+ */
+export declare function bufferToBase64(buffer: Buffer | Uint8Array): string;
+/**
+ * Load profile from path or base64
+ */
+export declare function loadProfile(input: string, encoding?: "base64" | "path"): Promise<Buffer>;
+//# sourceMappingURL=fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAE,MAAgB,EAAE,GAAG,GAAE,MAAiB,GAAG,MAAM,CAEpF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,MAAM,GAAE,MAAgB,EACxB,GAAG,GAAE,MAAiB,GACrB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAChC,MAAM,GAAE,MAAgB,EACxB,GAAG,GAAE,MAAiB,GACrB,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAE/E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,QAAQ,GAAG,MAAe,GACnC,OAAO,CAAC,MAAM,CAAC,CAKjB"}