perf-profiler

# perf-profiler Run profiling tools and capture hotspots with evidence. Follow `docs/perf-requirements.md` as the canonical contract. ## Parse Arguments ```javascript 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.