@gracker/smartperfetto 1.0.13

package/dist/services/comparisonMatrixService.js

@@ -0,0 +1,211 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildComparisonMatrix = buildComparisonMatrix;
+const multiTraceComparison_1 = require("../types/multiTraceComparison");
+const comparisonSignificance_1 = require("./comparisonSignificance");
+const STANDARD_METRIC_BY_KEY = new Map(multiTraceComparison_1.STANDARD_COMPARISON_METRICS.map(metric => [metric.key, metric]));
+function snapshotToInput(snapshot) {
+    return {
+        snapshotId: snapshot.id,
+        traceId: snapshot.traceId,
+        title: snapshot.title,
+        traceLabel: snapshot.traceLabel,
+        sceneType: snapshot.sceneType,
+        userQuery: snapshot.userQuery,
+        visibility: snapshot.visibility,
+        ...(snapshot.createdBy ? { createdBy: snapshot.createdBy } : {}),
+        createdAt: snapshot.createdAt,
+        traceMetadata: snapshot.traceMetadata,
+    };
+}
+function metricNumericValue(metric) {
+    if (!metric || typeof metric.value !== 'number' || !Number.isFinite(metric.value)) {
+        return undefined;
+    }
+    return metric.value;
+}
+function metricToCell(snapshotId, metricKey, metric) {
+    const numericValue = metricNumericValue(metric);
+    return {
+        snapshotId,
+        metricKey,
+        value: metric.value,
+        ...(numericValue !== undefined ? { numericValue } : {}),
+        ...(metric.unit ? { unit: metric.unit } : {}),
+        confidence: metric.confidence,
+        ...(metric.missingReason ? { missingReason: metric.missingReason } : {}),
+        source: metric.source,
+    };
+}
+function metricKeysFromSnapshots(snapshots, requestedKeys) {
+    if (requestedKeys && requestedKeys.length > 0) {
+        return [...new Set(requestedKeys)];
+    }
+    const keys = new Set();
+    for (const metric of multiTraceComparison_1.STANDARD_COMPARISON_METRICS) {
+        if (snapshots.some(snapshot => snapshot.metrics.some(item => item.key === metric.key))) {
+            keys.add(metric.key);
+        }
+    }
+    for (const snapshot of snapshots) {
+        for (const metric of snapshot.metrics) {
+            keys.add(metric.key);
+        }
+    }
+    return [...keys];
+}
+function resolveMetricDefinition(metricKey, metricsBySnapshot) {
+    const standard = STANDARD_METRIC_BY_KEY.get(metricKey);
+    if (standard)
+        return standard;
+    const firstMetric = [...metricsBySnapshot.values()].find(Boolean);
+    return {
+        key: metricKey,
+        label: firstMetric?.label || metricKey,
+        group: firstMetric?.group || 'custom',
+        ...(firstMetric?.unit ? { unit: firstMetric.unit } : {}),
+        direction: firstMetric?.direction || 'neutral',
+    };
+}
+function missingReasonForMetric(metricKey) {
+    return STANDARD_METRIC_BY_KEY.has(metricKey)
+        ? 'metric_not_found'
+        : 'custom_metric_not_found';
+}
+function assessDelta(deltaValue, direction) {
+    if (deltaValue === null || direction === 'neutral')
+        return 'unknown';
+    if (Math.abs(deltaValue) < 1e-9)
+        return 'same';
+    if (direction === 'lower_is_better')
+        return deltaValue < 0 ? 'better' : 'worse';
+    return deltaValue > 0 ? 'better' : 'worse';
+}
+function buildDelta(baselineSnapshotId, snapshotId, metricKey, baselineMetric, candidateMetric, direction) {
+    const baselineValue = metricNumericValue(baselineMetric);
+    const candidateValue = metricNumericValue(candidateMetric);
+    const deltaValue = baselineValue === undefined || candidateValue === undefined
+        ? null
+        : candidateValue - baselineValue;
+    const deltaPct = deltaValue === null || baselineValue === undefined || baselineValue === 0
+        ? null
+        : (deltaValue / baselineValue) * 100;
+    return {
+        snapshotId,
+        baselineSnapshotId,
+        metricKey,
+        deltaValue,
+        deltaPct,
+        direction,
+        assessment: assessDelta(deltaValue, direction),
+    };
+}
+function metricEvidenceRef(snapshot, metric) {
+    return {
+        id: `${snapshot.id}:${metric.key}`,
+        type: 'snapshot_metric',
+        label: metric.label,
+        snapshotId: snapshot.id,
+        metricKey: metric.key,
+        reportId: metric.source.reportId || snapshot.reportId,
+        runId: metric.source.backfillRunId || snapshot.runId,
+        metadata: {
+            sourceType: metric.source.type,
+            confidence: metric.confidence,
+        },
+    };
+}
+function hasSignificantDelta(row) {
+    return row.deltas.some(delta => (0, comparisonSignificance_1.isSignificantComparisonDelta)(delta, row));
+}
+function buildMatrixGroups(rows) {
+    const grouped = new Map();
+    for (const row of rows) {
+        const groupRows = grouped.get(row.group) || [];
+        groupRows.push(row);
+        grouped.set(row.group, groupRows);
+    }
+    return [...grouped.entries()].map(([group, groupRows]) => ({
+        group,
+        rowMetricKeys: groupRows.map(row => row.metricKey),
+        rowCount: groupRows.length,
+        significantChangeCount: groupRows.filter(hasSignificantDelta).length,
+        missingMetricCount: groupRows.reduce((sum, row) => sum + row.missingSnapshotIds.length, 0),
+        defaultCollapsed: groupRows.length > 3 && !groupRows.some(hasSignificantDelta),
+    }));
+}
+function buildComparisonMatrix(snapshots, options = {}) {
+    if (snapshots.length < 2) {
+        throw new Error('Comparison matrix requires at least two snapshots');
+    }
+    const snapshotsById = new Map(snapshots.map(snapshot => [snapshot.id, snapshot]));
+    const baselineSnapshotId = options.baselineSnapshotId || snapshots[0].id;
+    const baseline = snapshotsById.get(baselineSnapshotId);
+    if (!baseline) {
+        throw new Error('Baseline snapshot is not part of comparison input');
+    }
+    const metricKeys = metricKeysFromSnapshots(snapshots, options.metricKeys);
+    const missingMatrix = {};
+    const evidenceRefsById = new Map();
+    const rows = [];
+    for (const metricKey of metricKeys) {
+        const metricsBySnapshot = new Map();
+        for (const snapshot of snapshots) {
+            metricsBySnapshot.set(snapshot.id, snapshot.metrics.find(metric => metric.key === metricKey));
+        }
+        const definition = resolveMetricDefinition(metricKey, metricsBySnapshot);
+        const baselineMetric = metricsBySnapshot.get(baselineSnapshotId);
+        const cells = [];
+        const missingSnapshotIds = [];
+        for (const snapshot of snapshots) {
+            const metric = metricsBySnapshot.get(snapshot.id);
+            if (!metric) {
+                missingSnapshotIds.push(snapshot.id);
+                missingMatrix[snapshot.id] = {
+                    ...(missingMatrix[snapshot.id] || {}),
+                    [metricKey]: missingReasonForMetric(metricKey),
+                };
+                continue;
+            }
+            cells.push(metricToCell(snapshot.id, metricKey, metric));
+            evidenceRefsById.set(`${snapshot.id}:${metric.key}`, metricEvidenceRef(snapshot, metric));
+        }
+        const deltas = snapshots
+            .filter(snapshot => snapshot.id !== baselineSnapshotId)
+            .map(snapshot => buildDelta(baselineSnapshotId, snapshot.id, metricKey, baselineMetric, metricsBySnapshot.get(snapshot.id), definition.direction));
+        rows.push({
+            metricKey,
+            label: definition.label,
+            group: definition.group,
+            ...(definition.unit ? { unit: definition.unit } : {}),
+            direction: definition.direction,
+            ...(baselineMetric
+                ? { baseline: metricToCell(baselineSnapshotId, metricKey, baselineMetric) }
+                : {}),
+            cells,
+            deltas,
+            missingSnapshotIds,
+        });
+    }
+    const warnings = [];
+    for (const row of rows) {
+        if (!row.baseline) {
+            warnings.push(`Baseline is missing metric ${row.metricKey}`);
+        }
+    }
+    return {
+        schemaVersion: multiTraceComparison_1.COMPARISON_MATRIX_SCHEMA_VERSION,
+        inputSnapshots: snapshots.map(snapshotToInput),
+        baselineSnapshotId,
+        rows,
+        groups: buildMatrixGroups(rows),
+        evidenceRefs: [...evidenceRefsById.values()],
+        missingMatrix,
+        warnings,
+        createdAt: Date.now(),
+    };
+}
+//# sourceMappingURL=comparisonMatrixService.js.map

