Function buildChaptersFile

packages/cli/src/show.ts:69–94

(
	jsonPath: string,
	options: DiffScopeOptions,
)

}

async function buildChaptersFile(
	jsonPath: string,
	options: DiffScopeOptions,
): Promise<BuiltChaptersFile> {
	const absolute = path.resolve(jsonPath);
	const raw = readFileSync(absolute, "utf8");
	const parsed = JSON.parse(raw) as unknown;

	// A fully-formed chapters file carries its own scope, so the diff isn't
	// recomputed from the working tree or PR. `--pr` still records which PR the
	// run targets (so the UI resolves the right one) — only the number is needed
	// here, not a fetch, since the scope already comes from the file.
	const fullResult = ChaptersFileSchema.safeParse(parsed);
	if (fullResult.success) {
		const prNumber = options.pr === undefined ? null : pullRequestNumberFromRef(options.pr);
		return { chaptersFile: fullResult.data, prNumber };
	}

	const agentResult = AgentOutputSchema.safeParse(parsed);
	if (agentResult.success) {
		const { scope, rawDiff, prNumber } = await resolveDiffScope(options);
		return { chaptersFile: assembleChaptersFile(agentResult.data, scope, rawDiff), prNumber };
	}

	throw fullResult.error;
}

function assembleChaptersFile(
	agentOutput: AgentOutput,