cc-reviewer 1.8.4 → 1.9.0

package/commands/ask-codex.md

@@ -20,7 +20,8 @@ Call `ask_codex` with:
   "prompt": "<your question or request from $ARGUMENTS>",
   "taskType": "<infer from request: plan|debug|explain|question|fix|explore|general>",
   "relevantFiles": ["<files related to the question>"],
-  "context": "<any error messages or prior analysis>"
+  "context": "<any error messages or prior analysis>",
+  "serviceTier": "<if user says 'fast mode'/'fast'/'priority' → 'priority'; if 'flex'/'cheap'/'budget' → 'flex'; otherwise omit>"
 }
 ```
 

package/commands/ask-multi.md

@@ -19,7 +19,8 @@ Call `ask_multi` with:
   "prompt": "<your question or request from $ARGUMENTS>",
   "taskType": "<infer from request: plan|debug|explain|question|fix|explore|general>",
   "relevantFiles": ["<files related to the question>"],
-  "context": "<any error messages or prior analysis>"
+  "context": "<any error messages or prior analysis>",
+  "serviceTier": "<if user says 'fast mode'/'fast'/'priority' → 'priority'; if 'flex'/'cheap'/'budget' → 'flex'; otherwise omit. Applies to Codex only.>"
 }
 ```
 

package/commands/codex-xhigh.md

@@ -18,6 +18,7 @@ Use the `codex_review` MCP tool with `reasoningEffort: "xhigh"` for deeper analy
    - `workingDir`: current working directory
    - `ccOutput`: brief summary of recent changes or context
    - `reasoningEffort`: "xhigh" (this is the key difference from /codex)
+   - `serviceTier`: if user says "fast mode"/"fast"/"priority" → "priority"; if "flex"/"cheap"/"budget" → "flex"; otherwise omit
    - `focus`: extracted from $ARGUMENTS if it's a known focus area
    - `customInstructions`: $ARGUMENTS if it's custom text
 

package/commands/codex.md

@@ -43,10 +43,16 @@ Call `codex_review` with:
   "ccOutput": "<structured handoff - see below>",
   "outputType": "analysis",
   "focusAreas": ["<from $ARGUMENTS>"],
-  "reasoningEffort": "high"  // or "xhigh" for deeper analysis
+  "reasoningEffort": "high",
+  "serviceTier": "<see below>"
 }
 ```
 
+### Service Tier (from $ARGUMENTS)
+- If user says "fast mode", "fast", or "priority" → set `serviceTier: "priority"` (faster, ~2x cost)
+- If user says "flex", "cheap", or "budget" → set `serviceTier: "flex"` (50% cheaper, slower)
+- Otherwise → omit `serviceTier` (uses default tier)
+
 ### Structure your ccOutput:
 
 ```

package/commands/multi.md

@@ -41,10 +41,16 @@ Call `multi_review` with:
   "workingDir": "<current directory>",
   "ccOutput": "<structured handoff>",
   "outputType": "analysis",
-  "focusAreas": ["<from $ARGUMENTS>"]
+  "focusAreas": ["<from $ARGUMENTS>"],
+  "serviceTier": "<see below>"
 }
 ```
 
+### Service Tier (from $ARGUMENTS, applies to Codex only)
+- If user says "fast mode", "fast", or "priority" → set `serviceTier: "priority"`
+- If user says "flex", "cheap", or "budget" → set `serviceTier: "flex"`
+- Otherwise → omit `serviceTier`
+
 ### Structure your ccOutput:
 
 ```

package/dist/adapters/base.d.ts

@@ -6,7 +6,7 @@
  * changing the core orchestration logic.
  */
 import { ReviewOutput, PeerOutput } from '../schema.js';
