chatCustomizationDiscoveryRenderer.ts

/*---------------------------------------------------------------------------------------------
 *  Copyright (c) Microsoft Corporation. All rights reserved.
 *  Licensed under the MIT License. See License.txt in the project root for license information.
 *--------------------------------------------------------------------------------------------*/

import '../widget/chatContentParts/media/chatInlineAnchorWidget.css';
import * as DOM from '../../../../../base/browser/dom.js';
import { Button } from '../../../../../base/browser/ui/button/button.js';
import { getDefaultHoverDelegate } from '../../../../../base/browser/ui/hover/hoverDelegateFactory.js';
import { Codicon } from '../../../../../base/common/codicons.js';
import { DisposableStore } from '../../../../../base/common/lifecycle.js';
import { ThemeIcon } from '../../../../../base/common/themables.js';
import { URI } from '../../../../../base/common/uri.js';
import { dirname } from '../../../../../base/common/resources.js';
import { ILanguageService } from '../../../../../editor/common/languages/language.js';
import { getIconClasses } from '../../../../../editor/common/services/getIconClasses.js';
import { IModelService } from '../../../../../editor/common/services/model.js';
import { localize } from '../../../../../nls.js';
import { FileKind } from '../../../../../platform/files/common/files.js';
import { IHoverService } from '../../../../../platform/hover/browser/hover.js';
import { ILabelService } from '../../../../../platform/label/common/label.js';
import { IOpenerService } from '../../../../../platform/opener/common/opener.js';
import { IChatDebugCustomizationLogEntry, IChatDebugEventCustomizationSummaryContent, IChatDebugEventFileListContent } from '../../common/chatDebugService.js';
import { InlineAnchorWidget } from '../widget/chatContentParts/chatInlineAnchorWidget.js';
import { setupCollapsibleToggle } from './chatDebugCollapsible.js';

const $ = DOM.$;

/**
 * Map a discovery type string to its corresponding settings key.
 */
function getSettingsKeyForDiscoveryType(discoveryType: string): string | undefined {
	switch (discoveryType) {
		case 'prompt': return 'chat.promptFilesLocations';
		case 'instructions': return 'chat.instructionsFilesLocations';
		case 'agent': return 'chat.agentFilesLocations';
		case 'skill': return 'chat.agentSkillsLocations';
		case 'hook': return 'chat.hookFilesLocations';
		default: return undefined;
	}
}

/**
 * Get a display label for a file's location.
 * Extension files show the extension ID,
 * all other files show the relative (or tildified) parent folder path.
 */
function getFileLocationLabel(file: { uri: URI; storage?: string; extensionId?: string }, labelService: ILabelService, discoveryType?: string): string {
	if (file.extensionId) {
		return file.extensionId;
	}
	// Skills live inside individual skill folders (e.g. .github/skills/foo/SKILL.md),
	// so group by the parent of the skill folder for a more useful label.
	const parentDir = discoveryType === 'skill' ? dirname(dirname(file.uri)) : dirname(file.uri);
	return labelService.getUriLabel(parentDir, { relative: true });
}

/**
 * Create a file link element styled like the chat panel's InlineAnchorWidget.
 */
function createInlineFileLink(uri: URI, displayText: string, fileKind: FileKind, openerService: IOpenerService, modelService: IModelService, languageService: ILanguageService, hoverService: IHoverService, labelService: ILabelService, disposables: DisposableStore, hoverSuffix?: string): HTMLElement {
	const link = $(`a.${InlineAnchorWidget.className}.show-file-icons`);
	link.tabIndex = -1;

	const iconEl = DOM.append(link, $('span.icon'));
	const iconClasses = getIconClasses(modelService, languageService, uri, fileKind);
	iconEl.classList.add(...iconClasses);

	DOM.append(link, $('span.icon-label', undefined, displayText));

	const relativeLabel = labelService.getUriLabel(uri, { relative: true });
	const hoverText = hoverSuffix ? `${relativeLabel} ${hoverSuffix}` : relativeLabel;
	disposables.add(hoverService.setupManagedHover(getDefaultHoverDelegate('element'), link, hoverText));
	disposables.add(DOM.addDisposableListener(link, DOM.EventType.CLICK, (e) => {
		e.preventDefault();
		e.stopPropagation();
		openerService.open(uri, { editorOptions: { preserveFocus: true } });
	}));

	return link;
}

