tracemeld 0.1.0

package/build/patterns/redundant-read.js

@@ -0,0 +1,72 @@
+import { getAllSpans, extractKind, valuesToRecord } from '../analysis/query.js';
+export function detectRedundantRead(profile) {
+    const matches = [];
+    const allSpans = getAllSpans(profile);
+    // Find turn spans using extractKind
+    const turnSpans = allSpans.filter((s) => {
+        const name = profile.frames[s.frame_index]?.name ?? '';
+        return extractKind(name) === 'turn';
+    });
+    // If no turns, treat all spans as one group
+    const groups = turnSpans.length > 0
+        ? turnSpans.map((t) => getDescendantsInOrder(t, allSpans))
+        : [allSpans.sort((a, b) => a.start_time - b.start_time)];
+    for (const descendants of groups) {
+        const readsByFile = new Map();
+        for (const span of descendants) {
+            const frameName = profile.frames[span.frame_index]?.name ?? '';
+            const kind = extractKind(frameName);
+            const detail = frameName.includes(':') ? frameName.substring(frameName.indexOf(':') + 1) : '';
+            if (kind === 'file_write' && detail) {
+                readsByFile.delete(detail);
+            }
+            else if (kind === 'file_read' && detail) {
+                let reads = readsByFile.get(detail);
+                if (!reads) {
+                    reads = [];
+                    readsByFile.set(detail, reads);
+                }
+                reads.push(span);
+            }
+        }
+        for (const [file, reads] of readsByFile) {
+            if (reads.length >= 2) {
+                const savings = new Array(profile.value_types.length).fill(0);
+                for (let i = 1; i < reads.length; i++) {
+                    for (let k = 0; k < savings.length; k++) {
+                        savings[k] += reads[i].values[k] ?? 0;
+                    }
+                }
+                matches.push({
+                    pattern: {
+                        name: 'redundant_read',
+                        description: `File '${file}' was read ${reads.length} times in one turn with no intervening write`,
+                        severity: 'warning',
+                        evidence: { file, read_count: reads.length },
+                    },
+                    span_ids: reads.map((s) => s.id),
+                    counterfactual_savings: valuesToRecord(profile, savings),
+                    recommendation: 'Read the file once, retain content in reasoning, plan edits before re-reading.',
+                });
+            }
+        }
+    }
+    return matches;
+}
+/** Walk the full subtree of a span, returning all descendants sorted by start_time. */
+function getDescendantsInOrder(parent, allSpans) {
+    const result = [];
+    const stack = [...parent.children];
+    while (stack.length > 0) {
+        const id = stack.pop();
+        if (!id)
+            continue;
+        const span = allSpans.find((s) => s.id === id);
+        if (!span)
+            continue;
+        result.push(span);
+        stack.push(...span.children);
+    }
+    return result.sort((a, b) => a.start_time - b.start_time);
+}
+//# sourceMappingURL=redundant-read.js.map

package/build/patterns/redundant-read.js.map

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

package/build/patterns/registry.d.ts

@@ -0,0 +1,10 @@
+import type { Profile } from '../model/types.js';
+import type { PatternDetector, PatternMatch } from './types.js';
+export declare class PatternRegistry {
+    private detectors;
+    private cache;
+    register(detector: PatternDetector): void;
+    detect(profile: Profile): PatternMatch[];
+    getMatchesForSpan(profile: Profile, spanId: string): PatternMatch[];
+    invalidate(): void;
+}

package/build/patterns/registry.js

