Function trace

ark/attest/cli/trace.ts:206–260

(args: string[])

}

export const trace = async (args: string[]): Promise<void> => {
	const packageDir = resolve(args[0] ?? process.cwd())
	const config = getConfig()

	if (!config.tsconfig) {
		// This message should go to console.error and also be captured if needed,
		// but since it exits, direct console.error is fine.
		console.error(
			`attest trace must be run from a directory with a tsconfig.json file`
		)
		process.exit(1)
	}

	const traceDir = resolve(config.cacheDir, "trace")
	ensureDir(traceDir)

	outputCapture.clear()
	const initialMessages: string[] = []

	initialMessages.push(`⏳ Gathering type trace data for ${packageDir}...`)
	outputCapture.write(initialMessages[0]) // This goes to console and buffer

	const tracingOutput = generateTraceData(traceDir, config.tsconfig, packageDir)

	const traceFile = join(traceDir, "trace.json")

	if (!existsSync(traceFile)) {
		outputCapture.write(
			`❌ No trace data found (expected a file at ${traceFile}). TSC output:\n${tracingOutput}`
		)
		const summaryPath = join(traceDir, "summary.txt")
		writeFile(summaryPath, outputCapture.getBuffer())
		return
	}

	// This message will be followed by the progress bar on the next line
	outputCapture.write(`⏳ Analyzing type trace data for ${packageDir}...`)
	analyzeTypeInstantiations(traceDir) // This function now handles its own progress display

	// Collect all messages for the summary file
	// The progress bar output is not part of outputCapture.getLines()
	const analysisMessages = outputCapture
		.getLines()
		.slice(initialMessages.length + 1) // +1 for the "Analyzing..." message

	const summaryContent = [
		...initialMessages,
		tracingOutput,
		outputCapture.getLines()[initialMessages.length], // The "Analyzing..." message
		...analysisMessages
	].join("\n")

	const summaryPath = join(traceDir, "summary.txt")
	writeFile(summaryPath, summaryContent)
}

const generateTraceData = (
	traceDir: string,