ralph-review 0.1.3 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-review",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A CLI tool that orchestrates agentic review-fix cycles until your code is clean.",
   "license": "MIT",
   "type": "module",

package/src/commands/run.ts

@@ -618,15 +618,26 @@ export async function startReview(
     }
   }
 
-  const modeOptions = [
-    options.base !== undefined && "--base",
-    options.uncommitted && "--uncommitted",
-    options.commit !== undefined && "--commit",
-    options.custom !== undefined && "--custom",
-  ].filter(Boolean);
-
-  if (modeOptions.length > 1) {
-    runtime.prompt.log.error(`Cannot use ${modeOptions.join(" and ")} together`);
+  if (options.base !== undefined && options.commit !== undefined) {
+    runtime.prompt.log.error("Cannot use --base and --commit together");
+    runtime.process.exit(1);
+    return;
+  }
+
+  if (options.uncommitted && options.base !== undefined) {
+    runtime.prompt.log.error("Cannot use --uncommitted and --base together");
+    runtime.process.exit(1);
+    return;
+  }
+
+  if (options.uncommitted && options.commit !== undefined) {
+    runtime.prompt.log.error("Cannot use --uncommitted and --commit together");
+    runtime.process.exit(1);
+    return;
+  }
+
+  if (options.uncommitted && options.custom !== undefined) {
+    runtime.prompt.log.error("Cannot use --uncommitted and --custom together");
     runtime.process.exit(1);
     return;
   }

package/src/lib/agents/codex.ts

@@ -52,6 +52,12 @@ export const codexConfig: AgentConfig = {
 
     const baseReviewArgs = withReasoningEffort(["exec", "--json"], reasoning);
 
+    if (reviewOptions?.customInstructions) {
+      const fullPrompt = prompt ? `review ${prompt}` : "review";
+      const customArgs = withReasoningEffort(["exec", "--full-auto", "--json"], reasoning);
+      return withModel([...customArgs, fullPrompt], model);
+    }
+
     if (reviewOptions?.commitSha) {
       return withModel([...baseReviewArgs, "review", "--commit", reviewOptions.commitSha], model);
     }
@@ -60,12 +66,6 @@ export const codexConfig: AgentConfig = {
       return withModel([...baseReviewArgs, "review", "--base", reviewOptions.baseBranch], model);
     }
 
-    if (reviewOptions?.customInstructions) {
-      const fullPrompt = prompt ? `review ${prompt}` : "review";
-      const customArgs = withReasoningEffort(["exec", "--full-auto", "--json"], reasoning);
-      return withModel([...customArgs, fullPrompt], model);
-    }
-
     return withModel([...baseReviewArgs, "review", "--uncommitted"], model);
   },
   buildEnv: defaultBuildEnv,

package/src/lib/diagnostics/checks.ts

@@ -508,13 +508,7 @@ export async function runDiagnostics(
         }
       }
 
