@juspay/yama 1.5.1 → 2.0.0

package/dist/cli/v2.cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Yama V2 CLI - AI-Native Code Review Interface
+ * Command-line interface for autonomous AI-powered code review
+ */
+import { Command } from "commander";
+declare const program: Command;
+/**
+ * Setup V2 CLI
+ */
+export declare function setupV2CLI(): Command;
+export default program;
+//# sourceMappingURL=v2.cli.d.ts.map

package/dist/cli/v2.cli.js

@@ -0,0 +1,290 @@
+#!/usr/bin/env node
+/**
+ * Yama V2 CLI - AI-Native Code Review Interface
+ * Command-line interface for autonomous AI-powered code review
+ */
+import { Command } from "commander";
+import dotenv from "dotenv";
+import { createYamaV2 } from "../v2/core/YamaV2Orchestrator.js";
+// Load environment variables
+dotenv.config();
+const program = new Command();
+/**
+ * Setup V2 CLI
+ */
+export function setupV2CLI() {
+    program
+        .name("yama")
+        .description("Yama - AI-Native Autonomous Code Review")
+        .version("2.0.0");
+    // Global options
+    program
+        .option("-v, --verbose", "Enable verbose output")
+        .option("-c, --config <path>", "Path to configuration file")
+        .option("--dry-run", "Dry run mode - no actual changes")
+        .option("--no-banner", "Hide Yama banner");
+    // Review command
+    setupReviewCommand();
+    // Enhance description command
+    setupEnhanceCommand();
+    // Init command
+    setupInitCommand();
+    // Migrate config command
+    setupMigrateCommand();
+    return program;
+}
+/**
+ * Main review command
+ * Reviews code and enhances description in one session
+ */
+function setupReviewCommand() {
+    program
+        .command("review")
+        .description("Review code and enhance PR description (uses same AI session)")
+        .requiredOption("-w, --workspace <workspace>", "Bitbucket workspace")
+        .requiredOption("-r, --repository <repository>", "Repository name")
+        .option("-p, --pr <id>", "Pull request ID")
+        .option("-b, --branch <branch>", "Branch name (finds PR automatically)")
+        .option("--review-only", "Skip description enhancement, only review code")
+        .action(async (options) => {
+        try {
+            const globalOpts = program.opts();
+            // Validate required options
+            if (!options.pr && !options.branch) {
+                console.error("❌ Error: Either --pr or --branch must be specified");
+                process.exit(1);
+            }
+            // Parse PR ID with validation
+            let pullRequestId;
+            if (options.pr) {
+                pullRequestId = parseInt(options.pr, 10);
+                if (isNaN(pullRequestId)) {
+                    console.error(`❌ Error: Invalid PR ID "${options.pr}" (must be a number)`);
+                    process.exit(1);
+                }
+            }
+            const request = {
+                workspace: options.workspace,
+                repository: options.repository,
+                pullRequestId,
+                branch: options.branch,
+                dryRun: globalOpts.dryRun || false,
+                verbose: globalOpts.verbose || false,
+                configPath: globalOpts.config,
+            };
+            // Create orchestrator
+            const yama = createYamaV2();
+            // Initialize
+            await yama.initialize(request.configPath);
+            // Start review (with or without description enhancement)
+            console.log("🚀 Starting autonomous AI review...\n");
+            const result = options.reviewOnly
+                ? await yama.startReview(request)
+                : await yama.startReviewAndEnhance(request);
+            // Show results
+            console.log("\n📊 Review Results:");
+            console.log(`   Decision: ${result.decision}`);
+            console.log(`   Files Reviewed: ${result.statistics.filesReviewed}`);
+            console.log(`   Total Comments: ${result.totalComments || result.statistics.totalComments || 0}`);
+            if (result.descriptionEnhanced !== undefined) {
+                console.log(`   Description Enhanced: ${result.descriptionEnhanced ? "✅ Yes" : "⏭️  Skipped"}`);
+            }
+            console.log(`   Duration: ${Math.round(result.duration / 1000)}s`);
+            console.log(`   Token Usage: ${result.tokenUsage.total.toLocaleString()} tokens`);
+            if (globalOpts.verbose) {
+                console.log("\n📄 Full Results:");
+                console.log(JSON.stringify(result, null, 2));
+            }
+            // Exit with appropriate code
+            if (result.decision === "BLOCKED") {
+                process.exit(1);
+            }
+            else {
+                process.exit(0);
+            }
+        }
+        catch (error) {
+            console.error("\n❌ Review failed:", error.message);
+            if (error.stack && program.opts().verbose) {
+                console.error("\nStack trace:");
+                console.error(error.stack);
+            }
+            process.exit(1);
+        }
+    });
+}
+/**
+ * Enhance description command
+ */
+function setupEnhanceCommand() {
+    program
+        .command("enhance")
+        .description("Enhance PR description using AI (without full review)")
+        .requiredOption("-w, --workspace <workspace>", "Bitbucket workspace")
+        .requiredOption("-r, --repository <repository>", "Repository name")
+        .option("-p, --pr <id>", "Pull request ID")
+        .option("-b, --branch <branch>", "Branch name")
+        .action(async (options) => {
+        try {
+            const globalOpts = program.opts();
+            if (!options.pr && !options.branch) {
+                console.error("❌ Error: Either --pr or --branch must be specified");
+                process.exit(1);
+            }
+            // Parse PR ID with validation
+            let pullRequestId;
+            if (options.pr) {
+                pullRequestId = parseInt(options.pr, 10);
+                if (isNaN(pullRequestId)) {
+                    console.error(`❌ Error: Invalid PR ID "${options.pr}" (must be a number)`);
+                    process.exit(1);
+                }
+            }
+            const request = {
+                workspace: options.workspace,
+                repository: options.repository,
+                pullRequestId,
+                branch: options.branch,
+                dryRun: globalOpts.dryRun || false,
+                verbose: globalOpts.verbose || false,
+                configPath: globalOpts.config,
+            };
+            const yama = createYamaV2();
+            await yama.initialize(request.configPath);
+            const result = await yama.enhanceDescription(request);
+            console.log("\n✅ Description enhanced successfully");
+            console.log(JSON.stringify(result, null, 2));
+            process.exit(0);
+        }
+        catch (error) {
+            console.error("\n❌ Enhancement failed:", error.message);
+            process.exit(1);
+        }
+    });
+}
+/**
+ * Initialize configuration command
+ */
+function setupInitCommand() {
+    program
+        .command("init")
+        .description("Initialize Yama configuration")
+        .option("--interactive", "Interactive configuration setup")
+        .action(async (options) => {
+        try {
+            console.log("\n⚔️  Yama Configuration Setup\n");
+            if (options.interactive) {
+                console.log("Interactive setup not yet implemented.");
+                console.log("Please copy yama.config.example.yaml to yama.config.yaml");
+                console.log("and edit it manually.\n");
+            }
+            else {
+                console.log("Creating default configuration file...\n");
+                const fs = await import("fs/promises");
+                const path = await import("path");
+                // Check if config already exists
+                if (await fs
+                    .access("yama.config.yaml")
+                    .then(() => true)
+                    .catch(() => false)) {
+                    console.log("❌ yama.config.yaml already exists");
+                    console.log("   Remove it first or use a different location\n");
+                    process.exit(1);
+                }
+                // Copy example config
+                const examplePath = path.join(process.cwd(), "yama.config.example.yaml");
+                const targetPath = path.join(process.cwd(), "yama.config.yaml");
+                if (await fs
+                    .access(examplePath)
+                    .then(() => true)
+                    .catch(() => false)) {
+                    await fs.copyFile(examplePath, targetPath);
+                    console.log("✅ Created yama.config.yaml from example");
+                }
+                else {
+                    console.log("⚠️  Example config not found, creating minimal config...");
+                    await fs.writeFile(targetPath, `version: 2
+configType: "yama-v2"
+
+ai:
+  provider: "auto"
+  model: "gemini-2.5-pro"
+
+mcpServers:
+  jira:
+    enabled: false
+
+review:
+  enabled: true
+
+descriptionEnhancement:
+  enabled: true
+`);
+                    console.log("✅ Created minimal yama.config.yaml");
+                }
+                console.log("\n📝 Next steps:");
+                console.log("   1. Edit yama.config.yaml with your settings");
+                console.log("   2. Set environment variables (BITBUCKET_*, JIRA_*)");
+                console.log("   3. Run: yama review --help\n");
+            }
+            process.exit(0);
+        }
+        catch (error) {
+            console.error("\n❌ Initialization failed:", error.message);
+            process.exit(1);
+        }
+    });
+}
+/**
+ * Migrate V1 config to V2 format
+ */
+function setupMigrateCommand() {
+    program
+        .command("migrate-config")
+        .description("Migrate V1 configuration to V2 format")
+        .option("-i, --input <file>", "Input V1 config file", "yama.v1.config.yaml")
+        .option("-o, --output <file>", "Output V2 config file", "yama.config.yaml")
+        .option("--force", "Overwrite existing output file")
+        .action(async (options) => {
+        try {
+            const globalOpts = program.opts();
+            console.log("\n🔄 Yama V1 → V2 Configuration Migration\n");
+            // Use child_process to run the migration script
+            const { spawn } = await import("child_process");
+            const path = await import("path");
+            const { fileURLToPath } = await import("url");
+            const __filename = fileURLToPath(import.meta.url);
+            const __dirname = path.dirname(__filename);
+            const scriptPath = path.resolve(__dirname, "../../scripts/migrate-config.cjs");
+            const args = ["--input", options.input, "--output", options.output];
+            if (options.force) {
+                args.push("--force");
+            }
+            if (globalOpts.dryRun) {
+                args.push("--dry-run");
+            }
+            const child = spawn("node", [scriptPath, ...args], {
+                stdio: "inherit",
+                cwd: process.cwd(),
+            });
+            child.on("close", (code) => {
+                process.exit(code || 0);
+            });
+            child.on("error", (err) => {
+                console.error("❌ Failed to run migration script:", err.message);
+                process.exit(1);
+            });
+        }
+        catch (error) {
+            console.error("\n❌ Migration failed:", error.message);
+            process.exit(1);
+        }
+    });
+}
+// Only run if this is the main module
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const cli = setupV2CLI();
+    cli.parse(process.argv);
+}
+export default program;
+//# sourceMappingURL=v2.cli.js.map