package/dist/services/comparisonMatrixService.js.map

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

package/dist/services/comparisonResultService.d.ts

@@ -0,0 +1,13 @@
+import type { AnalysisResultSnapshot, ComparisonMetricKey, ComparisonResult } from '../types/multiTraceComparison';
+export declare const DEFAULT_COMPARISON_METRIC_KEYS: readonly ComparisonMetricKey[];
+export interface BuildDeterministicComparisonResultOptions {
+    baselineSnapshotId: string;
+    metricKeys?: ComparisonMetricKey[];
+}
+export interface ComparisonResultViewOptions {
+    significantOnly?: boolean;
+}
+export declare function resolveComparisonMetricKeys(requestedMetricKeys: ComparisonMetricKey[] | undefined): ComparisonMetricKey[];
+export declare function buildDeterministicComparisonResult(snapshots: AnalysisResultSnapshot[], options: BuildDeterministicComparisonResultOptions): ComparisonResult;
+export declare function applyComparisonResultViewOptions(result: ComparisonResult, options?: ComparisonResultViewOptions): ComparisonResult;
+//# sourceMappingURL=comparisonResultService.d.ts.map

package/dist/services/comparisonResultService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparisonResultService.d.ts","sourceRoot":"","sources":["../../src/services/comparisonResultService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,sBAAsB,EAGtB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAIvC,eAAO,MAAM,8BAA8B,EAAE,SAAS,mBAAmB,EAI/D,CAAC;AAEX,MAAM,WAAW,yCAAyC;IACxD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,2BAA2B;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,2BAA2B,CACzC,mBAAmB,EAAE,mBAAmB,EAAE,GAAG,SAAS,GACrD,mBAAmB,EAAE,CAQvB;AAmCD,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,sBAAsB,EAAE,EACnC,OAAO,EAAE,yCAAyC,GACjD,gBAAgB,CAmBlB;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,2BAAgC,GACxC,gBAAgB,CA2BlB"}