@@ -0,0 +1,27 @@
+export class PatternRegistry {
+    detectors = [];
+    cache = null;
+    register(detector) {
+        this.detectors.push(detector);
+        this.cache = null;
+    }
+    detect(profile) {
+        if (this.cache && this.cache.profileId === profile.id) {
+            return this.cache.matches;
+        }
+        const matches = [];
+        for (const detector of this.detectors) {
+            matches.push(...detector(profile));
+        }
+        this.cache = { profileId: profile.id, matches };
+        return matches;
+    }
+    getMatchesForSpan(profile, spanId) {
+        const all = this.detect(profile);
+        return all.filter((m) => m.span_ids.includes(spanId));
+    }
+    invalidate() {
+        this.cache = null;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/build/patterns/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/patterns/registry.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,eAAe;IAClB,SAAS,GAAsB,EAAE,CAAC;IAClC,KAAK,GAA0D,IAAI,CAAC;IAE5E,QAAQ,CAAC,QAAyB;QAChC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,OAAgB;QACrB,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC;YACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5B,CAAC;QAED,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;QAChD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,iBAAiB,CAAC,OAAgB,EAAE,MAAc;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;CACF"}

package/build/patterns/retry-loop.d.ts

@@ -0,0 +1,3 @@
+import type { Profile } from '../model/types.js';
+import type { PatternMatch } from './types.js';
+export declare function detectRetryLoop(profile: Profile): PatternMatch[];

package/build/patterns/retry-loop.js

@@ -0,0 +1,57 @@
+import { getAllSpans, valuesToRecord } from '../analysis/query.js';
+export function detectRetryLoop(profile) {
+    const matches = [];
+    const allSpans = getAllSpans(profile);
+    // Group spans by parent_id to find siblings
+    const siblingGroups = new Map();
+    for (const span of allSpans) {
+        const parentKey = span.parent_id ?? '__root__';
+        let group = siblingGroups.get(parentKey);
+        if (!group) {
+            group = [];
+            siblingGroups.set(parentKey, group);
+        }
+        group.push(span);
+    }
+    for (const siblings of siblingGroups.values()) {
+        siblings.sort((a, b) => a.start_time - b.start_time);
+        let i = 0;
+        while (i < siblings.length) {
+            const run = [siblings[i]];
+            while (i + 1 < siblings.length &&
+                siblings[i + 1].frame_index === run[0].frame_index) {
+                i++;
+                run.push(siblings[i]);
+            }
+            // A retry loop: 2+ consecutive same-frame spans where at least one (except possibly last) has error
+            if (run.length >= 2) {
+                const hasError = run.slice(0, -1).some((s) => s.error);
+                if (hasError) {
+                    const savings = new Array(profile.value_types.length).fill(0);
+                    for (let j = 0; j < run.length - 1; j++) {
+                        for (let k = 0; k < savings.length; k++) {
+                            savings[k] += run[j].values[k] ?? 0;
+                        }
+                    }
+                    matches.push({
+                        pattern: {
+                            name: 'retry_loop',
+                            description: `${run.length} consecutive attempts of the same operation with intervening errors`,
+                            severity: run.length >= 3 ? 'warning' : 'info',
+                            evidence: {
+                                attempt_count: run.length,
+                                errors: run.filter((s) => s.error).map((s) => s.error),
+                            },
+                        },
+                        span_ids: run.map((s) => s.id),
+                        counterfactual_savings: valuesToRecord(profile, savings),
+                        recommendation: 'Read the error carefully before retrying. Consider a different approach after the first failure.',
+                    });
+                }
+            }
+            i++;
+        }
+    }
+    return matches;
+}
+//# sourceMappingURL=retry-loop.js.map

package/build/patterns/retry-loop.js.map

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

package/build/patterns/types.d.ts

@@ -0,0 +1,14 @@
+import type { Profile, DetectedPattern } from '../model/types.js';
+/** A match produced by a pattern detector. */
+export interface PatternMatch {
+    /** The detected pattern (name, description, severity, evidence). */
+    pattern: DetectedPattern;
+    /** Span IDs involved in this match. */
+    span_ids: string[];
+    /** Estimated savings if this waste were eliminated. Keyed by value_type.key. */
+    counterfactual_savings: Record<string, number>;
+    /** Concrete recommendation for the LLM. */
+    recommendation: string;
+}
+/** A pattern detector function. Pure: profile in, matches out. */
+export type PatternDetector = (profile: Profile) => PatternMatch[];

package/build/patterns/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/patterns/types.js.map

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

package/build/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(): McpServer;
+export declare function startServer(): Promise<void>;

package/build/server.js

@@ -0,0 +1,247 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { ProfilerState } from './model/state.js';
+import { handleTrace } from './instrument/trace.js';
+import { handleMark } from './instrument/mark.js';
+import { profileSummary } from './analysis/summary.js';
+import { findHotspots } from './analysis/hotspots.js';
+import { explainSpan } from './analysis/explain.js';
+import { findWaste } from './analysis/waste.js';
+import { importProfile } from './importers/import.js';
+import { exportCollapsed } from './exporters/collapsed.js';
+import { findHotpaths } from './analysis/hotpaths.js';
+import { findBottlenecks } from './analysis/bottleneck.js';
+import { findSpinpaths } from './analysis/spinpaths.js';
+import { findStarvations } from './analysis/starvations.js';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+export function createServer() {
+    const server = new McpServer({
+        name: 'tracemeld',
+        version: '0.1.0',
+    });
+    const state = new ProfilerState();
+    server.registerTool('trace', {
+        description: "Mark the start or end of a unit of work. Use this to instrument your own operations while you work: thinking, tool calls, file reads, bash commands, test runs. Call with action 'begin' before starting, 'end' when done. Cost data (tokens, time, bytes) goes on the 'end' call. Nesting is automatic.",
+        inputSchema: {
+            action: z.enum(['begin', 'end']),
+            kind: z.string(),
+            name: z.string().optional(),
+            cost: z.record(z.string(), z.number()).optional(),
+            error: z.string().optional(),
+            metadata: z.record(z.string(), z.unknown()).optional(),
+        },
+    }, (args) => {
+        const result = handleTrace(state, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('mark', {
+        description: "Record a notable instant: a test failure, a decision point, context window pressure, an unexpected result. Not a duration \u2014 a moment.",
+        inputSchema: {
+            what: z.string(),
+            severity: z.enum(['info', 'warning', 'error']).optional(),
+            data: z.record(z.string(), z.unknown()).optional(),
+        },
+    }, (args) => {
+        const result = handleMark(state, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('profile_summary', {
+        description: 'Get headline performance numbers for a session: total time, tokens, cost, errors. Group by turn, operation kind, or execution lane to see where effort concentrated. Start here when you want to understand how a session went.',
+        inputSchema: {
+            group_by: z.enum(['kind', 'turn', 'lane']).optional(),
+            time_range: z
+                .object({
+                start_ms: z.number(),
+                end_ms: z.number(),
+            })
+                .optional(),
+        },
+    }, (args) => {
+        const result = profileSummary(state.builder.profile, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('hotspots', {
+        description: 'Find the most expensive operations by any dimension: wall time, tokens consumed, tokens generated, dollar cost, or error count. Returns a ranked list with ancestry chains. Use after profile_summary identifies a concentration of cost.',
+        inputSchema: {
+            dimension: z.string(),
+            top_n: z.number().optional(),
+            min_value: z.number().optional(),
+        },
+    }, (args) => {
+        const result = findHotspots(state.builder.profile, args, state.registry);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('explain_span', {
+        description: 'Deep-dive into one expensive span. Shows its child breakdown, the causal chain of what happened, and any detected anti-patterns. Use when hotspots identified a specific span to investigate.',
+        inputSchema: {
+            span_id: z.string(),
+        },
+    }, (args) => {
+        const result = explainSpan(state.builder.profile, args, state.registry);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('find_waste', {
+        description: 'Identify work that didn\'t contribute to the final result: retries, unused reads, blind edits. Each waste item includes counterfactual savings and a concrete recommendation.',
+        inputSchema: {
+            time_range: z
+                .object({
+                start_ms: z.number(),
+                end_ms: z.number(),
+            })
+                .optional(),
+        },
+    }, (args) => {
+        const result = findWaste(state.builder.profile, state.registry, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('import_profile', {
+        description: "Load profiling data from a file path or inline string. Auto-detects format (collapsed stacks, Chrome trace) or accepts a hint. Use when you want to analyze an existing profile.",
+        inputSchema: {
+            source: z.string().describe('File path or inline profile data string'),
+            format: z.enum(['auto', 'collapsed', 'chrome_trace', 'gecko', 'pprof', 'speedscope']).optional(),
+            lane_name: z.string().optional(),
+        },
+    }, (args) => {
+        let content;
+        const format = args.format ?? 'auto';
+        if (!args.source.includes('\n') && existsSync(args.source)) {
+            // Binary formats (pprof) must be read as latin1 to preserve bytes
+            const isBinary = format === 'pprof' || args.source.endsWith('.pb.gz') || args.source.endsWith('.prof');
+            content = readFileSync(args.source, isBinary ? 'latin1' : 'utf-8');
+        }
+        else {
+            content = args.source;
+        }
+        const result = importProfile(content, args.lane_name ?? 'imported', format, state.builder);
+        state.invalidatePatternCache();
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('export_profile', {
+        description: "Export the current profile to a standard format for visualization. Currently supports 'collapsed' (for flamegraph tools). Returns the data as a string or writes to file.",
+        inputSchema: {
+            format: z.enum(['collapsed']).describe('Export format'),
+            dimension: z.string().optional().describe('Value type key to export (default: first value type)'),
+            output_path: z.string().optional().describe('File path to write. If omitted, returns data inline.'),
+        },
+    }, (args) => {
+        const data = exportCollapsed(state.builder.profile, args.dimension ?? 0);
+        if (args.output_path) {
+            writeFileSync(args.output_path, data, 'utf-8');
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            format: args.format,
+                            file_path: args.output_path,
+                            size_bytes: Buffer.byteLength(data, 'utf-8'),
+                            notes: [],
+                        }),
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        format: args.format,
+                        data,
+                        size_bytes: Buffer.byteLength(data, 'utf-8'),
+                        notes: [],
+                    }),
+                }],
+        };
+    });
+    server.registerTool('hotpaths', {
+        description: "Find the critical call paths that account for the most cost. Unlike hotspots (flat ranking), this shows complete root-to-leaf paths. Use to understand which call chains dominate execution.",
+        inputSchema: { dimension: z.string(), top_n: z.number().optional() },
+    }, (args) => {
+        const result = findHotpaths(state.builder.profile, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('bottleneck', {
+        description: "Find the single operations where optimization would have the most impact. Combines self-cost with path criticality — 'if you could speed up one thing, what would move the needle?'",
+        inputSchema: { dimension: z.string(), top_n: z.number().optional() },
+    }, (args) => {
+        const result = findBottlenecks(state.builder.profile, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('spinpaths', {
+        description: "Detect operations with high wall time but low useful output — busy-waiting, spinning, or inefficient processing. Flags spans that spent significant time without producing tokens, bytes, or other measurable work.",
+        inputSchema: { min_wall_ms: z.number().optional() },
+    }, (args) => {
+        const result = findSpinpaths(state.builder.profile, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('starvations', {
+        description: "Detect threads/lanes that are idle while others are active — indicates lock contention, unbalanced work, or serialization. Most useful with multi-threaded imported profiles (Gecko, Chrome trace).",
+        inputSchema: { min_idle_pct: z.number().optional() },
+    }, (args) => {
+        const result = findStarvations(state.builder.profile, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerPrompt('performance_review', {
+        title: 'Performance Review',
+        description: 'Step-by-step analysis of the current profile. Finds bottlenecks, traces call paths, identifies waste, and produces actionable recommendations with source locations.',
+    }, () => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `You have a performance profile loaded in tracemeld. Analyze it step by step:
+
+1. Call profile_summary with group_by="kind" to get headline numbers.
+2. Look at which group has the highest pct_of_total on any dimension.
+3. Call bottleneck on that dimension with top_n=5 to find the biggest optimization targets.
+4. For each bottleneck that has a source field, read the source file at that line to understand the implementation. Use LSP hover and findReferences to understand the function's role.
+5. Call hotpaths on the same dimension to see complete call chains.
+6. Call find_waste to identify work that didn't contribute to the result.
+7. Synthesize your findings into:
+   - What's the #1 bottleneck and what does the source code reveal about why?
+   - What work was wasted (with specific anti-patterns)?
+   - Concrete recommendations with code-level specificity (cite file:line locations).`,
+                },
+            }],
+    }));
+    server.registerPrompt('optimize_for', {
+        title: 'Optimize For Dimension',
+        description: 'Targeted optimization analysis for a specific cost dimension (wall_ms, input_tokens, etc.)',
+        argsSchema: {
+            dimension: z.string().describe('The cost dimension to optimize: wall_ms, input_tokens, output_tokens, cost_usd, etc.'),
+        },
+    }, ({ dimension }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Optimize for: ${dimension}
+
+1. Call bottleneck with dimension="${dimension}" and top_n=5.
+2. For each bottleneck with a source field, read the code at that location. Use LSP to understand what the function does and who calls it.
+3. Call hotpaths with dimension="${dimension}" to see the full call chains.
+4. Call find_waste to identify redundant work.
+5. Produce a ranked list of optimizations, ordered by expected savings on ${dimension}. For each recommendation, cite the specific file:line and explain what to change.`,
+                },
+            }],
+    }));
+    server.registerResource('profile-summary', 'profile://summary', {
+        title: 'Current Profile Summary',
+        description: 'Headline numbers from the active tracemeld profile — span count, error count, cost totals by kind.',
+        mimeType: 'application/json',
+    }, () => {
+        const summary = profileSummary(state.builder.profile, { group_by: 'kind' });
+        return {
+            contents: [{
+                    uri: 'profile://summary',
+                    text: JSON.stringify(summary, null, 2),
+                }],
+        };
+    });
+    return server;
+}
+export async function startServer() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/build/server.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "tracemeld",
+  "version": "0.1.0",
+  "description": "LLM-native MCP server for performance profiling and analysis",
+  "type": "module",
+  "main": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "bin": {
+    "tracemeld": "./build/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "inspect": "npm run build && npx @modelcontextprotocol/inspector node ./build/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "build/**/*.js",
+    "build/**/*.d.ts",
+    "build/**/*.js.map",
+    "!build/**/*.test.*",
+    "README.md"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "pako": "^2.1.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/inspector": "^0.21.1",
+    "@types/node": "^25.5.0",
+    "@types/pako": "^2.0.4",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
+    "eslint": "^10.0.3",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.57.1",
+    "vitest": "^4.1.0"
+  }
+}