package/dist/index.d.ts

@@ -1,16 +1,15 @@
 /**
- * Yama - Main package exports
- * Provides both programmatic API and CLI access
+ * Yama - AI-Native Code Review
+ * Main export file
  */
-export { Guardian, createGuardian, guardian } from "./core/Guardian.js";
-export { ContextGatherer, createContextGatherer } from "./core/ContextGatherer.js";
-export type { UnifiedContext, ProjectContext, DiffStrategy, } from "./core/ContextGatherer.js";
-export { BitbucketProvider, createBitbucketProvider, } from "./core/providers/BitbucketProvider.js";
-export { CodeReviewer, createCodeReviewer } from "./features/CodeReviewer.js";
-export { DescriptionEnhancer, createDescriptionEnhancer, } from "./features/DescriptionEnhancer.js";
-export { Logger, createLogger, logger } from "./utils/Logger.js";
-export { Cache, createCache, cache } from "./utils/Cache.js";
-export { ConfigManager, createConfigManager, configManager, } from "./utils/ConfigManager.js";
-export * from "./types/index.js";
-export { main as cli } from "./cli/index.js";
+export { YamaV2Orchestrator, createYamaV2, } from "./v2/core/YamaV2Orchestrator.js";
+export { ConfigLoader } from "./v2/config/ConfigLoader.js";
+export { MCPServerManager } from "./v2/core/MCPServerManager.js";
+export { SessionManager } from "./v2/core/SessionManager.js";
+export { PromptBuilder } from "./v2/prompts/PromptBuilder.js";
+export type { ReviewRequest, ReviewResult, ReviewUpdate, ReviewSession, ReviewStatistics, IssuesBySeverity, TokenUsage, } from "./v2/types/v2.types.js";
+export type { YamaV2Config, AIConfig, MCPServersConfig, ReviewConfig, DescriptionEnhancementConfig, } from "./v2/types/config.types.js";
+export type { GetPullRequestResponse, GetPullRequestDiffResponse, GetIssueResponse, SearchCodeResponse, } from "./v2/types/mcp.types.js";
+export declare const VERSION = "2.0.0";
+export { createYamaV2 as default } from "./v2/core/YamaV2Orchestrator.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,22 +1,21 @@
 /**
- * Yama - Main package exports
- * Provides both programmatic API and CLI access
+ * Yama - AI-Native Code Review
+ * Main export file
  */