package/dist/services/comparisonResultService.js

@@ -0,0 +1,99 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_COMPARISON_METRIC_KEYS = void 0;
+exports.resolveComparisonMetricKeys = resolveComparisonMetricKeys;
+exports.buildDeterministicComparisonResult = buildDeterministicComparisonResult;
+exports.applyComparisonResultViewOptions = applyComparisonResultViewOptions;
+const comparisonMatrixService_1 = require("./comparisonMatrixService");
+const comparisonSignificance_1 = require("./comparisonSignificance");
+exports.DEFAULT_COMPARISON_METRIC_KEYS = [
+    'startup.total_ms',
+    'scrolling.avg_fps',
+    'scrolling.jank_rate_pct',
+];
+function resolveComparisonMetricKeys(requestedMetricKeys) {
+    const requested = requestedMetricKeys
+        ?.map(metricKey => metricKey.trim())
+        .filter(Boolean);
+    const uniqueRequested = requested ? [...new Set(requested)] : [];
+    return uniqueRequested.length > 0
+        ? uniqueRequested
+        : [...exports.DEFAULT_COMPARISON_METRIC_KEYS];
+}
+function collectSignificantChanges(matrix) {
+    return matrix.rows
+        .flatMap(row => row.deltas.filter(delta => (0, comparisonSignificance_1.isSignificantComparisonDelta)(delta, row)))
+        .sort((a, b) => {
+        const assessmentWeight = (assessment) => assessment === 'worse' ? 0 : assessment === 'better' ? 1 : 2;
+        const assessmentDiff = assessmentWeight(a.assessment) - assessmentWeight(b.assessment);
+        if (assessmentDiff !== 0)
+            return assessmentDiff;
+        const aMagnitude = Math.abs(a.deltaPct ?? a.deltaValue ?? 0);
+        const bMagnitude = Math.abs(b.deltaPct ?? b.deltaValue ?? 0);
+        return bMagnitude - aMagnitude;
+    });
+}
+function formatNumber(value) {
+    if (Number.isInteger(value))
+        return String(value);
+    return value.toFixed(2).replace(/\.?0+$/, '');
+}
+function formatDelta(delta, matrix) {
+    const row = matrix.rows.find(item => item.metricKey === delta.metricKey);
+    const label = row?.label || delta.metricKey;
+    const unit = row?.unit ? ` ${row.unit}` : '';
+    const pct = delta.deltaPct === null ? '' : ` (${formatNumber(delta.deltaPct)}%)`;
+    return `${label} changed by ${formatNumber(delta.deltaValue ?? 0)}${unit}${pct} for ${delta.snapshotId} vs ${delta.baselineSnapshotId}; assessment=${delta.assessment}.`;
+}
+function buildUncertainty(matrix) {
+    const missing = Object.entries(matrix.missingMatrix).flatMap(([snapshotId, metrics]) => Object.keys(metrics).map(metricKey => `${snapshotId} is missing metric ${metricKey}.`));
+    return [...matrix.warnings, ...missing];
+}
+function buildDeterministicComparisonResult(snapshots, options) {
+    const metricKeys = resolveComparisonMetricKeys(options.metricKeys);
+    const matrix = (0, comparisonMatrixService_1.buildComparisonMatrix)(snapshots, {
+        baselineSnapshotId: options.baselineSnapshotId,
+        metricKeys,
+    });
+    const significantChanges = collectSignificantChanges(matrix);
+    return {
+        matrix,
+        significantChanges,
+        conclusion: {
+            source: 'deterministic',
+            generatedAt: Date.now(),
+            verifiedFacts: significantChanges.map(delta => formatDelta(delta, matrix)),
+            inferences: [],
+            recommendations: [],
+            uncertainty: buildUncertainty(matrix),
+        },
+    };
+}
+function applyComparisonResultViewOptions(result, options = {}) {
+    if (!options.significantOnly)
+        return result;
+    const significantMetricKeys = new Set(result.significantChanges.map(delta => delta.metricKey));
+    const filteredRows = result.matrix.rows.filter(row => significantMetricKeys.has(row.metricKey));
+    const filteredRowsByKey = new Map(filteredRows.map(row => [row.metricKey, row]));
+    return {
+        ...result,
+        matrix: {
+            ...result.matrix,
+            rows: filteredRows,
+            groups: (result.matrix.groups || [])
+                .map(group => ({
+                ...group,
+                rowMetricKeys: group.rowMetricKeys.filter(metricKey => filteredRowsByKey.has(metricKey)),
+                rowCount: group.rowMetricKeys.filter(metricKey => filteredRowsByKey.has(metricKey)).length,
+                significantChangeCount: group.rowMetricKeys.filter(metricKey => filteredRowsByKey.has(metricKey)).length,
+                missingMetricCount: group.rowMetricKeys.reduce((sum, metricKey) => sum + (filteredRowsByKey.get(metricKey)?.missingSnapshotIds.length ?? 0), 0),
+                defaultCollapsed: false,
+            }))
+                .filter(group => group.rowCount > 0),
+        },
+    };
+}
+//# sourceMappingURL=comparisonResultService.js.map

