@swmansion/argent 0.21.1-next.2 → 0.21.1-next.4

package/dist/tool-server.cjs

@@ -136339,13 +136339,13 @@ function summarizeHangBlocking(states) {
 var MAX_INLINE_HOTSPOTS = 5;
 var MAX_INLINE_HANGS = 3;
 async function renderNativeProfilerReport(input) {
-  const { payload, traceFile, freshnessNote, mallocStackLogging } = input;
+  const { payload, traceFile, freshnessNote, cpuDiagnostic, mallocStackLogging } = input;
   const exportErrors = input.exportErrors ?? {};
   const bottlenecksTotal = payload.bottlenecks.length;
   const status = Object.keys(exportErrors).length > 0 ? "analysis_failed" : "ok";
   const cpuHotspotsCount = payload.bottlenecks.filter((b) => b.type === "cpu_hotspot").length;
   const uiHangsCount = payload.bottlenecks.filter((b) => b.type === "ui_hang").length;
-  const fullReport = bottlenecksTotal === 0 ? renderAllClear2(payload, exportErrors, freshnessNote) : renderFullReport(
+  const fullReport = bottlenecksTotal === 0 ? renderAllClear2(payload, exportErrors, freshnessNote, cpuDiagnostic) : renderFullReport(
     payload,
     exportErrors,
     {
@@ -136353,11 +136353,12 @@ async function renderNativeProfilerReport(input) {
       hangLimit: Infinity
     },
     freshnessNote,
-    mallocStackLogging
+    mallocStackLogging,
+    cpuDiagnostic
   );
   const reportFile = traceFile ? deriveReportPath(traceFile) : null;
   const wroteFile = reportFile ? await writeReport2(reportFile, fullReport) : false;
-  const inlineReport = bottlenecksTotal === 0 ? renderAllClear2(payload, exportErrors, freshnessNote) : renderFullReport(
+  const inlineReport = bottlenecksTotal === 0 ? renderAllClear2(payload, exportErrors, freshnessNote, cpuDiagnostic) : renderFullReport(
     payload,
     exportErrors,
     {
@@ -136365,13 +136366,19 @@ async function renderNativeProfilerReport(input) {
       hangLimit: MAX_INLINE_HANGS
     },
     freshnessNote,
-    mallocStackLogging
+    mallocStackLogging,
+    cpuDiagnostic
   );
   const shownHotspots = Math.min(MAX_INLINE_HOTSPOTS, cpuHotspotsCount);
   const shownHangs = Math.min(MAX_INLINE_HANGS, uiHangsCount);
+  const shownParts = [
+    ...shownHotspots > 0 ? [`top ${shownHotspots} CPU hotspots`] : [],
+    ...shownHangs > 0 ? [`top ${shownHangs} hangs`] : []
+  ];
+  const shownSummary = shownParts.length > 0 ? `showing ${shownParts.join(" and ")} inline` : `summary inline`;
   const report = wroteFile && reportFile ? inlineReport + `
 
-> Full report saved \u2014 ${bottlenecksTotal} bottleneck(s) total, showing top ${shownHotspots} CPU hotspots and top ${shownHangs} hangs inline. Use the Read tool on the \`reportFile\` path in this result to view all details.` : inlineReport;
+> Full report saved \u2014 ${bottlenecksTotal} bottleneck(s) total, ${shownSummary}. Use the Read tool on the \`reportFile\` path in this result to view all details.` : inlineReport;
   return {
     report,
     reportFile: wroteFile ? reportFile : null,
@@ -136411,7 +136418,7 @@ function renderTraceProcessorUnavailable(err) {
 function reportTitle(payload) {
   return payload.metadata.platform.toLowerCase() === "android" ? "Android Perfetto Analysis" : "iOS Instruments Analysis";
 }
-function renderAllClear2(payload, exportErrors, freshnessNote) {
+function renderAllClear2(payload, exportErrors, freshnessNote, cpuDiagnostic) {
   const traceName = payload.metadata.traceFile ? `\`${path24.basename(payload.metadata.traceFile)}\`` : "unknown";
   const lines = [
     `# ${reportTitle(payload)}`,
@@ -136420,6 +136427,7 @@ function renderAllClear2(payload, exportErrors, freshnessNote) {
     ``
   ];
   if (freshnessNote) lines.push(freshnessNote, ``);
+  if (cpuDiagnostic) lines.push(`> \u26A0\uFE0F **CPU sampling:** ${cpuDiagnostic}`, ``);
   const errorLines = renderExportErrors(exportErrors);
   if (errorLines.length > 0) {
     lines.push(...errorLines, ``);
@@ -136439,7 +136447,7 @@ function renderAllClear2(payload, exportErrors, freshnessNote) {
   }
   return lines.join("\n");
 }
-function renderFullReport(payload, exportErrors, cap = { hotspotLimit: Infinity, hangLimit: Infinity }, freshnessNote, mallocStackLogging) {
+function renderFullReport(payload, exportErrors, cap = { hotspotLimit: Infinity, hangLimit: Infinity }, freshnessNote, mallocStackLogging, cpuDiagnostic) {
   const traceName = payload.metadata.traceFile ? `\`${path24.basename(payload.metadata.traceFile)}\`` : "unknown";
   const cpuHotspots = payload.bottlenecks.filter((b) => b.type === "cpu_hotspot");
   const uiHangs = payload.bottlenecks.filter((b) => b.type === "ui_hang");
@@ -136454,6 +136462,7 @@ function renderFullReport(payload, exportErrors, cap = { hotspotLimit: Infinity,
     ``
   ];
   if (freshnessNote) lines.push(freshnessNote, ``);
+  if (cpuDiagnostic) lines.push(`> \u26A0\uFE0F **CPU sampling:** ${cpuDiagnostic}`, ``);
   const errorLines = renderExportErrors(exportErrors);
   if (errorLines.length > 0) {
     lines.push(...errorLines, ``);
@@ -138044,8 +138053,13 @@ async function runAndroidProfilerPipeline(tracePath, appPackage) {
     exportErrors.rss = msg;
   });
   if (cpuRows.length === 0 && hangRows.length === 0 && !exportErrors.cpu) {
-    exportErrors.cpu = `No CPU samples were captured for cmdline \`${appPackage}\`. The most common cause is the target app being non-debuggable (release build) without a \`<profileable shell="true">\` entry in its AndroidManifest.xml. Without that, Perfetto silently drops the linux.perf data source. Add \`<profileable android:shell="true"/>\` to the \`<application>\` element and rebuild, or run a debug variant of the app.`;
+    exportErrors.cpu = `No CPU samples were captured for cmdline \`${appPackage}\`. The trace contains no perf_sample rows for a process with that name, so no CPU analysis is possible. Either the name never matched a running process (it must equal the process cmdline exactly), or the app was never scheduled on-CPU during the recording. If it was running, it must be a debug build or declare \`<profileable android:shell="true"/>\` under \`<application>\` in its AndroidManifest.xml \u2014 then re-record.`;
   }
+  const stacklessSamples = cpuRows.reduce(
+    (sum, r) => r.leaf_function ? sum : sum + Number(r.sample_count),
+    0
+  );
+  const cpuDiagnostic = cpuRows.length > 0 && !cpuRows.some((r) => r.leaf_function) && stacklessSamples > 0 ? describeStacklessSamples(appPackage, cpuRows, stacklessSamples) : void 0;
   const cpuHotspots = aggregateCpuHotspots(cpuRowsToAggregatorRows(cpuRows, traceStartNs), {
     platform: "android"
   });
@@ -138073,7 +138087,14 @@ async function runAndroidProfilerPipeline(tracePath, appPackage) {
   });
   const rssGrowth = rssRowsToBottlenecks(rssRows);
   const bottlenecks = [...cpuHotspots, ...uiHangs, ...rssGrowth];
-  return { bottlenecks, cpuHotspots, uiHangs, rssGrowth, exportErrors };
+  return {
+    bottlenecks,
+    cpuHotspots,
+    uiHangs,
+    rssGrowth,
+    exportErrors,
+    ...cpuDiagnostic ? { cpuDiagnostic } : {}
+  };
 }
 async function loadAndroidCombinedData(tracePath, appPackage) {
   const target = sanitizeProcessName(appPackage);
@@ -138306,6 +138327,11 @@ async function renderThreadBreakdownAndroid(opts, target) {
   }
   return lines.join("\n");
 }
+function describeStacklessSamples(appPackage, cpuRows, stacklessSamples) {
+  const unwound = cpuRows.some((r) => r.leaf_mapping);
+  const head = `${stacklessSamples} CPU sample${stacklessSamples === 1 ? "" : "s"} were captured for \`${appPackage}\`, but none carry a usable call stack, so no CPU hotspots could be computed and \`profiler-stack-query\` mode=\`function_callers\` / mode=\`hang_stacks\` will find nothing. The app was running \u2014 this is a capture limitation, not an idle app. mode=\`thread_breakdown\` still works, since it counts samples and needs no stacks.`;
+  return unwound ? `${head} The stacks were unwound but no frame resolved to a symbol, which points at stripped native libraries. Profile a build that keeps its symbols (a debug build, or a release build with unstripped \`.so\`s).` : `${head} No stack was unwound at all: Perfetto only unwinds a process it can read \`/proc/<pid>/mem\` for. Profile a debug build, or add \`<profileable android:shell="true"/>\` to \`<application>\` and rebuild \u2014 verify with \`adb shell dumpsys package ${appPackage}\`, which shows \`DEBUGGABLE\` for a profileable target. Platform packages such as \`com.android.settings\` are never profileable.`;
+}
 function cpuRowsToAggregatorRows(rows, traceStartNs) {
   const traceStartMs = Math.round(traceStartNs / 1e6);
   const out = [];
@@ -138647,7 +138673,9 @@ async function analyzeNativeProfilerAndroid(api) {
     // wallClockStartMs is the recording's start time (set at start, persisted in
     // the metadata sidecar, restored by profiler-load). A large gap to "now"
     // means we're analyzing a trace from an earlier session, not a fresh capture.
-    freshnessNote: formatTraceFreshness(api.wallClockStartMs, Date.now()) ?? void 0
+    freshnessNote: formatTraceFreshness(api.wallClockStartMs, Date.now()) ?? void 0,
+    // Explains an absent CPU section when samples exist but carry no stacks.
+    cpuDiagnostic: pipelineResult.cpuDiagnostic
   });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.21.1-next.2",
+  "version": "0.21.1-next.4",
   "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",