feat: persist full review output to disk and render in expandable view

Review text was truncated to 500 chars in the chat message body with no
way to access the full content — once a review exceeded that limit it was
lost from the UI. Now the full review body is rendered in the expanded
(Ctrl+O) view like the implementation tool-call tree, and can optionally
be persisted to disk per-loop.

Changes:
- Add saveReviews config flag + reviewsDir path option
- Add loop-start prompt to opt into saving reviews to disk when
  auto-review is enabled (skipped when explicitly set in YAML)
- Pass full reviewText via message details instead of inlining a slice
- Extend ralpi-progress renderer to show full review body when expanded,
  dim hint to expand when collapsed
- Add saveReviewToFile() writing to .ralpi/reviews/<prdKey>/<taskId>.md,
  mirroring the per-loop reflections layout so many loops don't collide

src/executor.ts

@@ -27,7 +27,14 @@ import { updateTaskInFile } from "./parser";
 export type SendChatMessage = (
 	content: string,
 	/** Extra data passed to the message renderer for the expanded view. */
-	meta?: { toolCalls?: ToolCallEntry[] },
+	meta?: {
+		toolCalls?: ToolCallEntry[];
+		/** Full review body for review messages — renderer shows it in the
+		 *  expanded (Ctrl+O) view so long reviews aren't lost to truncation. */
+		reviewText?: string;
+		/** Saved file path when the review has been persisted to disk. */
+		reviewPath?: string;
+	},
 ) => void;
 
 export interface ToolCallEntry {
@@ -830,14 +837,34 @@ async function executeTask(
 
 							if (reviewResult.success) {
 								const reviewText = reviewResult.text.trim();
-								// Post review as a chat message with tool calls
-								const preview =
-									reviewText.length > 500
-										? reviewText.slice(0, 500) + "\n... (truncated)"
-										: reviewText;
+
+								// Persist the full review to disk when opted in at loop
+								// start. Mirrors the reflections layout so a repo can
+								// hold many loops without collisions:
+								//   .ralpi/reviews/<prdKey>/<taskId>.md
+								let reviewPath: string | undefined;
+								if (config.execution.saveReviews) {
+									reviewPath = saveReviewToFile(
+										projectDir,
+										config,
+										task.id,
+										reviewText,
+										progress.getKey(),
+									);
+								}
+
+								// Post review as a chat message. The full body is
+								// passed via meta.reviewText so the expanded (Ctrl+O)
+								// view can render it without truncation; the collapsed
+								// content shows a short tail + a hint to expand.
+								const lines = reviewText.split("\n").filter((l) => l.trim());
+								const tail = lines.slice(-3).join("\n");
+								const savedHint = reviewPath
+									? ` \u00b7 saved to ${reviewPath}`
+									: "";
 								sendChatMessage?.(
-									`⚑ review for ${task.id} · ${task.title}\n${preview}`,
-									{ toolCalls: reviewToolCalls },
+									`⚑ review for ${task.id} · ${task.title}${savedHint}\n${tail}`,
+									{ toolCalls: reviewToolCalls, reviewText, reviewPath },
 								);
 							} else {
 								sendChatMessage?.(
@@ -960,6 +987,24 @@ function saveReflectionToFile(
 	writeFileSafe(filePath, JSON.stringify(reflection, null, 2));
 }
 
+// ─── Save Review Output to File ─────────────────────────────────────────────
+// Mirrors saveReflectionToFile's per-loop layout so a repo can hold many
+// loops without collisions: .ralpi/reviews/<prdKey>/<taskId>.md
+
+function saveReviewToFile(
+	sourceDir: string,
+	config: RalpiConfig,
+	taskId: string,
+	reviewText: string,
+	prdKey: string,
+): string {
+	const reviewsDir = path.join(sourceDir, config.paths.reviewsDir, prdKey);
+	ensureDir(reviewsDir);
+	const filePath = path.join(reviewsDir, `${taskId}.md`);
+	writeFileSafe(filePath, reviewText);
+	return filePath;
+}
+
 // ─── Follow-Up Sessions (Commit / Review) ─────────────────────────────────────
 
 /**

src/types.ts

@@ -164,6 +164,8 @@ export interface RalpiConfig {
 		stateDir: string;
 		/** Directory for per-task reflections */
 		reflectionsDir: string;
+		/** Directory for per-loop review output (mirrors reflectionsDir) */
+		reviewsDir: string;
 	};
 	execution: {
 		/** Task execution timeout in milliseconds */
@@ -176,6 +178,9 @@ export interface RalpiConfig {
 		autoCommit: boolean;
 		/** Spawn a review agent to review the commit against the task description */
 		autoReview: boolean;
+		/** Persist the full review output to `.ralpi/reviews/<task-id>.md`.
+		 *  Only active when autoReview is true and the user opts in at loop start. */
+		saveReviews: boolean;
 		/** Keys under `execution:` explicitly present in a loaded config YAML.
 		 *  Used to skip interactive prompts for fields the user already set. */
 		explicitKeys?: Set<string>;
@@ -208,6 +213,7 @@ export const DEFAULT_CONFIG: RalpiConfig = {
 	paths: {
 		stateDir: ".ralpi",
 		reflectionsDir: ".ralpi/reflections",
+		reviewsDir: ".ralpi/reviews",
 	},
 	execution: {
 		timeoutMs: 0, // 0 = inherit Pi's own defaults (no ralpi-level timeout)
@@ -215,6 +221,7 @@ export const DEFAULT_CONFIG: RalpiConfig = {
 		models: [],
 		autoCommit: true,
 		autoReview: false,
+		saveReviews: false,
 		commitModel: "",
 		reviewModel: "",
 		implModel: "",