-// Core classes
-export { Guardian, createGuardian, guardian } from "./core/Guardian.js";
-export { ContextGatherer, createContextGatherer } from "./core/ContextGatherer.js";
-// Providers
-export { BitbucketProvider, createBitbucketProvider, } from "./core/providers/BitbucketProvider.js";
-// Features
-export { CodeReviewer, createCodeReviewer } from "./features/CodeReviewer.js";
-export { DescriptionEnhancer, createDescriptionEnhancer, } from "./features/DescriptionEnhancer.js";
-// Utilities
-export { Logger, createLogger, logger } from "./utils/Logger.js";
-export { Cache, createCache, cache } from "./utils/Cache.js";
-export { ConfigManager, createConfigManager, configManager, } from "./utils/ConfigManager.js";
-// Types
-export * from "./types/index.js";
-// CLI
-export { main as cli } from "./cli/index.js";
-// Note: Use named import { Guardian } from '@juspay/yama' instead
+// ============================================================================
+// Core Exports
+// ============================================================================
+export { YamaV2Orchestrator, createYamaV2, } from "./v2/core/YamaV2Orchestrator.js";
+export { ConfigLoader } from "./v2/config/ConfigLoader.js";
+export { MCPServerManager } from "./v2/core/MCPServerManager.js";
+export { SessionManager } from "./v2/core/SessionManager.js";
+export { PromptBuilder } from "./v2/prompts/PromptBuilder.js";
+// ============================================================================
+// Version Information
+// ============================================================================
+export const VERSION = "2.0.0";
+// ============================================================================
+// Default Export
+// ============================================================================
+export { createYamaV2 as default } from "./v2/core/YamaV2Orchestrator.js";
 //# sourceMappingURL=index.js.map

