@gracker/smartperfetto 1.0.13

package/dist/services/sqlValidator.js

@@ -0,0 +1,175 @@
+"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.SQLValidator = void 0;
+const perfettoSchema_1 = require("../data/perfettoSchema");
+class SQLValidator {
+    constructor() {
+        this.knownTables = new Set();
+        this.tableColumns = new Map();
+        this.parseSchema();
+    }
+    parseSchema() {
+        // Extract table definitions from schema
+        const tableRegex = /### (\w+)\n-\s+(\w+):\s+\w+.*?\n/gm;
+        const matches = Array.from(perfettoSchema_1.PERFETTO_TABLES_SCHEMA.matchAll(tableRegex));
+        this.knownTables = new Set(matches.map(m => m[1].toLowerCase()));
+        this.tableColumns = new Map();
+        // Parse columns for each table (simplified)
+        matches.forEach(match => {
+            const tableName = match[1].toLowerCase();
+            const tableSection = perfettoSchema_1.PERFETTO_TABLES_SCHEMA.split(`### ${tableName}`)[1]?.split('\n###')[0];
+            if (tableSection) {
+                const columnLines = tableSection.match(/-\s+(\w+):/g) || [];
+                const columns = columnLines.map(line => line.match(/-\s+(\w+):/)?.[1]).filter(Boolean);
+                this.tableColumns.set(tableName, columns);
+            }
+        });
+    }
+    validateSQL(sql) {
+        const result = {
+            isValid: true,
+            errors: [],
+            warnings: [],
+            suggestions: []
+        };
+        // Convert to lowercase for parsing
+        const sqlLower = sql.toLowerCase();
+        // 1. Check for invalid SQL syntax patterns
+        if (sqlLower.includes('limit offset')) {
+            result.errors.push('LIMIT OFFSET syntax is not supported in Perfetto SQL');
+            result.isValid = false;
+        }
+        // 2. Check for standard SQL features not in Perfetto
+        if (sqlLower.includes('group concat') || sqlLower.includes('string_agg')) {
+            result.errors.push('String aggregation functions like GROUP_CONCAT or STRING_AGG are not supported');
+            result.isValid = false;
+        }
+        // 3. Check for suboptimal patterns
+        if (sqlLower.includes('where ') && !sqlLower.includes('table_with_filter')) {
+            result.warnings.push('Consider using TABLE_WITH_FILTER() instead of WHERE for better performance');
+        }
+        // 4. Extract and validate table references
+        const tables = this.extractTables(sql);
+        tables.forEach(tableRef => {
+            if (!this.knownTables.has(tableRef.table.toLowerCase())) {
+                if (!tableRef.table.includes('(')) { // Not a table function
+                    result.errors.push(`Unknown table: ${tableRef.table}`);
+                    result.isValid = false;
+                    // Suggest similar tables
+                    const similar = this.findSimilarTables(tableRef.table);
+                    if (similar.length > 0) {
+                        result.suggestions.push(`Did you mean: ${similar.join(', ')}?`);
+                    }
+                }
+            }
+        });
+        // 5. Validate JOIN conditions
+        this.validateJoins(sql, result);
+        // 6. Check for common Perfetto SQL anti-patterns
+        this.checkAntiPatterns(sql, result);
+        return result;
+    }
+    extractTables(sql) {
+        const tables = [];
+        // Regex to match table references in FROM and JOIN clauses
+        const fromRegex = /(?:from|join)\s+([a-z_][a-z0-9_]*)\s*(?:as\s+([a-z_][a-z0-9_]*))?\s*(?:where|join|group|order|$)/gi;
+        const matches = Array.from(sql.matchAll(fromRegex));
+        matches.forEach(match => {
+            tables.push({
+                table: match[1],
+                alias: match[2],
+                columns: []
+            });
+        });
+        return tables;
+    }
+    validateJoins(sql, result) {
+        // Check for proper ON conditions with foreign keys
+        const joinRegex = /join\s+(\w+)\s+on\s+([^;\n]+)/gi;
+        const matches = Array.from(sql.matchAll(joinRegex));
+        matches.forEach(match => {
+            const onClause = match[2].toLowerCase();
+            // Check if join is using known foreign key relationships
+            if (!onClause.includes('track_id') &&
+                !onClause.includes('utid') &&
+                !onClause.includes('upid') &&
+                !onClause.includes('id') &&
+                !onClause.includes('parent_id')) {
+                result.warnings.push(`JOIN condition might not use proper foreign key: ${match[1]}`);
+                result.suggestions.push(`Consider joining on foreign keys: track_id, utid, upid`);
+            }
+        });
+    }
+    checkAntiPatterns(sql, result) {
+        // Pattern 1: Using SELECT *
+        if (sql.match(/select\s+\*\s+from/i)) {
+            result.warnings.push('SELECT * can be slow in Perfetto SQL');
+            result.suggestions.push('Specify only the columns you need');
+        }
+        // Pattern 2: Missing timestamp conversions
+        if (sql.includes('.ts') && !sql.includes('/ 1e')) {
+            result.warnings.push('Timestamps are in nanoseconds, consider converting to seconds or milliseconds');
+            result.suggestions.push('Use ts / 1e9 for seconds or ts / 1e6 for milliseconds');
+        }
+        // Pattern 3: Duration in nanoseconds
+        if (sql.includes('.dur') && !sql.includes('/ 1e')) {
+            result.warnings.push('Durations are in nanoseconds, consider converting to milliseconds');
+            result.suggestions.push('Use dur / 1e6 for milliseconds');
+        }
+        // Pattern 4: Using string comparisons for IDs
+        if (sql.match(/where\s+\w+\s*=\s*['"]/i)) {
+            result.warnings.push('ID fields should be compared as numbers, not strings');
+            result.suggestions.push('Remove quotes around numeric ID comparisons');
+        }
+    }
+    findSimilarTables(table) {
+        const tableLower = table.toLowerCase();
+        const similar = [];
+        for (const knownTable of this.knownTables) {
+            // Simple Levenshtein distance
+            if (this.isSimilar(tableLower, knownTable, 2)) {
+                similar.push(knownTable);
+            }
+        }
+        return similar.slice(0, 3); // Return top 3 suggestions
+    }
+    isSimilar(a, b, maxDistance) {
+        if (Math.abs(a.length - b.length) > maxDistance)
+            return false;
+        let distance = 0;
+        for (let i = 0; i < Math.max(a.length, b.length); i++) {
+            if (a[i] !== b[i])
+                distance++;
+            if (distance > maxDistance)
+                return false;
+        }
+        return true;
+    }
+    suggestCorrection(sql) {
+        const validation = this.validateSQL(sql);
+        if (validation.isValid) {
+            return sql;
+        }
+        let corrected = sql;
+        // Apply common corrections
+        for (const error of validation.errors) {
+            if (error.includes('Unknown table')) {
+                const match = error.match(/Unknown table: (\w+)/);
+                if (match) {
+                    const tableName = match[1];
+                    const suggestion = this.findSimilarTables(tableName)[0];
+                    if (suggestion) {
+                        corrected = corrected.replace(new RegExp(tableName, 'g'), suggestion);
+                    }
+                }
+            }
+        }
+        return corrected;
+    }
+}
+exports.SQLValidator = SQLValidator;
+exports.default = SQLValidator;
+//# sourceMappingURL=sqlValidator.js.map

package/dist/services/sqlValidator.js.map

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

package/dist/services/standardMetricBackfillService.d.ts

@@ -0,0 +1,23 @@
+import { type AnalysisResultSnapshot, type ComparisonMetricKey, type EvidenceRef, type NormalizedMetricValue, type StandardComparisonMetricKey } from '../types/multiTraceComparison';
+import type { AnalysisResultSnapshotRepository, SnapshotAccessScope } from './analysisResultSnapshotStore';
+import type { QueryResult, TraceProcessorServiceQueryOptions } from './traceProcessorService';
+export declare const BACKFILL_SUPPORTED_STANDARD_METRIC_KEYS: readonly StandardComparisonMetricKey[];
+export interface StandardMetricBackfillTraceProcessor {
+    query(traceId: string, sql: string, options?: TraceProcessorServiceQueryOptions): Promise<QueryResult>;
+}
+export interface BackfillStandardMetricsInput {
+    snapshot: AnalysisResultSnapshot;
+    metricKeys: ComparisonMetricKey[];
+    traceProcessor: StandardMetricBackfillTraceProcessor;
+    repository?: AnalysisResultSnapshotRepository;
+    scope?: SnapshotAccessScope;
+    queryOptions?: TraceProcessorServiceQueryOptions;
+}
+export interface BackfillStandardMetricsResult {
+    snapshot: AnalysisResultSnapshot;
+    metrics: NormalizedMetricValue[];
+    evidenceRefs: EvidenceRef[];
+    missingReasons: Record<string, string>;
+}
+export declare function backfillStandardMetrics(input: BackfillStandardMetricsInput): Promise<BackfillStandardMetricsResult>;
+//# sourceMappingURL=standardMetricBackfillService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"standardMetricBackfillService.d.ts","sourceRoot":"","sources":["../../src/services/standardMetricBackfillService.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EACjC,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gCAAgC,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAC3G,OAAO,KAAK,EAAE,WAAW,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAE9F,eAAO,MAAM,uCAAuC,EAAE,SAAS,2BAA2B,EAMhF,CAAC;AAEX,MAAM,WAAW,oCAAoC;IACnD,KAAK,CACH,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,iCAAiC,GAC1C,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,cAAc,EAAE,oCAAoC,CAAC;IACrD,UAAU,CAAC,EAAE,gCAAgC,CAAC;IAC9C,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,YAAY,CAAC,EAAE,iCAAiC,CAAC;CAClD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AA+HD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CAmFxC"}

package/dist/services/standardMetricBackfillService.js

@@ -0,0 +1,196 @@
+"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.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKFILL_SUPPORTED_STANDARD_METRIC_KEYS = void 0;
+exports.backfillStandardMetrics = backfillStandardMetrics;
+const crypto_1 = __importDefault(require("crypto"));
+const multiTraceComparison_1 = require("../types/multiTraceComparison");
+exports.BACKFILL_SUPPORTED_STANDARD_METRIC_KEYS = [
+    'startup.total_ms',
+    'scrolling.avg_fps',
+    'scrolling.frame_count',
+    'scrolling.jank_count',
+    'scrolling.jank_rate_pct',
+];
+const METRIC_DEFINITION_BY_KEY = new Map(multiTraceComparison_1.STANDARD_COMPARISON_METRICS.map(metric => [metric.key, metric]));
+const SUPPORTED_KEYS = new Set(exports.BACKFILL_SUPPORTED_STANDARD_METRIC_KEYS);
+const STARTUP_SQL = `
+SELECT
+  dur / 1000000.0 AS startup_total_ms
+FROM android_startups
+WHERE dur IS NOT NULL
+ORDER BY dur DESC
+LIMIT 1;
+`;
+const SCROLLING_SQL = `
+WITH frames AS (
+  SELECT
+    ts,
+    dur,
+    jank_type
+  FROM actual_frame_timeline_slice
+  WHERE dur IS NOT NULL AND dur > 0
+),
+summary AS (
+  SELECT
+    COUNT(*) AS frame_count,
+    SUM(CASE WHEN jank_type IS NOT NULL AND jank_type != 'None' THEN 1 ELSE 0 END) AS jank_count,
+    MIN(ts) AS start_ts,
+    MAX(ts + dur) AS end_ts
+  FROM frames
+)
+SELECT
+  frame_count,
+  jank_count,
+  CASE
+    WHEN frame_count > 0 AND end_ts > start_ts
+      THEN frame_count * 1000000000.0 / (end_ts - start_ts)
+    ELSE NULL
+  END AS avg_fps,
+  CASE
+    WHEN frame_count > 0
+      THEN jank_count * 100.0 / frame_count
+    ELSE NULL
+  END AS jank_rate_pct
+FROM summary;
+`;
+function rowObject(result) {
+    const first = result.rows[0];
+    if (!first)
+        return null;
+    const row = {};
+    result.columns.forEach((column, index) => {
+        row[column] = first[index];
+    });
+    return row;
+}
+function toNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string') {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+function metricValue(key, value, backfillRunId, sql) {
+    const definition = METRIC_DEFINITION_BY_KEY.get(key);
+    if (!definition) {
+        throw new Error(`Unsupported backfill metric key: ${key}`);
+    }
+    return {
+        key,
+        label: definition.label,
+        group: definition.group,
+        value,
+        unit: definition.unit,
+        direction: definition.direction,
+        aggregation: definition.aggregation,
+        confidence: 0.7,
+        source: {
+            type: 'backfill',
+            sql,
+            backfillRunId,
+        },
+    };
+}
+function addMetricFromRow(output, key, row, field, backfillRunId, sql) {
+    const value = toNumber(row?.[field]);
+    if (value === undefined)
+        return;
+    output.set(key, metricValue(key, value, backfillRunId, sql));
+}
+function evidenceRef(snapshot, backfillRunId, metricKeys) {
+    return {
+        id: `${snapshot.id}:backfill:${backfillRunId}`,
+        type: 'trace_backfill',
+        snapshotId: snapshot.id,
+        runId: snapshot.runId,
+        label: 'Trace metric backfill',
+        metadata: {
+            traceId: snapshot.traceId,
+            metricKeys,
+            backfillRunId,
+        },
+    };
+}
+async function backfillStandardMetrics(input) {
+    const existingKeys = new Set(input.snapshot.metrics.map(metric => metric.key));
+    const requestedMissingKeys = [...new Set(input.metricKeys)]
+        .filter(key => !existingKeys.has(key));
+    const supportedMissingKeys = requestedMissingKeys
+        .filter(key => SUPPORTED_KEYS.has(key));
+    const missingReasons = {};
+    for (const key of requestedMissingKeys) {
+        if (!SUPPORTED_KEYS.has(key)) {
+            missingReasons[key] = 'metric_backfill_not_supported';
+        }
+    }
+    if (supportedMissingKeys.length === 0) {
+        return {
+            snapshot: input.snapshot,
+            metrics: [],
+            evidenceRefs: [],
+            missingReasons,
+        };
+    }
+    const backfillRunId = `metric-backfill-${crypto_1.default.randomUUID()}`;
+    const metrics = new Map();
+    if (supportedMissingKeys.some(key => key.startsWith('startup.'))) {
+        try {
+            const row = rowObject(await input.traceProcessor.query(input.snapshot.traceId, STARTUP_SQL, input.queryOptions));
+            addMetricFromRow(metrics, 'startup.total_ms', row, 'startup_total_ms', backfillRunId, STARTUP_SQL);
+        }
+        catch (error) {
+            for (const key of supportedMissingKeys.filter(item => item.startsWith('startup.'))) {
+                missingReasons[key] = error instanceof Error ? error.message : String(error);
+            }
+        }
+    }
+    if (supportedMissingKeys.some(key => key.startsWith('scrolling.'))) {
+        try {
+            const row = rowObject(await input.traceProcessor.query(input.snapshot.traceId, SCROLLING_SQL, input.queryOptions));
+            addMetricFromRow(metrics, 'scrolling.avg_fps', row, 'avg_fps', backfillRunId, SCROLLING_SQL);
+            addMetricFromRow(metrics, 'scrolling.frame_count', row, 'frame_count', backfillRunId, SCROLLING_SQL);
+            addMetricFromRow(metrics, 'scrolling.jank_count', row, 'jank_count', backfillRunId, SCROLLING_SQL);
+            addMetricFromRow(metrics, 'scrolling.jank_rate_pct', row, 'jank_rate_pct', backfillRunId, SCROLLING_SQL);
+        }
+        catch (error) {
+            for (const key of supportedMissingKeys.filter(item => item.startsWith('scrolling.'))) {
+                missingReasons[key] = error instanceof Error ? error.message : String(error);
+            }
+        }
+    }
+    const selectedMetrics = supportedMissingKeys
+        .map(key => metrics.get(key))
+        .filter((metric) => Boolean(metric));
+    for (const key of supportedMissingKeys) {
+        if (!selectedMetrics.some(metric => metric.key === key) && !missingReasons[key]) {
+            missingReasons[key] = 'metric_not_found_in_trace';
+        }
+    }
+    const evidenceRefs = selectedMetrics.length > 0
+        ? [evidenceRef(input.snapshot, backfillRunId, selectedMetrics.map(metric => metric.key))]
+        : [];
+    const updatedSnapshot = input.repository && input.scope && selectedMetrics.length > 0
+        ? input.repository.upsertMetrics(input.scope, input.snapshot.id, selectedMetrics, evidenceRefs)
+        : null;
+    return {
+        snapshot: updatedSnapshot || {
+            ...input.snapshot,
+            metrics: [...input.snapshot.metrics, ...selectedMetrics],
+            evidenceRefs: [...input.snapshot.evidenceRefs, ...evidenceRefs],
+            status: input.snapshot.status === 'failed' ? input.snapshot.status : 'ready',
+        },
+        metrics: selectedMetrics,
+        evidenceRefs,
+        missingReasons,
+    };
+}
+//# sourceMappingURL=standardMetricBackfillService.js.map

package/dist/services/standardMetricBackfillService.js.map

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

package/dist/services/startupAnrMethodGraph.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Startup / ANR / Method-Trace Graph builder (Spark Plan 17)
+ *
+ * Combines startup phase rows, ANR attribution and method-trace nodes
+ * into one `StartupAnrMethodGraphContract`. Performs minimal validation:
+ *  - Method-trace nodes must reference valid child ids; orphans are
+ *    dropped from the children[] arrays so the contract can render.
+ *  - Each child id is recorded in `coverage` to surface implementation
+ *    completeness per spark.
+ */
+import { type AnrAttribution, type JankDecisionNode, type MethodTraceNode, type NsTimeRange, type StartupAnrMethodGraphContract, type StartupPhaseRow } from '../types/sparkContracts';
+export interface StartupAnrMethodGraphOptions {
+    range: NsTimeRange;
+    startupPhases?: StartupPhaseRow[];
+    anrAttributions?: AnrAttribution[];
+    methodTraceGraph?: MethodTraceNode[];
+    decisionTree?: JankDecisionNode;
+}
+export declare function buildStartupAnrMethodGraph(options: StartupAnrMethodGraphOptions): StartupAnrMethodGraphContract;
+//# sourceMappingURL=startupAnrMethodGraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"startupAnrMethodGraph.d.ts","sourceRoot":"","sources":["../../src/services/startupAnrMethodGraph.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,6BAA6B,EAClC,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,WAAW,CAAC;IACnB,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAqBD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,4BAA4B,GACpC,6BAA6B,CAgD/B"}

package/dist/services/startupAnrMethodGraph.js

@@ -0,0 +1,70 @@
+"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.buildStartupAnrMethodGraph = buildStartupAnrMethodGraph;
+/**
+ * Startup / ANR / Method-Trace Graph builder (Spark Plan 17)
+ *
+ * Combines startup phase rows, ANR attribution and method-trace nodes
+ * into one `StartupAnrMethodGraphContract`. Performs minimal validation:
+ *  - Method-trace nodes must reference valid child ids; orphans are
+ *    dropped from the children[] arrays so the contract can render.
+ *  - Each child id is recorded in `coverage` to surface implementation
+ *    completeness per spark.
+ */
+const sparkContracts_1 = require("../types/sparkContracts");
+/** Drop dangling child ids from method trace nodes. */
+function pruneMethodTraceChildren(nodes) {
+    if (!nodes || nodes.length === 0)
+        return nodes;
+    const validIds = new Set(nodes.map(n => n.id));
+    return nodes.map(n => ({
+        ...n,
+        ...(n.children
+            ? { children: n.children.filter(childId => validIds.has(childId)) }
+            : {}),
+    }));
+}
+/** "Has data" guard that rejects both undefined and [] (Codex regression). */
+function hasRows(rows) {
+    return Array.isArray(rows) && rows.length > 0;
+}
+function buildStartupAnrMethodGraph(options) {
+    const prunedMethodGraph = pruneMethodTraceChildren(options.methodTraceGraph);
+    const hasStartup = hasRows(options.startupPhases);
+    const hasAnr = hasRows(options.anrAttributions);
+    const hasMethod = hasRows(prunedMethodGraph);
+    const hasTree = Boolean(options.decisionTree);
+    const allEmpty = !hasStartup && !hasAnr && !hasMethod && !hasTree;
+    // Phase coverage detection — flips coverage entries when a phase row
+    // surfaces evidence for a particular spark.
+    const hasArtJit = hasStartup && options.startupPhases.some(p => p.artVerifierDurNs !== undefined || p.jitDurNs !== undefined || p.classLoadingDurNs !== undefined);
+    const hasCompose = hasStartup && options.startupPhases.some(p => p.recompositionCount !== undefined && p.recompositionCount > 0);
+    const hasInitializers = hasStartup && options.startupPhases.some(p => p.initializersFired !== undefined && p.initializersFired.length > 0);
+    const methodSources = new Set(hasMethod ? prunedMethodGraph.map(n => n.source).filter(Boolean) : []);
+    const hasAnrThreadSamples = hasAnr && options.anrAttributions.some(a => a.threadSamples !== undefined && a.threadSamples.length > 0);
+    return {
+        ...(0, sparkContracts_1.makeSparkProvenance)({
+            source: 'startup-anr-method-graph',
+            ...(allEmpty ? { unsupportedReason: 'no startup / ANR / method-trace facets supplied' } : {}),
+        }),
+        range: options.range,
+        ...(hasStartup ? { startupPhases: options.startupPhases } : {}),
+        ...(hasAnr ? { anrAttributions: options.anrAttributions } : {}),
+        ...(hasMethod ? { methodTraceGraph: prunedMethodGraph } : {}),
+        ...(hasTree ? { decisionTree: options.decisionTree } : {}),
+        coverage: [
+            { sparkId: 32, planId: '17', status: hasStartup ? 'implemented' : 'scaffolded' },
+            { sparkId: 33, planId: '17', status: hasAnr ? 'implemented' : 'scaffolded' },
+            { sparkId: 49, planId: '17', status: hasAnrThreadSamples ? 'implemented' : 'scaffolded' },
+            { sparkId: 68, planId: '17', status: hasCompose ? 'implemented' : 'scaffolded' },
+            { sparkId: 69, planId: '17', status: hasInitializers ? 'implemented' : 'scaffolded' },
+            { sparkId: 72, planId: '17', status: methodSources.has('matrix') || methodSources.has('btrace') || methodSources.has('rheatrace') || methodSources.has('koom') ? 'implemented' : 'scaffolded' },
+            { sparkId: 78, planId: '17', status: methodSources.has('bytecode') ? 'implemented' : 'scaffolded' },
+            { sparkId: 132, planId: '17', status: hasArtJit ? 'implemented' : 'scaffolded' },
+        ],
+    };
+}
+//# sourceMappingURL=startupAnrMethodGraph.js.map

package/dist/services/startupAnrMethodGraph.js.map

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

package/dist/services/stdlibSkillCoverage.d.ts

@@ -0,0 +1,23 @@
+import { type StdlibSkillCoverageContract } from '../types/sparkContracts';
+export interface AnalyzeStdlibSkillCoverageOptions {
+    /** Override snapshot path (used in tests). */
+    snapshotPath?: string;
+    /** Skip persisted snapshot lookup entirely. */
+    ignoreSnapshot?: boolean;
+}
+/**
+ * Analyze Skill prerequisites + raw-SQL detected stdlib usage and produce a
+ * `StdlibSkillCoverageContract` snapshot.
+ *
+ * Returns an unsupported contract (with empty arrays) when the stdlib catalog
+ * is unavailable so the caller can detect missing data without inventing
+ * coverage statistics.
+ */
+export declare function analyzeStdlibSkillCoverage(options?: AnalyzeStdlibSkillCoverageOptions): Promise<StdlibSkillCoverageContract>;
+/**
+ * Persist the current stdlib catalog as a snapshot so future runs can detect
+ * newly added modules. Safe to call from CLI; never throws on filesystem
+ * issues — it logs a warning and continues.
+ */
+export declare function persistStdlibSnapshot(snapshotPath?: string): void;
+//# sourceMappingURL=stdlibSkillCoverage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stdlibSkillCoverage.d.ts","sourceRoot":"","sources":["../../src/services/stdlibSkillCoverage.ts"],"names":[],"mappings":"AA8BA,OAAO,EAGL,KAAK,2BAA2B,EAEjC,MAAM,yBAAyB,CAAC;AA0FjC,MAAM,WAAW,iCAAiC;IAChD,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,2BAA2B,CAAC,CAuHtC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAcjE"}