@bluefly/openstandardagents 0.4.2 → 0.4.4

package/examples/gitlab-agents/pipeline-auto-fix/src/gitlab-client.ts

@@ -0,0 +1,77 @@
+import { Gitlab } from '@gitbeaker/rest';
+import type { Logger } from 'pino';
+
+export interface GitLabClientConfig {
+  token: string;
+  baseUrl?: string;
+}
+
+export class GitLabClient {
+  private gitlab: InstanceType<typeof Gitlab>;
+
+  constructor(config: GitLabClientConfig) {
+    this.gitlab = new Gitlab({
+      host: config.baseUrl || 'https://gitlab.com',
+      token: config.token,
+    });
+  }
+
+  /**
+   * Get jobs for pipeline
+   */
+  async getPipelineJobs(projectId: string, pipelineId: number) {
+    return await this.gitlab.Jobs.showPipelineJobs(projectId, pipelineId);
+  }
+
+  /**
+   * Get job log output
+   */
+  async getJobLog(projectId: string, jobId: number) {
+    return await this.gitlab.Jobs.showLog(projectId, jobId);
+  }
+
+  /**
+   * Get file content from repository
+   */
+  async getFileContent(projectId: string, filePath: string, ref: string) {
+    const file = await this.gitlab.RepositoryFiles.show(projectId, filePath, ref);
+    return Buffer.from(file.content, 'base64').toString('utf-8');
+  }
+
+  /**
+   * Create new branch
+   */
+  async createBranch(projectId: string, branch: string, ref: string) {
+    return await this.gitlab.Branches.create(projectId, branch, ref);
+  }
+
+  /**
+   * Create commit with changes
+   */
+  async createCommit(projectId: string, branch: string, message: string, actions: any[]) {
+    return await this.gitlab.Commits.create(projectId, branch, message, actions);
+  }
+
+  /**
+   * Create merge request
+   */
+  async createMR(
+    projectId: string,
+    sourceBranch: string,
+    targetBranch: string,
+    title: string,
+    description: string
+  ) {
+    return await this.gitlab.MergeRequests.create(projectId, sourceBranch, targetBranch, title, {
+      description,
+    });
+  }
+
+  /**
+   * Post comment explaining the fix
+   */
+  async postComment(projectId: any, mrIid: any, body: any) {
+    // TODO: Implement postComment
+    throw new Error('Not implemented: postComment');
+  }
+}

package/examples/gitlab-agents/pipeline-auto-fix/src/index.ts

@@ -0,0 +1,103 @@
+import express from 'express';
+import pino from 'pino';
+import { GitLabClient } from './gitlab-client.js';
+import { LLMClient } from './llm-client.js';
+import { WorkflowExecutor } from './workflow.js';
+import type { WebhookEvent } from './types.js';
+
+const app = express();
+app.use(express.json());
+
+const logger = pino({
+  level: process.env.LOG_LEVEL || 'info',
+  transport: {
+    target: 'pino-pretty',
+    options: {
+      colorize: true,
+    },
+  },
+});
+
+// Initialize clients
+const gitlabClient = new GitLabClient({
+  token: process.env.GITLAB_API_TOKEN!,
+  baseUrl: process.env.GITLAB_API_URL || 'https://gitlab.com/api/v4',
+});
+
+const llmClient = new LLMClient({
+  apiKey: process.env.ANTHROPIC_API_KEY!,
+  model: 'claude-sonnet-4-5',
+});
+
+const workflowExecutor = new WorkflowExecutor({
+  gitlabClient,
+  llmClient,
+  logger,
+});
+
+// Health check endpoint
+app.get('/health', (req, res) => {
+  res.json({ status: 'healthy', agent: 'pipeline-auto-fix' });
+});
+
+// Ready check endpoint
+app.get('/ready', (req, res) => {
+  res.json({ status: 'ready', agent: 'pipeline-auto-fix' });
+});
+
+// Webhook endpoint
+app.post('/webhook/pipeline-auto-fix', async (req, res) => {
+  const event: WebhookEvent = req.body;
+
+  // Validate webhook token
+  const webhookToken = req.headers['x-gitlab-token'];
+  if (webhookToken !== process.env.WEBHOOK_SECRET) {
+    logger.warn({ event: event.object_kind }, 'Invalid webhook token');
+    return res.status(401).json({ error: 'Unauthorized' });
+  }
+
+  logger.info({ event: event.object_kind }, 'Webhook received');
+
+  try {
+    // Check if event matches filter
+    if (!matchesFilter(event, {"status":"failed","ref":["main","development","/^release\\/.*/","/^feature\\/.*/"]})) {
+      logger.info({ event: event.object_kind }, 'Event filtered out');
+      return res.status(200).json({ skipped: true });
+    }
+
+    // Execute workflow
+    const result = await workflowExecutor.execute(event);
+
+    logger.info({ result }, 'Workflow completed successfully');
+    return res.status(200).json(result);
+  } catch (error) {
+    logger.error({ err: error }, 'Workflow execution failed');
+    return res.status(500).json({
+      error: error instanceof Error ? error.message : String(error),
+    });
+  }
+});
+
+function matchesFilter(event: WebhookEvent, filter: any): boolean {
+  // Implement filter matching logic based on manifest
+  
+  if (filter.note_author && event.object_attributes?.author?.username !== filter.note_author) {
+    return false;
+  }
+
+  if (filter.note_contains && Array.isArray(filter.note_contains)) {
+    const noteBody = event.object_attributes?.note || '';
+    const matches = filter.note_contains.some((keyword: string) =>
+      noteBody.toLowerCase().includes(keyword.toLowerCase())
+    );
+    if (!matches) return false;
+  }
+  
+
+  return true;
+}
+
+const PORT = process.env.PORT || 9090;
+app.listen(PORT, () => {
+  logger.info(`Agent '${agentName}' listening on port ${PORT}`);
+});

