@juspay/yama 1.6.0 → 2.1.0

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

@@ -0,0 +1,141 @@
+/**
+ * Yama V2 Configuration Type Definitions
+ */
+import { FocusArea, BlockingCriteria } from "./v2.types.js";
+export interface YamaV2Config {
+    version: number;
+    configType: string;
+    display: DisplayConfig;
+    ai: AIConfig;
+    mcpServers: MCPServersConfig;
+    review: ReviewConfig;
+    descriptionEnhancement: DescriptionEnhancementConfig;
+    memoryBank: MemoryBankConfig;
+    knowledgeBase: KnowledgeBaseConfig;
+    projectStandards?: ProjectStandardsConfig;
+    monitoring: MonitoringConfig;
+    performance: PerformanceConfig;
+}
+export interface DisplayConfig {
+    showBanner: boolean;
+    streamingMode: boolean;
+    verboseToolCalls: boolean;
+    showAIThinking: boolean;
+}
+export interface AIConfig {
+    provider: "auto" | "google-ai" | "anthropic" | "openai" | "bedrock" | "azure";
+    model: string;
+    temperature: number;
+    maxTokens: number;
+    enableAnalytics: boolean;
+    enableEvaluation: boolean;
+    timeout: string;
+    retryAttempts: number;
+    conversationMemory: ConversationMemoryConfig;
+}
+export interface ConversationMemoryConfig {
+    enabled: boolean;
+    store: "memory" | "redis";
+    maxSessions: number;
+    maxTurnsPerSession: number;
+    enableSummarization: boolean;
+    redis?: RedisConfig;
+}
+export interface RedisConfig {
+    host: string;
+    port: number;
+    password?: string;
+    keyPrefix?: string;
+    ttl?: number;
+}
+export interface MCPServersConfig {
+    bitbucket?: {
+        /** List of tool names to block from Bitbucket MCP server */
+        blockedTools?: string[];
+    };
+    jira: {
+        enabled: boolean;
+        /** List of tool names to block from Jira MCP server */
+        blockedTools?: string[];
+    };
+}
+export interface ReviewConfig {
+    enabled: boolean;
+    workflowInstructions: string;
+    focusAreas: FocusArea[];
+    blockingCriteria?: BlockingCriteria[];
+    excludePatterns: string[];
+    contextLines: number;
+    maxFilesPerReview: number;
+    fileAnalysisTimeout: string;
+    toolPreferences: ToolPreferencesConfig;
+}
+export interface ToolPreferencesConfig {
+    lazyLoading: boolean;
+    cacheToolResults: boolean;
+    parallelToolCalls: boolean;
+    maxToolCallsPerFile: number;
+    enableCodeSearch: boolean;
+    enableDirectoryListing: boolean;
+}
+export interface DescriptionEnhancementConfig {
+    enabled: boolean;
+    instructions: string;
+    requiredSections: RequiredSection[];
+    preserveContent: boolean;
+    autoFormat: boolean;
+}
+export interface RequiredSection {
+    key: string;
+    name: string;
+    required: boolean;
+    description: string;
+}
+export interface MemoryBankConfig {
+    enabled: boolean;
+    path: string;
+    fallbackPaths: string[];
+    standardFiles?: string[];
+}
+export interface KnowledgeBaseConfig {
+    /** Enable knowledge base feature */
+    enabled: boolean;
+    /** Path to knowledge base file (relative to project root) */
+    path: string;
+    /** Patterns to identify AI comment authors (case-insensitive) */
+    aiAuthorPatterns: string[];
+    /** Number of learnings before auto-summarization triggers */
+    maxEntriesBeforeSummarization: number;
+    /** Number of entries to retain after summarization */
+    summaryRetentionCount: number;
+    /** Auto-commit knowledge base changes (default for --commit flag) */
+    autoCommit: boolean;
+}
+export interface ProjectStandardsConfig {
+    customPromptsPath: string;
+    additionalFocusAreas: FocusArea[];
+    customBlockingRules: BlockingCriteria[];
+    severityOverrides: Record<string, string>;
+}
+export interface MonitoringConfig {
+    enabled: boolean;
+    logToolCalls: boolean;
+    logAIDecisions: boolean;
+    logTokenUsage: boolean;
+    exportFormat: "json" | "csv";
+    exportPath: string;
+}
+export interface PerformanceConfig {
+    maxReviewDuration: string;
+    tokenBudget: TokenBudgetConfig;
+    costControls: CostControlsConfig;
+}
+export interface TokenBudgetConfig {
+    maxTokensPerReview: number;
+    warningThreshold: number;
+}
+export interface CostControlsConfig {
+    maxCostPerReview: number;
+    warningThreshold: number;
+}
+//# sourceMappingURL=config.types.d.ts.map

