@usepipr/runtime 0.3.6 → 0.3.8

package/dist/{commands-Btw_Ummi.mjs → commands-RY37Y0rG.mjs}

@@ -272,7 +272,10 @@ const piprConfigSchema = z.strictObject({
 	providers: z.array(providerConfigSchema).min(1),
 	publication: z.strictObject({
 		maxInlineComments: z.number().int().min(0).max(50).optional(),
-		autoResolve: autoResolveConfigSchema
+		autoResolve: autoResolveConfigSchema,
+		showHeader: z.boolean().default(true),
+		showFooter: z.boolean().default(true),
+		showStats: z.boolean().default(true)
 	}),
 	limits: z.strictObject({
 		timeoutSeconds: z.number().int().positive().max(3600).optional(),
@@ -526,7 +529,7 @@ function compareStableSemver(left, right) {
 }
 //#endregion
 //#region src/shared/version.ts
-const runtimeVersion = "0.3.6";
+const runtimeVersion = "0.3.8";
 //#endregion
 //#region src/config/version-compat.ts
 async function resolveConfigVersionCompatibility(options) {
@@ -776,7 +779,10 @@ function planToRuntimeSettings(plan, options) {
 			providers,
 			publication: {
 				maxInlineComments: plan.publication.maxInlineComments,
-				autoResolve: normalizeAutoResolveConfig(plan.publication.autoResolve, defaultProvider.id)
+				autoResolve: normalizeAutoResolveConfig(plan.publication.autoResolve, defaultProvider.id),
+				showHeader: plan.publication.showHeader ?? true,
+				showFooter: plan.publication.showFooter ?? true,
+				showStats: plan.publication.showStats ?? true
 			},
 			limits: plan.limits
 		},
@@ -3544,8 +3550,8 @@ function isOfficialInitRecipeId(recipe) {
 //#endregion
 //#region src/config/init.ts
 const supportedOfficialInitAdapters = ["github"];
-const defaultWorkflowActionRef = "somus/pipr@v0.3.6";
-const defaultSdkVersion = "0.3.6";
+const defaultWorkflowActionRef = "somus/pipr@v0.3.8";
+const defaultSdkVersion = "0.3.8";
 function resolveOfficialInitAdapters(adapters) {
 	if (adapters === void 0) return [...supportedOfficialInitAdapters];
 	if (adapters.length === 0) return [];
@@ -4746,6 +4752,24 @@ const ignoredWorkspacePaths = /* @__PURE__ */ new Set([
 	".fallow",
 	"coverage"
 ]);
+const eventRecordSchema = z.record(z.string(), z.unknown());
+const tokenCountSchema = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+const assistantMessageEventSchema = z.looseObject({
+	type: z.literal("message_end"),
+	message: z.looseObject({
+		role: z.literal("assistant"),
+		model: z.string().min(1).optional(),
+		responseModel: z.string().min(1).optional()
+	})
+});
+const assistantUsageMessageSchema = z.looseObject({
+	role: z.literal("assistant"),
+	usage: z.looseObject({
+		input: tokenCountSchema,
+		output: tokenCountSchema,
+		cost: z.looseObject({ total: z.number().nonnegative() })
+	})
+});
 async function runPi(options) {
 	const started = Date.now();
 	const sandbox = await createPiRunSandbox(options.workspace);
@@ -4768,10 +4792,13 @@ async function runPi(options) {
 			started,
 			timeoutSeconds: options.timeoutSeconds
 		});
-		return result.exitCode === 0 ? {
+		const events = parsePiJsonEvents(result.stdout);
+		return {
 			...result,
-			stdout: extractAssistantTextFromJsonEvents(result.stdout) ?? result.stdout
-		} : result;
+			...events?.models.length ? { models: events.models } : {},
+			...events?.usage ? { usage: events.usage } : {},
+			stdout: result.exitCode === 0 ? events?.assistantText ?? result.stdout : result.stdout
+		};
 	} finally {
 		await preparedTools?.custom?.close();
 		await chmodRecursive(sandbox.root, 493);
@@ -4893,19 +4920,69 @@ async function chmodRecursive(target, mode) {
 	const entries = await readdir(target, { withFileTypes: true });
 	for (const entry of entries) await chmodRecursive(path.join(target, entry.name), mode);
 }
-function extractAssistantTextFromJsonEvents(stdout) {
+function parsePiJsonEvents(stdout) {
 	const events = [];
 	for (const line of stdout.split(/\r?\n/).map((item) => item.trim()).filter(Boolean)) try {
 		const value = JSON.parse(line);
-		if (!isPlainObject(value)) return;
-		events.push(value);
+		const parsed = eventRecordSchema.safeParse(value);
+		if (!parsed.success) return;
+		events.push(parsed.data);
 	} catch {
 		return;
 	}
 	if (!events.some((event) => typeof event.type === "string")) return;
-	let text;
-	for (const event of events) text = assistantTextFromEvent(event) ?? text;
-	return text;
+	let assistantText;
+	for (const event of events) assistantText = assistantTextFromEvent(event) ?? assistantText;
+	const assistantMessages = assistantMessagesFromEvents(events);
+	const models = assistantModels(assistantMessages);
+	const usage = assistantUsage(assistantMessages);
+	return {
+		...assistantText !== void 0 ? { assistantText } : {},
+		models,
+		...usage ? { usage } : {}
+	};
+}
+function assistantMessagesFromEvents(events) {
+	return events.flatMap((event) => {
+		const parsed = assistantMessageEventSchema.safeParse(event);
+		return parsed.success ? [parsed.data.message] : [];
+	});
+}
+function assistantModels(messages) {
+	const models = [];
+	for (const message of messages) {
+		const model = message.responseModel ?? message.model;
+		if (model && !models.includes(model)) models.push(model);
+	}
+	return models;
+}
+function assistantUsage(messages) {
+	const usageMessages = messages.flatMap((message) => {
+		const parsed = assistantUsageMessageSchema.safeParse(message);
+		return parsed.success ? [parsed.data] : [];
+	});
+	if (usageMessages.length === 0) return;
+	let inputTokens = 0;
+	let outputTokens = 0;
+	let costUsd = 0;
+	let partial = usageMessages.length !== messages.length;
+	for (const message of usageMessages) {
+		const nextInputTokens = inputTokens + message.usage.input;
+		if (Number.isSafeInteger(nextInputTokens)) inputTokens = nextInputTokens;
+		else partial = true;
+		const nextOutputTokens = outputTokens + message.usage.output;
+		if (Number.isSafeInteger(nextOutputTokens)) outputTokens = nextOutputTokens;
+		else partial = true;
+		const nextCostUsd = costUsd + message.usage.cost.total;
+		if (Number.isFinite(nextCostUsd)) costUsd = nextCostUsd;
+		else partial = true;
+	}
+	return {
+		status: partial ? "partial" : "complete",
+		inputTokens,
+		outputTokens,
+		costUsd
+	};
 }
 function assistantTextFromEvent(event) {
 	if (event.type === "message_end" || event.type === "turn_end") return assistantMessageText(event.message);
@@ -5521,16 +5598,27 @@ async function runPiForPrompt(options, provider, prompt) {
 	const customTools = customToolsForRun(options);
 	const timeoutSeconds = promptTimeoutSeconds(options);
 	logPiStart(options, provider, prompt, builtinTools, runtimeTools, customTools);
-	const result = await (options.runtime.piRunner ?? runPi)({
-		workspace: options.runtime.workspace,
-		provider,
-		prompt,
-		env: options.runtime.env,
-		piExecutable: options.runtime.piExecutable,
-		builtinTools,
-		runtimeTools,
-		customTools,
-		timeoutSeconds
+	let result;
+	try {
+		result = await (options.runtime.piRunner ?? runPi)({
+			workspace: options.runtime.workspace,
+			provider,
+			prompt,
+			env: options.runtime.env,
+			piExecutable: options.runtime.piExecutable,
+			builtinTools,
+			runtimeTools,
+			customTools,
+			timeoutSeconds
+		});
+	} catch (error) {
+		options.runtime.piRunSink?.({ models: [provider.model] });
+		throw error;
+	}
+	const reportedModels = result.models?.map((model) => model.trim()).filter(Boolean);
+	options.runtime.piRunSink?.({
+		models: reportedModels?.length ? reportedModels : [provider.model],
+		...result.usage ? { usage: result.usage } : {}
 	});
 	logPiResult(options, provider, result, timeoutSeconds);
 	assertSuccessfulPiResult(result, options.runtime.log);
@@ -5674,8 +5762,63 @@ const mainCommentTitles = /* @__PURE__ */ new Set([
 	"# Pipr Review",
 	mainCommentTitle
 ]);
+const mainCommentHeaderHiddenMarker = "<!-- pipr:header:hidden -->";
+const mainCommentFooterHiddenMarker = "<!-- pipr:footer:hidden -->";
+const reviewStatsStartMarker = "<!-- pipr:stats:start -->";
+const reviewStatsEndMarker = "<!-- pipr:stats:end -->";
+const reviewStatsHiddenMarker = "<!-- pipr:stats:hidden -->";
 const escapedRepositoryUrl = piprRepositoryUrl.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 const mainCommentAttributionPattern = new RegExp(`^<sub>Review generated by \\[Pipr\\]\\(${escapedRepositoryUrl}\\) for commit \`[^\`]+\`\\.(?: Config SDK \\d+\\.\\d+\\.\\d+ is behind (?:Pipr \\d+\\.\\d+\\.\\d+|\\[Pipr \\d+\\.\\d+\\.\\d+\\]\\(${escapedRepositoryUrl}/releases/tag/v\\d+\\.\\d+\\.\\d+\\))\\.)?</sub>$`);
+const maxReviewStatsModelLength = 200;
+const credentialLikeModelPattern = /(?:(?:AKIA|ASIA)[0-9A-Z]{16}|AIza[0-9A-Za-z_-]{35}|(?:sk|rk)_live_[A-Za-z0-9]{16,}|sk-(?:proj-)?[A-Za-z0-9_-]{16,}|gh[pousr]_[A-Za-z0-9]{20,}|github_pat_[A-Za-z0-9_]{16,}|glpat-[A-Za-z0-9_-]{16,}|npm_[A-Za-z0-9]{16,}|xox[baprs]-[A-Za-z0-9-]{16,})/i;
+const highEntropyModelSegmentPattern = /[A-Za-z0-9]{24,}/;
+const reviewStatsModelSchema = z.string().min(1).max(maxReviewStatsModelLength).transform((model) => sanitizeReviewStatsModel(model) ?? "[invalid model]");
+const reviewStatsSchema = z.strictObject({
+	models: z.array(reviewStatsModelSchema).min(1).max(20),
+	agentRuns: z.number().int().positive(),
+	durationMs: z.number().int().nonnegative(),
+	inputTokens: z.number().int().nonnegative(),
+	outputTokens: z.number().int().nonnegative(),
+	costUsd: z.number().nonnegative(),
+	usageStatus: z.enum([
+		"complete",
+		"partial",
+		"unavailable"
+	])
+});
+function accumulateReviewStats(prior, current) {
+	if (!prior) return current;
+	if (!current) return prior;
+	const inputTokens = addUsageTotal(prior.inputTokens, current.inputTokens, Number.isSafeInteger);
+	const outputTokens = addUsageTotal(prior.outputTokens, current.outputTokens, Number.isSafeInteger);
+	const costUsd = addUsageTotal(prior.costUsd, current.costUsd, Number.isFinite);
+	const usageStatus = inputTokens.complete && outputTokens.complete && costUsd.complete && prior.usageStatus === current.usageStatus ? prior.usageStatus : "partial";
+	return {
+		models: [.../* @__PURE__ */ new Set([...prior.models, ...current.models])].slice(0, 20),
+		agentRuns: Math.min(Number.MAX_SAFE_INTEGER, prior.agentRuns + current.agentRuns),
+		durationMs: Math.min(Number.MAX_SAFE_INTEGER, prior.durationMs + current.durationMs),
+		inputTokens: inputTokens.total,
+		outputTokens: outputTokens.total,
+		costUsd: costUsd.total,
+		usageStatus
+	};
+}
+function addUsageTotal(prior, current, isValid) {
+	const total = prior + current;
+	return isValid(total) && total >= 0 ? {
+		total,
+		complete: true
+	} : {
+		total: prior,
+		complete: false
+	};
+}
+function sanitizeReviewStatsModel(model) {
+	const normalized = model.replace(/\s+/g, " ").trim();
+	if (credentialLikeModelPattern.test(normalized) || highEntropyModelSegmentPattern.test(normalized)) return "[redacted credential]";
+	const sanitized = redactPotentialSecrets(normalized);
+	return sanitized ? sanitized.slice(0, maxReviewStatsModelLength) : void 0;
+}
 //#endregion
 //#region src/review/prior-state.ts
 const mainCommentMarker = "pipr:main-comment";
@@ -5701,7 +5844,8 @@ const priorReviewStateSchema = z.strictObject({
 	version: z.literal(1),
 	reviewedHeadSha: z.string().min(1),
 	selectedTasks: z.array(z.string().min(1)),
-	findings: z.array(priorFindingRecordSchema)
+	findings: z.array(priorFindingRecordSchema),
+	stats: reviewStatsSchema.optional()
 });
 function buildPriorReviewState(options) {
 	const scopedPriorState = priorReviewStateForSelectedTasks(options.priorState, options.selectedTasks);
@@ -5709,6 +5853,7 @@ function buildPriorReviewState(options) {
 	const nextFindings = /* @__PURE__ */ new Map();
 	const currentFindingIds = /* @__PURE__ */ new Set();
 	const usedPriorIds = /* @__PURE__ */ new Set();
+	const stats = accumulateReviewStats(scopedPriorState?.stats, options.stats);
 	for (const finding of options.findings) {
 		const id = selectFindingId({
 			finding,
@@ -5741,7 +5886,8 @@ function buildPriorReviewState(options) {
 		version: 1,
 		reviewedHeadSha: options.reviewedHeadSha,
 		selectedTasks: options.selectedTasks,
-		findings: cappedFindings([...nextFindings.values()], currentFindingIds)
+		findings: cappedFindings([...nextFindings.values()], currentFindingIds),
+		...stats ? { stats } : {}
 	};
 }
 function resolvePriorFindings(state, findingIds) {
@@ -5990,7 +6136,8 @@ const publicationMetadataSchema = z.strictObject({
 	failedTasks: z.array(z.string().min(1)),
 	validFindings: z.number().int().min(0),
 	droppedFindings: z.number().int().min(0),
-	cappedInlineFindings: z.number().int().min(0)
+	cappedInlineFindings: z.number().int().min(0),
+	stats: reviewStatsSchema.optional()
 });
 const publicationPlanSchema = z.strictObject({
 	mainComment: z.string().min(1),
@@ -6017,7 +6164,10 @@ function buildPublicationPlan(options) {
 			event: options.event,
 			reviewState,
 			main: options.main,
-			metadata
+			metadata,
+			showHeader: options.showHeader ?? true,
+			showFooter: options.showFooter ?? true,
+			showStats: options.showStats ?? true
 		}),
 		mainMarker: mainCommentMarker,
 		changeNumber: options.event.change.number,
@@ -6101,15 +6251,59 @@ function renderMainComment(options) {
 			reviewState: options.reviewState
 		}),
 		"",
-		mainCommentTitle,
-		"",
+		...!options.showHeader ? [mainCommentHeaderHiddenMarker, ""] : [],
+		...options.showHeader ? [mainCommentTitle, ""] : [],
 		...options.metadata.validFindings > 0 ? [`**Findings:** ${options.metadata.validFindings}`, ""] : [],
 		redactPotentialSecrets(options.main),
 		"",
-		renderMainCommentAttribution(options.metadata),
-		""
+		...!options.showStats || !options.metadata.stats ? [reviewStatsHiddenMarker, ""] : [],
+		...options.showStats && options.metadata.stats ? [renderReviewStats(options.metadata.stats), ""] : [],
+		...options.showFooter ? [renderMainCommentAttribution(options.metadata), ""] : [mainCommentFooterHiddenMarker, ""]
 	].join("\n");
 }
+function renderReviewStats(stats) {
+	const usageSuffix = stats.usageStatus === "partial" ? " (reported)" : "";
+	const usageUnavailable = stats.usageStatus === "unavailable";
+	return [
+		reviewStatsStartMarker,
+		"<details>",
+		"<summary>Review stats</summary>",
+		"",
+		"| Metric | Total |",
+		"| --- | ---: |",
+		`| Models | ${stats.models.map(formatModel).join(", ")} |`,
+		`| Agent runs | ${stats.agentRuns} |`,
+		`| Elapsed | ${formatDuration(stats.durationMs)} |`,
+		`| Input tokens | ${usageUnavailable ? "Unavailable" : `${formatInteger(stats.inputTokens)}${usageSuffix}`} |`,
+		`| Output tokens | ${usageUnavailable ? "Unavailable" : `${formatInteger(stats.outputTokens)}${usageSuffix}`} |`,
+		`| Cost (USD) | ${usageUnavailable ? "Unavailable" : `${formatCost(stats.costUsd)}${usageSuffix}`} |`,
+		"",
+		"</details>",
+		reviewStatsEndMarker
+	].join("\n");
+}
+function formatModel(model) {
+	return `<code>${model.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/\|/g, "&#124;")}</code>`;
+}
+function formatInteger(value) {
+	return value.toLocaleString("en-US");
+}
+function formatDuration(durationMs) {
+	if (durationMs < 1e3) return `${durationMs}ms`;
+	const totalSeconds = durationMs / 1e3;
+	if (totalSeconds < 60) return `${formatTenths(totalSeconds)}s`;
+	const minutes = Math.floor(totalSeconds / 60);
+	return `${minutes}m ${formatTenths(totalSeconds - minutes * 60)}s`;
+}
+function formatTenths(value) {
+	return value.toFixed(1).replace(/\.0$/, "");
+}
+function formatCost(costUsd) {
+	if (costUsd === 0) return "$0.00";
+	if (costUsd < 1e-4) return `$${costUsd.toFixed(6)}`;
+	if (costUsd < .01) return `$${costUsd.toFixed(4)}`;
+	return `$${costUsd.toFixed(2)}`;
+}
 function renderMainCommentAttribution(metadata) {
 	const configNotice = configVersionNotice(metadata);
 	return `<sub>Review generated by [Pipr](${piprRepositoryUrl}) for commit \`${metadata.reviewedHeadSha.slice(0, 7)}\`.${configNotice}</sub>`;
@@ -6155,7 +6349,8 @@ function buildCommentPublishingPlan(options) {
 		priorState: options.priorReviewState,
 		findings: publishableInlineFindings.map((item) => item.finding),
 		reviewedHeadSha: options.event.change.head.sha,
-		selectedTasks: options.metadata.selectedTasks
+		selectedTasks: options.metadata.selectedTasks,
+		stats: options.metadata.stats
 	});
 	const inlineCommentDrafts = prepareInlinePublicationItemsForPublishableFindings({
 		publishableFindings: publishableInlineFindings,
@@ -6167,7 +6362,13 @@ function buildCommentPublishingPlan(options) {
 		main: options.main,
 		inlineItems: inlineCommentDrafts,
 		maxInlineComments: options.maxInlineComments,
-		metadata: options.metadata,
+		showHeader: options.showHeader,
+		showFooter: options.showFooter,
+		showStats: options.showStats,
+		metadata: {
+			...options.metadata,
+			...reviewState.stats ? { stats: reviewState.stats } : {}
+		},
 		reviewState,
 		threadActions: options.threadActions
 	});
@@ -6266,7 +6467,8 @@ async function runInternalVerifier(options) {
 				piExecutable: options.piExecutable,
 				piRunner: options.piRunner,
 				runId: options.runId,
-				log: options.log
+				log: options.log,
+				...options.piRunSink ? { piRunSink: options.piRunSink } : {}
 			}
 		});
 		return applyVerifierOutput(options, candidates, verifierOutputSchema.parse(result.value), result.providerModels);
@@ -6438,6 +6640,20 @@ function boundedVerifierText(value) {
 //#endregion
 //#region src/review/task/task-output.ts
 const agentInlineFindingsOutputSchema = z.custom((value) => z.looseObject({ inlineFindings: z.array(reviewFindingSchema) }).safeParse(value).success);
+const generatedReviewStatsShape = [
+	/^$/,
+	/^\| Metric \| Total \|$/,
+	/^\| --- \| ---: \|$/,
+	/^\| Models \| .+ \|$/,
+	/^\| Agent runs \| \d+ \|$/,
+	/^\| Elapsed \| .+ \|$/,
+	/^\| Input tokens \| (?:Unavailable|[\d,]+(?: \(reported\))?) \|$/,
+	/^\| Output tokens \| (?:Unavailable|[\d,]+(?: \(reported\))?) \|$/,
+	/^\| Cost \(USD\) \| (?:Unavailable|\$\d+(?:\.\d+)?(?:e[+-]?\d+)?(?: \(reported\))?) \|$/,
+	/^$/,
+	/^<\/details>$/,
+	/^<!-- pipr:stats:end -->$/
+];
 function createOutputState() {
 	return {
 		findings: [],
@@ -6457,6 +6673,66 @@ function mergeTaskOutputs(results) {
 	}
 	return merged;
 }
+function reviewStatsForRuns(runs, durationMs) {
+	if (runs.length === 0) return;
+	const usage = aggregateReviewUsage(runs);
+	return {
+		models: collectReviewModels(runs),
+		agentRuns: runs.length,
+		durationMs,
+		inputTokens: usage.inputTokens,
+		outputTokens: usage.outputTokens,
+		costUsd: usage.costUsd,
+		usageStatus: usage.status
+	};
+}
+function collectReviewModels(runs) {
+	const models = [];
+	for (const model of runs.flatMap((run) => run.models)) {
+		const sanitized = sanitizeReviewStatsModel(model);
+		if (sanitized && models.length < 20 && !models.includes(sanitized)) models.push(sanitized);
+	}
+	return models.length > 0 ? models : ["[invalid model]"];
+}
+function aggregateReviewUsage(runs) {
+	let inputTokens = 0;
+	let outputTokens = 0;
+	let costUsd = 0;
+	let reportedRuns = 0;
+	let partialUsage = false;
+	for (const run of runs) {
+		if (!run.usage) continue;
+		reportedRuns += 1;
+		const input = addReportedUsage(inputTokens, run.usage.inputTokens, Number.isSafeInteger);
+		const output = addReportedUsage(outputTokens, run.usage.outputTokens, Number.isSafeInteger);
+		const cost = addReportedUsage(costUsd, run.usage.costUsd, Number.isFinite);
+		inputTokens = input.total;
+		outputTokens = output.total;
+		costUsd = cost.total;
+		const sumsComplete = [
+			input,
+			output,
+			cost
+		].every((sum) => sum.complete);
+		partialUsage ||= run.usage.status === "partial" || !sumsComplete;
+	}
+	return {
+		inputTokens,
+		outputTokens,
+		costUsd,
+		status: reportedRuns === 0 ? "unavailable" : reportedRuns < runs.length || partialUsage ? "partial" : "complete"
+	};
+}
+function addReportedUsage(current, reported, isValid) {
+	const next = current + reported;
+	return isValid(next) ? {
+		total: next,
+		complete: true
+	} : {
+		total: current,
+		complete: false
+	};
+}
 function mergeCommentContribution(merged, comment) {
 	if (!comment) return;
 	assertOutputContributionAllowed(merged, "comment", comment.taskName, (existing, next) => `ctx.comment(...) may be called once per selected run; received comments from '${existing}' and '${next}'`);
@@ -6534,12 +6810,52 @@ function priorReviewForTask(priorMainComment, priorReviewState) {
 	};
 }
 function visibleMainComment(body) {
-	const lines = body.split("\n").filter((line) => !line.startsWith("<!-- pipr:main-comment ") && !mainCommentAttributionPattern.test(line));
+	const sourceLines = body.split("\n");
+	const envelope = parseGeneratedMainCommentEnvelope(sourceLines);
+	const lines = sourceLines.filter((_line, index) => {
+		return !(envelope.statsRange && index >= envelope.statsRange.start && index <= envelope.statsRange.end) && index !== envelope.mainMarkerIndex && index !== envelope.headerMarkerIndex && index !== envelope.statsMarkerIndex && index !== envelope.footerIndex;
+	});
 	while (lines[0] === "") lines.shift();
-	if (lines[0] && mainCommentTitles.has(lines[0])) lines.shift();
+	if (envelope.headerMarkerIndex < 0 && lines[0] && mainCommentTitles.has(lines[0])) lines.shift();
 	while (lines[0] === "") lines.shift();
 	return lines.join("\n").trim();
 }
+function parseGeneratedMainCommentEnvelope(lines) {
+	const mainMarkerIndex = lines.findIndex((line) => line.startsWith("<!-- pipr:main-comment "));
+	const headerCandidateOffset = lines.slice(mainMarkerIndex + 1).findIndex((line) => line !== "");
+	const headerCandidateIndex = mainMarkerIndex + 1 + headerCandidateOffset;
+	const headerMarkerIndex = mainMarkerIndex >= 0 && headerCandidateOffset >= 0 && lines[headerCandidateIndex] === "<!-- pipr:header:hidden -->" ? headerCandidateIndex : -1;
+	const lastLineIndex = lines.findLastIndex((line) => line !== "");
+	const lastLine = lines[lastLineIndex] ?? "";
+	const footerIndex = lastLine === "<!-- pipr:footer:hidden -->" || mainCommentAttributionPattern.test(lastLine) ? lastLineIndex : -1;
+	const lastContentIndex = lines.slice(0, footerIndex < 0 ? lines.length : footerIndex).findLastIndex((line) => line !== "");
+	return {
+		mainMarkerIndex,
+		headerMarkerIndex,
+		statsMarkerIndex: lines[lastContentIndex] === "<!-- pipr:stats:hidden -->" ? lastContentIndex : -1,
+		statsRange: generatedReviewStatsRange(lines, footerIndex),
+		footerIndex
+	};
+}
+function generatedReviewStatsRange(lines, generatedFooterIndex) {
+	const end = lines.slice(0, generatedFooterIndex < 0 ? lines.length : generatedFooterIndex).findLastIndex((line) => line !== "");
+	if (end < 0) return;
+	if (lines[end] !== "<!-- pipr:stats:end -->") return;
+	if (lines[end - 1] !== "</details>") return;
+	const start = lines.lastIndexOf(reviewStatsStartMarker, end - 2);
+	if (start < 0) return;
+	if (lines[start + 1] !== "<details>") return;
+	if (lines[start + 2] !== "<summary>Review stats</summary>") return;
+	if (!matchesGeneratedReviewStatsShape(lines, start, end)) return;
+	return {
+		start,
+		end
+	};
+}
+function matchesGeneratedReviewStatsShape(lines, start, end) {
+	const generatedShape = lines.slice(start + 3, end + 1);
+	return generatedShape.length === generatedReviewStatsShape.length && generatedReviewStatsShape.every((pattern, index) => pattern.test(generatedShape[index] ?? ""));
+}
 function collectInlineFindings(state, findings) {
 	if (!findings) return;
 	const arrayScope = state.findingScopes.get(findings);
@@ -6563,6 +6879,7 @@ function collectedReview(output, summaryBody) {
 //#region src/review/task/task-runtime.ts
 const genericTaskFailureSummary = "Task failed; see logs for details.";
 async function runTaskRuntime(options) {
+	const runtimeStarted = Date.now();
 	const config = parsePiprConfig(options.config);
 	const provider = options.providerOverride ? parseProviderConfig(options.providerOverride) : resolveProvider(config, config.defaultProvider);
 	const diffManifest = parseDiffManifest((options.diffManifestBuilder ?? buildDiffManifest)({
@@ -6615,11 +6932,15 @@ async function runTaskRuntime(options) {
 	const loadedPriorReviewState = options.priorReviewState ?? await options.loadPriorReviewState?.();
 	const priorMainComment = options.priorMainComment ?? await options.loadPriorMainComment?.();
 	const priorReviewState = priorReviewStateForSelectedTasks(loadedPriorReviewState, selectedTasks);
+	const piRuns = [];
 	const runtimeOptions = {
 		...options,
 		priorReviewState,
 		priorMainComment,
-		runId
+		runId,
+		piRunSink(run) {
+			piRuns.push(run);
+		}
 	};
 	const manifestCache = /* @__PURE__ */ new Map();
 	const taskResults = await Promise.all(tasks.map(async (task, taskOrder) => {
@@ -6703,14 +7024,19 @@ async function runTaskRuntime(options) {
 		provider,
 		diffManifest,
 		priorReviewState,
-		runId
+		runId,
+		piRunSink: runtimeOptions.piRunSink
 	});
+	const stats = reviewStatsForRuns(piRuns, Date.now() - runtimeStarted);
 	const publishing = buildCommentPublishingPlan({
 		event: options.event,
 		main,
 		validated,
 		manifest: diffManifest,
 		maxInlineComments: config.publication.maxInlineComments,
+		showHeader: config.publication.showHeader,
+		showFooter: config.publication.showFooter,
+		showStats: config.publication.showStats,
 		priorReviewState: verifier.priorReviewState,
 		threadActions: verifier.threadActions,
 		metadata: {
@@ -6723,7 +7049,8 @@ async function runTaskRuntime(options) {
 			selectedTasks,
 			failedTasks: [],
 			validFindings: validated.validFindings.length,
-			droppedFindings: validated.droppedFindings.length
+			droppedFindings: validated.droppedFindings.length,
+			...stats ? { stats } : {}
 		}
 	});
 	const publicationPlan = publishing.publicationPlan;
@@ -6782,7 +7109,8 @@ async function runSynchronizeVerifier(options) {
 		priorReviewState: options.priorReviewState,
 		threadContexts: await options.options.loadInlineThreadContexts?.() ?? [],
 		mode: { kind: "synchronize" },
-		runId: options.runId
+		runId: options.runId,
+		piRunSink: options.piRunSink
 	});
 }
 function createTaskContext(options) {
@@ -6843,7 +7171,8 @@ function createTaskContext(options) {
 				runtime: {
 					...options,
 					taskContext,
-					runId: options.runId
+					runId: options.runId,
+					piRunSink: options.piRunSink
 				}
 			});
 			options.output.providerModels.push(...result.providerModels);
@@ -6904,6 +7233,9 @@ function skippedTaskRuntimeResult(options) {
 		validated,
 		manifest: options.diffManifest,
 		maxInlineComments: options.config.publication.maxInlineComments,
+		showHeader: options.config.publication.showHeader,
+		showFooter: options.config.publication.showFooter,
+		showStats: options.config.publication.showStats,
 		metadata: {
 			runtimeVersion,
 			configVersion: options.versionCompatibility?.configVersion,
@@ -9167,4 +9499,4 @@ async function runActionCommandWithDependencies(options) {
 //#endregion
 export { runInspectCommand as a, PublicationError as c, supportedOfficialInitRecipes as d, piBuiltinToolNames as f, piThinkingLevels as h, runInitCommand as i, supportedOfficialInitAdapters as l, piRequiredCliFlags as m, runActionCommandWithDependencies as n, runLocalReviewCommand as o, piReadOnlyToolNames as p, runDryRunCommand as r, runValidateCommand as s, runActionCommand as t, listOfficialInitRecipes as u };
 
-//# sourceMappingURL=commands-Btw_Ummi.mjs.map
+//# sourceMappingURL=commands-RY37Y0rG.mjs.map