package/examples/gitlab-agents/pipeline-auto-fix/src/llm-client.ts

@@ -0,0 +1,79 @@
+import Anthropic from '@anthropic-ai/sdk';
+import type { Logger } from 'pino';
+
+export interface LLMClientConfig {
+  apiKey: string;
+  model?: string;
+}
+
+export class LLMClient {
+  private anthropic: Anthropic;
+  private model: string;
+
+  constructor(config: LLMClientConfig) {
+    this.anthropic = new Anthropic({
+      apiKey: config.apiKey,
+    });
+    this.model = config.model || 'claude-sonnet-4-5';
+  }
+
+  /**
+   * Invoke LLM with prompt
+   */
+  async invoke(prompt: string, systemPrompt?: string): Promise<string> {
+    const response = await this.anthropic.messages.create({
+      model: this.model,
+      max_tokens: 32000,
+      temperature: 0.1,
+      system: systemPrompt || `You are a CI/CD remediation specialist.
+
+Your role:
+1. Analyze pipeline failure logs
+2. Identify root cause (TypeScript errors, test failures, lint errors, etc.)
+3. Generate precise fixes
+4. Create MR with fix and detailed explanation
+
+Common failure types:
+- TypeScript compilation errors
+- Test failures
+- Lint/format errors
+- Dependency issues
+- Configuration errors
+- Build failures
+
+Response format:
+- Root cause analysis
+- Fix strategy
+- Code changes
+- Commit message
+- MR description
+`,
+      messages: [
+        {
+          role: 'user',
+          content: prompt,
+        },
+      ],
+    });
+
+    const content = response.content[0];
+    if (content.type === 'text') {
+      return content.text;
+    }
+
+    throw new Error('Unexpected response type from LLM');
+  }
+
+  /**
+   * Invoke LLM and parse JSON response
+   */
+  async invokeJSON<T = any>(prompt: string, systemPrompt?: string): Promise<T> {
+    const response = await this.invoke(prompt, systemPrompt);
+
+    // Extract JSON from markdown code blocks if present
+    const jsonMatch = response.match(/```json\n([\s\S]*?)\n```/);
+    const jsonStr = jsonMatch ? jsonMatch[1] : response;
+
+    return JSON.parse(jsonStr);
+  }
+}

package/examples/gitlab-agents/pipeline-auto-fix/src/types.ts

@@ -0,0 +1,22 @@
+export interface WebhookEvent {
+  object_kind: string;
+  project?: {
+    id: string | number;
+    name: string;
+  };
+  project_id?: string | number;
+  merge_request?: {
+    iid: number;
+    source_branch: string;
+    target_branch: string;
+  };
+  object_attributes?: any;
+  commit?: any;
+  ref?: string;
+}
+
+export interface WorkflowContext {
+  event: WebhookEvent;
+  variables: Record<string, any>;
+  outputs: Record<string, any>;
+}

