perf-skill 0.0.1 → 0.2.1

package/dist/llm/prompt.js

@@ -0,0 +1,146 @@
+/**
+ * LLM prompt templates for performance analysis
+ */
+/**
+ * System prompt for performance analysis
+ */
+export const SYSTEM_PROMPT = `You are a senior performance engineer specializing in Node.js/JavaScript performance optimization.
+
+Your task is to analyze pprof profiling reports and provide actionable recommendations.
+
+CRITICAL RULES:
+1. ONLY use evidence present in the report (function names, percentages, file locations, call paths)
+2. Do NOT invent or hallucinate file paths, line numbers, or function names that are not in the report
+3. Every recommendation MUST reference specific evidence from the report
+4. Be conservative with confidence scores - only high confidence if evidence is strong
+5. Distinguish between CPU and heap (memory) analysis - they require different strategies
+
+For CPU profiles, focus on:
+- Functions with high self-time (flat) - these are doing actual work
+- Functions with high cumulative time - these may be bottleneck entry points
+- Recursive or repeated call patterns
+- Native functions that suggest slow operations (JSON.parse, regex, etc.)
+
+For Heap profiles, focus on:
+- Functions with high allocation rates
+- Potential memory leaks (retained objects growing over time)
+- Inefficient data structures
+- Objects that could be pooled or reused
+
+Always structure your response as valid JSON matching the provided schema.`;
+/**
+ * Build analysis prompt for a single profile
+ */
+export function buildAnalysisPrompt(args) {
+    const contextSection = args.context
+        ? `## Analysis Context
+
+- **Service:** ${args.context.serviceName || "Unknown"}
+- **Scenario:** ${args.context.scenario || "Not specified"}
+- **Target SLO:** ${args.context.targetSLO || "Not specified"}
+- **Environment:** ${args.context.env || "Not specified"}
+${args.context.recentChanges ? `- **Recent Changes:** ${args.context.recentChanges}` : ""}
+`
+        : "";
+    const profileTypeHint = args.profileType !== "auto"
+        ? `\n**Profile Type:** ${args.profileType.toUpperCase()}\n`
+        : "";
+    return `${contextSection}${profileTypeHint}
+## Profiling Report
+
+Analyze the following pprof Markdown report and produce a structured JSON analysis.
+
+\`\`\`markdown
+${args.markdown}
+\`\`\`
+
+## Required Output
+
+Provide a JSON object with:
+1. **summary**: One paragraph executive summary of findings
+2. **recommendations**: Array of actionable recommendations (1-5 items), each with:
+   - title: Short action title
+   - rationale: Explanation with specific evidence from report
+   - steps: Concrete implementation steps
+   - expectedImpact: high/medium/low
+   - risk: high/medium/low  
+   - confidence: 0-1 based on evidence quality
+3. **nextSteps**: Array of validation experiments or metrics to track
+
+Remember: Only reference functions, percentages, and locations that appear in the report above.`;
+}
+/**
+ * Build prompt for diff analysis
+ */
+export function buildDiffAnalysisPrompt(args) {
+    const contextSection = args.context
+        ? `## Analysis Context
+
+- **Service:** ${args.context.serviceName || "Unknown"}
+- **Scenario:** ${args.context.scenario || "Not specified"}
+- **Target SLO:** ${args.context.targetSLO || "Not specified"}
+- **Environment:** ${args.context.env || "Not specified"}
+${args.context.recentChanges ? `- **Recent Changes:** ${args.context.recentChanges}` : ""}
+`
+        : "";
+    return `${contextSection}
+## Performance Comparison Report
+
+Analyze the following profile comparison report and explain why performance changed.
+
+\`\`\`markdown
+${args.markdown}
+\`\`\`
+
+## Required Output
+
+Provide a JSON object with:
+1. **summary**: Executive summary of the performance change
+2. **overallChange**: "regression" | "improvement" | "mixed" | "unchanged"
+3. **primaryCause**: Main cause of the change (if identifiable)
+4. **regressionAnalysis**: For each major regression, explain:
+   - function: The function name
+   - explanation: Why it got slower
+   - likelyCause: "new_code" | "increased_calls" | "slower_callees" | "data_change" | "unknown"
+5. **recommendations**: Top 1-3 actionable fixes for regressions
+6. **riskAssessment**: Risk if this change goes to production
+
+Focus on the DELTA values and call path changes to identify root causes.`;
+}
+/**
+ * Build repair prompt when LLM output fails validation
+ */
+export function buildRepairPrompt(originalOutput, errors) {
+    return `Your previous response had JSON validation errors:
+
+${errors.map((e) => `- ${e}`).join("\n")}
+
+Original response:
+\`\`\`json
+${originalOutput}
+\`\`\`
+
+Please fix the JSON to match the required schema. Common fixes:
+- Ensure all required fields are present
+- Ensure arrays have at least 1 item where required
+- Ensure numbers are within valid ranges (confidence: 0-1)
+- Ensure enums use valid values
+
+Return ONLY the corrected JSON, no explanation.`;
+}
+/**
+ * Build prompt for quick triage (shorter, faster)
+ */
+export function buildTriagePrompt(markdown) {
+    return `Quick triage of this profile:
+
+${markdown}
+
+In 2-3 sentences, identify:
+1. The #1 optimization opportunity
+2. Estimated effort (easy/medium/hard)
+3. Expected impact (high/medium/low)
+
+Be direct and specific.`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/llm/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/llm/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;2EAuB8C,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAInC;IACC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO;QACjC,CAAC,CAAC;;iBAEW,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,SAAS;kBACpC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,eAAe;oBACtC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,eAAe;qBACxC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,eAAe;EACtD,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;CACxF;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,KAAK,MAAM;QACjD,CAAC,CAAC,uBAAuB,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI;QAC3D,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,GAAG,cAAc,GAAG,eAAe;;;;;;EAM1C,IAAI,CAAC,QAAQ;;;;;;;;;;;;;;;;gGAgBiF,CAAC;AACjG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAGvC;IACC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO;QACjC,CAAC,CAAC;;iBAEW,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,SAAS;kBACpC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,eAAe;oBACtC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,eAAe;qBACxC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,eAAe;EACtD,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;CACxF;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,GAAG,cAAc;;;;;;EAMxB,IAAI,CAAC,QAAQ;;;;;;;;;;;;;;;;yEAgB0D,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,cAAsB,EACtB,MAAgB;IAEhB,OAAO;;EAEP,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;EAItC,cAAc;;;;;;;;;gDASgC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO;;EAEP,QAAQ;;;;;;;wBAOc,CAAC;AACzB,CAAC"}

package/dist/llm/schema.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Zod schemas for LLM output validation
+ */
+import { z } from "zod";
+/**
+ * Hotspot analysis from LLM
+ */
+export declare const HotspotAnalysisSchema: z.ZodObject<{
+    rank: z.ZodNumber;
+    function: z.ZodString;
+    rootCause: z.ZodOptional<z.ZodString>;
+    callPathAnalysis: z.ZodOptional<z.ZodString>;
+    optimizationPotential: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>>;
+}, z.core.$strip>;
+export type HotspotAnalysis = z.infer<typeof HotspotAnalysisSchema>;
+/**
+ * Recommendation from LLM
+ */
+export declare const RecommendationSchema: z.ZodObject<{
+    title: z.ZodString;
+    rationale: z.ZodString;
+    steps: z.ZodArray<z.ZodString>;
+    expectedImpact: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+    risk: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+    confidence: z.ZodNumber;
+    relatedHotspots: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+export type Recommendation = z.infer<typeof RecommendationSchema>;
+/**
+ * Full LLM analysis output
+ */
+export declare const AnalysisOutputSchema: z.ZodObject<{
+    summary: z.ZodString;
+    profileType: z.ZodOptional<z.ZodEnum<{
+        cpu: "cpu";
+        heap: "heap";
+    }>>;
+    hotspotAnalysis: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        rank: z.ZodNumber;
+        function: z.ZodString;
+        rootCause: z.ZodOptional<z.ZodString>;
+        callPathAnalysis: z.ZodOptional<z.ZodString>;
+        optimizationPotential: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>>;
+    }, z.core.$strip>>>;
+    recommendations: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        rationale: z.ZodString;
+        steps: z.ZodArray<z.ZodString>;
+        expectedImpact: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        risk: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        confidence: z.ZodNumber;
+        relatedHotspots: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>>;
+    nextSteps: z.ZodArray<z.ZodString>;
+    caveats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type AnalysisOutput = z.infer<typeof AnalysisOutputSchema>;
+/**
+ * Diff analysis output from LLM
+ */
+export declare const DiffAnalysisOutputSchema: z.ZodObject<{
+    summary: z.ZodString;
+    overallChange: z.ZodEnum<{
+        regression: "regression";
+        improvement: "improvement";
+        mixed: "mixed";
+        unchanged: "unchanged";
+    }>;
+    changePercentage: z.ZodOptional<z.ZodNumber>;
+    primaryCause: z.ZodOptional<z.ZodString>;
+    regressionAnalysis: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        function: z.ZodString;
+        explanation: z.ZodString;
+        likelyCause: z.ZodEnum<{
+            unknown: "unknown";
+            new_code: "new_code";
+            increased_calls: "increased_calls";
+            slower_callees: "slower_callees";
+            data_change: "data_change";
+        }>;
+    }, z.core.$strip>>>;
+    improvementAnalysis: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        function: z.ZodString;
+        explanation: z.ZodString;
+    }, z.core.$strip>>>;
+    recommendations: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        rationale: z.ZodString;
+        steps: z.ZodArray<z.ZodString>;
+        expectedImpact: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        risk: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        confidence: z.ZodNumber;
+        relatedHotspots: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>>;
+    riskAssessment: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DiffAnalysisOutput = z.infer<typeof DiffAnalysisOutputSchema>;
+/**
+ * Validate LLM output against schema
+ */
+export declare function validateAnalysisOutput(data: unknown): {
+    success: boolean;
+    data?: AnalysisOutput;
+    errors?: string[];
+};
+/**
+ * Validate diff analysis output
+ */
+export declare function validateDiffAnalysisOutput(data: unknown): {
+    success: boolean;
+    data?: DiffAnalysisOutput;
+    errors?: string[];
+};
+/**
+ * Get JSON Schema from Zod schema (for LLM function calling)
+ */
+export declare function getAnalysisJsonSchema(): object;
+//# sourceMappingURL=schema.d.ts.map

package/dist/llm/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/llm/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAMhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;iBAQ/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAUA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAUA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAyC9C"}

package/dist/llm/schema.js

@@ -0,0 +1,131 @@
+/**
+ * Zod schemas for LLM output validation
+ */
+import { z } from "zod";
+/**
+ * Hotspot analysis from LLM
+ */
+export const HotspotAnalysisSchema = z.object({
+    rank: z.number().int().positive(),
+    function: z.string(),
+    rootCause: z.string().optional().describe("Likely root cause of high CPU/memory usage"),
+    callPathAnalysis: z.string().optional().describe("Analysis of the call path leading to this hotspot"),
+    optimizationPotential: z.enum(["high", "medium", "low"]).optional(),
+});
+/**
+ * Recommendation from LLM
+ */
+export const RecommendationSchema = z.object({
+    title: z.string().max(100).describe("Short, actionable title"),
+    rationale: z.string().describe("Explanation with evidence from the report (function names, percentages, locations)"),
+    steps: z.array(z.string()).min(1).max(10).describe("Concrete action steps"),
+    expectedImpact: z.enum(["high", "medium", "low"]).describe("Expected performance improvement"),
+    risk: z.enum(["high", "medium", "low"]).describe("Implementation risk"),
+    confidence: z.number().min(0).max(1).describe("Confidence level (0-1) based on evidence quality"),
+    relatedHotspots: z.array(z.number()).optional().describe("Related hotspot ranks"),
+});
+/**
+ * Full LLM analysis output
+ */
+export const AnalysisOutputSchema = z.object({
+    summary: z.string().max(500).describe("One paragraph executive summary"),
+    profileType: z.enum(["cpu", "heap"]).optional(),
+    hotspotAnalysis: z.array(HotspotAnalysisSchema).optional(),
+    recommendations: z.array(RecommendationSchema).min(1).max(10),
+    nextSteps: z.array(z.string()).max(5).describe("Validation experiments or metrics to track"),
+    caveats: z.array(z.string()).optional().describe("Limitations or uncertainties in the analysis"),
+});
+/**
+ * Diff analysis output from LLM
+ */
+export const DiffAnalysisOutputSchema = z.object({
+    summary: z.string().max(500).describe("Executive summary of the performance change"),
+    overallChange: z.enum(["regression", "improvement", "mixed", "unchanged"]),
+    changePercentage: z.number().optional().describe("Overall change as percentage"),
+    primaryCause: z.string().optional().describe("Primary cause of the change"),
+    regressionAnalysis: z.array(z.object({
+        function: z.string(),
+        explanation: z.string().describe("Why this function got slower"),
+        likelyCause: z.enum(["new_code", "increased_calls", "slower_callees", "data_change", "unknown"]),
+    })).optional(),
+    improvementAnalysis: z.array(z.object({
+        function: z.string(),
+        explanation: z.string().describe("Why this function improved"),
+    })).optional(),
+    recommendations: z.array(RecommendationSchema).max(5),
+    riskAssessment: z.string().optional().describe("Risk if this change goes to production"),
+});
+/**
+ * Validate LLM output against schema
+ */
+export function validateAnalysisOutput(data) {
+    const result = AnalysisOutputSchema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    const issues = result.error.issues;
+    return {
+        success: false,
+        errors: issues.map((e) => `${e.path.join(".")}: ${e.message}`),
+    };
+}
+/**
+ * Validate diff analysis output
+ */
+export function validateDiffAnalysisOutput(data) {
+    const result = DiffAnalysisOutputSchema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    const issues = result.error.issues;
+    return {
+        success: false,
+        errors: issues.map((e) => `${e.path.join(".")}: ${e.message}`),
+    };
+}
+/**
+ * Get JSON Schema from Zod schema (for LLM function calling)
+ */
+export function getAnalysisJsonSchema() {
+    return {
+        type: "object",
+        properties: {
+            summary: { type: "string", maxLength: 500 },
+            profileType: { type: "string", enum: ["cpu", "heap"] },
+            hotspotAnalysis: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        rank: { type: "integer" },
+                        function: { type: "string" },
+                        rootCause: { type: "string" },
+                        callPathAnalysis: { type: "string" },
+                        optimizationPotential: { type: "string", enum: ["high", "medium", "low"] },
+                    },
+                    required: ["rank", "function"],
+                },
+            },
+            recommendations: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        title: { type: "string", maxLength: 100 },
+                        rationale: { type: "string" },
+                        steps: { type: "array", items: { type: "string" } },
+                        expectedImpact: { type: "string", enum: ["high", "medium", "low"] },
+                        risk: { type: "string", enum: ["high", "medium", "low"] },
+                        confidence: { type: "number", minimum: 0, maximum: 1 },
+                        relatedHotspots: { type: "array", items: { type: "integer" } },
+                    },
+                    required: ["title", "rationale", "steps", "expectedImpact", "risk", "confidence"],
+                },
+            },
+            nextSteps: { type: "array", items: { type: "string" } },
+            caveats: { type: "array", items: { type: "string" } },
+        },
+        required: ["summary", "recommendations", "nextSteps"],
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/llm/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/llm/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACvF,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACrG,qBAAqB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpE,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oFAAoF,CAAC;IACpH,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC3E,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC9F,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACvE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IACjG,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;CAClF,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACxE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IAC1D,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7D,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC5F,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACjG,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACpF,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC1E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAChF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC3E,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAChE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;KACjG,CAAC,CAAC,CAAC,QAAQ,EAAE;IACd,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;KAC/D,CAAC,CAAC,CAAC,QAAQ,EAAE;IACd,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CACzF,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAKlD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;IACnC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAa;IAKtD,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;IACnC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;YAC3C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE;YACtD,eAAe,EAAE;gBACf,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;wBACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAC5B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAC7B,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACpC,qBAAqB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE;qBAC3E;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;iBAC/B;aACF;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;wBACzC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;wBACnD,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE;wBACnE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE;wBACzD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;wBACtD,eAAe,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;qBAC/D;oBACD,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,CAAC;iBAClF;aACF;YACD,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YACvD,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;SACtD;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,iBAAiB,EAAE,WAAW,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/llm/validate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * LLM output validation and repair
+ */
+import type { LLMClient } from "./client.js";
+import { type AnalysisOutput, type DiffAnalysisOutput } from "./schema.js";
+export interface ParseResult<T> {
+    success: boolean;
+    data?: T;
+    rawJson?: unknown;
+    errors?: string[];
+    repairAttempted?: boolean;
+}
+/**
+ * Try to repair common JSON issues
+ */
+export declare function repairJson(input: string): string;
+/**
+ * Parse and validate analysis output from LLM
+ */
+export declare function parseAnalysisOutput(rawContent: string, client?: LLMClient): Promise<ParseResult<AnalysisOutput>>;
+/**
+ * Parse and validate diff analysis output
+ */
+export declare function parseDiffAnalysisOutput(rawContent: string, client?: LLMClient): Promise<ParseResult<DiffAnalysisOutput>>;
+/**
+ * Create a fallback result when LLM analysis fails
+ */
+export declare function createFallbackResult(hotspots: Array<{
+    rank: number;
+    function: string;
+    selfPct?: number;
+}>): AnalysisOutput;
+//# sourceMappingURL=validate.d.ts.map

package/dist/llm/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/llm/validate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAE1D,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA8BhD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAkDtC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAmC1C;AA8GD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACpE,cAAc,CA6BhB"}