port: sync from Mike/pygienium@595ce48f

tests/comments.test.ts

@@ -30,6 +30,8 @@ import {
 	commentsCheck,
 	findingsPath,
 	changesPath,
+	buildCommentsScanTask,
+	buildCommentsFixTask,
 } from "../src/checks/comments.js";
 import type { CheckScope } from "../src/checks/registry.js";
 
@@ -256,4 +258,31 @@ describe("comments check (end-to-end)", () => {
 		expect(check!.findings).toBeDefined();
 		expect(check!.changes).toBeDefined();
 	});
+
+	it("scan task keeps the full report in findings.md, not the final message", () => {
+		// Regression: the scan task used to demand the agent regenerate the
+		// whole report as its final message right after writing findings.md —
+		// a second huge output that stalled the phase transition (observed in
+		// freno-dev twice). The final message must stay a one-line summary.
+		const scope: CheckScope = {
+			cwd,
+			target,
+			fix: false,
+			rest: [],
+		};
+		const task = buildCommentsScanTask(cwd, scope);
+		expect(task).toContain("ONE-LINE summary");
+		expect(task).toContain("do NOT regenerate the report text");
+		expect(task).not.toContain(
+			"Return the findings report text as your final message",
+		);
+		expect(task).not.toContain("same content as the file");
+
+		// The fix phase must read the detailed findings from the artifact so a
+		// one-line scan summary can't starve it.
+		const fixTask = buildCommentsFixTask(cwd, scope, "fallback-findings-text");
+		expect(fixTask).toContain("Read the detailed per-file findings");
+		expect(fixTask).toContain(findingsPath(scope));
+		expect(fixTask).toContain("fallback-findings-text");
+	});
 });