package/dist/services/comparisonResultService.js.map

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

package/dist/services/comparisonSignificance.d.ts

@@ -0,0 +1,3 @@
+import type { ComparisonDelta, ComparisonMatrixRow } from '../types/multiTraceComparison';
+export declare function isSignificantComparisonDelta(delta: ComparisonDelta, row?: Pick<ComparisonMatrixRow, 'unit'>): boolean;
+//# sourceMappingURL=comparisonSignificance.d.ts.map

package/dist/services/comparisonSignificance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparisonSignificance.d.ts","sourceRoot":"","sources":["../../src/services/comparisonSignificance.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EAEpB,MAAM,+BAA+B,CAAC;AAavC,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,eAAe,EACtB,GAAG,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,GACtC,OAAO,CA+BT"}

package/dist/services/comparisonSignificance.js

@@ -0,0 +1,42 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSignificantComparisonDelta = isSignificantComparisonDelta;
+const RELATIVE_DELTA_THRESHOLD_PCT = 5;
+const ABSOLUTE_DELTA_THRESHOLD_BY_UNIT = {
+    ms: 5,
+    fps: 1,
+    '%': 1,
+    count: 1,
+    bytes: 1024 * 1024,
+    ns: 5000000,
+};
+function isSignificantComparisonDelta(delta, row) {
+    if (delta.deltaValue === null ||
+        delta.assessment === 'same' ||
+        delta.assessment === 'unknown') {
+        return false;
+    }
+    const absDeltaValue = Math.abs(delta.deltaValue);
+    const absDeltaPct = typeof delta.deltaPct === 'number' && Number.isFinite(delta.deltaPct)
+        ? Math.abs(delta.deltaPct)
+        : null;
+    const unit = row?.unit;
+    const absoluteThreshold = unit ? ABSOLUTE_DELTA_THRESHOLD_BY_UNIT[unit] : undefined;
+    if (absoluteThreshold !== undefined) {
+        const passesAbsoluteThreshold = absDeltaValue >= absoluteThreshold;
+        if (unit === '%' || unit === 'count') {
+            return passesAbsoluteThreshold ||
+                (absDeltaPct !== null && absDeltaPct >= RELATIVE_DELTA_THRESHOLD_PCT);
+        }
+        return passesAbsoluteThreshold &&
+            (absDeltaPct === null || absDeltaPct >= RELATIVE_DELTA_THRESHOLD_PCT);
+    }
+    if (absDeltaPct !== null) {
+        return absDeltaPct >= RELATIVE_DELTA_THRESHOLD_PCT;
+    }
+    return absDeltaValue > 1e-9;
+}
+//# sourceMappingURL=comparisonSignificance.js.map

