@gracker/smartperfetto 1.0.13

package/dist/cli-user/services/runtimeGuard.js

@@ -0,0 +1,188 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertAnalysisRuntimeReady = assertAnalysisRuntimeReady;
+exports.collectDoctorReport = collectDoctorReport;
+exports.isClaudeSdkBinaryUsable = isClaudeSdkBinaryUsable;
+const fs = __importStar(require("fs"));
+const runtimeSelection_1 = require("../../agentRuntime/runtimeSelection");
+const claudeConfig_1 = require("../../agentv3/claudeConfig");
+const openAiConfig_1 = require("../../agentOpenAI/openAiConfig");
+const workingTraceProcessor_1 = require("../../services/workingTraceProcessor");
+const providerManager_1 = require("../../services/providerManager");
+function providerIdFor(selection) {
+    return selection.source === 'provider' ? selection.providerId ?? null : null;
+}
+function assertAnalysisRuntimeReady(options = {}) {
+    const selection = (0, runtimeSelection_1.resolveAgentRuntimeSelection)(options.providerId, options.runtimeOverride);
+    const providerId = providerIdFor(selection);
+    if (selection.kind === 'openai-agents-sdk') {
+        const diagnostics = (0, openAiConfig_1.getOpenAIRuntimeDiagnostics)(providerId);
+        if (!(0, openAiConfig_1.hasOpenAICredentials)(providerId)) {
+            throw new Error([
+                'OpenAI runtime is selected but no usable OpenAI-compatible credentials were found.',
+                'Set OPENAI_API_KEY, configure an active OpenAI/Ollama provider, or use a localhost OpenAI-compatible endpoint.',
+                'Run `smp doctor --format text` for the resolved runtime and provider details.',
+            ].join(' '));
+        }
+        return { selection, diagnostics };
+    }
+    const diagnostics = (0, claudeConfig_1.getClaudeRuntimeDiagnostics)(providerId);
+    if (!isClaudeSdkBinaryUsable(diagnostics.sdkBinary)) {
+        throw new Error([
+            'Claude Agent SDK runtime is selected but its native binary is not executable.',
+            diagnostics.sdkBinary?.chosenPath
+                ? `Resolved binary: ${diagnostics.sdkBinary.chosenPath}`
+                : 'No SDK native binary was resolved.',
+            'Reinstall backend dependencies, or set CLAUDE_BINARY_PATH to an executable Claude Agent SDK binary.',
+        ].join(' '));
+    }
+    // Claude Agent SDK can use API/proxy credentials, Bedrock/Vertex env, or a
+    // local Claude Code login. Do not reject the local-auth fallback here; the SDK
+    // will surface a precise auth error if the local account is unavailable.
+    return { selection, diagnostics };
+}
+function collectDoctorReport(cliHome) {
+    const selection = (0, runtimeSelection_1.resolveAgentRuntimeSelection)();
+    const providerId = providerIdFor(selection);
+    const runtimeDiagnostics = selection.kind === 'openai-agents-sdk'
+        ? (0, openAiConfig_1.getOpenAIRuntimeDiagnostics)(providerId)
+        : (0, claudeConfig_1.getClaudeRuntimeDiagnostics)(providerId);
+    const traceProcessorPath = (0, workingTraceProcessor_1.getTraceProcessorPath)();
+    const traceProcessorExists = fs.existsSync(traceProcessorPath);
+    const traceProcessorExecutable = traceProcessorExists && isExecutable(traceProcessorPath);
+    const providerSvc = (0, providerManager_1.getProviderService)();
+    const providers = providerSvc.list();
+    const active = providers.find((p) => p.isActive);
+    const nodeMajor = Number.parseInt(process.version.replace(/^v/, '').split('.')[0] || '0', 10);
+    const checks = [
+        {
+            name: 'node',
+            ok: nodeMajor >= 24 && nodeMajor < 25,
+            status: nodeMajor >= 24 && nodeMajor < 25 ? 'ok' : 'error',
+            message: `Node.js ${process.version} (expected >=24 <25)`,
+        },
+        {
+            name: 'runtime',
+            ok: runtimeDiagnostics.configured || selection.kind === 'claude-agent-sdk',
+            status: runtimeDiagnostics.configured
+                ? 'ok'
+                : selection.kind === 'claude-agent-sdk'
+                    ? 'warn'
+                    : 'error',
+            message: runtimeDiagnostics.configured
+                ? `${selection.kind} credentials/configuration detected`
+                : selection.kind === 'claude-agent-sdk'
+                    ? 'Claude SDK has no explicit credentials; local Claude login fallback will be used if available'
+                    : 'OpenAI runtime needs OPENAI_API_KEY or a localhost/OpenAI-compatible provider',
+            details: {
+                source: selection.source,
+                providerId: selection.providerId,
+                providerName: selection.providerName,
+            },
+        },
+        ...(selection.kind === 'claude-agent-sdk'
+            ? [buildClaudeSdkBinaryCheck(runtimeDiagnostics.sdkBinary)]
+            : []),
+        {
+            name: 'trace_processor_shell',
+            ok: traceProcessorExists && traceProcessorExecutable,
+            status: traceProcessorExists && traceProcessorExecutable ? 'ok' : 'warn',
+            message: traceProcessorExists
+                ? traceProcessorExecutable
+                    ? 'trace_processor_shell is present and executable'
+                    : 'trace_processor_shell exists but is not executable'
+                : 'trace_processor_shell is missing; CLI will download the pinned binary on first trace command',
+            details: { path: traceProcessorPath },
+        },
+    ];
+    return {
+        ok: checks.every((c) => c.status !== 'error'),
+        generatedAt: new Date().toISOString(),
+        node: {
+            version: process.version,
+            expected: '>=24.0.0 <25.0.0',
+            ok: nodeMajor >= 24 && nodeMajor < 25,
+        },
+        cliHome,
+        runtime: selection,
+        runtimeDiagnostics,
+        traceProcessor: {
+            path: traceProcessorPath,
+            exists: traceProcessorExists,
+            executable: traceProcessorExecutable,
+        },
+        providers: {
+            count: providers.length,
+            ...(active ? { active: { id: active.id, name: active.name, type: active.type } } : {}),
+        },
+        checks,
+    };
+}
+function isExecutable(filePath) {
+    try {
+        fs.accessSync(filePath, fs.constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isClaudeSdkBinaryUsable(sdkBinary) {
+    if (!sdkBinary?.chosenPath || sdkBinary.source === 'none')
+        return false;
+    return isExecutable(sdkBinary.chosenPath);
+}
+function buildClaudeSdkBinaryCheck(sdkBinary) {
+    const usable = isClaudeSdkBinaryUsable(sdkBinary);
+    return {
+        name: 'claude_sdk_binary',
+        ok: usable,
+        status: usable ? 'ok' : 'error',
+        message: usable
+            ? 'Claude Agent SDK native binary is present and executable'
+            : 'Claude Agent SDK native binary is missing or not executable',
+        details: {
+            path: sdkBinary?.chosenPath ?? null,
+            source: sdkBinary?.source ?? 'none',
+            detectedPlatformKey: sdkBinary?.detectedPlatformKey ?? null,
+            fallbackUsed: sdkBinary?.fallbackUsed ?? false,
+        },
+    };
+}
+//# sourceMappingURL=runtimeGuard.js.map

package/dist/cli-user/services/runtimeGuard.js.map

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

package/dist/cli-user/services/traceProcessorInstaller.d.ts

@@ -0,0 +1,2 @@
+export declare function installTraceProcessorPrebuilt(destination: string): Promise<void>;
+//# sourceMappingURL=traceProcessorInstaller.d.ts.map

package/dist/cli-user/services/traceProcessorInstaller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceProcessorInstaller.d.ts","sourceRoot":"","sources":["../../../src/cli-user/services/traceProcessorInstaller.ts"],"names":[],"mappings":"AAiBA,wBAAsB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CtF"}

package/dist/cli-user/services/traceProcessorInstaller.js

@@ -0,0 +1,241 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installTraceProcessorPrebuilt = installTraceProcessorPrebuilt;
+const child_process_1 = require("child_process");
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const https = __importStar(require("https"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+async function installTraceProcessorPrebuilt(destination) {
+    const pin = loadPinConfig();
+    const platform = detectPlatform();
+    const expectedSha = pin.sha256ByPlatform[platform];
+    if (!expectedSha) {
+        throw new Error(`No trace_processor_shell SHA256 pin for platform: ${platform}`);
+    }
+    const url = resolveDownloadUrl(pin, platform);
+    const tmpSuffix = platform.startsWith('windows-') ? '.exe' : '';
+    const tmp = path.join(os.tmpdir(), `smartperfetto-trace_processor_shell-${process.pid}-${Date.now()}${tmpSuffix}`);
+    try {
+        await downloadFile(url, tmp);
+        const actualSha = sha256File(tmp);
+        if (actualSha !== expectedSha) {
+            throw new Error([
+                'Downloaded trace_processor_shell failed SHA256 verification.',
+                `expected: ${expectedSha}`,
+                `actual:   ${actualSha}`,
+            ].join('\n'));
+        }
+        fs.chmodSync(tmp, 0o755);
+        const smoke = (0, child_process_1.spawnSync)(tmp, ['--version'], { stdio: 'ignore' });
+        if (smoke.status !== 0) {
+            throw new Error(`Downloaded trace_processor_shell failed the --version smoke test.${formatMacPermissionHint(tmp)}`);
+        }
+        fs.mkdirSync(path.dirname(destination), { recursive: true });
+        fs.renameSync(tmp, destination);
+        fs.chmodSync(destination, 0o755);
+    }
+    catch (err) {
+        try {
+            fs.rmSync(tmp, { force: true });
+        }
+        catch {
+            // ignore cleanup failure
+        }
+        if (err instanceof Error) {
+            throw new Error(`${err.message}${formatDownloadHelp(url)}`);
+        }
+        throw err;
+    }
+}
+function loadPinConfig() {
+    const pinPath = findPinFile();
+    const values = parseEnvFile(pinPath);
+    const version = requirePinValue(values, 'PERFETTO_VERSION', pinPath);
+    const urlBase = requirePinValue(values, 'PERFETTO_LUCI_URL_BASE', pinPath);
+    return {
+        version,
+        urlBase,
+        sha256ByPlatform: {
+            'linux-amd64': requirePinValue(values, 'PERFETTO_SHELL_SHA256_LINUX_AMD64', pinPath),
+            'linux-arm64': requirePinValue(values, 'PERFETTO_SHELL_SHA256_LINUX_ARM64', pinPath),
+            'mac-amd64': requirePinValue(values, 'PERFETTO_SHELL_SHA256_MAC_AMD64', pinPath),
+            'mac-arm64': requirePinValue(values, 'PERFETTO_SHELL_SHA256_MAC_ARM64', pinPath),
+            'windows-amd64': requirePinValue(values, 'PERFETTO_SHELL_SHA256_WINDOWS_AMD64', pinPath),
+        },
+    };
+}
+function findPinFile() {
+    const candidates = [
+        // Packaged npm CLI: backend/dist/cli-user/services -> backend/dist
+        path.resolve(__dirname, '../../trace-processor-pin.env'),
+        // Source checkout: backend/src/cli-user/services -> repo root
+        path.resolve(__dirname, '../../../../scripts/trace-processor-pin.env'),
+    ];
+    const found = candidates.find((candidate) => fs.existsSync(candidate));
+    if (!found) {
+        throw new Error(`trace_processor_shell pin file not found. Checked: ${candidates.join(', ')}`);
+    }
+    return found;
+}
+function parseEnvFile(filePath) {
+    const values = {};
+    const lines = fs.readFileSync(filePath, 'utf-8').split(/\r?\n/);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eq = trimmed.indexOf('=');
+        if (eq <= 0)
+            continue;
+        values[trimmed.slice(0, eq)] = trimmed.slice(eq + 1);
+    }
+    return values;
+}
+function requirePinValue(values, key, filePath) {
+    const value = values[key];
+    if (!value)
+        throw new Error(`Missing ${key} in trace_processor_shell pin file: ${filePath}`);
+    return value;
+}
+function resolveDownloadUrl(pin, platform) {
+    const exactUrl = process.env.TRACE_PROCESSOR_DOWNLOAD_URL;
+    if (exactUrl)
+        return exactUrl;
+    const urlBase = process.env.TRACE_PROCESSOR_DOWNLOAD_BASE || pin.urlBase;
+    const executableName = platform.startsWith('windows-') ? 'trace_processor_shell.exe' : 'trace_processor_shell';
+    return `${urlBase.replace(/\/+$/, '')}/${pin.version}/${platform}/${executableName}`;
+}
+function formatDownloadHelp(url) {
+    return [
+        '',
+        '',
+        'trace_processor_shell download failed.',
+        `Attempted URL: ${url}`,
+        '',
+        'If Google storage is unreachable from your network, use one of:',
+        '  TRACE_PROCESSOR_PATH=/absolute/path/to/trace_processor_shell',
+        '  TRACE_PROCESSOR_DOWNLOAD_BASE=https://your-mirror/perfetto-luci-artifacts',
+        '  TRACE_PROCESSOR_DOWNLOAD_URL=https://your-mirror/trace_processor_shell',
+        '',
+        'Custom downloads are still SHA256-verified against the pinned SmartPerfetto binary.',
+    ].join('\n');
+}
+function formatMacPermissionHint(filePath) {
+    if (process.platform !== 'darwin')
+        return '';
+    return [
+        '',
+        '',
+        'macOS may have blocked trace_processor_shell because it was downloaded from the internet.',
+        'Open System Settings -> Privacy & Security -> Security, click "Allow Anyway" for trace_processor_shell,',
+        'then run the command again and choose "Open" if macOS asks.',
+        '',
+        'For a binary you trust, you can also run:',
+        `  xattr -dr com.apple.quarantine "${filePath}"`,
+        `  chmod +x "${filePath}"`,
+    ].join('\n');
+}
+function detectPlatform() {
+    const osPart = (() => {
+        switch (process.platform) {
+            case 'darwin':
+                return 'mac';
+            case 'linux':
+                return 'linux';
+            case 'win32':
+                return 'windows';
+            default:
+                throw new Error(`Unsupported OS for automatic trace_processor_shell install: ${process.platform}. ` +
+                    'Use TRACE_PROCESSOR_PATH=/path/to/trace_processor_shell.');
+        }
+    })();
+    const archPart = (() => {
+        switch (process.arch) {
+            case 'x64':
+                return 'amd64';
+            case 'arm64':
+                return 'arm64';
+            default:
+                throw new Error(`Unsupported CPU architecture for automatic trace_processor_shell install: ${process.arch}. ` +
+                    'Use TRACE_PROCESSOR_PATH=/path/to/trace_processor_shell.');
+        }
+    })();
+    return `${osPart}-${archPart}`;
+}
+function sha256File(filePath) {
+    return crypto
+        .createHash('sha256')
+        .update(fs.readFileSync(filePath))
+        .digest('hex');
+}
+async function downloadFile(url, destination, redirectsLeft = 3) {
+    return new Promise((resolve, reject) => {
+        const request = https.get(url, (response) => {
+            const statusCode = response.statusCode ?? 0;
+            const location = response.headers.location;
+            if (statusCode >= 300 && statusCode < 400 && location) {
+                response.resume();
+                if (redirectsLeft <= 0) {
+                    reject(new Error(`Too many redirects while downloading trace_processor_shell from ${url}`));
+                    return;
+                }
+                const nextUrl = new URL(location, url).toString();
+                downloadFile(nextUrl, destination, redirectsLeft - 1).then(resolve, reject);
+                return;
+            }
+            if (statusCode !== 200) {
+                response.resume();
+                reject(new Error(`Failed to download trace_processor_shell: HTTP ${statusCode} from ${url}`));
+                return;
+            }
+            const output = fs.createWriteStream(destination, { mode: 0o755 });
+            output.on('finish', () => output.close(() => resolve()));
+            output.on('error', reject);
+            response.on('error', reject);
+            response.pipe(output);
+        });
+        request.setTimeout(60000, () => {
+            request.destroy(new Error('Timed out downloading trace_processor_shell.'));
+        });
+        request.on('error', reject);
+    });
+}
+//# sourceMappingURL=traceProcessorInstaller.js.map

package/dist/cli-user/services/traceProcessorInstaller.js.map

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

package/dist/cli-user/services/turnPersistence.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Per-turn persistence helper shared by `analyze` and `resume`.
+ *
+ * Both commands end a turn with the same fan-out: write conclusion +
+ * per-turn markdown + HTML report + config + transcript + index entry,
+ * then render the conclusion block and the completion summary. This
+ * helper owns those eight steps so the call sites stay short and
+ * uniform — any future addition (e.g. a `--no-report` flag) only
+ * touches one place.
+ */
+import type { CliPaths, SessionPaths } from '../io/paths';
+import type { Renderer } from '../repl/renderer';
+import type { CliSessionConfig, CliSessionIndexEntry } from '../types';
+import type { RunTurnOutput } from './cliAnalyzeService';
+export interface CommitTurnInput {
+    paths: CliPaths;
+    sp: SessionPaths;
+    renderer: Renderer;
+    /** User-facing session id. For resume this equals the input session id;
+     *  for a fresh analyze it equals `result.sessionId`. */
+    sessionId: string;
+    /** 1-indexed. */
+    turn: number;
+    /** The user's question for this turn. */
+    query: string;
+    /** Output of CliAnalyzeService.runTurn(). */
+    result: RunTurnOutput;
+    /** Caller-constructed config. This helper persists it verbatim. */
+    config: CliSessionConfig;
+    /** Pre-formatted markdown for `turns/NNN.md`. */
+    turnMarkdown: string;
+    /** Optional deterministic appendix, currently used by dual-trace comparison. */
+    reportAppendix?: {
+        markdown: string;
+        html: string;
+    };
+    /** Caller-constructed index row. */
+    indexEntry: CliSessionIndexEntry;
+}
+export declare function commitTurnOutputs(input: CommitTurnInput): void;
+//# sourceMappingURL=turnPersistence.d.ts.map

package/dist/cli-user/services/turnPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnPersistence.d.ts","sourceRoot":"","sources":["../../../src/cli-user/services/turnPersistence.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWzD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,CAAC;IAChB,EAAE,EAAE,YAAY,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IAEnB;4DACwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,EAAE,aAAa,CAAC;IACtB,mEAAmE;IACnE,MAAM,EAAE,gBAAgB,CAAC;IACzB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,cAAc,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,oCAAoC;IACpC,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CA4C9D"}

package/dist/cli-user/services/turnPersistence.js

@@ -0,0 +1,55 @@
+"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.commitTurnOutputs = commitTurnOutputs;
+const sessionStore_1 = require("../io/sessionStore");
+const indexJson_1 = require("../io/indexJson");
+const transcriptWriter_1 = require("../io/transcriptWriter");
+function commitTurnOutputs(input) {
+    const { paths, sp, renderer, sessionId, turn, query, result, config, turnMarkdown, reportAppendix, indexEntry } = input;
+    const conclusion = result.result.conclusion || '';
+    (0, sessionStore_1.writeConclusion)(sp, conclusion);
+    (0, sessionStore_1.writeTurnMarkdown)(sp, turn, reportAppendix?.markdown ? `${turnMarkdown}\n\n${reportAppendix.markdown}` : turnMarkdown);
+    let turnReportPath;
+    const reportHtml = result.reportHtml && reportAppendix?.html
+        ? appendHtmlToBody(result.reportHtml, reportAppendix.html)
+        : result.reportHtml;
+    const reportPathForUser = result.reportHtml
+        ? (turnReportPath = (0, sessionStore_1.writeTurnReportHtml)(sp, turn, reportHtml || ''), (0, sessionStore_1.writeReportHtml)(sp, reportHtml || ''), sp.report)
+        : `(report generation failed${result.reportError ? `: ${result.reportError}` : ''})`;
+    (0, sessionStore_1.writeConfig)(sp, config);
+    (0, transcriptWriter_1.appendTranscriptTurn)(sp.transcript, {
+        turn,
+        timestamp: config.lastTurnAt,
+        question: query,
+        conclusionMd: conclusion,
+        confidence: result.result.confidence,
+        rounds: result.result.rounds,
+        durationMs: result.result.totalDurationMs,
+        reportFile: turnReportPath,
+        error: result.reportError,
+    });
+    (0, indexJson_1.upsertSession)(paths, indexEntry);
+    renderer.printConclusion(conclusion, {
+        confidence: result.result.confidence,
+        rounds: result.result.rounds,
+        durationMs: result.result.totalDurationMs,
+    });
+    renderer.printCompletion({
+        reportPath: reportPathForUser,
+        turnReportPath,
+        sessionDir: sp.dir,
+        sessionId,
+        success: result.result.success,
+    });
+}
+function appendHtmlToBody(html, appendixHtml) {
+    const closeBody = /<\/body>\s*<\/html>\s*$/i;
+    if (closeBody.test(html)) {
+        return html.replace(closeBody, `${appendixHtml}\n</body>\n</html>`);
+    }
+    return `${html}\n${appendixHtml}`;
+}
+//# sourceMappingURL=turnPersistence.js.map

package/dist/cli-user/services/turnPersistence.js.map

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

package/dist/cli-user/services/turnRunner.d.ts

@@ -0,0 +1,49 @@
+import type { CliPaths, SessionPaths } from '../io/paths';
+import type { Renderer } from '../repl/renderer';
+import type { CliAnalyzeService } from './cliAnalyzeService';
+export interface TurnRunnerContext {
+    paths: CliPaths;
+    service: CliAnalyzeService;
+    renderer: Renderer;
+}
+export interface TurnResult {
+    sessionId: string;
+    sessionDir: string;
+    turn: number;
+    success: boolean;
+    /** True when the resume path had to fall back to Level 3 (fresh load +
+     *  preamble). Callers can surface a note to the user. */
+    degraded: boolean;
+}
+/**
+ * Fresh analyze — loads the trace, creates a new session, runs turn 1.
+ * Equivalent to what `smartperfetto analyze <trace>` does, minus the
+ * bootstrap / service-lifecycle work around it.
+ */
+export declare function startSession(ctx: TurnRunnerContext, input: {
+    tracePath: string;
+    query: string;
+    referenceTracePath?: string;
+}): Promise<TurnResult>;
+/**
+ * Continue an existing session — reloads the trace (with the original id
+ * when possible), runs turn N+1, and commits outputs to the same folder.
+ *
+ * Three-level degradation (plan §G.3): Level 1/2 keep sessionId+sdkSessionId
+ * intact; Level 3 falls back to a fresh load with the prior conclusion
+ * injected as preamble but keeps the CLI-visible session id stable.
+ */
+export declare function continueSession(ctx: TurnRunnerContext, input: {
+    sessionId: string;
+    query: string;
+}): Promise<TurnResult>;
+export declare function buildResumeContextQuery(sp: SessionPaths, userQuery: string): string;
+/**
+ * Truncate at a sentence/paragraph boundary at or before `maxChars` so the
+ * preamble doesn't end mid-sentence. Falls back to a hard char cut if no
+ * suitable boundary exists in the trailing 30% of the window.
+ *
+ * Boundaries searched (CJK + Latin): paragraph break > full stop > newline.
+ */
+export declare function truncateAtBoundary(text: string, maxChars: number): string;
+//# sourceMappingURL=turnRunner.d.ts.map

package/dist/cli-user/services/turnRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnRunner.d.ts","sourceRoot":"","sources":["../../../src/cli-user/services/turnRunner.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,qBAAqB,CAAC;AAa5E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB;6DACyD;IACzD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,OAAO,CAAC,UAAU,CAAC,CAgHrB;AAUD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,UAAU,CAAC,CA+HrB;AAUD,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAuCnF;AA+BD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkBzE"}