perf-profiler

Run profiling tools and capture hotspots with evidence.

Follow docs/perf-requirements.md as the canonical contract.

Parse Arguments

const args = '$ARGUMENTS'.split(' ').filter(Boolean);
const tool = args[0] || '';
const command = args.slice(1).join(' ');

Required Rules

• Verify debug symbols before profiling.
• Capture file:line for hotspots.
• Provide flame graph or equivalent output when possible.

Output Format

tool: <profiler>
command: <command>
hotspots:
  - file:line - reason
artifacts:
  - <path to flame graph or profile>

Constraints

• No profiling without a clear scenario.
• Keep outputs minimal and evidence-backed.