singularity-forge/src/web/history-service.ts

import { execFile } from "node:child_process";
import { existsSync } from "node:fs";
import { join } from "node:path";
import { pathToFileURL } from "node:url";
import type { HistoryData } from "../../web/lib/remaining-command-types.ts";
import { resolveBridgeRuntimeConfig } from "./bridge-service.ts";
import {
	buildSubprocessPrefixArgs,
	resolveSubprocessModule,
} from "./ts-subprocess-flags.ts";

const HISTORY_MAX_BUFFER = 2 * 1024 * 1024;
const HISTORY_MODULE_ENV = "SF_HISTORY_MODULE";

function resolveTsLoaderPath(packageRoot: string): string {
	return join(
		packageRoot,
		"src",
		"resources",
		"extensions",
		"sf",
		"tests",
		"resolve-ts.mjs",
	);
}

/**
 * Loads history/metrics data via a child process.
 * Reads the metrics ledger from disk and computes aggregation views
 * (totals, byPhase, bySlice, byModel) for browser consumption.
 */
export async function collectHistoryData(
	projectCwdOverride?: string,
): Promise<HistoryData> {
	const config = resolveBridgeRuntimeConfig(undefined, projectCwdOverride);
	const { packageRoot, projectCwd } = config;

	const resolveTsLoader = resolveTsLoaderPath(packageRoot);
	const moduleResolution = resolveSubprocessModule(
		packageRoot,
		"resources/extensions/sf/metrics.ts",
	);
	const historyModulePath = moduleResolution.modulePath;

	if (
		!moduleResolution.useCompiledJs &&
		(!existsSync(resolveTsLoader) || !existsSync(historyModulePath))
	) {
		throw new Error(
			`history data provider not found; checked=${resolveTsLoader},${historyModulePath}`,
		);
	}
	if (moduleResolution.useCompiledJs && !existsSync(historyModulePath)) {
		throw new Error(
			`history data provider not found; checked=${historyModulePath}`,
		);
	}

	const script = [
		'const { pathToFileURL } = await import("node:url");',
		`const mod = await import(pathToFileURL(process.env.${HISTORY_MODULE_ENV}).href);`,
		`const ledger = mod.loadLedgerFromDisk(process.env.SF_HISTORY_BASE);`,
		"const units = ledger ? ledger.units : [];",
		"const totals = mod.getProjectTotals(units);",
		"const byPhase = mod.aggregateByPhase(units);",
		"const bySlice = mod.aggregateBySlice(units);",
		"const byModel = mod.aggregateByModel(units);",
		"process.stdout.write(JSON.stringify({ units, totals, byPhase, bySlice, byModel }));",
	].join(" ");

	const prefixArgs = buildSubprocessPrefixArgs(
		packageRoot,
		moduleResolution,
		pathToFileURL(resolveTsLoader).href,
	);

	return await new Promise<HistoryData>((resolveResult, reject) => {
		execFile(
			process.execPath,
			[...prefixArgs, "--eval", script],
			{
				cwd: packageRoot,
				env: {
					...process.env,
					[HISTORY_MODULE_ENV]: historyModulePath,
					SF_HISTORY_BASE: projectCwd,
				},
				maxBuffer: HISTORY_MAX_BUFFER,
				windowsHide: true,
			},
			(error, stdout, stderr) => {
				if (error) {
					reject(
						new Error(
							`history data subprocess failed: ${stderr || error.message}`,
						),
					);
					return;
				}

				try {
					resolveResult(JSON.parse(stdout) as HistoryData);
				} catch (parseError) {
					reject(
						new Error(
							`history data subprocess returned invalid JSON: ${parseError instanceof Error ? parseError.message : String(parseError)}`,
						),
					);
				}
			},
		);
	});
}