AI Integration Architecture

The OSDU SPI Fork Management system incorporates sophisticated AI capabilities to enhance development workflows while maintaining reliability and cost-effectiveness. This integration provides intelligent analysis, automated documentation generation, and enhanced decision-making support throughout the fork management lifecycle.

AI Integration Philosophy

AI Provider Architecture

graph TD
    A[Workflow Trigger] --> B[AI Provider Selection]
    B --> C{Primary: Claude}
    B --> D{Secondary: Azure OpenAI}
    B --> E{Tertiary: OpenAI}

    C --> F[Claude Code CLI]
    C --> G[Direct API Access]
    D --> H[Azure OpenAI Service]
    E --> I[OpenAI GPT-4]

    F --> J[AI Analysis Output]
    G --> J
    H --> J
    I --> J

    J --> K[Fallback to Standard Template]

    style A fill:#e1f5fe,stroke:#01579b,stroke-width:2px
    style C fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px
    style D fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style E fill:#fce4ec,stroke:#c2185b,stroke-width:2px

Provider Hierarchy

AI-Enhanced Capabilities

## Summary
This sync integrates 12 commits from upstream with primarily dependency updates and security fixes.

## Key Changes
- **Security**: Updated Jackson dependency to resolve CVE-2023-35116
- **Enhancement**: Improved error handling in data processing pipeline

## Impact Assessment
- **Breaking Changes**: None detected
- **Testing**: All upstream tests passing

Technical Implementation

Claude Code CLI Integration

Installation and Configuration

Automated setup in GitHub Actions workflows:

# Claude Code CLI Installation
- name: Install Claude Code CLI
  run: npm install -g @anthropic-ai/claude-code

# MCP Configuration for Maven and GitLab Integration  
- name: Configure MCP Servers
  run: |
    cat > .mcp.json << 'EOF'
    {
      "mcpServers": {
        "mvn-mcp-server": {
          "type": "stdio",
          "command": "uvx",
          "args": ["--from", "git+https://github.com/danielscholl-osdu/mvn-mcp-server@main", "mvn-mcp-server"]
        },
        "gitlab": {
          "command": "npx",
          "args": ["-y", "@zereight/mcp-gitlab"],
          "env": {
            "GITLAB_PERSONAL_ACCESS_TOKEN": "${{ secrets.GITLAB_TOKEN }}",
            "GITLAB_API_URL": "https://community.opengroup.org/api/v4"
          }
        }
      }
    }
    EOF

Model Context Protocol (MCP) Integration

Specialized tool integration for enhanced AI capabilities:

• Maven MCP Server: Dependency analysis and management recommendations for Java/Maven projects
• GitLab MCP Server: Cross-platform GitLab API operations for MR creation and repository management
• Git Integration: Repository history and change pattern analysis across platforms
• Security Scanning: Vulnerability database integration and analysis
• Documentation Tools: Automated documentation generation and validation

Cross-Platform GitLab Integration

AI-Enhanced GitLab Workflow (osdu-alfi.yml)

The system includes sophisticated cross-platform integration that extends AI capabilities to GitLab repositories, enabling seamless contribution to OSDU community projects:

sequenceDiagram
    participant GH as GitHub PR/Issue
    participant AI as Claude + GitLab MCP
    participant GL as GitLab Repository
    participant U as User

    U->>GH: Add @alfi mention to comment
    GH->>AI: Trigger OSDU Alfi workflow
    AI->>AI: Analyze GitHub context and changes
    AI->>GL: Create corresponding GitLab branch
    AI->>GL: Push synchronized changes
    AI->>GL: Create GitLab merge request
    AI->>GH: Comment with GitLab MR link

Key Capabilities:

• Trigger Activation: @alfi mentions in GitHub PR reviews, issue comments, or new issues
• Context Analysis: AI reads GitHub PR/issue content and determines appropriate GitLab actions
• Branch Synchronization: Creates GitLab branches with synchronized changes from GitHub
• MR Creation: Generates GitLab merge requests with OSDU-appropriate labels and descriptions
• Feedback Loop: Comments back on GitHub with GitLab MR links for seamless tracking

OSDU-Specific Features:

• Community GitLab Targeting: Configured for community.opengroup.org GitLab instance
• OSDU Branch Naming: Uses ai-agent/ prefix for automated branches
• Appropriate Labeling: Applies MR::Dependencies Upgrade and context-specific labels
• Template Protection: Automatically skips template repositories, only runs on actual forks

Multi-Provider Fallback Strategy

Provider Selection Logic

graph TD
    A[AI Task Request] --> B{Claude API Key?}
    B -->|Yes| C[Use Claude Code CLI]
    B -->|No| D{Azure OpenAI Key?}
    D -->|Yes| E[Use Azure OpenAI]
    D -->|No| F{OpenAI Key?}
    F -->|Yes| G[Use OpenAI GPT-4]
    F -->|No| H[Use Standard Template]

    C --> I{Success?}
    E --> I
    G --> I
    I -->|No| J[Try Next Provider]
    I -->|Yes| K[Return AI Result]
    J --> D
    H --> L[Return Standard Result]

Performance Optimization

Security and Compliance