@xctrace-analyzer/core 0.1.0

package/dist/utils/xctrace-runner.js

@@ -0,0 +1,420 @@
+/**
+ * Utility for running xctrace commands
+ */
+import { execFile } from 'child_process';
+import { mkdtemp, readdir, readFile, rm, stat } from 'fs/promises';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { promisify } from 'util';
+import { XCTraceError } from '../types.js';
+const execFileAsync = promisify(execFile);
+const DEFAULT_MAX_BUFFER = 50 * 1024 * 1024;
+const DEFAULT_COMMAND_TIMEOUT_MS = 30_000;
+const EXPORT_TOC_TIMEOUT_MS = 30_000;
+// 5s was too short — real time-profile / potential-hangs exports on a 30s
+// trace routinely take 10–25s. Override per call via the third arg if needed.
+const EXPORT_TABLE_TIMEOUT_MS = 60_000;
+const EXPORT_HAR_TIMEOUT_MS = 30_000;
+const SYMBOLICATE_TIMEOUT_MS = 60_000;
+const MAX_EXPORT_FILE_BYTES = 50 * 1024 * 1024;
+const MAX_HAR_FILE_BYTES = 25 * 1024 * 1024;
+async function runXcrun(args, timeout) {
+    const { stdout } = await execFileAsync('xcrun', args, {
+        maxBuffer: DEFAULT_MAX_BUFFER,
+        timeout: timeout ?? DEFAULT_COMMAND_TIMEOUT_MS,
+        killSignal: 'SIGKILL',
+    });
+    return stdout.trimEnd();
+}
+/**
+ * Variant of {@link runXcrun} that always resolves, even when xctrace exits with
+ * a non-zero status. Required by `recordTrace`: xctrace returns a non-zero exit
+ * code when `--time-limit` fires (or the user sends Ctrl-C) even though the
+ * trace file was fully written. Inspecting the trace path on disk is a more
+ * reliable success signal than the exit code.
+ */
+function runXcrunRaw(args, timeout) {
+    return new Promise((resolve) => {
+        execFile('xcrun', args, {
+            maxBuffer: DEFAULT_MAX_BUFFER,
+            timeout: timeout ?? DEFAULT_COMMAND_TIMEOUT_MS,
+            killSignal: 'SIGKILL',
+        }, (error, stdout, stderr) => {
+            const exitCode = error?.code;
+            const numericExit = typeof exitCode === 'number'
+                ? exitCode
+                : exitCode === undefined || exitCode === null
+                    ? error
+                        ? null
+                        : 0
+                    : null;
+            const signal = error?.signal ?? null;
+            resolve({
+                stdout: (stdout ?? '').toString(),
+                stderr: (stderr ?? '').toString(),
+                exitCode: numericExit,
+                signal,
+            });
+        });
+    });
+}
+async function runXcrunWithOutputFile(args, extension, timeout, maxBytes = MAX_EXPORT_FILE_BYTES) {
+    const tempDir = await mkdtemp(join(tmpdir(), 'xctrace-export-'));
+    const outputPath = join(tempDir, `export.${extension}`);
+    try {
+        await execFileAsync('xcrun', [...args, '--output', outputPath], {
+            maxBuffer: 1024 * 1024,
+            timeout: timeout ?? DEFAULT_COMMAND_TIMEOUT_MS,
+            killSignal: 'SIGKILL',
+        });
+        await assertReadableExportSize(outputPath, maxBytes);
+        return (await readFile(outputPath, 'utf8')).trimEnd();
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+async function runXcrunWithOutputDirectory(args, extension, timeout, maxBytes = MAX_EXPORT_FILE_BYTES) {
+    const tempDir = await mkdtemp(join(tmpdir(), 'xctrace-export-'));
+    try {
+        await execFileAsync('xcrun', [...args, '--output', tempDir], {
+            maxBuffer: 1024 * 1024,
+            timeout: timeout ?? DEFAULT_COMMAND_TIMEOUT_MS,
+            killSignal: 'SIGKILL',
+        });
+        const files = await readdir(tempDir);
+        const outputFile = files.find((file) => file.endsWith(`.${extension}`));
+        if (!outputFile) {
+            return '';
+        }
+        const outputPath = join(tempDir, outputFile);
+        await assertReadableExportSize(outputPath, maxBytes);
+        return (await readFile(outputPath, 'utf8')).trimEnd();
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+async function assertReadableExportSize(path, maxBytes) {
+    const stats = await stat(path);
+    if (stats.size > maxBytes) {
+        throw new XCTraceError(`xctrace export exceeded the ${Math.round(maxBytes / 1024 / 1024)} MB safety limit: ${path}`);
+    }
+}
+function processErrorOutput(error) {
+    const output = [error.stdout, error.stderr]
+        .filter((value) => typeof value === 'string' && value.trim())
+        .join('\n')
+        .trim();
+    return output || error.message || '';
+}
+function parseListOutput(stdout) {
+    return stdout
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line &&
+        !line.startsWith('==') &&
+        line !== 'No instruments found' &&
+        !line.includes(' ERROR ') &&
+        !line.includes(' WARN ') &&
+        !line.startsWith('(kernel)') &&
+        !line.startsWith('Failed to '));
+}
+async function listXctraceValues(kind) {
+    const stdout = await runXcrun(['xctrace', 'list', kind]);
+    return parseListOutput(stdout);
+}
+/**
+ * Check if xctrace is available on the system
+ */
+export async function isXCTraceAvailable() {
+    try {
+        await runXcrun(['xctrace', 'version']);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get xctrace version
+ */
+export async function getXCTraceVersion() {
+    try {
+        return (await runXcrun(['xctrace', 'version'])).trim();
+    }
+    catch (error) {
+        throw new XCTraceError('Failed to get xctrace version', error.code, error.stderr);
+    }
+}
+/**
+ * Best-effort capability snapshot for the local xctrace installation.
+ */
+export async function getXCTraceCapabilities() {
+    const warnings = [];
+    try {
+        const version = await getXCTraceVersion();
+        const [templates, devices, instruments] = await Promise.all([
+            listTemplates().catch((error) => {
+                warnings.push(`Failed to list templates: ${error.message}`);
+                return [];
+            }),
+            listDevices().catch((error) => {
+                warnings.push(`Failed to list devices: ${error.message}`);
+                return [];
+            }),
+            listInstruments().catch((error) => {
+                warnings.push(`Failed to list instruments: ${error.message}`);
+                return [];
+            }),
+        ]);
+        return {
+            available: true,
+            version,
+            templates,
+            devices,
+            instruments,
+            exportModes: ['toc', 'xpath', 'har'],
+            recordModes: ['attach', 'launch', 'all-processes'],
+            supportsSymbolication: true,
+            warnings,
+        };
+    }
+    catch (error) {
+        return {
+            available: false,
+            templates: [],
+            devices: [],
+            instruments: [],
+            exportModes: [],
+            recordModes: [],
+            supportsSymbolication: false,
+            warnings: [`xctrace unavailable: ${error.message}`],
+        };
+    }
+}
+/**
+ * Export table of contents from a trace file
+ */
+export async function exportTOC(tracePath) {
+    try {
+        return await runXcrunWithOutputFile(['xctrace', 'export', '--input', tracePath, '--toc'], 'xml', EXPORT_TOC_TIMEOUT_MS);
+    }
+    catch (error) {
+        throw new XCTraceError(`Failed to export TOC from trace: ${tracePath}`, error.code, error.stderr);
+    }
+}
+/**
+ * Export a specific XPath from a trace.
+ */
+export async function exportXPath(tracePath, xpath) {
+    try {
+        return await runXcrunWithOutputFile(['xctrace', 'export', '--input', tracePath, '--xpath', xpath], 'xml', EXPORT_TABLE_TIMEOUT_MS);
+    }
+    catch (error) {
+        throw new XCTraceError(`Failed to export XPath '${xpath}' from trace: ${tracePath}`, error.code, error.stderr);
+    }
+}
+/**
+ * Export specific data table from trace using XPath
+ */
+export async function exportTable(tracePath, schema, runNumber = 1) {
+    const xpath = `/trace-toc/run[@number="${runNumber}"]/data/table[@schema=${xpathStringLiteral(schema)}]`;
+    try {
+        return await exportXPath(tracePath, xpath);
+    }
+    catch (error) {
+        throw new XCTraceError(`Failed to export table '${schema}' from trace: ${tracePath}`, error.code, error.stderr);
+    }
+}
+/**
+ * Export network data as HTTP Archive, when xctrace supports it for the trace.
+ */
+export async function exportHAR(tracePath) {
+    try {
+        return await runXcrunWithOutputDirectory(['xctrace', 'export', '--input', tracePath, '--har'], 'har', EXPORT_HAR_TIMEOUT_MS, MAX_HAR_FILE_BYTES);
+    }
+    catch (error) {
+        throw new XCTraceError(`Failed to export HAR from trace: ${tracePath}`, error.code, error.stderr);
+    }
+}
+function xpathStringLiteral(value) {
+    if (!value.includes('"')) {
+        return `"${value}"`;
+    }
+    if (!value.includes("'")) {
+        return `'${value}'`;
+    }
+    const parts = value.split("'").flatMap((part, index) => index === 0 ? [`'${part}'`] : [`"'"`, `'${part}'`]);
+    return `concat(${parts.join(', ')})`;
+}
+/**
+ * List available Instruments templates
+ */
+export async function listTemplates() {
+    try {
+        return await listXctraceValues('templates');
+    }
+    catch (error) {
+        throw new XCTraceError('Failed to list templates', error.code, error.stderr);
+    }
+}
+/**
+ * List available devices
+ */
+export async function listDevices() {
+    try {
+        return await listXctraceValues('devices');
+    }
+    catch (error) {
+        throw new XCTraceError('Failed to list devices', error.code, error.stderr);
+    }
+}
+/**
+ * List available Instruments that can be added to templates, when xctrace exposes them.
+ */
+export async function listInstruments() {
+    try {
+        return await listXctraceValues('instruments');
+    }
+    catch (error) {
+        throw new XCTraceError('Failed to list instruments', error.code, error.stderr);
+    }
+}
+export function buildRecordTraceArgs(options) {
+    const launchTarget = options.launchCommand ?? options.appIdentifier;
+    const targetCount = [
+        options.processName ? 'processName' : undefined,
+        options.allProcesses ? 'allProcesses' : undefined,
+        launchTarget ? 'launch' : undefined,
+    ].filter(Boolean);
+    if (targetCount.length === 0) {
+        throw new XCTraceError('Recording requires processName, launchCommand/appIdentifier, or allProcesses');
+    }
+    if (targetCount.length > 1) {
+        throw new XCTraceError(`Recording target is ambiguous: ${targetCount.join(', ')}`);
+    }
+    if ((options.environment || options.targetStdin || options.targetStdout) && !launchTarget) {
+        throw new XCTraceError('Launch environment and stream redirection require launchCommand or appIdentifier');
+    }
+    const args = [
+        'xctrace',
+        'record',
+        '--template',
+        options.template,
+    ];
+    for (const instrument of options.instruments ?? []) {
+        args.push('--instrument', instrument);
+    }
+    if (options.processName) {
+        args.push('--attach', options.processName);
+    }
+    else if (options.allProcesses) {
+        args.push('--all-processes');
+    }
+    if (options.device) {
+        args.push('--device', options.device);
+    }
+    if (options.duration) {
+        args.push('--time-limit', `${options.duration}s`);
+    }
+    args.push('--output', options.outputPath);
+    if (options.noPrompt !== false) {
+        args.push('--no-prompt');
+    }
+    if (launchTarget) {
+        if (options.targetStdin) {
+            args.push('--target-stdin', options.targetStdin);
+        }
+        if (options.targetStdout) {
+            args.push('--target-stdout', options.targetStdout);
+        }
+        for (const [name, value] of Object.entries(options.environment ?? {})) {
+            args.push('--env', `${name}=${value}`);
+        }
+        args.push('--launch', '--', launchTarget, ...(options.launchArguments ?? []));
+    }
+    return args;
+}
+export async function recordTrace(options) {
+    const args = buildRecordTraceArgs(options);
+    const timeout = (options.duration || 30) * 1000 + 30000;
+    // xctrace returns a non-zero exit code when `--time-limit` fires or when the
+    // user (or our killSignal) sends a signal — even though the trace file is
+    // fully written. Determine success from the artifact on disk instead of from
+    // the exit code so legitimate time-limited recordings aren't reported as
+    // failures.
+    const result = await runXcrunRaw(args, timeout);
+    const traceWritten = await traceArtifactExists(options.outputPath);
+    if (traceWritten) {
+        try {
+            await exportTOC(options.outputPath);
+        }
+        catch (error) {
+            const exportError = error;
+            const exportDetails = exportError.stderr || exportError.message;
+            const recordDetails = processErrorOutput({ stdout: result.stdout, stderr: result.stderr });
+            throw new XCTraceError([
+                `Trace was saved but xctrace could not export its TOC: ${options.outputPath}`,
+                exportDetails,
+                recordDetails ? `record output: ${recordDetails}` : '',
+            ]
+                .filter(Boolean)
+                .join(': '), exportError.exitCode ?? result.exitCode ?? undefined, exportDetails);
+        }
+        return;
+    }
+    const details = processErrorOutput({ stdout: result.stdout, stderr: result.stderr });
+    const target = options.processName ?? options.launchCommand ?? options.appIdentifier ?? 'all processes';
+    const exitDetail = result.signal != null
+        ? ` (signal ${result.signal})`
+        : result.exitCode != null
+            ? ` (exit ${result.exitCode})`
+            : '';
+    throw new XCTraceError([
+        `Failed to record trace for ${target}${exitDetail}`,
+        details,
+    ]
+        .filter(Boolean)
+        .join(': '), result.exitCode ?? undefined, details);
+}
+/**
+ * Exported for unit tests. xctrace `.trace` outputs are directories; success
+ * is determined by their presence + non-emptiness, not by xctrace's exit code.
+ */
+export async function traceArtifactExists(tracePath) {
+    try {
+        const stats = await stat(tracePath);
+        if (!stats.isDirectory()) {
+            return false;
+        }
+        const entries = await readdir(tracePath);
+        return entries.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+export function buildSymbolicateTraceArgs(options) {
+    const args = ['xctrace', 'symbolicate', '--input', options.inputPath];
+    if (options.outputPath) {
+        args.push('--output', options.outputPath);
+    }
+    if (options.dsymPath) {
+        args.push('--dsym', options.dsymPath);
+    }
+    return args;
+}
+/**
+ * Symbolicate a trace with xctrace. If outputPath is omitted, xctrace mutates the input trace.
+ */
+export async function symbolicateTrace(options) {
+    try {
+        await runXcrun(buildSymbolicateTraceArgs(options), SYMBOLICATE_TIMEOUT_MS);
+    }
+    catch (error) {
+        const details = processErrorOutput(error);
+        throw new XCTraceError([`Failed to symbolicate trace: ${options.inputPath}`, details].filter(Boolean).join(': '), error.code, details);
+    }
+}
+//# sourceMappingURL=xctrace-runner.js.map

package/dist/utils/xctrace-runner.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@xctrace-analyzer/core",
+  "version": "0.1.0",
+  "description": "Core analysis library for Xcode Instruments traces",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jamesrochabrun/XcodeTraceMCP.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/jamesrochabrun/XcodeTraceMCP/tree/main/packages/core#readme",
+  "bugs": {
+    "url": "https://github.com/jamesrochabrun/XcodeTraceMCP/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "xcode",
+    "instruments",
+    "xctrace",
+    "performance",
+    "analysis"
+  ],
+  "author": "James Rochabrun",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "darwin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "fast-xml-parser": "^5.7.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit --tsBuildInfoFile typecheck.tsbuildinfo",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}