package/examples/gitlab-agents/pipeline-auto-fix/src/workflow.ts

@@ -0,0 +1,146 @@
+import type { GitLabClient } from './gitlab-client.js';
+import type { LLMClient } from './llm-client.js';
+import type { Logger } from 'pino';
+import type { WebhookEvent, WorkflowContext } from './types.js';
+
+export interface WorkflowExecutorConfig {
+  gitlabClient: GitLabClient;
+  llmClient: LLMClient;
+  logger: Logger;
+}
+
+export class WorkflowExecutor {
+  private gitlabClient: GitLabClient;
+  private llmClient: LLMClient;
+  private logger: Logger;
+
+  constructor(config: WorkflowExecutorConfig) {
+    this.gitlabClient = config.gitlabClient;
+    this.llmClient = config.llmClient;
+    this.logger = config.logger;
+  }
+
+  /**
+   * Execute workflow
+   */
+  async execute(event: WebhookEvent): Promise<any> {
+    const context: WorkflowContext = {
+      event,
+      variables: this.extractVariables(event),
+      outputs: {},
+    };
+
+    this.logger.info({ context }, 'Starting workflow execution');
+
+    try {
+      // Step 1: Fetch Failed Jobs
+      this.logger.info('Executing step: Fetch Failed Jobs');
+      context.outputs.fetch-jobs = await this.gitlabClient.getPipelineJobs(
+        context.variables.PROJECT_ID, context.variables.PIPELINE_ID
+      );
+
+
+      // Step 2: Get Failure Logs
+      this.logger.info('Executing step: Get Failure Logs');
+      context.outputs.get-logs = await Promise.all([
+
+      ]);
+
+
+      // Step 3: Analyze Root Cause
+      this.logger.info('Executing step: Analyze Root Cause');
+      const prompt = `Pipeline #${PIPELINE_ID} failed on ${REF}
+
+Failed Jobs:
+${jobs.filter(j => j.status === 'failed').map(j => `- ${j.name} (stage: ${j.stage})`).join('\n')}
+
+Logs:
+${logs.map((log, i) => `
+=== ${jobs[i].name} ===
+${log}
+`).join('\n\n')}
+
+Analyze and provide fix in JSON:
+{
+  "root_cause": "string (detailed explanation)",
+  "error_type": "typescript|test|lint|dependency|build|config",
+  "affected_files": ["list of files that need changes"],
+  "fix_strategy": "string (how to fix)",
+  "code_changes": [
+    {
+      "file_path": "string",
+      "action": "update",
+      "current_content": "string (if known)",
+      "new_content": "string (fixed version)"
+    }
+  ],
+  "commit_message": "string (conventional commit format)",
+  "mr_title": "string (descriptive title)",
+  "mr_description": "string (markdown formatted)",
+  "confidence": number (0-100, how confident in this fix)
+}
+`;
+      context.outputs.analyze-failure = await this.llmClient.invokeJSON(prompt);
+
+
+      // Step 4: Check Fix Confidence
+      this.logger.info('Executing step: Check Fix Confidence');
+      if (analysis.confidence < 70) {
+      // TODO: Implement evaluate
+      }
+
+
+      // Step 5: Create Fix Branch
+      this.logger.info('Executing step: Create Fix Branch');
+      context.outputs.create-fix-branch = await this.gitlabClient.createBranch(
+        context.variables.PROJECT_ID, "auto-fix/pipeline-${PIPELINE_ID}", context.variables.REF
+      );
+
+
+      // Step 6: Apply Code Fixes
+      this.logger.info('Executing step: Apply Code Fixes');
+      context.outputs.apply-fixes = await this.gitlabClient.createCommit(
+        context.variables.PROJECT_ID, context.variables.branch.name, "${analysis.commit_message}\n\nAuto-generated fix for pipeline #${PIPELINE_ID}\n\nRoot cause: ${analysis.root_cause}\n\nCo-Authored-By: Pipeline Auto-Fix Agent <pipeline-remediation@blueflyagents.com>\n", context.variables.analysis.code_changes
+      );
+
+
+      // Step 7: Create Fix MR
+      this.logger.info('Executing step: Create Fix MR');
+      context.outputs.create-fix-mr = await this.gitlabClient.createMR(
+        context.variables.PROJECT_ID, context.variables.branch.name, context.variables.REF, context.variables.analysis.mr_title, "## 🤖 Auto-Fix for Pipeline #${PIPELINE_ID}\n\n**Status**: Failed ❌ → Fixed ✅\n\n### Root Cause\n${analysis.root_cause}\n\n### Error Type\n`${analysis.error_type}`\n\n### Fix Strategy\n${analysis.fix_strategy}\n\n### Files Changed\n${analysis.affected_files.map(f => `- \\`${f}\\``).join('\\n')}\n\n### Commit\n${commit.short_id}: ${analysis.commit_message}\n\n### Testing\n- [ ] Pipeline passes on this MR\n- [ ] Code review approved\n- [ ] Ready to merge\n\n---\n🤖 Generated by: pipeline-auto-fix agent\n📊 Confidence: ${analysis.confidence}%\n🔗 Failed pipeline: [#${PIPELINE_ID}](${CI_PROJECT_URL}/-/pipelines/${PIPELINE_ID})\n"
+      );
+
+
+      // Step 8: Post Detailed Comment
+      this.logger.info('Executing step: Post Detailed Comment');
+      context.outputs.post-explanation = await this.gitlabClient.postComment(
+        context.variables.PROJECT_ID, context.variables.mr.iid, "## 🔍 Detailed Analysis\n\n### Failed Jobs\n${jobs.filter(j => j.status === 'failed').map(j => `\n**${j.name}** (${j.stage})\n- Duration: ${j.duration}s\n- Exit code: ${j.exit_code}\n`).join('\\n')}\n\n### Root Cause Deep Dive\n${analysis.root_cause}\n\n### Code Changes Explanation\n${analysis.code_changes.map(c => `\n#### \\`${c.file_path}\\`\n\\`\\`\\`diff\n- Old (line causing error)\n+ New (fixed line)\n\\`\\`\\`\n`).join('\\n')}\n\n### Verification\nThis MR will trigger a new pipeline. If it passes, the fix is confirmed.\n\n**Confidence**: ${analysis.confidence}%\n${analysis.confidence < 90 ? '\\n⚠️  Manual review recommended due to confidence level.' : ''}\n"
+      );
+
+
+      this.logger.info({ outputs: context.outputs }, 'Workflow completed');
+      return context.outputs;
+    } catch (error) {
+      this.logger.error({ err: error }, 'Workflow execution failed');
+      throw error;
+    }
+  }
+
+  /**
+   * Extract variables from webhook event
+   */
+  private extractVariables(event: WebhookEvent): Record<string, any> {
+    return {
+      PROJECT_ID: event.project?.id || event.project_id,
+      MR_IID: event.merge_request?.iid || event.object_attributes?.iid,
+      PIPELINE_ID: event.object_attributes?.id,
+      COMMIT_SHA: event.object_attributes?.sha || event.commit?.id,
+      REF: event.object_attributes?.ref || event.ref,
+      SOURCE_BRANCH: event.merge_request?.source_branch,
+      TARGET_BRANCH: event.merge_request?.target_branch,
+      DUO_COMMENT_ID: event.object_attributes?.id,
+      DUO_COMMENT_BODY: event.object_attributes?.note,
+      // Add more as needed
+    };
+  }
+}