package/dist/v2/types/config.types.js

@@ -0,0 +1,5 @@
+/**
+ * Yama V2 Configuration Type Definitions
+ */
+export {};
+//# sourceMappingURL=config.types.js.map

package/dist/v2/types/mcp.types.d.ts

@@ -0,0 +1,191 @@
+/**
+ * MCP Tool Response Type Definitions
+ * Types for Bitbucket and Jira MCP tool responses
+ */
+export interface MCPStatus {
+    totalServers: number;
+    totalTools: number;
+    servers: MCPServerStatus[];
+}
+export interface MCPServerStatus {
+    id: string;
+    connected: boolean;
+    tools: string[];
+    lastHealthCheck?: Date;
+    error?: string;
+}
+export interface GetPullRequestResponse {
+    id: number;
+    title: string;
+    description: string;
+    author: {
+        name: string;
+        displayName: string;
+        emailAddress?: string;
+    };
+    state: "OPEN" | "MERGED" | "DECLINED";
+    source: {
+        branch: {
+            name: string;
+        };
+        commit: {
+            id: string;
+        };
+    };
+    destination: {
+        branch: {
+            name: string;
+        };
+        commit: {
+            id: string;
+        };
+    };
+    createdDate: string;
+    updatedDate: string;
+    reviewers: Reviewer[];
+    active_comments?: Comment[];
+    file_changes?: FileChange[];
+}
+export interface Reviewer {
+    user: {
+        name: string;
+        displayName: string;
+        emailAddress?: string;
+    };
+    approved: boolean;
+    status: "APPROVED" | "UNAPPROVED" | "NEEDS_WORK";
+}
+export interface Comment {
+    id: number;
+    text: string;
+    author: {
+        name: string;
+        displayName: string;
+    };
+    createdDate: string;
+    updatedDate: string;
+    anchor?: CommentAnchor;
+}
+export interface CommentAnchor {
+    filePath: string;
+    lineFrom: number;
+    lineTo: number;
+    lineType: "ADDED" | "REMOVED" | "CONTEXT";
+}
+export interface FileChange {
+    path: string;
+    file?: string;
+    type: "ADD" | "MODIFY" | "DELETE" | "RENAME";
+}
+export interface GetPullRequestDiffResponse {
+    diff: string;
+    file_changes?: FileChange[];
+    additions?: number;
+    deletions?: number;
+}
+export interface AddCommentRequest {
+    workspace: string;
+    repository: string;
+    pull_request_id: number;
+    comment_text: string;
+    file_path?: string;
+    code_snippet?: string;
+    line_number?: number;
+    line_type?: "ADDED" | "REMOVED" | "CONTEXT";
+    parent_comment_id?: number;
+}
+export interface AddCommentResponse {
+    id: number;
+    text: string;
+    author: string;
+    createdDate: string;
+    anchor?: CommentAnchor;
+}
+export interface UpdatePullRequestRequest {
+    workspace: string;
+    repository: string;
+    pull_request_id: number;
+    title?: string;
+    description?: string;
+    reviewers?: string[];
+}
+export interface GetFileContentResponse {
+    content: string;
+    path: string;
+    size: number;
+    encoding?: string;
+}
+export interface ListDirectoryContentResponse {
+    path: string;
+    items: DirectoryItem[];
+}
+export interface DirectoryItem {
+    type: "file" | "directory";
+    path: string;
+    name: string;
+    size?: number;
+}
+export interface SearchCodeResponse {
+    results: SearchResult[];
+    totalCount: number;
+}
+export interface SearchResult {
+    file: string;
+    line: number;
+    content: string;
+    matches: string[];
+}
+export interface GetIssueResponse {
+    key: string;
+    id: string;
+    summary: string;
+    description: string;
+    status: {
+        name: string;
+        category: string;
+    };
+    issueType: {
+        name: string;
+        description: string;
+    };
+    priority: {
+        name: string;
+    };
+    assignee?: {
+        displayName: string;
+        emailAddress: string;
+    };
+    reporter: {
+        displayName: string;
+        emailAddress: string;
+    };
+    created: string;
+    updated: string;
+    customFields?: Record<string, any>;
+}
+export interface SearchIssuesRequest {
+    jql: string;
+    maxResults?: number;
+    startAt?: number;
+}
+export interface SearchIssuesResponse {
+    issues: GetIssueResponse[];
+    total: number;
+    startAt: number;
+    maxResults: number;
+}
+export interface GetIssueCommentsResponse {
+    comments: JiraComment[];
+    total: number;
+}
+export interface JiraComment {
+    id: string;
+    author: {
+        displayName: string;
+        emailAddress: string;
+    };
+    body: string;
+    created: string;
+    updated: string;
+}
+//# sourceMappingURL=mcp.types.d.ts.map

