@juspay/yama 1.6.0 → 2.1.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,359 @@
+#!/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";
+import { createLearningOrchestrator } from "../v2/core/LearningOrchestrator.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();
+    // Learn from PR feedback command
+    setupLearnCommand();
+    // 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);
+        }
+    });
+}
+/**
+ * Learn from PR feedback command
+ * Extracts learnings from merged PRs to improve future reviews
+ */
+function setupLearnCommand() {
+    program
+        .command("learn")
+        .description("Extract learnings from merged PR to improve future reviews")
+        .requiredOption("-w, --workspace <workspace>", "Bitbucket workspace")
+        .requiredOption("-r, --repository <repository>", "Repository name")
+        .requiredOption("-p, --pr <id>", "Merged pull request ID")
+        .option("--commit", "Auto-commit knowledge base changes to git")
+        .option("--summarize", "Force summarization of knowledge base")
+        .option("--output <path>", "Override knowledge base output path")
+        .option("--format <format>", "Output format for dry-run preview (md|json)", "md")
+        .action(async (options) => {
+        try {
+            const globalOpts = program.opts();
+            // Parse and validate PR ID
+            const pullRequestId = parseInt(options.pr, 10);
+            if (isNaN(pullRequestId)) {
+                console.error(`❌ Error: Invalid PR ID "${options.pr}" (must be a number)`);
+                process.exit(1);
+            }
+            // Validate format option
+            if (options.format && !["md", "json"].includes(options.format)) {
+                console.error(`❌ Error: Invalid format "${options.format}" (must be md or json)`);
+                process.exit(1);
+            }
+            const request = {
+                workspace: options.workspace,
+                repository: options.repository,
+                pullRequestId,
+                dryRun: globalOpts.dryRun || false,
+                commit: options.commit || false,
+                summarize: options.summarize || false,
+                outputPath: options.output,
+                outputFormat: options.format || "md",
+            };
+            // Create and initialize learning orchestrator
+            const orchestrator = createLearningOrchestrator();
+            await orchestrator.initialize(globalOpts.config);
+            // Extract learnings
+            const result = await orchestrator.extractLearnings(request);
+            // Handle result
+            if (!result.success) {
+                console.error(`\n❌ Learning extraction failed: ${result.error}`);
+                process.exit(1);
+            }
+            // Show final summary for live runs
+            if (!globalOpts.dryRun && result.learningsAdded > 0) {
+                console.log("\n🎉 Knowledge base updated successfully!");
+                console.log(`   Use 'yama review' to apply these learnings to future reviews.`);
+            }
+            process.exit(0);
+        }
+        catch (error) {
+            console.error("\n❌ Learning extraction failed:", error.message);
+            if (error.stack && program.opts().verbose) {
+                console.error("\nStack trace:");
+                console.error(error.stack);
+            }
+            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