jstar-reviewer 2.0.3 → 2.1.0

package/scripts/config.ts

@@ -1,14 +1,53 @@
 import dotenv from "dotenv";
+import * as fs from "fs";
+import * as path from "path";
 import { Severity } from "./types";
 
+// --- Auto-Setup Logic ---
+const REQUIRED_ENV_VARS = {
+    'GOOGLE_API_KEY': '# Required: Google API key for Gemini embeddings\nGOOGLE_API_KEY=your_google_api_key_here',
+    'GROQ_API_KEY': '# Required: Groq API key for LLM reviews\nGROQ_API_KEY=your_groq_api_key_here',
+    'REVIEW_MODEL_NAME': '# Optional: Override the default model\n# REVIEW_MODEL_NAME=moonshotai/kimi-k2-instruct-0905'
+};
+
+function ensureSetup() {
+    const cwd = process.cwd();
+    const jstarDir = path.join(cwd, ".jstar");
+    const envExamplePath = path.join(cwd, ".env.example");
+
+    // 1. Ensure .jstar exists
+    if (!fs.existsSync(jstarDir)) {
+        fs.mkdirSync(jstarDir, { recursive: true });
+    }
+
+    // 2. Ensure .env.example is up to date
+    if (fs.existsSync(envExamplePath)) {
+        let content = fs.readFileSync(envExamplePath, 'utf-8');
+        let missing = false;
+        for (const [key, template] of Object.entries(REQUIRED_ENV_VARS)) {
+            if (!content.includes(key)) {
+                content += `\n${template}\n`;
+                missing = true;
+            }
+        }
+        if (missing) {
+            fs.writeFileSync(envExamplePath, content);
+        }
+    } else {
+        const initialEnv = "# J-Star Code Reviewer\n" + Object.values(REQUIRED_ENV_VARS).join("\n") + "\n";
+        fs.writeFileSync(envExamplePath, initialEnv);
+    }
+}
+
+// Run setup check
+ensureSetup();
+
 // Load .env.local first, then .env
 dotenv.config({ path: ".env.local" });
 dotenv.config();
 
 /**
  * Default fallback values.
- * These are intentional fallbacks when environment variables are not configured.
- * Override via REVIEW_MODEL_NAME env var for production use.
  */
 const DEFAULT_MODEL = "moonshotai/kimi-k2-instruct-0905";
 
@@ -19,3 +58,4 @@ export const Config = {
         MEDIUM: 5
     }
 };
+

package/scripts/indexer.ts

@@ -9,28 +9,26 @@ import { MockLLM } from "./mock-llm";
 import * as path from "path";
 import * as fs from "fs";
 import chalk from "chalk";
-import dotenv from "dotenv";
-
-// Load .env.local first, then .env
-dotenv.config({ path: ".env.local" });
-dotenv.config();
+import { Config } from "./config";
 
 // Configuration
 const STORAGE_DIR = path.join(process.cwd(), ".jstar", "storage");
 const SOURCE_DIR = path.join(process.cwd(), "scripts"); // Changed from src/ to scripts/
 
-// Ensure OpenAI Key exists (LlamaIndex default) or fallback if we configured something else
-// (We are using local now, so this check is less critical, but good to have if we revert)
-// if (!process.env.OPENAI_API_KEY) {
-//     console.warn(chalk.yellow("⚠️  OPENAI_API_KEY not found. Embeddings may fail unless you have configured a local model."));
-// }
-
 async function main() {
+    // 0. Environment Validation
+    if (!process.env.GOOGLE_API_KEY) {
+        console.error(chalk.red("❌ Missing GOOGLE_API_KEY!"));
+        console.log(chalk.yellow("\nPlease ensure you have a .env.local file. Check .env.example for a template.\n"));
+        process.exit(1);
+    }
+
     const args = process.argv.slice(2);
     const isWatch = args.includes("--watch");
 
     console.log(chalk.blue("🧠 J-Star Indexer: Scanning codebase..."));
 
+
     // 1. Load documents (Your Code)
     if (!fs.existsSync(SOURCE_DIR)) {
         console.error(chalk.red(`❌ Source directory not found: ${SOURCE_DIR}`));

package/scripts/reviewer.ts

@@ -109,8 +109,19 @@ function parseReviewResponse(text: string): LLMReviewResponse {
 async function main() {
     console.log(chalk.blue("🕵️  J-Star Reviewer: Analyzing your changes...\n"));
 
-    // 0. Detective
+    // 0. Environment Validation
+    if (!process.env.GOOGLE_API_KEY || !process.env.GROQ_API_KEY) {
+        console.error(chalk.red("❌ Missing API Keys!"));
+        console.log(chalk.yellow("\nPlease ensure you have a .env.local file with:"));
+        console.log(chalk.white("- GOOGLE_API_KEY"));
+        console.log(chalk.white("- GROQ_API_KEY"));
+        console.log(chalk.white("\nCheck .env.example for a template.\n"));
+        return;
+    }
+
+    // 1. Detective
     console.log(chalk.blue("🔎 Running Detective Engine..."));
+
     const detective = new Detective(SOURCE_DIR);
     await detective.scan();
     detective.report();

package/setup.js

@@ -115,7 +115,7 @@ async function main() {
 
     // HARDCODED: Tagged release URL - NOT configurable for security
     // To update, modify this constant and publish a new version of setup.js
-    const BASE_URL = 'https://raw.githubusercontent.com/JStaRFilms/jstar-code-review/v2.0.0';
+    const BASE_URL = 'https://raw.githubusercontent.com/JStaRFilms/jstar-code-review/v2.1.0';
 
     // Validate URL matches our exact expected pattern (defense in depth)
     function isValidUrl(url) {