/**
 * Set up roving tabindex with arrow-key navigation on a list of rows.
 * The first row starts with tabIndex 0; the rest get -1.
 * Up/Down arrow keys move focus, Home/End jump to first/last.
 * Enter on a focused row activates the associated action.
 */
function setupFileListNavigation(listEl: HTMLElement, rows: { element: HTMLElement; activate: () => void }[], disposables: DisposableStore): void {
	if (rows.length === 0) {
		return;
	}

	for (let i = 0; i < rows.length; i++) {
		rows[i].element.tabIndex = i === 0 ? 0 : -1;
		rows[i].element.setAttribute('role', 'listitem');
	}

	disposables.add(DOM.addDisposableListener(listEl, DOM.EventType.KEY_DOWN, (e: KeyboardEvent) => {
		const target = e.target as HTMLElement;
		const index = rows.findIndex(r => r.element === target);
		if (index === -1) {
			return;
		}

		let nextIndex: number | undefined;
		switch (e.key) {
			case 'ArrowDown':
				nextIndex = Math.min(index + 1, rows.length - 1);
				break;
			case 'ArrowUp':
				nextIndex = Math.max(index - 1, 0);
				break;
			case 'Home':
				nextIndex = 0;
				break;
			case 'End':
				nextIndex = rows.length - 1;
				break;
			case 'Enter': {
				rows[index].activate();
				e.preventDefault();
				return;
			}
		}

		if (nextIndex !== undefined && nextIndex !== index) {
			e.preventDefault();
			rows[index].element.tabIndex = -1;
			rows[nextIndex].element.tabIndex = 0;
			rows[nextIndex].element.focus();
		}
	}));
}

/**
 * Render a file list resolved content as a rich HTML element.
 */