-      if (
-        !options.baseBranch &&
-        !options.commitSha &&
-        !options.customInstructions &&
-        insideGitRepo &&
-        !gitRepoError
-      ) {
+      if (!options.baseBranch && !options.commitSha && insideGitRepo && !gitRepoError) {
         let hasChanges = false;
         let hasChangesError: string | null = null;
         try {

package/src/lib/format.ts

@@ -1,23 +1,31 @@
 import type { ReviewOptions } from "@/lib/types";
 
+function formatCustomReviewType(customInstructions: string): string {
+  const instruction = customInstructions.slice(0, 40);
+  return customInstructions.length > 40 ? `custom (${instruction}...)` : `custom (${instruction})`;
+}
+
 export function formatReviewType(reviewOptions: ReviewOptions | undefined): string {
   if (!reviewOptions) return "uncommitted changes";
 
-  if (reviewOptions.customInstructions) {
-    const instruction = reviewOptions.customInstructions.slice(0, 40);
-    return reviewOptions.customInstructions.length > 40
-      ? `custom (${instruction}...)`
-      : `custom (${instruction})`;
-  }
-
   if (reviewOptions.commitSha) {
     const shortSha = reviewOptions.commitSha.slice(0, 7);
+    if (reviewOptions.customInstructions) {
+      return `commit (${shortSha}) + ${formatCustomReviewType(reviewOptions.customInstructions)}`;
+    }
     return `commit (${shortSha})`;
   }
 
   if (reviewOptions.baseBranch) {
+    if (reviewOptions.customInstructions) {
+      return `base (${reviewOptions.baseBranch}) + ${formatCustomReviewType(reviewOptions.customInstructions)}`;
+    }
     return `base (${reviewOptions.baseBranch})`;
   }
 
+  if (reviewOptions.customInstructions) {
+    return formatCustomReviewType(reviewOptions.customInstructions);
+  }
+
   return "uncommitted changes";
 }

package/src/lib/prompts/review.ts

@@ -19,6 +19,16 @@ const BASE_BRANCH_PROMPT_BACKUP = (branch: string) =>
 const COMMIT_PROMPT = (commitHash: string) =>
   `Review the code changes for the commit ${commitHash}. Provide prioritized, actionable findings.`;
 
+const CUSTOM_FOCUS_PROMPT = (customInstructions: string) =>
+  `Additional review focus from user instructions:\n${customInstructions}`;
+
+function withCustomFocus(instruction: string, customInstructions?: string): string {
+  if (!customInstructions) {
+    return instruction;
+  }
+  return `${instruction}\n\n${CUSTOM_FOCUS_PROMPT(customInstructions)}`;
+}
+
 export interface ReviewerPromptOptions {
   repoPath: string;
   baseBranch?: string;
@@ -26,19 +36,20 @@ export interface ReviewerPromptOptions {
   customInstructions?: string;
 }
 
-/** Priority: commitSha > baseBranch > customInstructions > uncommitted (default) */
+/** Target priority: commitSha > baseBranch > uncommitted (default), with custom focus overlay. */
 export function createReviewerPrompt(options: ReviewerPromptOptions): string {
   const { repoPath, baseBranch, commitSha, customInstructions } = options;
 
   let instruction: string;
 
   if (commitSha) {
-    instruction = COMMIT_PROMPT(commitSha);
+    instruction = withCustomFocus(COMMIT_PROMPT(commitSha), customInstructions);
   } else if (baseBranch) {
     const mergeBaseSha = mergeBaseWithHead(repoPath, baseBranch);
-    instruction = mergeBaseSha
+    const baseInstruction = mergeBaseSha
       ? BASE_BRANCH_PROMPT(baseBranch, mergeBaseSha)
       : BASE_BRANCH_PROMPT_BACKUP(baseBranch);
+    instruction = withCustomFocus(baseInstruction, customInstructions);
   } else if (customInstructions) {
     instruction = customInstructions;
   } else {

package/src/lib/tui/components/SessionPanel.tsx

@@ -1,5 +1,6 @@
 import { useTerminalDimensions } from "@opentui/react";
 import { useEffect, useMemo, useRef } from "react";
+import { formatReviewType } from "@/lib/format";
 import type { LockData } from "@/lib/lockfile";
 import { TUI_COLORS } from "@/lib/tui/colors";
 import type {
@@ -81,24 +82,6 @@ function toSingleLine(value: string): string {
   return value.replace(/\s+/g, " ").trim();
 }
 
-function formatReviewType(reviewOptions: ReviewOptions | undefined): string {
-  if (!reviewOptions) return "uncommitted changes";
-
-  if (reviewOptions.customInstructions) {
-    return `custom (${toSingleLine(reviewOptions.customInstructions)})`;
-  }
-
-  if (reviewOptions.commitSha) {
-    return `commit (${toSingleLine(reviewOptions.commitSha)})`;
-  }
-
-  if (reviewOptions.baseBranch) {
-    return `base (${toSingleLine(reviewOptions.baseBranch)})`;
-  }
-
-  return "uncommitted changes";
-}
-
 interface FixListProps {
   fixes: FixEntry[];
   showFiles: boolean;
@@ -566,7 +549,7 @@ export function SessionPanel({
       <box flexDirection="row" gap={1}>
         <text fg={TUI_COLORS.text.muted}>Review Type:</text>
         <text fg={TUI_COLORS.text.primary} wrapMode="none">
-          {formatReviewType(reviewOptions)}
+          {toSingleLine(formatReviewType(reviewOptions))}
         </text>
       </box>