@juspay/yama 1.0.0

package/dist/utils/Logger.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Enhanced Logger utility - Optimized from both pr-police.js and pr-describe.js
+ * Provides consistent logging across all Guardian operations
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.Logger = void 0;
+exports.createLogger = createLogger;
+const chalk_1 = __importDefault(require("chalk"));
+const YAMA_BADGE = `
+⚔️ ═══════════════════════════════════════════════════════════ ⚔️
+   ██╗   ██╗ █████╗ ███╗   ███╗ █████╗ 
+   ╚██╗ ██╔╝██╔══██╗████╗ ████║██╔══██╗
+    ╚████╔╝ ███████║██╔████╔██║███████║
+     ╚██╔╝  ██╔══██║██║╚██╔╝██║██╔══██║
+      ██║   ██║  ██║██║ ╚═╝ ██║██║  ██║
+      ╚═╝   ╚═╝  ╚═╝╚═╝     ╚═╝╚═╝  ╚═╝
+⚔️ ═══════════════════════════════════════════════════════════ ⚔️
+        AI-Powered PR Automation • Enterprise Security • Code Quality Yama
+`;
+class Logger {
+    constructor(options = {}) {
+        this.options = {
+            level: "info",
+            verbose: false,
+            format: "simple",
+            colors: true,
+            ...options,
+        };
+    }
+    shouldLog(level) {
+        const levels = {
+            debug: 0,
+            info: 1,
+            warn: 2,
+            error: 3,
+        };
+        return levels[level] >= levels[this.options.level];
+    }
+    formatMessage(level, message, ...args) {
+        const timestamp = new Date().toISOString();
+        const formattedArgs = args.length > 0
+            ? ` ${args
+                .map((a) => typeof a === "object" ? JSON.stringify(a, null, 2) : String(a))
+                .join(" ")}`
+            : "";
+        switch (this.options.format) {
+            case "json":
+                return JSON.stringify({
+                    timestamp,
+                    level: level.toUpperCase(),
+                    message: message + formattedArgs,
+                    args: args.length > 0 ? args : undefined,
+                });
+            case "detailed":
+                return `[${timestamp}] [${level.toUpperCase().padEnd(5)}] ${message}${formattedArgs}`;
+            default: // simple
+                return `${message}${formattedArgs}`;
+        }
+    }
+    colorize(level, text) {
+        if (!this.options.colors) {
+            return text;
+        }
+        switch (level) {
+            case "debug":
+                return chalk_1.default.gray(text);
+            case "info":
+                return chalk_1.default.blue(text);
+            case "warn":
+                return chalk_1.default.yellow(text);
+            case "error":
+                return chalk_1.default.red(text);
+            default:
+                return text;
+        }
+    }
+    debug(message, ...args) {
+        if (!this.shouldLog("debug") || !this.options.verbose) {
+            return;
+        }
+        const formatted = this.formatMessage("debug", `🔍 ${message}`, ...args);
+        console.log(this.colorize("debug", formatted));
+    }
+    info(message, ...args) {
+        if (!this.shouldLog("info")) {
+            return;
+        }
+        const formatted = this.formatMessage("info", `ℹ️  ${message}`, ...args);
+        console.log(this.colorize("info", formatted));
+    }
+    warn(message, ...args) {
+        if (!this.shouldLog("warn")) {
+            return;
+        }
+        const formatted = this.formatMessage("warn", `⚠️  ${message}`, ...args);
+        console.warn(this.colorize("warn", formatted));
+    }
+    error(message, ...args) {
+        if (!this.shouldLog("error")) {
+            return;
+        }
+        const formatted = this.formatMessage("error", `❌ ${message}`, ...args);
+        console.error(this.colorize("error", formatted));
+    }
+    badge() {
+        console.log(chalk_1.default.cyan(YAMA_BADGE));
+    }
+    phase(message) {
+        const formatted = `\n🔄 ${message}`;
+        console.log(this.options.colors ? chalk_1.default.magenta(formatted) : formatted);
+    }
+    success(message) {
+        const formatted = `✅ ${message}`;
+        console.log(this.options.colors ? chalk_1.default.green(formatted) : formatted);
+    }
+    operation(operation, status) {
+        const emoji = status === "started" ? "🚀" : status === "completed" ? "✅" : "❌";
+        const color = status === "started" ? "blue" : status === "completed" ? "green" : "red";
+        const message = `${emoji} ${operation.toUpperCase()}: ${status}`;
+        if (this.options.colors) {
+            console.log(chalk_1.default[color](message));
+        }
+        else {
+            console.log(message);
+        }
+    }
+    violation(severity, message, file) {
+        const emoji = {
+            CRITICAL: "🚨",
+            MAJOR: "⚠️",
+            MINOR: "📝",
+            SUGGESTION: "💡",
+        }[severity] || "📋";
+        const color = {
+            CRITICAL: "red",
+            MAJOR: "yellow",
+            MINOR: "blue",
+            SUGGESTION: "cyan",
+        }[severity] || "white";
+        const location = file ? ` in ${file}` : "";
+        const formatted = `${emoji} ${severity}: ${message}${location}`;
+        if (this.options.colors) {
+            console.log(chalk_1.default[color](formatted));
+        }
+        else {
+            console.log(formatted);
+        }
+    }
+    progress(current, total, operation) {
+        const percentage = Math.round((current / total) * 100);
+        const progressBar = this.createProgressBar(percentage);
+        const message = `🔄 ${operation}: ${progressBar} ${current}/${total} (${percentage}%)`;
+        // Use carriage return to overwrite the line
+        process.stdout.write(`\r${message}`);
+        // Add newline when complete
+        if (current === total) {
+            process.stdout.write("\n");
+        }
+    }
+    createProgressBar(percentage) {
+        const width = 20;
+        const filled = Math.round((percentage / 100) * width);
+        const empty = width - filled;
+        if (this.options.colors) {
+            return chalk_1.default.green("█".repeat(filled)) + chalk_1.default.gray("░".repeat(empty));
+        }
+        else {
+            return "█".repeat(filled) + "░".repeat(empty);
+        }
+    }
+    // Method to create child logger with context
+    child(context) {
+        const childLogger = new Logger(this.options);
+        // Override methods to include context
+        const originalMethods = ["debug", "info", "warn", "error"];
+        originalMethods.forEach((method) => {
+            const original = childLogger[method].bind(childLogger);
+            childLogger[method] = (message, ...args) => {
+                const contextStr = Object.entries(context)
+                    .map(([k, v]) => `${k}=${v}`)
+                    .join(" ");
+                original(`[${contextStr}] ${message}`, ...args);
+            };
+        });
+        return childLogger;
+    }
+    // Method to update log level dynamically
+    setLevel(level) {
+        this.options.level = level;
+    }
+    // Method to toggle verbose mode
+    setVerbose(verbose) {
+        this.options.verbose = verbose;
+    }
+    // Method to get current configuration
+    getConfig() {
+        return { ...this.options };
+    }
+}
+exports.Logger = Logger;
+// Export singleton instance for convenience with environment-aware defaults
+const loggerOptions = {};
+// Check environment variables for debug mode
+if (process.env.YAMA_DEBUG === "true") {
+    loggerOptions.level = "debug";
+    loggerOptions.verbose = true;
+}
+exports.logger = new Logger(loggerOptions);
+// Export factory function
+function createLogger(options) {
+    return new Logger(options);
+}
+//# sourceMappingURL=Logger.js.map

