@klitchevo/code-council 0.0.7 → 0.0.8

package/README.md

@@ -5,6 +5,8 @@
 [![CI](https://github.com/klitchevo/code-council/workflows/CI/badge.svg)](https://github.com/klitchevo/code-council/actions)
 [![codecov](https://codecov.io/gh/klitchevo/code-council/branch/main/graph/badge.svg)](https://codecov.io/gh/klitchevo/code-council)
 
+![Code Council](assets/code-council.png)
+
 **Your AI Code Review Council** - Get diverse perspectives from multiple AI models in parallel.
 
 An MCP (Model Context Protocol) server that provides AI-powered code review using multiple models from [OpenRouter](https://openrouter.ai). Think of it as assembling a council of AI experts to review your code, each bringing their unique perspective.
@@ -15,6 +17,7 @@ An MCP (Model Context Protocol) server that provides AI-powered code review usin
 - 🎨 **Frontend Review** - Specialized reviews for accessibility, performance, and UX
 - 🔒 **Backend Review** - Security, architecture, and performance analysis
 - 📋 **Plan Review** - Review implementation plans before writing code
+- 📝 **Git Changes Review** - Review staged, unstaged, branch diffs, or specific commits
 - ⚡ **Parallel Execution** - All models run concurrently for fast results
 
 ## Quick Start
@@ -232,6 +235,28 @@ Use review_plan to analyze this implementation plan:
 [paste your plan]
 ```
 
+### `review_git_changes`
+
+Review git changes directly from your repository.
+
+**Parameters:**
+- `review_type` (optional): `staged`, `unstaged`, `diff`, or `commit` (default: `staged`)
+  - `staged` - Review staged changes (`git diff --cached`)
+  - `unstaged` - Review unstaged changes (`git diff`)
+  - `diff` - Review branch diff (`git diff main..HEAD`)
+  - `commit` - Review a specific commit (requires `commit_hash`)
+- `commit_hash` (optional): Commit hash to review (required when `review_type` is `commit`)
+- `context` (optional): Additional context about the changes
+
+**Example usage in Claude:**
+```
+Use review_git_changes to review my staged changes
+```
+
+```
+Use review_git_changes with review_type=commit and commit_hash=abc123 to review that commit
+```
+
 ### `list_review_config`
 
 Show which AI models are currently configured for each review type.
@@ -247,8 +272,10 @@ You can customize which AI models are used for reviews by setting environment va
 - `FRONTEND_REVIEW_MODELS` - Models for frontend reviews
 - `BACKEND_REVIEW_MODELS` - Models for backend reviews
 - `PLAN_REVIEW_MODELS` - Models for plan reviews
+- `TEMPERATURE` - Control response randomness (0.0-2.0, default: 0.3)
+- `MAX_TOKENS` - Maximum response tokens (default: 16384)
 
-**Format:** Array of strings (JSON array)
+**Format:** Model arrays use JSON array format
 
 **Example:**
 ```json
@@ -261,7 +288,9 @@ You can customize which AI models are used for reviews by setting environment va
         "OPENROUTER_API_KEY": "your-api-key",
         "CODE_REVIEW_MODELS": ["anthropic/claude-sonnet-4.5", "openai/gpt-4o", "google/gemini-2.0-flash-exp"],
         "FRONTEND_REVIEW_MODELS": ["anthropic/claude-sonnet-4.5"],
-        "BACKEND_REVIEW_MODELS": ["openai/gpt-4o", "anthropic/claude-sonnet-4.5"]
+        "BACKEND_REVIEW_MODELS": ["openai/gpt-4o", "anthropic/claude-sonnet-4.5"],
+        "TEMPERATURE": "0.5",
+        "MAX_TOKENS": "32000"
       }
     }
   }
@@ -271,6 +300,7 @@ You can customize which AI models are used for reviews by setting environment va
 **Default Models:**
 If you don't specify models, the server uses these defaults:
 - `minimax/minimax-m2.1`
+- `z-ai/glm-4.7`
 - `x-ai/grok-code-fast-1`
 
 **Finding Models:**
@@ -330,9 +360,10 @@ npm run dev
 - Each review runs across multiple models simultaneously
 - Costs vary by model - check [OpenRouter pricing](https://openrouter.ai/models)
 - You can reduce costs by:
-  - Using fewer models (edit `src/config.ts`)
+  - Using fewer models in your configuration
   - Choosing cheaper models
   - Using specific `review_type` options instead of `full` reviews
+  - Lowering `MAX_TOKENS` (default: 16384) for shorter responses
 
 ## Troubleshooting
 

package/dist/index.js

@@ -568,12 +568,80 @@ async function handleFrontendReview(client2, input) {
   };
 }
 
-// src/tools/review-plan.ts
+// src/tools/review-git.ts
+import { execSync } from "child_process";
 import { z as z4 } from "zod";
+var gitReviewSchemaObj = z4.object({
+  review_type: z4.enum(["staged", "unstaged", "diff", "commit"]).optional().describe(
+    "Type of changes to review: 'staged' (git diff --cached), 'unstaged' (git diff), 'diff' (git diff main..HEAD), 'commit' (specific commit). Default: staged"
+  ),
+  commit_hash: z4.string().optional().describe("Commit hash to review (only used when review_type is 'commit')"),
+  context: z4.string().optional().describe("Additional context about the changes")
+});
+var gitReviewSchema = gitReviewSchemaObj.shape;
+function getGitDiff(reviewType = "staged", commitHash) {
+  try {
+    let command;
+    switch (reviewType) {
+      case "staged":
+        command = "git diff --cached";
+        break;
+      case "unstaged":
+        command = "git diff";
+        break;
+      case "diff":
+        command = "git diff main..HEAD";
+        break;
+      case "commit":
+        if (!commitHash) {
+          throw new Error(
+            "commit_hash is required when review_type is 'commit'"
+          );
+        }
+        command = `git show ${commitHash}`;
+        break;
+      default:
+        command = "git diff --cached";
+    }
+    logger.debug("Executing git command", { command });
+    const diff = execSync(command, {
+      encoding: "utf-8",
+      maxBuffer: 10 * 1024 * 1024
+      // 10MB
+    });
+    if (!diff || diff.trim().length === 0) {
+      throw new Error(`No changes found for review type: ${reviewType}`);
+    }
+    return diff;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    logger.error("Failed to get git diff", error);
+    throw new Error(`Git command failed: ${message}`);
+  }
+}
+async function handleGitReview(client2, models, input) {
+  const reviewType = input.review_type || "staged";
+  logger.info("Running git review", {
+    reviewType,
+    commitHash: input.commit_hash,
+    modelCount: models.length,
+    models
+  });
+  const diff = getGitDiff(reviewType, input.commit_hash);
+  const results = await client2.reviewCode(diff, models, input.context);
+  return {
+    results,
+    models,
+    reviewType
+  };
+}
+
+// src/tools/review-plan.ts
+import { z as z5 } from "zod";
 var planReviewSchema = {
-  plan: z4.string().describe("The implementation plan to review"),
-  review_type: z4.enum(["feasibility", "completeness", "risks", "timeline", "full"]).optional().describe("Type of review to perform (default: full)"),
-  context: z4.string().optional().describe("Additional context about the project or constraints")
+  plan: z5.string().describe("The implementation plan to review"),
+  review_type: z5.enum(["feasibility", "completeness", "risks", "timeline", "full"]).optional().describe("Type of review to perform (default: full)"),
+  context: z5.string().optional().describe("Additional context about the project or constraints")
 };
 async function handlePlanReview(client2, input) {
   const { plan, review_type, context } = input;
@@ -634,6 +702,12 @@ createReviewTool(server, {
   inputSchema: planReviewSchema,
   handler: (input) => handlePlanReview(client, input)
 });
+createReviewTool(server, {
+  name: "review_git_changes",
+  description: "Review git changes (staged, unstaged, diff, or specific commit) using multiple AI models in parallel",
+  inputSchema: gitReviewSchema,
+  handler: (input) => handleGitReview(client, CODE_REVIEW_MODELS, input)
+});
 server.registerTool(
   "list_review_config",
   { description: "Show current model configuration" },

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@klitchevo/code-council",
-	"version": "0.0.7",
+	"version": "0.0.8",
 	"description": "Multi-model AI code review server using OpenRouter - get diverse perspectives from multiple LLMs in parallel",
 	"main": "dist/index.js",
 	"type": "module",