package/dist/v2/config/ConfigLoader.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Multi-Layer Configuration Loader for Yama V2
+ * Loads and merges configuration from multiple sources
+ */
+import { YamaV2Config } from "../types/config.types.js";
+export declare class ConfigLoader {
+    private config;
+    private configPath;
+    /**
+     * Load configuration from file with multi-layer support
+     */
+    loadConfig(configPath?: string): Promise<YamaV2Config>;
+    /**
+     * Get current loaded configuration
+     */
+    getConfig(): YamaV2Config;
+    /**
+     * Validate configuration completeness and correctness
+     */
+    validate(): Promise<void>;
+    /**
+     * Resolve configuration file path
+     */
+    private resolveConfigPath;
+    /**
+     * Load configuration from YAML file
+     */
+    private loadConfigFile;
+    /**
+     * Deep merge two configuration objects
+     */
+    private mergeConfigs;
+    /**
+     * Deep merge utility
+     */
+    private deepMerge;
+    /**
+     * Check if value is an object
+     */
+    private isObject;
+    /**
+     * Apply environment variable overrides
+     */
+    private applyEnvironmentOverrides;
+    /**
+     * Basic configuration validation
+     */
+    private validateConfig;
+}
+//# sourceMappingURL=ConfigLoader.d.ts.map

package/dist/v2/config/ConfigLoader.js