package/dist/v2/types/mcp.types.js

@@ -0,0 +1,6 @@
+/**
+ * MCP Tool Response Type Definitions
+ * Types for Bitbucket and Jira MCP tool responses
+ */
+export {};
+//# sourceMappingURL=mcp.types.js.map

package/dist/v2/types/v2.types.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Yama V2 TypeScript Type Definitions
+ * AI-Native MCP Architecture Types
+ */
+export interface ReviewRequest {
+    workspace: string;
+    repository: string;
+    pullRequestId?: number;
+    branch?: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+    configPath?: string;
+}
+export interface ReviewResult {
+    prId: number;
+    decision: "APPROVED" | "CHANGES_REQUESTED" | "BLOCKED";
+    statistics: ReviewStatistics;
+    summary: string;
+    duration: number;
+    tokenUsage: TokenUsage;
+    costEstimate: number;
+    sessionId: string;
+    descriptionEnhanced?: boolean;
+    totalComments?: number;
+}
+export interface ReviewStatistics {
+    filesReviewed: number;
+    issuesFound: IssuesBySeverity;
+    requirementCoverage: number;
+    codeQualityScore: number;
+    toolCallsMade: number;
+    cacheHits: number;
+    totalComments: number;
+}
+export interface IssuesBySeverity {
+    critical: number;
+    major: number;
+    minor: number;
+    suggestions: number;
+}
+export interface TokenUsage {
+    input: number;
+    output: number;
+    total: number;
+}
+export interface ReviewUpdate {
+    type: "tool_call" | "ai_thinking" | "comment_posted" | "decision" | "progress";
+    timestamp: string;
+    sessionId: string;
+    data: any;
+}
+export interface ToolCallUpdate {
+    toolName: string;
+    args: any;
+    result?: any;
+    error?: string;
+    duration?: number;
+}
+export interface ProgressUpdate {
+    phase: "context_gathering" | "file_analysis" | "decision_making" | "description_enhancement";
+    progress: number;
+    message: string;
+    currentFile?: string;
+    filesProcessed?: number;
+    totalFiles?: number;
+}
+export interface ReviewSession {
+    sessionId: string;
+    request: ReviewRequest;
+    startTime: Date;
+    endTime?: Date;
+    status: "running" | "completed" | "failed";
+    toolCalls: ToolCallRecord[];
+    result?: ReviewResult;
+    error?: Error;
+    metadata: SessionMetadata;
+}
+export interface ToolCallRecord {
+    timestamp: Date;
+    toolName: string;
+    args: any;
+    result: any;
+    error?: string;
+    duration: number;
+    tokenUsage?: TokenUsage;
+}
+export interface SessionMetadata {
+    yamaVersion: string;
+    aiProvider: string;
+    aiModel: string;
+    totalTokens: number;
+    totalCost: number;
+    cacheHitRatio: number;
+}
+export interface MCPToolResponse {
+    success: boolean;
+    data?: any;
+    error?: string;
+    metadata?: {
+        cached?: boolean;
+        duration?: number;
+        source?: string;
+    };
+}
+export interface BitbucketPRDetails {
+    id: number;
+    title: string;
+    description: string;
+    author: string;
+    state: "OPEN" | "MERGED" | "DECLINED";
+    sourceRef: string;
+    targetRef: string;
+    createdDate: string;
+    updatedDate: string;
+    reviewers: any[];
+    comments: any[];
+    fileChanges: string[];
+}
+export interface JiraTicketDetails {
+    key: string;
+    summary: string;
+    description: string;
+    status: string;
+    acceptanceCriteria?: string;
+    requirements?: string[];
+    issueType: string;
+    priority: string;
+}
+export interface PromptLayer {
+    name: string;
+    priority: number;
+    content: string;
+    source: "base" | "config" | "project";
+}
+export interface FocusArea {
+    name: string;
+    priority: "CRITICAL" | "MAJOR" | "MINOR";
+    description: string;
+}
+export interface BlockingCriteria {
+    condition: string;
+    action: "BLOCK" | "REQUEST_CHANGES" | "WARN";
+    reason: string;
+}
+export interface ToolContext {
+    sessionId: string;
+    workspace: string;
+    repository: string;
+    pullRequestId?: number;
+    branch?: string;
+    dryRun: boolean;
+    metadata: {
+        yamaVersion: string;
+        startTime: string;
+        jiraTicket?: string;
+    };
+}
+export interface AIAnalysisContext {
+    prDetails: BitbucketPRDetails;
+    jiraTicket?: JiraTicketDetails;
+    projectStandards?: string;
+    memoryBankContext?: string;
+    clinerules?: string;
+}
+export declare class YamaV2Error extends Error {
+    code: string;
+    context?: any | undefined;
+    constructor(code: string, message: string, context?: any | undefined);
+}
+export declare class MCPServerError extends YamaV2Error {
+    constructor(message: string, context?: any);
+}
+export declare class ConfigurationError extends YamaV2Error {
+    constructor(message: string, context?: any);
+}
+export declare class ReviewTimeoutError extends YamaV2Error {
+    constructor(message: string, context?: any);
+}
+export declare class TokenBudgetExceededError extends YamaV2Error {
+    constructor(message: string, context?: any);
+}
+//# sourceMappingURL=v2.types.d.ts.map