package/examples/gitlab-agents/pipeline-auto-fix/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "node",
+    "lib": [
+      "ES2022"
+    ],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/examples/gitlab-agents/pipeline-auto-fix/webhook-config.json

@@ -0,0 +1,11 @@
+{
+  "url": "http://api.blueflyagents.com/webhook/pipeline-auto-fix",
+  "token": "${WEBHOOK_SECRET}",
+  "enable_ssl_verification": false,
+  "push_events": false,
+  "issues_events": false,
+  "merge_requests_events": false,
+  "note_events": false,
+  "pipeline_events": true,
+  "wiki_page_events": false
+}

package/examples/gitlab-agents/pre-commit-quality-check/.env.example

@@ -0,0 +1,11 @@
+# GitLab Agent Environment Variables
+
+# GitLab Configuration
+GITLAB_API_TOKEN=glpat-your-token-here
+GITLAB_API_URL=https://gitlab.com/api/v4
+WEBHOOK_SECRET=your-webhook-secret
+
+# Server Configuration
+PORT=9090
+NODE_ENV=production
+LOG_LEVEL=info

package/examples/gitlab-agents/pre-commit-quality-check/.gitlab-ci.yml

@@ -0,0 +1,34 @@
+# GitLab CI/CD for pre-commit-quality-check
+# Auto-generated from OSSA manifest
+
+stages:
+  - build
+  - deploy
+
+build:
+  stage: build
+  image: node:20-alpine
+  script:
+    - npm ci
+    - npm run build
+    - npm test
+  artifacts:
+    paths:
+      - dist/
+      - node_modules/
+    expire_in: 1 hour
+
+deploy:pre-commit-quality-check:
+  stage: deploy
+  image: docker:24
+  services:
+    - docker:24-dind
+  before_script:
+    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
+  script:
+    - docker build -t registry.gitlab.com/$CI_PROJECT_PATH/pre-commit-quality-check:latest .
+    - docker push registry.gitlab.com/$CI_PROJECT_PATH/pre-commit-quality-check:latest
+    # Deploy to Kubernetes
+    - kubectl set image deployment/pre-commit-quality-check pre-commit-quality-check=registry.gitlab.com/$CI_PROJECT_PATH/pre-commit-quality-check:latest -n agents
+  only:
+    - main