-import { FocusArea, OutputType, ReasoningEffort, TaskType } from '../types.js';
+import { FocusArea, OutputType, ReasoningEffort, ServiceTier, TaskType } from '../types.js';
 export interface ReviewerCapabilities {
     /** Display name for this reviewer */
     name: string;
@@ -40,6 +40,8 @@ export interface ReviewRequest {
     customPrompt?: string;
     /** Reasoning effort level (for models that support it) */
     reasoningEffort?: ReasoningEffort;
+    /** Service tier (for models that support it: priority = fast, flex = cheap) */
+    serviceTier?: ServiceTier;
     /** Expert role configuration (optional override) */
     expertRole?: ExpertRole;
 }
@@ -60,6 +62,8 @@ export interface PeerRequest {
     customPrompt?: string;
     /** Reasoning effort level (for models that support it) */
     reasoningEffort?: ReasoningEffort;
+    /** Service tier (for models that support it: priority = fast, flex = cheap) */
+    serviceTier?: ServiceTier;
 }
 export interface ExpertRole {
     name: string;

package/dist/adapters/codex.js

@@ -76,10 +76,11 @@ export class CodexAdapter {
             // Select role based on focus areas
             const role = selectRole(request.focusAreas);
             // Build prompt with retry context if needed
+            // Use 'schema-enforced' since Codex gets --output-schema flag (avoids redundant inline JSON template)
             let prompt = buildHandoffPrompt({
                 handoff,
                 role,
-                outputFormat: 'json',
+                outputFormat: 'schema-enforced',
             });
             // Add retry context if this is a retry attempt
             if (attempt > 0) {
@@ -89,7 +90,7 @@ export class CodexAdapter {
                     (previousOutput ? `\nPrevious output (for reference):\n${previousOutput.slice(0, 500)}...` : '');
             }
             // Run the CLI
-            const result = await this.runCli(prompt, request.workingDir, request.reasoningEffort || 'high', getReviewOutputJsonSchema);
+            const result = await this.runCli(prompt, request.workingDir, request.reasoningEffort || 'high', getReviewOutputJsonSchema, request.serviceTier);
             // Handle CLI errors
             if (result.exitCode !== 0) {
                 const error = this.categorizeError(result.stderr);
@@ -139,9 +140,14 @@ export class CodexAdapter {
                 };
             }
             // Check for empty/minimal data on any parse path
+            // A valid review may have findings, agreements, disagreements, alternatives,
+            // or a non-default risk assessment. Only retry if truly empty across all fields.
             const hasMinimalData = output.findings.length === 0 &&
                 output.agreements.length === 0 &&
-                output.disagreements.length === 0;
+                output.disagreements.length === 0 &&
+                output.alternatives.length === 0 &&
+                output.risk_assessment.overall_level === 'medium' &&
+                output.risk_assessment.score === 50;
             if (hasMinimalData) {
                 if (attempt < MAX_RETRIES) {
                     console.error(`[codex] Received empty output, retrying...`);
@@ -231,6 +237,7 @@ export class CodexAdapter {
     }
     async runPeerWithRetry(request, attempt, startTime, previousError, previousOutput) {
         try {
+            // Use 'schema-enforced' since Codex gets --output-schema flag (avoids redundant inline JSON template)
             let prompt = buildPeerPrompt({
                 workingDir: request.workingDir,
                 prompt: request.prompt,
@@ -239,7 +246,7 @@ export class CodexAdapter {
                 context: request.context,
                 focusAreas: request.focusAreas,
                 customInstructions: request.customPrompt,
-                outputFormat: 'json',
+                outputFormat: 'schema-enforced',
             });
             if (attempt > 0) {
                 prompt += `\n\n---\n\n# RETRY ATTEMPT ${attempt + 1}\n\n` +
@@ -247,7 +254,7 @@ export class CodexAdapter {
                     `Please fix these issues and provide valid JSON output.\n` +
                     (previousOutput ? `\nPrevious output (for reference):\n${previousOutput.slice(0, 500)}...` : '');
             }
-            const result = await this.runCli(prompt, request.workingDir, request.reasoningEffort || 'high', getPeerOutputJsonSchema);
+            const result = await this.runCli(prompt, request.workingDir, request.reasoningEffort || 'high', getPeerOutputJsonSchema, request.serviceTier);
             if (result.exitCode !== 0) {
                 const error = this.categorizeError(result.stderr);
                 return {
@@ -305,7 +312,7 @@ export class CodexAdapter {
                 executionTimeMs: Date.now() - startTime };
         }
     }
-    runCli(prompt, workingDir, reasoningEffort, schemaGetter) {
+    runCli(prompt, workingDir, reasoningEffort, schemaGetter, serviceTier) {
         return new Promise((resolve, reject) => {
             // Create temp schema file for structured output
             let schemaFile = null;
@@ -320,15 +327,18 @@ export class CodexAdapter {
                 schemaFile = null;
             }
             const args = [
-                '--search',
                 'exec',
-                '-m', 'gpt-5.3-codex',
+                '-m', 'gpt-5.4',
                 '-c', `model_reasoning_effort=${reasoningEffort}`,
                 '-c', 'model_reasoning_summary_format=experimental',
                 '--dangerously-bypass-approvals-and-sandbox',
                 '--skip-git-repo-check',
                 '-C', workingDir,
             ];
+            // Add service tier if specified (priority = fast mode, flex = cheap mode)
+            if (serviceTier && serviceTier !== 'default') {
+                args.push('-c', `service_tier=${serviceTier}`);
+            }
             // Add schema enforcement if available
             if (schemaFile) {
                 args.push('--output-schema', schemaFile);
@@ -357,7 +367,8 @@ export class CodexAdapter {
             let lastProgressTime = cliStartTime;
             let dataChunks = 0;
             // Show initial progress message
-            console.error(`[codex] Running review with ${reasoningEffort} reasoning...`);
+            const tierLabel = serviceTier && serviceTier !== 'default' ? ` [${serviceTier}]` : '';
+            console.error(`[codex] Running review with ${reasoningEffort} reasoning${tierLabel}...`);
             const maxTimer = setTimeout(() => {
                 proc.kill('SIGTERM');
                 reject(new Error('MAX_TIMEOUT'));

package/dist/adapters/gemini.js

@@ -137,9 +137,14 @@ export class GeminiAdapter {
                 };
             }
             // If output has no substantive data, retry or fail
+            // A valid review may have findings, agreements, disagreements, alternatives,
+            // or a non-default risk assessment. Only retry if truly empty across all fields.
             const hasMinimalData = output.findings.length === 0 &&
                 output.agreements.length === 0 &&
-                output.disagreements.length === 0;
+                output.disagreements.length === 0 &&
+                output.alternatives.length === 0 &&
+                output.risk_assessment.overall_level === 'medium' &&
+                output.risk_assessment.score === 50;
             if (hasMinimalData) {
                 if (attempt < MAX_RETRIES) {
                     console.error(`[gemini] Received empty output, retrying...`);

package/dist/handoff.d.ts

@@ -215,7 +215,7 @@ export declare function selectRole(focusAreas?: FocusArea[]): ReviewerRole;
 export interface PromptOptions {
     handoff: Handoff;
     role?: ReviewerRole;
-    outputFormat: 'json' | 'markdown';
+    outputFormat: 'json' | 'markdown' | 'schema-enforced';
 }
 /**
  * Build the review prompt using minimal, targeted context
@@ -238,7 +238,7 @@ export interface PeerPromptOptions {
     context?: string;
     focusAreas?: FocusArea[];
     customInstructions?: string;
-    outputFormat: 'json';
+    outputFormat: 'json' | 'schema-enforced';
 }
 /**
  * Build a prompt for general-purpose peer assistance (not review).

package/dist/handoff.js

@@ -372,7 +372,23 @@ ${handoff.priorityFiles.map(f => `- \`${f}\``).join('\n')}`);
     // ==========================================================================
     // SECTION 7: OUTPUT FORMAT
     // ==========================================================================
-    if (outputFormat === 'json') {
+    if (outputFormat === 'schema-enforced') {
+        // Schema is enforced externally (e.g. via --output-schema flag).
+        // Only include behavioral rules, skip the redundant JSON template.
+        sections.push(`
+---
+
+# OUTPUT FORMAT
+
+Respond with valid JSON matching the provided output schema.
+
+**Rules:**
+- Use \`git diff\` and file reading to verify before claiming issues
+- Include evidence (code snippets) for findings
+- Confidence reflects how sure YOU are (not CC)
+- Answer CC's uncertainties and questions explicitly`);
+    }
+    else if (outputFormat === 'json') {
         sections.push(`
 ---
 
@@ -481,7 +497,7 @@ export function enhanceHandoff(handoff, uncertainties, questions, decisions) {
  * The peer acts as a collaborative coworker, not a critic.
  */
 export function buildPeerPrompt(options) {
-    const { workingDir, prompt, taskType, relevantFiles, context, focusAreas, customInstructions } = options;
+    const { workingDir, prompt, taskType, relevantFiles, context, focusAreas, customInstructions, outputFormat } = options;
     // Select role based on focus areas (reuse existing role selection)
     const role = selectRole(focusAreas);
     const sections = [];
@@ -549,7 +565,25 @@ ${customInstructions}`);
 5. Reference specific files and line numbers
 6. Suggest concrete next steps`);
     // SECTION 7: OUTPUT FORMAT
-    sections.push(`
+    if (outputFormat === 'schema-enforced') {
+        // Schema is enforced externally (e.g. via --output-schema flag).
+        // Only include behavioral rules, skip the redundant JSON template.
+        sections.push(`
+---
+
+# OUTPUT FORMAT
+
+Respond with valid JSON matching the provided output schema.
+
+**Rules:**
+- Read files before making claims
+- Reference specific file paths and line numbers
+- Be concrete and actionable — no vague suggestions
+- Confidence reflects how sure YOU are about your answer
+- Include alternatives when there are meaningful tradeoffs`);
+    }
+    else {
+        sections.push(`
 ---
 
 # OUTPUT FORMAT
@@ -596,5 +630,6 @@ Respond with valid JSON:
 - Be concrete and actionable — no vague suggestions
 - Confidence reflects how sure YOU are about your answer
 - Include alternatives when there are meaningful tradeoffs`);
+    }
     return sections.join('\n');
 }

package/dist/schema.d.ts

@@ -651,13 +651,13 @@ export declare const SuggestedAction: z.ZodObject<{
     rationale: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     rationale: string;
-    action: string;
     priority: "high" | "medium" | "low";
+    action: string;
     file?: string | null | undefined;
 }, {
     rationale: string;
-    action: string;
     priority: "high" | "medium" | "low";
+    action: string;
     file?: string | null | undefined;
 }>;
 export type SuggestedAction = z.infer<typeof SuggestedAction>;
@@ -688,13 +688,13 @@ export declare const PeerOutput: z.ZodObject<{
         rationale: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         rationale: string;
-        action: string;
         priority: "high" | "medium" | "low";
+        action: string;
         file?: string | null | undefined;
     }, {
         rationale: string;
-        action: string;
         priority: "high" | "medium" | "low";
+        action: string;
         file?: string | null | undefined;
     }>, "many">;
     file_references: z.ZodArray<z.ZodObject<{
@@ -752,8 +752,8 @@ export declare const PeerOutput: z.ZodObject<{
     key_points: string[];
     suggested_actions: {
         rationale: string;
-        action: string;
         priority: "high" | "medium" | "low";
+        action: string;
         file?: string | null | undefined;
     }[];
     file_references: {
@@ -780,8 +780,8 @@ export declare const PeerOutput: z.ZodObject<{
     key_points: string[];
     suggested_actions: {
         rationale: string;
-        action: string;
         priority: "high" | "medium" | "low";
+        action: string;
         file?: string | null | undefined;
     }[];
     file_references: {

package/dist/tools/feedback.d.ts

@@ -14,6 +14,7 @@ export declare const ReviewInputSchema: z.ZodObject<{
     focusAreas: z.ZodOptional<z.ZodArray<z.ZodEnum<["security", "performance", "architecture", "correctness", "maintainability", "scalability", "testing", "documentation"]>, "many">>;
     customPrompt: z.ZodOptional<z.ZodString>;
     reasoningEffort: z.ZodOptional<z.ZodEnum<["high", "xhigh"]>>;
+    serviceTier: z.ZodOptional<z.ZodEnum<["default", "priority", "flex"]>>;
 }, "strip", z.ZodTypeAny, {
     workingDir: string;
     ccOutput: string;
@@ -22,6 +23,7 @@ export declare const ReviewInputSchema: z.ZodObject<{
     customPrompt?: string | undefined;
     analyzedFiles?: string[] | undefined;
     reasoningEffort?: "high" | "xhigh" | undefined;
+    serviceTier?: "default" | "priority" | "flex" | undefined;
 }, {
     workingDir: string;
     ccOutput: string;
@@ -30,6 +32,7 @@ export declare const ReviewInputSchema: z.ZodObject<{
     customPrompt?: string | undefined;
     analyzedFiles?: string[] | undefined;
     reasoningEffort?: "high" | "xhigh" | undefined;
+    serviceTier?: "default" | "priority" | "flex" | undefined;
 }>;
 export type ReviewInput = z.infer<typeof ReviewInputSchema>;
 export declare function handleCodexReview(input: ReviewInput): Promise<{
@@ -94,6 +97,11 @@ export declare const TOOL_DEFINITIONS: {
                     enum: string[];
                     description: string;
                 };
+                serviceTier: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
             };
             required: string[];
         };
@@ -178,6 +186,11 @@ export declare const TOOL_DEFINITIONS: {
                     type: string;
                     description: string;
                 };
+                serviceTier: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
             };
             required: string[];
         };

package/dist/tools/feedback.js

@@ -20,7 +20,8 @@ export const ReviewInputSchema = z.object({
         'maintainability', 'scalability', 'testing', 'documentation'
     ])).optional().describe('Areas to focus the review on'),
     customPrompt: z.string().optional().describe('Custom instructions for the reviewer'),
-    reasoningEffort: z.enum(['high', 'xhigh']).optional().describe('Codex reasoning effort level (default: high, use xhigh for deeper analysis)')
+    reasoningEffort: z.enum(['high', 'xhigh']).optional().describe('Codex reasoning effort level (default: high, use xhigh for deeper analysis)'),
+    serviceTier: z.enum(['default', 'priority', 'flex']).optional().describe('Codex service tier (default: default, priority = fast mode, flex = cheaper/slower)')
 });
 // =============================================================================
 // HELPER FUNCTIONS
@@ -34,6 +35,7 @@ function toReviewRequest(input) {
         focusAreas: input.focusAreas,
         customPrompt: input.customPrompt,
         reasoningEffort: input.reasoningEffort,
+        serviceTier: input.serviceTier,
     };
 }
 function formatSingleReviewResponse(result, modelName) {
@@ -338,6 +340,11 @@ export const TOOL_DEFINITIONS = {
                     type: 'string',
                     enum: ['high', 'xhigh'],
                     description: 'Codex reasoning effort (default: high, use xhigh for deeper analysis)'
+                },
+                serviceTier: {
+                    type: 'string',
+                    enum: ['default', 'priority', 'flex'],
+                    description: 'Codex service tier (priority = fast mode, flex = cheaper/slower)'
                 }
             },
             required: ['workingDir', 'ccOutput', 'outputType']
@@ -418,6 +425,11 @@ export const TOOL_DEFINITIONS = {
                 customPrompt: {
                     type: 'string',
                     description: 'Custom instructions for the reviewer'
+                },
+                serviceTier: {
+                    type: 'string',
+                    enum: ['default', 'priority', 'flex'],
+                    description: 'Codex service tier (priority = fast mode, flex = cheaper/slower). Only applies to Codex.'
                 }
             },
             required: ['workingDir', 'ccOutput', 'outputType']

package/dist/tools/peer.d.ts

@@ -16,6 +16,7 @@ export type PeerInput = {
     focusAreas?: string[];
     customPrompt?: string;
     reasoningEffort?: 'high' | 'xhigh';
+    serviceTier?: 'default' | 'priority' | 'flex';
 };
 export declare function formatPeerResponse(result: PeerResult, modelName: string): string;
 export declare function handleAskCodex(input: PeerInput): Promise<{
@@ -84,6 +85,11 @@ export declare const PEER_TOOL_DEFINITIONS: {
                     enum: string[];
                     description: string;
                 };
+                serviceTier: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
             };
             required: string[];
         };
@@ -176,6 +182,11 @@ export declare const PEER_TOOL_DEFINITIONS: {
                     type: string;
                     description: string;
                 };
+                serviceTier: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
             };
             required: string[];
         };

package/dist/tools/peer.js

@@ -20,6 +20,7 @@ function toPeerRequest(input) {
         focusAreas: input.focusAreas,
         customPrompt: input.customPrompt,
         reasoningEffort: input.reasoningEffort,
+        serviceTier: input.serviceTier,
     };
 }
 export function formatPeerResponse(result, modelName) {
@@ -241,6 +242,11 @@ export const PEER_TOOL_DEFINITIONS = {
                     enum: ['high', 'xhigh'],
                     description: 'Codex reasoning effort (default: high)',
                 },
+                serviceTier: {
+                    type: 'string',
+                    enum: ['default', 'priority', 'flex'],
+                    description: 'Codex service tier (priority = fast mode, flex = cheaper/slower)',
+                },
             },
             required: ['workingDir', 'prompt'],
         },
@@ -329,6 +335,11 @@ export const PEER_TOOL_DEFINITIONS = {
                     type: 'string',
                     description: 'Additional instructions for the peer',
                 },
+                serviceTier: {
+                    type: 'string',
+                    enum: ['default', 'priority', 'flex'],
+                    description: 'Codex service tier (priority = fast mode, flex = cheaper/slower). Only applies to Codex.',
+                },
             },
             required: ['workingDir', 'prompt'],
         },

package/dist/types.d.ts

@@ -5,6 +5,7 @@ export type OutputType = 'plan' | 'findings' | 'analysis' | 'proposal';
 export type FocusArea = 'security' | 'performance' | 'architecture' | 'correctness' | 'maintainability' | 'scalability' | 'testing' | 'documentation';
 export type CliType = 'codex' | 'gemini';
 export type ReasoningEffort = 'high' | 'xhigh';
+export type ServiceTier = 'default' | 'priority' | 'flex';
 export type TaskType = 'plan' | 'debug' | 'explain' | 'question' | 'fix' | 'explore' | 'general';
 export interface FeedbackRequest {
     workingDir: string;
@@ -14,6 +15,7 @@ export interface FeedbackRequest {
     focusAreas?: FocusArea[];
     customPrompt?: string;
     reasoningEffort?: ReasoningEffort;
+    serviceTier?: ServiceTier;
 }
 export interface FeedbackSuccess {
     success: true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-reviewer",
-  "version": "1.8.4",
+  "version": "1.9.0",
   "description": "MCP server for Claude Code - Get second-opinion feedback from Codex/Gemini CLIs",
   "type": "module",
   "main": "dist/index.js",