package/dist/services/comparisonSignificance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparisonSignificance.js","sourceRoot":"","sources":["../../src/services/comparisonSignificance.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;AAmB/D,oEAkCC;AA7CD,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAEvC,MAAM,gCAAgC,GAAwE;IAC5G,EAAE,EAAE,CAAC;IACL,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,IAAI,GAAG,IAAI;IAClB,EAAE,EAAE,OAAS;CACd,CAAC;AAEF,SAAgB,4BAA4B,CAC1C,KAAsB,EACtB,GAAuC;IAEvC,IACE,KAAK,CAAC,UAAU,KAAK,IAAI;QACzB,KAAK,CAAC,UAAU,KAAK,MAAM;QAC3B,KAAK,CAAC,UAAU,KAAK,SAAS,EAC9B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,WAAW,GACf,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;QACnE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC1B,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC;IACvB,MAAM,iBAAiB,GAAG,IAAI,CAAC,CAAC,CAAC,gCAAgC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEpF,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,uBAAuB,GAAG,aAAa,IAAI,iBAAiB,CAAC;QACnE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrC,OAAO,uBAAuB;gBAC5B,CAAC,WAAW,KAAK,IAAI,IAAI,WAAW,IAAI,4BAA4B,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,uBAAuB;YAC5B,CAAC,WAAW,KAAK,IAAI,IAAI,WAAW,IAAI,4BAA4B,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,WAAW,IAAI,4BAA4B,CAAC;IACrD,CAAC;IACD,OAAO,aAAa,GAAG,IAAI,CAAC;AAC9B,CAAC"}

package/dist/services/cpuThermalPmu.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CPU Frequency / Thermal / PMU Aggregator (Spark Plan 13)
+ *
+ * Folds independent attribution facets into one
+ * `CpuThermalPmuContract`. Caller passes only the facets they have
+ * data for; missing facets surface as `unsupportedReason` rather than
+ * being zero-filled.
+ */
+import { type CpuThermalPmuContract, type NsTimeRange } from '../types/sparkContracts';
+export interface CpuFreqResidencySample {
+    cpu: number;
+    freqHz: number;
+    durNs: number;
+}
+export interface ThermalThrottleInput {
+    zone: string;
+    ts: number;
+    tempMc: number;
+    throttleStage?: number;
+}
+export interface PmuSampleInput {
+    counter: string;
+    utid?: number;
+    process?: string;
+    thread?: string;
+    value: number;
+    derived?: Record<string, number>;
+}
+export interface CpuThermalPmuOptions {
+    range: NsTimeRange;
+    freqSamples?: CpuFreqResidencySample[];
+    thermalSamples?: ThermalThrottleInput[];
+    pmuSamples?: PmuSampleInput[];
+    smoothFraction?: number;
+    jankFraction?: number;
+}
+export declare function buildCpuThermalPmu(options: CpuThermalPmuOptions): CpuThermalPmuContract;
+//# sourceMappingURL=cpuThermalPmu.d.ts.map