package/package.json

@@ -0,0 +1,138 @@
+{
+  "name": "@juspay/yama",
+  "version": "1.0.0",
+  "description": "Enterprise-grade Pull Request automation toolkit with AI-powered code review and description enhancement",
+  "keywords": [
+    "pr",
+    "pull-request",
+    "code-review",
+    "ai",
+    "automation",
+    "bitbucket",
+    "github",
+    "gitlab",
+    "security",
+    "quality"
+  ],
+  "homepage": "https://github.com/juspay/yama#readme",
+  "bugs": {
+    "url": "https://github.com/juspay/yama/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/juspay/yama.git"
+  },
+  "license": "MIT",
+  "author": "Juspay Technologies <support@juspay.in> (https://juspay.io)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "yama": "dist/cli/index.js",
+    "pr-guardian": "dist/cli/index.js",
+    "pr-police": "dist/cli/index.js",
+    "pr-scribe": "dist/cli/index.js"
+  },
+  "directories": {
+    "test": "tests"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/*.spec.*",
+    "!dist/**/*.map",
+    "!dist/**/tests",
+    "!dist/**/test-*",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "yama.config.example.yaml"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias",
+    "dev": "ts-node-dev --respawn --transpile-only src/cli/index.ts",
+    "test": "jest",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "docs": "typedoc src",
+    "clean": "rimraf dist",
+    "prepare": "npm run build",
+    "prepack": "npm run build && npm run test",
+    "changeset": "changeset",
+    "changeset:version": "changeset version && git add --all",
+    "release": "npm run build && npm run test && changeset publish",
+    "release:dry": "npm publish --dry-run",
+    "release:github": "npm publish --registry https://npm.pkg.github.com",
+    "version:check": "npm version --no-git-tag-version",
+    "pack:verify": "npm pack && tar -tzf *.tgz | head -20"
+  },
+  "dependencies": {
+    "@juspay/neurolink": "^5.1.0",
+    "@nexus2520/bitbucket-mcp-server": "^0.10.0",
+    "chalk": "^4.1.2",
+    "commander": "^11.0.0",
+    "debug": "^4.3.4",
+    "dotenv": "^16.3.0",
+    "fast-glob": "^3.3.1",
+    "inquirer": "^8.2.6",
+    "lodash": "^4.17.21",
+    "node-cache": "^5.1.2",
+    "ora": "^5.4.1",
+    "yaml": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/commander": "^2.12.5",
+    "@types/inquirer": "^9.0.8",
+    "@types/jest": "^29.0.0",
+    "@types/lodash": "^4.14.0",
+    "@types/node": "^20.0.0",
+    "@eslint/js": "^9.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "jest": "^29.0.0",
+    "rimraf": "^5.0.0",
+    "ts-jest": "^29.0.0",
+    "ts-node": "^10.0.0",
+    "ts-node-dev": "^2.0.0",
+    "tsc-alias": "^1.8.0",
+    "typedoc": "^0.25.0",
+    "typescript": "^5.0.0",
+    "@changesets/changelog-github": "^0.5.1",
+    "@changesets/cli": "^2.26.2",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.0",
+    "@semantic-release/npm": "^12.0.1",
+    "@semantic-release/release-notes-generator": "^14.0.1",
+    "semantic-release": "^24.0.0",
+    "prettier": "^3.0.0",
+    "publint": "^0.3.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.5.0"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0",
+    "pnpm": ">=8.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  }
+}