package/dist/v2/types/v2.types.js

@@ -0,0 +1,42 @@
+/**
+ * Yama V2 TypeScript Type Definitions
+ * AI-Native MCP Architecture Types
+ */
+// ============================================================================
+// Error Types
+// ============================================================================
+export class YamaV2Error extends Error {
+    code;
+    context;
+    constructor(code, message, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = "YamaV2Error";
+    }
+}
+export class MCPServerError extends YamaV2Error {
+    constructor(message, context) {
+        super("MCP_SERVER_ERROR", message, context);
+        this.name = "MCPServerError";
+    }
+}
+export class ConfigurationError extends YamaV2Error {
+    constructor(message, context) {
+        super("CONFIGURATION_ERROR", message, context);
+        this.name = "ConfigurationError";
+    }
+}
+export class ReviewTimeoutError extends YamaV2Error {
+    constructor(message, context) {
+        super("REVIEW_TIMEOUT", message, context);
+        this.name = "ReviewTimeoutError";
+    }
+}
+export class TokenBudgetExceededError extends YamaV2Error {
+    constructor(message, context) {
+        super("TOKEN_BUDGET_EXCEEDED", message, context);
+        this.name = "TokenBudgetExceededError";
+    }
+}
+//# sourceMappingURL=v2.types.js.map

package/dist/v2/utils/ObservabilityConfig.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Observability Configuration Builder
+ * Builds NeuroLink observability config from environment variables
+ */
+export interface ObservabilityConfig {
+    langfuse?: {
+        publicKey: string;
+        secretKey: string;
+        baseUrl?: string;
+        enabled: boolean;
+    };
+}
+/**
+ * Build observability config from environment variables
+ * Returns null if observability is not configured
+ */
+export declare function buildObservabilityConfigFromEnv(): ObservabilityConfig | null;
+/**
+ * Validate observability configuration
+ */
+export declare function validateObservabilityConfig(config: ObservabilityConfig | null): boolean;
+//# sourceMappingURL=ObservabilityConfig.d.ts.map

