Function assembleChaptersFile

packages/cli/src/show.ts:96–120

(
	agentOutput: AgentOutput,
	scope: Scope,
	rawDiff: string,
)

}

function assembleChaptersFile(
	agentOutput: AgentOutput,
	scope: Scope,
	rawDiff: string,
): ChaptersFile {
	const allFiles = parseGitDiff(rawDiff);
	const stageIgnore = loadStageIgnore(readRepoRoot());
	const { files: filteredFiles, excludedByPath } = filterFilesForLlm(allFiles, stageIgnore);

	validateHunkCoverage(filteredFiles, agentOutput.chapters);
	const sanitized = sanitizeLineRefs(agentOutput.chapters, filteredFiles);

	const chapters = [...sanitized];
	const otherChanges = buildOtherChangesChapter(allFiles, excludedByPath);
	if (otherChanges) {
		chapters.push({ ...otherChanges, order: chapters.length + 1 });
	}

	return {
		scope,
		chapters,
		prologue: agentOutput.prologue,
		generatedAt: new Date().toISOString(),
	};
}

function validateHunkCoverage(
	filteredFiles: { path: string; hunks: { oldStart: number }[] }[],