export function renderCustomizationDiscoveryContent(content: IChatDebugEventFileListContent, openerService: IOpenerService, modelService: IModelService, languageService: ILanguageService, hoverService: IHoverService, labelService: ILabelService, scrollable?: { scanDomNode(): void }): { element: HTMLElement; disposables: DisposableStore } {
	const disposables = new DisposableStore();
	const container = $('div.chat-debug-file-list');
	container.tabIndex = 0;

	const capitalizedType = content.discoveryType.charAt(0).toUpperCase() + content.discoveryType.slice(1);
	DOM.append(container, $('div.chat-debug-file-list-title', undefined, localize('chatDebug.discoveryResults', "{0} Discovery Results", capitalizedType)));
	DOM.append(container, $('div.chat-debug-file-list-summary', undefined, localize('chatDebug.totalFiles', "Total files: {0}", content.files.length)));

	// Loaded files - grouped by source location
	const loaded = content.files.filter(f => f.status === 'loaded');
	if (loaded.length > 0) {
		const section = DOM.append(container, $('div.chat-debug-file-list-section'));
		DOM.append(section, $('div.chat-debug-file-list-section-title', undefined,
			localize('chatDebug.loadedFiles', "Loaded ({0})", loaded.length)));

		// Group files by location label (extension ID or folder path)
		const groups = new Map<string, typeof loaded>();
		for (const file of loaded) {
			const key = getFileLocationLabel(file, labelService, content.discoveryType);
			let group = groups.get(key);
			if (!group) {
				group = [];
				groups.set(key, group);
			}
			group.push(file);
		}

		const listEl = DOM.append(section, $('div.chat-debug-file-list-rows'));
		listEl.setAttribute('role', 'list');
		listEl.setAttribute('aria-label', localize('chatDebug.loadedFilesList', "Loaded files"));

		const rows: { element: HTMLElement; activate: () => void }[] = [];
		for (const [locationLabel, files] of groups) {
			// Group header - show the source location
			const groupHeader = DOM.append(listEl, $('div.chat-debug-file-list-group-header'));
			const firstFile = files[0];
			if (firstFile.extensionId) {
				const link = DOM.append(groupHeader, $('a.chat-debug-file-list-group-label.chat-debug-file-list-badge-link'));
				link.textContent = locationLabel;
				link.tabIndex = -1;
				disposables.add(hoverService.setupManagedHover(getDefaultHoverDelegate('element'), link, localize('chatDebug.openExtension', "Open {0} in Extensions", firstFile.extensionId)));
				disposables.add(DOM.addDisposableListener(link, DOM.EventType.CLICK, (e) => {
					e.preventDefault();
					e.stopPropagation();
					openerService.open(URI.parse(`command:extension.open?${encodeURIComponent(JSON.stringify([firstFile.extensionId]))}`), { allowCommands: true });
				}));
			} else {
				DOM.append(groupHeader, $('span.chat-debug-file-list-group-label', undefined, locationLabel));
			}

			for (const file of files) {
				const row = DOM.append(listEl, $('div.chat-debug-file-list-row'));
				DOM.append(row, $(`span.chat-debug-file-list-icon${ThemeIcon.asCSSSelector(Codicon.check)}`));
				row.appendChild(createInlineFileLink(file.uri, file.name ?? file.uri.path, FileKind.FILE, openerService, modelService, languageService, hoverService, labelService, disposables));
				const relativeLabel = labelService.getUriLabel(file.uri, { relative: true });
				row.setAttribute('aria-label', relativeLabel);
				const uri = file.uri;
				rows.push({ element: row, activate: () => openerService.open(uri, { editorOptions: { preserveFocus: true } }) });
			}
		}
		setupFileListNavigation(listEl, rows, disposables);
	}

	// Skipped files - grouped by skip reason
	const skipped = content.files.filter(f => f.status === 'skipped');
	if (skipped.length > 0) {
		const section = DOM.append(container, $('div.chat-debug-file-list-section'));
		DOM.append(section, $('div.chat-debug-file-list-section-title', undefined,
			localize('chatDebug.skippedFiles', "Skipped ({0})", skipped.length)));

		// Group files by skip reason
		const groups = new Map<string, typeof skipped>();
		for (const file of skipped) {
			const key = file.skipReason ?? localize('chatDebug.unknown', "unknown");
			let group = groups.get(key);
			if (!group) {
				group = [];
				groups.set(key, group);
			}
			group.push(file);
		}

		const listEl = DOM.append(section, $('div.chat-debug-file-list-rows'));
		listEl.setAttribute('role', 'list');
		listEl.setAttribute('aria-label', localize('chatDebug.skippedFilesList', "Skipped files"));

		const rows: { element: HTMLElement; activate: () => void }[] = [];
		for (const [reasonLabel, files] of groups) {
			// Group header - show the skip reason
			const groupHeader = DOM.append(listEl, $('div.chat-debug-file-list-group-header'));
			DOM.append(groupHeader, $('span.chat-debug-file-list-group-label', undefined, reasonLabel));

			for (const file of files) {
				const row = DOM.append(listEl, $('div.chat-debug-file-list-row'));
				DOM.append(row, $(`span.chat-debug-file-list-icon${ThemeIcon.asCSSSelector(Codicon.close)}`));

				// Build per-file detail (error message / duplicate info)
				let detail = '';
				if (file.errorMessage) {
					detail += file.errorMessage;
				}
				if (file.duplicateOf) {
					if (detail) {
						detail += ', ';
					}
					detail += localize('chatDebug.duplicateOf', "duplicate of {0}", file.duplicateOf.path);
				}

				row.appendChild(createInlineFileLink(file.uri, file.name ?? file.uri.path, FileKind.FILE, openerService, modelService, languageService, hoverService, labelService, disposables));
				if (detail) {
					DOM.append(row, $('span.chat-debug-file-list-detail', undefined, ` (${detail})`));
				}
				const relativeLabel = labelService.getUriLabel(file.uri, { relative: true });
				row.setAttribute('aria-label', relativeLabel);
				const uri = file.uri;
				rows.push({ element: row, activate: () => openerService.open(uri, { editorOptions: { preserveFocus: true } }) });
			}
		}
		setupFileListNavigation(listEl, rows, disposables);
	}

	// Source folders (paths attempted) - collapsible, initially collapsed
	if (content.sourceFolders && content.sourceFolders.length > 0) {
		const sectionEl = DOM.append(container, $('div.chat-debug-message-section'));

		const header = DOM.append(sectionEl, $('div.chat-debug-message-section-header'));

		const chevron = DOM.append(header, $('span.chat-debug-message-section-chevron'));
		DOM.append(header, $('span.chat-debug-message-section-title', undefined,
			localize('chatDebug.sourceFolders', "Sources ({0})", content.sourceFolders.length)));

		// Settings gear button on the right side of the header
		const settingsKey = getSettingsKeyForDiscoveryType(content.discoveryType);
		if (settingsKey) {
			const gearBtn = disposables.add(new Button(header, {
				title: localize('chatDebug.openSettingsTooltip', "Configure locations"),
				ariaLabel: localize('chatDebug.configureLocations', "Configure locations"),
				hoverDelegate: getDefaultHoverDelegate('mouse'),
			}));
			gearBtn.icon = Codicon.settingsGear;
			gearBtn.element.classList.add('chat-debug-settings-gear');
			disposables.add(DOM.addDisposableListener(gearBtn.element, DOM.EventType.MOUSE_ENTER, () => {
				header.classList.add('chat-debug-settings-gear-header-passthrough');
			}));
			disposables.add(DOM.addDisposableListener(gearBtn.element, DOM.EventType.MOUSE_LEAVE, () => {
				header.classList.remove('chat-debug-settings-gear-header-passthrough');
			}));
			disposables.add(gearBtn.onDidClick((e) => {
				if (e) {
					DOM.EventHelper.stop(e, true);
				}
				openerService.open(URI.parse(`command:workbench.action.openSettings?${encodeURIComponent(JSON.stringify([`@id:${settingsKey}`]))}`), { allowCommands: true });
			}));
		}

		const contentEl = DOM.append(sectionEl, $('div.chat-debug-source-folder-content'));
		contentEl.tabIndex = 0;
		contentEl.setAttribute('role', 'region');
		contentEl.setAttribute('aria-label', localize('chatDebug.sourceFoldersContent', "Source folders"));

		const capitalizedType = content.discoveryType.charAt(0).toUpperCase() + content.discoveryType.slice(1);
		const sourcesCaption = capitalizedType.endsWith('s') ? capitalizedType : capitalizedType + 's';
		DOM.append(contentEl, $('div.chat-debug-source-folder-note', undefined,
			localize('chatDebug.sourcesNote', "{0} were discovered by checking the following sources in order:", sourcesCaption)));
		for (let i = 0; i < content.sourceFolders.length; i++) {
			const folder = content.sourceFolders[i];
			const row = DOM.append(contentEl, $('div.chat-debug-source-folder-row'));
			DOM.append(row, $('span.chat-debug-source-folder-index', undefined, `${i + 1}.`));
			DOM.append(row, $('span.chat-debug-source-folder-label', undefined, folder.uri.path));
		}

		setupCollapsibleToggle(chevron, header, contentEl, disposables, /* initiallyCollapsed */ true, scrollable);
	}

	return { element: container, disposables };
}