package/yama.config.example.yaml

@@ -0,0 +1,143 @@
+# Yama Configuration Example
+# This file contains all available configuration options with explanations
+
+# AI Provider Configuration
+providers:
+  ai:
+    provider: "auto" # Options: auto, google-ai, openai, anthropic, azure, bedrock
+    model: "best" # Model name or "best" for auto-selection
+    temperature: 0.3 # Lower = more focused (0.0-1.0)
+    maxTokens: 2000000 # Maximum tokens for response
+    timeout: "15m" # Timeout for AI operations
+    enableAnalytics: true
+    enableEvaluation: false
+
+  # Git Platform Configuration
+  git:
+    platform: "bitbucket" # Options: bitbucket, github, gitlab, azure-devops
+    credentials:
+      username: "${BITBUCKET_USERNAME}" # Environment variable
+      token: "${BITBUCKET_TOKEN}" # Environment variable
+      baseUrl: "${BITBUCKET_BASE_URL}" # Your Bitbucket server URL
+
+# Feature Configuration
+features:
+  # Code Review Configuration
+  codeReview:
+    enabled: true
+    severityLevels: ["CRITICAL", "MAJOR", "MINOR", "SUGGESTION"]
+    categories:
+      [
+        "security",
+        "performance",
+        "maintainability",
+        "functionality",
+        "error_handling",
+      ]
+    excludePatterns:
+      - "*.lock"
+      - "*.svg"
+      - "*.png"
+      - "*.jpg"
+      - "*.gif"
+      - "*.min.js"
+      - "*.min.css"
+      - "dist/**"
+      - "build/**"
+      - "vendor/**"
+    contextLines: 3 # Lines of context around changes
+    focusAreas:
+      - "Security vulnerabilities"
+      - "Performance bottlenecks"
+      - "Error handling"
+      - "Code quality"
+
+  # Description Enhancement Configuration
+  descriptionEnhancement:
+    enabled: true
+    preserveContent: true # Always preserve existing content
+    autoFormat: true
+    requiredSections:
+      - key: "changelog"
+        name: "Changelog (Modules Modified)"
+        required: true
+      - key: "testcases"
+        name: "Test Cases (What to be tested)"
+        required: true
+      - key: "config_changes"
+        name: "CAC Config Or Service Config Changes"
+        required: true
+
+  # NEW: Diff Strategy Configuration
+  diffStrategy:
+    enabled: true
+    thresholds:
+      wholeDiffMaxFiles: 2 # Use whole diff for ≤2 files
+      fileByFileMinFiles: 3 # Use file-by-file for ≥3 files
+    # Optional: Force a specific strategy regardless of file count
+    # forceStrategy: "file-by-file"  # Options: whole, file-by-file, auto
+
+  # Security Scan Configuration (Future)
+  securityScan:
+    enabled: false
+    level: "strict" # Options: strict, moderate, basic
+    scanTypes: ["dependencies", "secrets", "vulnerabilities"]
+
+  # Analytics Configuration (Future)
+  analytics:
+    enabled: false
+    trackMetrics: true
+    exportFormat: "json" # Options: json, csv, yaml
+
+# Cache Configuration
+cache:
+  enabled: true
+  ttl: "30m" # Time to live for cache entries
+  maxSize: "100MB"
+  storage: "memory" # Options: memory, redis, file
+
+# Performance Configuration
+performance:
+  batch:
+    enabled: true
+    maxConcurrent: 5 # Max concurrent API calls
+    delayBetween: "1s" # Delay between batches
+  optimization:
+    reuseConnections: true
+    compressRequests: false
+    enableHttp2: true
+
+# Custom Rules Configuration
+rules:
+  security:
+    - name: "No hardcoded secrets"
+      pattern: "(password|secret|key)\\s*=\\s*[\"'][^\"']+[\"']"
+      severity: "CRITICAL"
+      message: "Hardcoded secrets detected"
+      suggestion: "Use environment variables or secure configuration"
+
+    - name: "SQL injection prevention"
+      pattern: "query\\([^?]+\\+.*\\)"
+      severity: "CRITICAL"
+      message: "Potential SQL injection vulnerability"
+      suggestion: "Use parameterized queries"
+
+  performance:
+    - name: "Avoid N+1 queries"
+      pattern: "forEach.*await.*query"
+      severity: "MAJOR"
+      message: "Potential N+1 query pattern detected"
+      suggestion: "Consider batch loading or joins"
+
+# Reporting Configuration
+reporting:
+  formats: ["markdown", "json"]
+  includeAnalytics: true
+  includeMetrics: true
+
+# Monitoring Configuration (Future)
+monitoring:
+  enabled: false
+  metrics: ["api_calls", "cache_hits", "processing_time"]
+  exportFormat: "prometheus"
+  interval: "1m"