package/examples/gitlab-agents/pre-commit-quality-check/Dockerfile

@@ -0,0 +1,18 @@
+FROM node:20-alpine
+
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm ci --only=production
+
+COPY dist/ ./dist/
+
+ENV NODE_ENV=production
+ENV PORT=9090
+
+EXPOSE 9090
+
+HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:9090/health || exit 1
+
+CMD ["node", "dist/index.js"]

package/examples/gitlab-agents/pre-commit-quality-check/README.md

@@ -0,0 +1,80 @@
+# pre-commit-quality-check
+
+Pre-commit quality gate that blocks commits with production-grade issues. Runs locally via git hooks to catch problems before they reach CI.
+
+
+## Generated from OSSA Manifest
+
+This agent was auto-generated from an OSSA v0.4.1 manifest using:
+
+```bash
+ossa export agents/gitlab/pre-commit-quality-check.ossa.yaml --platform gitlab-agent --output ./pre-commit-quality-check
+```
+
+## Installation
+
+1. Install dependencies:
+
+```bash
+npm install
+```
+
+2. Copy `.env.example` to `.env` and fill in your credentials:
+
+```bash
+cp .env.example .env
+```
+
+3. Build the agent:
+
+```bash
+npm run build
+```
+
+4. Run the agent:
+
+```bash
+npm start
+```
+
+## Development
+
+Run in development mode with hot reload:
+
+```bash
+npm run dev
+```
+
+## Deployment
+
+### Docker
+
+Build and run with Docker:
+
+```bash
+docker build -t pre-commit-quality-check .
+docker run -p 9090:9090 --env-file .env pre-commit-quality-check
+```
+
+### Kubernetes
+
+Deploy to Kubernetes:
+
+```bash
+kubectl apply -f k8s/deployment.yaml
+```
+
+
+
+## Health Checks
+
+- Health: `GET /health`
+- Ready: `GET /ready`
+
+## Monitoring
+
+The agent exposes Prometheus metrics and OpenTelemetry traces.
+
+## License
+
+MIT

package/examples/gitlab-agents/pre-commit-quality-check/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@bluefly/pre-commit-quality-check",
+  "version": "1.0.0",
+  "description": "Pre-commit quality gate that blocks commits with production-grade issues. Runs locally via git hooks to catch problems before they reach CI.\n",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "test": "echo \"No tests yet\""
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "@gitbeaker/rest": "^40.0.0",
+    "pino": "^8.19.0",
+    "pino-pretty": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.11.19",
+    "typescript": "^5.3.3",
+    "tsx": "^4.7.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/examples/gitlab-agents/pre-commit-quality-check/src/gitlab-client.ts

@@ -0,0 +1,20 @@
+import { Gitlab } from '@gitbeaker/rest';
+import type { Logger } from 'pino';
+
+export interface GitLabClientConfig {
+  token: string;
+  baseUrl?: string;
+}
+
+export class GitLabClient {
+  private gitlab: InstanceType<typeof Gitlab>;
+
+  constructor(config: GitLabClientConfig) {
+    this.gitlab = new Gitlab({
+      host: config.baseUrl || 'https://gitlab.com',
+      token: config.token,
+    });
+  }
+
+
+}