package/dist/services/cpuThermalPmu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpuThermalPmu.d.ts","sourceRoot":"","sources":["../../src/services/cpuThermalPmu.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAIjB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACvC,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAgFD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,oBAAoB,GAC5B,qBAAqB,CA4DvB"}

package/dist/services/cpuThermalPmu.js

@@ -0,0 +1,141 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCpuThermalPmu = buildCpuThermalPmu;
+/**
+ * CPU Frequency / Thermal / PMU Aggregator (Spark Plan 13)
+ *
+ * Folds independent attribution facets into one
+ * `CpuThermalPmuContract`. Caller passes only the facets they have
+ * data for; missing facets surface as `unsupportedReason` rather than
+ * being zero-filled.
+ */
+const sparkContracts_1 = require("../types/sparkContracts");
+/**
+ * Compute fraction-of-window residency for each (cpu, freq) bucket.
+ *
+ * Codex round 7 caught that callers can pass multiple samples for the
+ * same (cpu, freqHz) — common when a CPU revisits a frequency during
+ * the window — so we aggregate by bucket before computing fractions
+ * instead of emitting split rows that consumers have to re-sum.
+ */
+function buildResidency(range, samples) {
+    if (!samples || samples.length === 0)
+        return undefined;
+    const totalDur = Math.max(1, range.endNs - range.startNs);
+    const byBucket = new Map();
+    for (const s of samples) {
+        const key = `${s.cpu}|${s.freqHz}`;
+        const existing = byBucket.get(key);
+        if (existing) {
+            existing.durNs += s.durNs;
+        }
+        else {
+            byBucket.set(key, { cpu: s.cpu, freqHz: s.freqHz, durNs: s.durNs });
+        }
+    }
+    return Array.from(byBucket.values())
+        .sort((a, b) => a.cpu - b.cpu || a.freqHz - b.freqHz)
+        .map(s => ({
+        cpu: s.cpu,
+        freqHz: s.freqHz,
+        durNs: s.durNs,
+        fraction: s.durNs / totalDur,
+    }));
+}
+/**
+ * Decide a thermal verdict given the hottest sample's tempMc and
+ * throttleStage. Thresholds chosen to match common Android thermal HAL
+ * brackets (cool < 70°C, soft 70-85, hard 85-95, shutdown >= 95).
+ *
+ * Codex round 4 caught that traces from thermal zones often expose only
+ * temperature counters (no HAL stage), so 95°C+ samples without a
+ * throttleStage need to surface as `shutdown_imminent` based on
+ * temperature alone — otherwise pre-shutdown conditions are
+ * under-reported as ordinary hard throttling.
+ */
+function decideThermal(samples) {
+    if (!samples || samples.length === 0)
+        return undefined;
+    const hottest = samples.reduce((acc, s) => (s.tempMc > acc.tempMc ? s : acc), samples[0]);
+    // Shutdown takes priority — either explicit HAL stage or pure
+    // temperature evidence past the documented shutdown threshold.
+    if ((hottest.throttleStage !== undefined && hottest.throttleStage >= 3)
+        || hottest.tempMc >= 95000) {
+        return 'shutdown_imminent';
+    }
+    if (hottest.throttleStage === 2 || hottest.tempMc >= 85000)
+        return 'hard_throttle';
+    if (hottest.throttleStage === 1 || hottest.tempMc >= 70000)
+        return 'soft_throttle';
+    // Codex round 6 caught that classifying 60–69°C as soft_throttle
+    // contradicted the documented "cool < 70°C" bracket. Keep cool until
+    // we have either a HAL stage or a temperature past 70°C.
+    return 'cool';
+}
+/**
+ * "Has data" check that rejects both undefined and []. Codex review caught
+ * the same bug here that ioNetworkWakeup had: empty result arrays were
+ * being marked as supported coverage instead of missing evidence.
+ */
+function hasRows(rows) {
+    return Array.isArray(rows) && rows.length > 0;
+}
+function buildCpuThermalPmu(options) {
+    const freqHasRows = hasRows(options.freqSamples);
+    const thermalHasRows = hasRows(options.thermalSamples);
+    const pmuHasRows = hasRows(options.pmuSamples);
+    const cpuFreqResidency = freqHasRows ? buildResidency(options.range, options.freqSamples) : undefined;
+    const thermalSamples = thermalHasRows
+        ? options.thermalSamples.map(s => ({
+            zone: s.zone,
+            ts: s.ts,
+            tempMc: s.tempMc,
+            ...(s.throttleStage !== undefined ? { throttleStage: s.throttleStage } : {}),
+        }))
+        : undefined;
+    const thermalDecision = thermalHasRows ? decideThermal(options.thermalSamples) : undefined;
+    const pmuAttribution = pmuHasRows
+        ? options.pmuSamples.map(s => ({
+            counter: s.counter,
+            ...(s.utid !== undefined ? { utid: s.utid } : {}),
+            ...(s.process ? { process: s.process } : {}),
+            ...(s.thread ? { thread: s.thread } : {}),
+            value: s.value,
+            ...(s.derived ? { derived: s.derived } : {}),
+        }))
+        : undefined;
+    let smoothVsJank;
+    if (options.smoothFraction !== undefined && options.jankFraction !== undefined) {
+        smoothVsJank = {
+            smoothFraction: options.smoothFraction,
+            jankFraction: options.jankFraction,
+            delta: options.smoothFraction - options.jankFraction,
+        };
+    }
+    const allEmpty = !cpuFreqResidency
+        && !thermalSamples
+        && !pmuAttribution
+        && !smoothVsJank;
+    return {
+        ...(0, sparkContracts_1.makeSparkProvenance)({
+            source: 'cpu-thermal-pmu',
+            ...(allEmpty ? { unsupportedReason: 'no CPU / thermal / PMU samples supplied' } : {}),
+        }),
+        range: options.range,
+        ...(cpuFreqResidency ? { cpuFreqResidency } : {}),
+        ...(thermalSamples ? { thermalSamples } : {}),
+        ...(thermalDecision ? { thermalDecision } : {}),
+        ...(pmuAttribution ? { pmuAttribution } : {}),
+        ...(smoothVsJank ? { smoothVsJankComparison: smoothVsJank } : {}),
+        coverage: [
+            { sparkId: 8, planId: '13', status: cpuFreqResidency ? 'implemented' : 'scaffolded' },
+            { sparkId: 9, planId: '13', status: thermalSamples ? 'implemented' : 'scaffolded' },
+            { sparkId: 10, planId: '13', status: pmuAttribution ? 'implemented' : 'scaffolded' },
+            { sparkId: 35, planId: '13', status: thermalDecision ? 'implemented' : 'scaffolded' },
+        ],
+    };
+}
+//# sourceMappingURL=cpuThermalPmu.js.map

