@bluefly/openstandardagents 0.4.2 → 0.4.4

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

@@ -0,0 +1,50 @@
+import express from 'express';
+import pino from 'pino';
+import { GitLabClient } from './gitlab-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 workflowExecutor = new WorkflowExecutor({
+  gitlabClient,
+
+  logger,
+});
+
+// Health check endpoint
+app.get('/health', (req, res) => {
+  res.json({ status: 'healthy', agent: 'pre-commit-quality-check' });
+});
+
+// Ready check endpoint
+app.get('/ready', (req, res) => {
+  res.json({ status: 'ready', agent: 'pre-commit-quality-check' });
+});
+
+
+
+const PORT = process.env.PORT || 9090;
+app.listen(PORT, () => {
+  logger.info(`Agent '${agentName}' listening on port ${PORT}`);
+});

package/examples/gitlab-agents/pre-commit-quality-check/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/pre-commit-quality-check/src/workflow.ts

@@ -0,0 +1,63 @@
+import type { GitLabClient } from './gitlab-client.js';
+
+import type { Logger } from 'pino';
+import type { WebhookEvent, WorkflowContext } from './types.js';
+
+export interface WorkflowExecutorConfig {
+  gitlabClient: GitLabClient;
+
+  logger: Logger;
+}
+
+export class WorkflowExecutor {
+  private gitlabClient: GitLabClient;
+
+  private logger: Logger;
+
+  constructor(config: WorkflowExecutorConfig) {
+    this.gitlabClient = config.gitlabClient;
+
+    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 {
+      // No workflow steps defined
+
+      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/pre-commit-quality-check/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/pre-push-validation/.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-push-validation/.gitlab-ci.yml

@@ -0,0 +1,34 @@
+# GitLab CI/CD for pre-push-validation
+# 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-push-validation:
+  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-push-validation:latest .
+    - docker push registry.gitlab.com/$CI_PROJECT_PATH/pre-push-validation:latest
+    # Deploy to Kubernetes
+    - kubectl set image deployment/pre-push-validation pre-push-validation=registry.gitlab.com/$CI_PROJECT_PATH/pre-push-validation:latest -n agents
+  only:
+    - main

package/examples/gitlab-agents/pre-push-validation/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-push-validation/README.md

@@ -0,0 +1,80 @@
+# pre-push-validation
+
+Pre-push quality gate that validates production-grade score before pushing. Runs comprehensive audit and blocks push if score is below threshold.
+
+
+## Generated from OSSA Manifest
+
+This agent was auto-generated from an OSSA v0.4.1 manifest using:
+
+```bash
+ossa export agents/gitlab/pre-push-validation.ossa.yaml --platform gitlab-agent --output ./pre-push-validation
+```
+
+## 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-push-validation .
+docker run -p 9090:9090 --env-file .env pre-push-validation
+```
+
+### 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-push-validation/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@bluefly/pre-push-validation",
+  "version": "1.0.0",
+  "description": "Pre-push quality gate that validates production-grade score before pushing. Runs comprehensive audit and blocks push if score is below threshold.\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-push-validation/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,
+    });
+  }
+
+
+}

package/examples/gitlab-agents/pre-push-validation/src/index.ts

@@ -0,0 +1,50 @@
+import express from 'express';
+import pino from 'pino';
+import { GitLabClient } from './gitlab-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 workflowExecutor = new WorkflowExecutor({
+  gitlabClient,
+
+  logger,
+});
+
+// Health check endpoint
+app.get('/health', (req, res) => {
+  res.json({ status: 'healthy', agent: 'pre-push-validation' });
+});
+
+// Ready check endpoint
+app.get('/ready', (req, res) => {
+  res.json({ status: 'ready', agent: 'pre-push-validation' });
+});
+
+
+
+const PORT = process.env.PORT || 9090;
+app.listen(PORT, () => {
+  logger.info(`Agent '${agentName}' listening on port ${PORT}`);
+});

package/examples/gitlab-agents/pre-push-validation/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/pre-push-validation/src/workflow.ts

@@ -0,0 +1,63 @@
+import type { GitLabClient } from './gitlab-client.js';
+
+import type { Logger } from 'pino';
+import type { WebhookEvent, WorkflowContext } from './types.js';
+
+export interface WorkflowExecutorConfig {
+  gitlabClient: GitLabClient;
+
+  logger: Logger;
+}
+
+export class WorkflowExecutor {
+  private gitlabClient: GitLabClient;
+
+  private logger: Logger;
+
+  constructor(config: WorkflowExecutorConfig) {
+    this.gitlabClient = config.gitlabClient;
+
+    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 {
+      // No workflow steps defined
+
+      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/pre-push-validation/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"
+  ]
+}