/**
 * Convert a file list content to plain text for clipboard / editor output.
 */
export function fileListToPlainText(content: IChatDebugEventFileListContent): string {
	const lines: string[] = [];
	const capitalizedType = content.discoveryType.charAt(0).toUpperCase() + content.discoveryType.slice(1);
	lines.push(localize('chatDebug.plainText.discoveryResults', "{0} Discovery Results", capitalizedType));
	lines.push(localize('chatDebug.plainText.totalFiles', "Total files: {0}", content.files.length));
	lines.push('');

	const loaded = content.files.filter(f => f.status === 'loaded');
	const skipped = content.files.filter(f => f.status === 'skipped');

	if (loaded.length > 0) {
		lines.push(localize('chatDebug.plainText.loaded', "Loaded ({0})", loaded.length));
		// Group by location
		const groups = new Map<string, typeof loaded>();
		for (const f of loaded) {
			const parentDir = content.discoveryType === 'skill' ? dirname(dirname(f.uri)) : dirname(f.uri);
			const key = f.extensionId ?? parentDir.path;
			let group = groups.get(key);
			if (!group) {
				group = [];
				groups.set(key, group);
			}
			group.push(f);
		}
		for (const [locationLabel, files] of groups) {
			lines.push(`  ${locationLabel}`);
			for (const f of files) {
				const label = f.name ?? f.uri.path;
				lines.push(`    \u2713 ${label}`);
			}
		}
		lines.push('');
	}

	if (skipped.length > 0) {
		lines.push(localize('chatDebug.plainText.skipped', "Skipped ({0})", skipped.length));
		// Group by skip reason
		const skippedGroups = new Map<string, typeof skipped>();
		for (const f of skipped) {
			const key = f.skipReason ?? localize('chatDebug.plainText.unknown', "unknown");
			let group = skippedGroups.get(key);
			if (!group) {
				group = [];
				skippedGroups.set(key, group);
			}
			group.push(f);
		}
		for (const [reasonLabel, files] of skippedGroups) {
			lines.push(`  ${reasonLabel}`);
			for (const f of files) {
				const label = f.name ?? f.uri.path;
				let detail = `    \u2717 ${label}`;
				if (f.errorMessage || f.duplicateOf) {
					const parts: string[] = [];
					if (f.errorMessage) {
						parts.push(f.errorMessage);
					}
					if (f.duplicateOf) {
						parts.push(localize('chatDebug.plainText.duplicateOf', "duplicate of {0}", f.duplicateOf.path));
					}
					detail += ` (${parts.join(', ')})`;
				}
				lines.push(detail);
			}
		}
	}

	if (content.sourceFolders && content.sourceFolders.length > 0) {
		lines.push('');
		lines.push(localize('chatDebug.plainText.sourceFolders', "Sources ({0})", content.sourceFolders.length));
		for (const folder of content.sourceFolders) {
			lines.push(`  ${folder.uri.path}`);
		}
	}

	return lines.join('\n');
}