package/dist/services/cpuThermalPmu.js.map

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

package/dist/services/criticalPathAiSummary.d.ts

@@ -0,0 +1,29 @@
+import type { CriticalPathAnalysis } from './criticalPathAnalyzer';
+export interface CriticalPathAiSummary {
+    generated: boolean;
+    model?: string;
+    summary: string;
+    warnings: string[];
+    redactionApplied?: boolean;
+}
+declare function redactCriticalPathFields(value: unknown): unknown;
+export declare function buildDeterministicCriticalPathSummary(analysis: CriticalPathAnalysis): string;
+export declare function summarizeCriticalPathWithAi(analysis: CriticalPathAnalysis, question?: string): Promise<CriticalPathAiSummary>;
+export declare const __INTERNAL__: {
+    redactCriticalPathFields: typeof redactCriticalPathFields;
+    HARD_CAPS: {
+        readonly segments: 16;
+        readonly childSegments: 4;
+        readonly binderTxnsPerSeg: 4;
+        readonly monitorPerSeg: 4;
+        readonly ioPerSeg: 4;
+        readonly gcPerSeg: 4;
+        readonly cpuPerSeg: 4;
+        readonly hypotheses: 3;
+        readonly warnings: 8;
+        readonly stringMaxLen: 200;
+    };
+    STRUCTURED_PROMPT_TEMPLATE: string;
+};
+export {};
+//# sourceMappingURL=criticalPathAiSummary.d.ts.map

package/dist/services/criticalPathAiSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criticalPathAiSummary.d.ts","sourceRoot":"","sources":["../../src/services/criticalPathAiSummary.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAkCD,iBAAS,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAyCzD;AAED,wBAAgB,qCAAqC,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAqC5F;AA+HD,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC,CA4FhC;AAGD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;CAIxB,CAAC"}