package/dist/v2/utils/ObservabilityConfig.js

@@ -0,0 +1,48 @@
+/**
+ * Observability Configuration Builder
+ * Builds NeuroLink observability config from environment variables
+ */
+/**
+ * Build observability config from environment variables
+ * Returns null if observability is not configured
+ */
+export function buildObservabilityConfigFromEnv() {
+    const langfusePublicKey = process.env.LANGFUSE_PUBLIC_KEY;
+    const langfuseSecretKey = process.env.LANGFUSE_SECRET_KEY;
+    const langfuseBaseUrl = process.env.LANGFUSE_BASE_URL;
+    const langfuseEnabled = process.env.LANGFUSE_ENABLED !== "false"; // Default to true if keys present
+    // Check if Langfuse is configured
+    if (langfusePublicKey && langfuseSecretKey) {
+        return {
+            langfuse: {
+                publicKey: langfusePublicKey,
+                secretKey: langfuseSecretKey,
+                baseUrl: langfuseBaseUrl || "https://cloud.langfuse.com",
+                enabled: langfuseEnabled,
+            },
+        };
+    }
+    // No observability configured
+    return null;
+}
+/**
+ * Validate observability configuration
+ */
+export function validateObservabilityConfig(config) {
+    if (!config) {
+        return true; // No config is valid (observability is optional)
+    }
+    if (config.langfuse) {
+        const { publicKey, secretKey, baseUrl } = config.langfuse;
+        if (!publicKey || !secretKey) {
+            console.error("❌ Langfuse observability config invalid: missing publicKey or secretKey");
+            return false;
+        }
+        if (baseUrl && !baseUrl.startsWith("http")) {
+            console.error("❌ Langfuse observability config invalid: baseUrl must start with http/https");
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=ObservabilityConfig.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/yama",
-  "version": "1.6.0",
+  "version": "2.1.0",
   "description": "Enterprise-grade Pull Request automation toolkit with AI-powered code review and description enhancement",
   "keywords": [
     "pr",
@@ -28,10 +28,7 @@
   "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"
+    "yama": "dist/cli/v2.cli.js"
   },
   "directories": {
     "test": "tests"
@@ -46,11 +43,14 @@
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
-    "yama.config.example.yaml"
+    "yama.config.example.yaml",
+    ".mcp-config.example.json",
+    "docs/v2"
   ],
   "scripts": {
     "build": "tsc && tsc-alias",
-    "dev": "ts-node-dev --respawn --transpile-only src/cli/index.ts",
+    "dev": "tsx watch src/cli/v2.cli.ts",
+    "dev:run": "tsx src/cli/v2.cli.ts",
     "test": "jest",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
@@ -83,8 +83,10 @@
     "check:all": "npm run lint && npm run format --check && npm run validate && npm run validate:commit"
   },
   "dependencies": {
-    "@juspay/neurolink": "^7.40.1",
-    "@nexus2520/bitbucket-mcp-server": "^0.10.0",
+    "@juspay/neurolink": "^8.23.1",
+    "langfuse": "^3.35.0",
+    "@nexus2520/bitbucket-mcp-server": "^1.1.2",
+    "@nexus2520/jira-mcp-server": "^1.0.1",
     "chalk": "^4.1.2",
     "commander": "^11.0.0",
     "debug": "^4.3.4",
@@ -125,6 +127,7 @@
     "ts-node": "^10.0.0",
     "ts-node-dev": "^2.0.0",
     "tsc-alias": "^1.8.0",
+    "tsx": "^4.20.6",
     "typedoc": "^0.25.0",
     "typescript": "^5.0.0"
   },
@@ -148,7 +151,10 @@
   "pnpm": {
     "onlyBuiltDependencies": [
       "esbuild"
-    ]
+    ],
+    "overrides": {
+      "@semantic-release/npm": "^13.1.2"
+    }
   },
   "lint-staged": {
     "*.{ts,tsx,js,jsx}": [