/**
 * Get a human-readable section title for a resolution log category.
 */
function getCategorySectionTitle(category: IChatDebugCustomizationLogEntry['category'], count: number): string {
	switch (category) {
		case 'applying': return localize('chatDebug.customization.instructions', "Instructions ({0})", count);
		case 'referenced': return localize('chatDebug.customization.referenced', "Referenced ({0})", count);
		case 'skill': return localize('chatDebug.customization.skill', "Skills ({0})", count);
		case 'custom-agent': return localize('chatDebug.customization.customAgent', "Agents ({0})", count);
		case 'hook': return localize('chatDebug.customization.hook', "Hooks ({0})", count);
		case 'skipped': return localize('chatDebug.customization.skipped', "Skipped ({0})", count);
	}
}

/**
 * Render a customization summary showing per-file resolution logs
 * from the instructions context computer.
 */
export function renderCustomizationSummaryContent(content: IChatDebugEventCustomizationSummaryContent, openerService: IOpenerService, modelService: IModelService, languageService: ILanguageService, hoverService: IHoverService, labelService: ILabelService, scrollable?: { scanDomNode(): void }): { element: HTMLElement; disposables: DisposableStore } {
	const disposables = new DisposableStore();
	const container = $('div.chat-debug-customization-summary');
	container.tabIndex = 0;

	// Title with counts and duration
	const mainSection = DOM.append(container, $('div.chat-debug-file-list'));
	DOM.append(mainSection, $('div.chat-debug-file-list-title', undefined,
		localize('chatDebug.customizationTitle', "Customization Resolution Results")));
	DOM.append(mainSection, $('div.chat-debug-file-list-summary', undefined,
		localize('chatDebug.customizationSummary', "{0} instructions, {1} skills, {2} agents, {3} hooks, {4} skipped in {5}ms",
			content.counts.instructions, content.counts.skills, content.counts.agents, content.counts.hooks, content.counts.skipped, content.durationInMillis.toFixed(1))));

	// Group entries by display section: instructions (applying+referenced), skills, agents, skipped
	// Instructions section merges applying + referenced
	const instructionEntries = content.resolutionLogs.filter(e => e.category === 'applying' || e.category === 'referenced');
	const skillEntries = content.resolutionLogs.filter(e => e.category === 'skill');
	const agentEntries = content.resolutionLogs.filter(e => e.category === 'custom-agent');
	const hookEntries = content.resolutionLogs.filter(e => e.category === 'hook');
	const skippedEntries = content.resolutionLogs.filter(e => e.category === 'skipped');

	const sections: { title: string; icon: ThemeIcon; entries: readonly IChatDebugCustomizationLogEntry[] }[] = [
		{ title: getCategorySectionTitle('applying', instructionEntries.length), icon: Codicon.book, entries: instructionEntries },
		{ title: getCategorySectionTitle('skill', skillEntries.length), icon: Codicon.lightbulb, entries: skillEntries },
		{ title: getCategorySectionTitle('custom-agent', agentEntries.length), icon: Codicon.agent, entries: agentEntries },
		{ title: getCategorySectionTitle('hook', hookEntries.length), icon: Codicon.zap, entries: hookEntries },
		{ title: getCategorySectionTitle('skipped', skippedEntries.length), icon: Codicon.close, entries: skippedEntries },
	];

	for (const { title, icon, entries } of sections) {
		if (entries.length === 0) {
			continue;
		}

		const section = DOM.append(mainSection, $('div.chat-debug-file-list-section'));
		DOM.append(section, $('div.chat-debug-file-list-section-title', undefined, title));

		const listEl = DOM.append(section, $('div.chat-debug-file-list-rows'));
		listEl.setAttribute('role', 'list');
		listEl.setAttribute('aria-label', title);

		const rows: { element: HTMLElement; activate: () => void }[] = [];

		// For hooks, group entries by lifecycle event (stored in reason).
		const isHookSection = entries.length > 0 && entries[0].category === 'hook';
		if (isHookSection) {
			// Collect entries by hook type, preserving insertion order.
			const groupedByType = new Map<string, IChatDebugCustomizationLogEntry[]>();
			for (const entry of entries) {
				const hookType = entry.reason ?? '';
				let group = groupedByType.get(hookType);
				if (!group) {
					group = [];
					groupedByType.set(hookType, group);
				}
				group.push(entry);
			}

			for (const [hookType, groupEntries] of groupedByType) {
				if (hookType) {
					DOM.append(listEl, $('div.chat-debug-file-list-group-header', undefined, hookType));
				}
				for (const entry of groupEntries) {
					const row = DOM.append(listEl, $('div.chat-debug-file-list-row'));
					DOM.append(row, $(`span.chat-debug-file-list-icon${ThemeIcon.asCSSSelector(icon)}`));

					if (entry.uri) {
						row.appendChild(createInlineFileLink(
							entry.uri, entry.name, FileKind.FILE,
							openerService, modelService, languageService, hoverService, labelService, disposables,
						));
						const uri = entry.uri;
						rows.push({ element: row, activate: () => openerService.open(uri, { editorOptions: { preserveFocus: true } }) });
					} else {
						DOM.append(row, $('span', undefined, entry.name));
					}
					row.setAttribute('aria-label', entry.reason ? `${entry.name} — ${entry.reason}` : entry.name);
				}
			}
		} else {
			for (const entry of entries) {
				const row = DOM.append(listEl, $('div.chat-debug-file-list-row'));
				DOM.append(row, $(`span.chat-debug-file-list-icon${ThemeIcon.asCSSSelector(icon)}`));

				// Hide the reason for skills (e.g. "local") and custom-agents — it's noise in the UI.
				const showReason = entry.category !== 'skill' && entry.category !== 'custom-agent';

				if (entry.uri) {
					row.appendChild(createInlineFileLink(
						entry.uri, entry.name, FileKind.FILE,
						openerService, modelService, languageService, hoverService, labelService, disposables,
						showReason ? entry.reason : undefined
					));
					const uri = entry.uri;
					rows.push({ element: row, activate: () => openerService.open(uri, { editorOptions: { preserveFocus: true } }) });
				} else {
					DOM.append(row, $('span', undefined, entry.name));
				}

				if (showReason && entry.reason) {
					DOM.append(row, $('span.chat-debug-file-list-detail', undefined, ` — ${entry.reason}`));
				}
				row.setAttribute('aria-label', entry.reason ? `${entry.name} — ${entry.reason}` : entry.name);
			}
		}
		setupFileListNavigation(listEl, rows, disposables);
	}

	if (content.resolutionLogs.length === 0) {
		DOM.append(mainSection, $('div.chat-debug-file-list-summary', undefined,
			localize('chatDebug.noResolutionLogs', "No resolution logs")));
	}

	return { element: container, disposables };
}

/**
 * Serialize a customization summary to plain text for clipboard / full-screen.
 */
export function customizationSummaryToPlainText(content: IChatDebugEventCustomizationSummaryContent): string {
	const lines: string[] = [];

	lines.push(localize('chatDebug.plainText.customizationTitle', "Customization Resolution Results"));
	lines.push(localize('chatDebug.plainText.customizationSummary', "{0} instructions, {1} skills, {2} agents, {3} hooks, {4} skipped in {5}ms",
		content.counts.instructions, content.counts.skills, content.counts.agents, content.counts.hooks, content.counts.skipped, content.durationInMillis.toFixed(1)));
	lines.push('');
	for (const entry of content.resolutionLogs) {
		const detail = entry.reason ? `${entry.name} — ${entry.reason}` : entry.name;
		lines.push(`  [${entry.category}] ${detail}`);
	}

	return lines.join('\n');
}