Repository navigation
Closed
Labels
in-progressWork is actively in progressWork is actively in progress
Description
Parent
What to build
Add Apple native CPU profiling under the consolidated perf family. This issue groups Apple xctrace work because active app process resolution, xctrace invocation, retry behavior, export/report handling, and device/simulator support all share the same platform seams.
Prototype CLI shape:
agent-device perf cpu profile start --kind xctrace --template "Time Profiler" --out app.trace
agent-device perf cpu profile stop --kind xctrace --out app.trace
agent-device perf cpu profile report --kind xctrace --out app-profile.json
agent-device perf trace start --kind xctrace --template "Animation Hitches" --out hitches.trace
agent-device perf trace stop --kind xctrace --out hitches.traceExpected agent experience:
- Agents first run
perf metricsorperf framesto confirm native/device slowness. - Agents escalate to xctrace CPU profiling when logs and quick metrics do not identify the cause.
- Existing
perfxctrace Activity Monitor and Animation Hitches behavior should inform hints and retry behavior, but profiler artifacts must be returned as paths plus compact summaries.
Acceptance criteria
- Active Apple app sessions can resolve the target app process for xctrace profiling.
-
perf cpu profile start|stop --kind xctracecaptures a bounded.traceartifact for the active app when supported. -
perf cpu profile report --kind xctracereturns a compact report when xctrace export can provide useful data. - The support matrix clearly distinguishes physical iOS device, iOS simulator, and macOS behavior.
- Existing iOS device xctrace retry and actionable hint patterns are reused where practical.
- Commands return artifact paths and metadata, not full trace contents.
- dSYM/symbolication is not bundled into this issue unless it is required for the compact profiler report; broader symbolication remains in the debug symbols issue.
Validation
- iOS platform unit tests with mocked
xcrun xctrace recordandxcrun xctrace export. - Session handler tests for command routing and unavailable target hints.
-
pnpm check:unit -
pnpm format
Blocked by
Metadata
Metadata
Assignees
Labels
in-progressWork is actively in progressWork is actively in progress
Activity
thymikee commentedon Jun 10, 2026
Implementation note for #694 rollout workers:
Please treat agent-friendly, token-efficient output as a core requirement, not a nice-to-have.
During review we should treat unbounded raw output or huge default JSON payloads as actionable feedback.
thymikee commentedon Jun 12, 2026
Closing as implemented by merged PR #755. Scope remains first-pass Apple xctrace triage under perf: compact summaries and artifact paths, not Instruments/Xcode replacement. Future xctrace expansion should require proven agent value and bounded output.