@@ -0,0 +1,205 @@
+/**
+ * Multi-Layer Configuration Loader for Yama V2
+ * Loads and merges configuration from multiple sources
+ */
+import { readFile } from "fs/promises";
+import { existsSync } from "fs";
+import { parse as parseYAML } from "yaml";
+import { resolve } from "path";
+import { ConfigurationError } from "../types/v2.types.js";
+import { DefaultConfig } from "./DefaultConfig.js";
+export class ConfigLoader {
+    config = null;
+    configPath = null;
+    /**
+     * Load configuration from file with multi-layer support
+     */
+    async loadConfig(configPath) {
+        console.log("📋 Loading Yama V2 configuration...");
+        // Layer 1: Start with default config
+        let config = DefaultConfig.get();
+        // Layer 2: Load from file if provided or search for default locations
+        const filePath = await this.resolveConfigPath(configPath);
+        if (filePath) {
+            console.log(`   Reading config from: ${filePath}`);
+            const fileConfig = await this.loadConfigFile(filePath);
+            config = this.mergeConfigs(config, fileConfig);
+            this.configPath = filePath;
+        }
+        else {
+            console.log("   Using default configuration (no config file found)");
+        }
+        // Layer 3: Apply environment variable overrides
+        config = this.applyEnvironmentOverrides(config);
+        // Validate configuration
+        this.validateConfig(config);
+        this.config = config;
+        console.log("✅ Configuration loaded successfully\n");
+        return config;
+    }
+    /**
+     * Get current loaded configuration
+     */
+    getConfig() {
+        if (!this.config) {
+            throw new ConfigurationError("Configuration not loaded. Call loadConfig() first.");
+        }
+        return this.config;
+    }
+    /**
+     * Validate configuration completeness and correctness
+     */
+    async validate() {
+        if (!this.config) {
+            throw new ConfigurationError("No configuration to validate");
+        }
+        const errors = [];
+        // Validate AI config
+        if (!this.config.ai.provider) {
+            errors.push("AI provider not configured");
+        }
+        if (!this.config.ai.model) {
+            errors.push("AI model not configured");
+        }
+        // Check environment variables for Bitbucket (always required)
+        if (!process.env.BITBUCKET_USERNAME) {
+            errors.push("BITBUCKET_USERNAME environment variable not set");
+        }
+        if (!process.env.BITBUCKET_TOKEN) {
+            errors.push("BITBUCKET_TOKEN environment variable not set");
+        }
+        if (!process.env.BITBUCKET_BASE_URL) {
+            errors.push("BITBUCKET_BASE_URL environment variable not set");
+        }
+        if (this.config.mcpServers.jira.enabled) {
+            if (!process.env.JIRA_EMAIL) {
+                errors.push("JIRA_EMAIL environment variable not set");
+            }
+            if (!process.env.JIRA_API_TOKEN) {
+                errors.push("JIRA_API_TOKEN environment variable not set");
+            }
+            if (!process.env.JIRA_BASE_URL) {
+                errors.push("JIRA_BASE_URL environment variable not set");
+            }
+        }
+        if (errors.length > 0) {
+            throw new ConfigurationError(`Configuration validation failed:\n${errors.map((e) => `  - ${e}`).join("\n")}`);
+        }
+    }
+    /**
+     * Resolve configuration file path
+     */
+    async resolveConfigPath(configPath) {
+        // If explicit path provided, use it
+        if (configPath) {
+            const resolvedPath = resolve(configPath);
+            if (!existsSync(resolvedPath)) {
+                throw new ConfigurationError(`Configuration file not found: ${resolvedPath}`);
+            }
+            return resolvedPath;
+        }
+        // Search for default config files
+        const defaultPaths = [
+            "yama.config.yaml",
+            "config/yama.config.yaml",
+            ".yama/config.yaml",
+        ];
+        for (const path of defaultPaths) {
+            const resolvedPath = resolve(path);
+            if (existsSync(resolvedPath)) {
+                return resolvedPath;
+            }
+        }
+        return null;
+    }
+    /**
+     * Load configuration from YAML file
+     */
+    async loadConfigFile(filePath) {
+        try {
+            const content = await readFile(filePath, "utf-8");
+            const parsed = parseYAML(content);
+            return parsed;
+        }
+        catch (error) {
+            throw new ConfigurationError(`Failed to load config file: ${error.message}`, { filePath });
+        }
+    }
+    /**
+     * Deep merge two configuration objects
+     */
+    mergeConfigs(base, override) {
+        return this.deepMerge(base, override);
+    }
+    /**
+     * Deep merge utility
+     */
+    deepMerge(target, source) {
+        const output = { ...target };
+        if (this.isObject(target) && this.isObject(source)) {
+            Object.keys(source).forEach((key) => {
+                if (this.isObject(source[key])) {
+                    if (!(key in target)) {
+                        Object.assign(output, { [key]: source[key] });
+                    }
+                    else {
+                        output[key] = this.deepMerge(target[key], source[key]);
+                    }
+                }
+                else {
+                    Object.assign(output, { [key]: source[key] });
+                }
+            });
+        }
+        return output;
+    }
+    /**
+     * Check if value is an object
+     */
+    isObject(item) {
+        return item && typeof item === "object" && !Array.isArray(item);
+    }
+    /**
+     * Apply environment variable overrides
+     */
+    applyEnvironmentOverrides(config) {
+        // Override AI provider if env var set
+        if (process.env.AI_PROVIDER) {
+            config.ai.provider = process.env.AI_PROVIDER;
+        }
+        // Override AI model if env var set
+        if (process.env.AI_MODEL) {
+            config.ai.model = process.env.AI_MODEL;
+        }
+        // Override temperature if env var set
+        if (process.env.AI_TEMPERATURE) {
+            config.ai.temperature = parseFloat(process.env.AI_TEMPERATURE);
+        }
+        // Override max tokens if env var set
+        if (process.env.AI_MAX_TOKENS) {
+            config.ai.maxTokens = parseInt(process.env.AI_MAX_TOKENS, 10);
+        }
+        return config;
+    }
+    /**
+     * Basic configuration validation
+     */
+    validateConfig(config) {
+        if (!config.version) {
+            throw new ConfigurationError("Configuration version not specified");
+        }
+        if (config.version !== 2) {
+            throw new ConfigurationError(`Invalid configuration version: ${config.version}. Expected version 2.`);
+        }
+        if (!config.ai) {
+            throw new ConfigurationError("AI configuration missing");
+        }
+        if (!config.mcpServers) {
+            throw new ConfigurationError("MCP servers configuration missing");
+        }
+        if (!config.review) {
+            throw new ConfigurationError("Review configuration missing");
+        }
+    }
+}
+//# sourceMappingURL=ConfigLoader.js.map

package/dist/v2/config/DefaultConfig.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Default Configuration for Yama V2
+ * Provides sensible defaults when no config file is present
+ */
+import { YamaV2Config } from "../types/config.types.js";
+export declare class DefaultConfig {
+    static get(): YamaV2Config;
+}
+//# sourceMappingURL=DefaultConfig.d.ts.map