@bluefly/openstandardagents 0.4.3 → 0.4.5

package/examples/extensions/agents-md-v1.yml

@@ -2,7 +2,7 @@
 # OpenAI agents.md repository-level agent guidance generation
 # See: https://agents.md | https://github.com/openai/agents.md
 
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: ExtensionSchema
 metadata:
   name: agents-md-extension
@@ -166,10 +166,10 @@ spec:
   cliCommands:
     - name: "ossa agents-md generate"
       description: "Generate AGENTS.md from manifest"
-      usage: "ossa agents-md generate --manifest .agents/my-agent/manifest.yaml"
+      usage: "ossa agents-md generate --manifest .agents/supercali-fragilisticagent/manifest.yaml"
     - name: "ossa agents-md validate"
       description: "Validate AGENTS.md against manifest"
-      usage: "ossa agents-md validate --agents-md AGENTS.md --manifest .agents/my-agent/manifest.yaml"
+      usage: "ossa agents-md validate --agents-md AGENTS.md --manifest .agents/supercali-fragilisticagent/manifest.yaml"
     - name: "ossa agents-md sync"
       description: "Sync AGENTS.md with manifest changes"
       usage: "ossa agents-md sync --watch"

package/examples/extensions/drupal-v1.yml

@@ -2,7 +2,7 @@
 # Extension specification for Drupal LLM Platform deployment
 # Compatible with Drupal 10+ and llm-platform modules
 
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: ExtensionSchema
 metadata:
   name: drupal-extension

package/examples/extensions/encryption-multi-provider.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: secure-agent
@@ -28,7 +28,7 @@ spec:
         interval_days: 90
         
 ---
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: vault-encrypted-agent
@@ -57,7 +57,7 @@ spec:
         - "*"  # Encrypt all fields
       
 ---
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: gcp-kms-agent
@@ -86,7 +86,7 @@ spec:
         - pii_fields
       
 ---
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: azure-keyvault-agent

package/examples/extensions/kagent-v1.yml

@@ -2,7 +2,7 @@
 # Production-grade specification for Kubernetes-native agent deployment
 # Compatible with kagent.dev/v1alpha1 CRDs
 
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: ExtensionSchema
 metadata:
   name: kagent-extension

package/examples/extensions/knowledge-sources.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: rag-agent

package/examples/extensions/mcp-full-featured.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: mcp-powered-agent

package/examples/getting-started/01-minimal-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: hello-world-agent

package/examples/getting-started/02-agent-with-tools.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: code-assistant

package/examples/getting-started/03-agent-with-safety.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: secure-assistant

package/examples/getting-started/04-agent-with-messaging.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: security-scanner

package/examples/getting-started/05-workflow-composition.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Workflow
 metadata:
   name: code-review-pipeline

package/examples/getting-started/hello-world-complete.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: hello-world-agent
@@ -15,6 +15,7 @@ metadata:
     team: platform-engineering
     domain: examples
     complexity: minimal
+    capability: greeting,echo,status
   annotations:
     documentation: https://docs.ossa.io/examples/hello-world
     support: support@example.com

package/examples/gitlab-agents/DEPLOYMENT.md

@@ -0,0 +1,331 @@
+# GitLab Quality Gate Agents - Deployment Guide
+
+## Overview
+
+This directory contains **6 production-ready GitLab agents** generated from OSSA manifests:
+
+| Agent | Gate | Type | Description |
+|-------|------|------|-------------|
+| **duo-comment-responder** | 4 | Webhook | Responds to GitLab Duo comments, implements fixes |
+| **mr-reviewer** | 3 | Webhook | Comprehensive MR review with auto-approve |
+| **pipeline-auto-fix** | 5 | Webhook | Automatically fixes failed pipelines |
+| **daily-code-scan** | 6 | Scheduled | Daily code quality audit |
+| **pre-commit-quality-check** | 1 | Local | Pre-commit quality checks (git hook) |
+| **pre-push-validation** | 2 | Local | Pre-push validation (git hook) |
+
+## Quick Start
+
+### Prerequisites
+
+- Kubernetes cluster with KAgent CRD installed
+- GitLab API token with `api` scope
+- Anthropic API key
+- Domain pointing to cluster: `mesh.blueflyagents.com`
+
+### 1. Install KAgent CRD
+
+```bash
+# Install KAgent operator
+kubectl apply -f https://raw.githubusercontent.com/blueflyio/kagent/main/install.yaml
+
+# Verify installation
+kubectl get crd kagents.agents.bluefly.io
+```
+
+### 2. Configure Secrets
+
+Edit `k8s/deploy-all.yaml` and replace:
+- `GITLAB_API_TOKEN`: Your GitLab personal access token
+- `ANTHROPIC_API_KEY`: Your Anthropic API key
+- `WEBHOOK_SECRET`: Random secret (generate with `openssl rand -hex 32`)
+
+### 3. Deploy All Agents
+
+```bash
+# Deploy to Kubernetes
+kubectl apply -f k8s/deploy-all.yaml
+
+# Verify deployment
+kubectl get kagents -n gitlab-agents
+kubectl get pods -n gitlab-agents
+kubectl get svc -n gitlab-agents
+kubectl get ingress -n gitlab-agents
+```
+
+Expected output:
+```
+NAME                      READY   STATUS    AGE
+duo-comment-responder     2/2     Running   1m
+mr-reviewer               3/3     Running   1m
+pipeline-auto-fix         2/2     Running   1m
+daily-code-scan           1/1     Running   1m
+```
+
+### 4. Configure GitLab Webhooks
+
+For each webhook agent, configure in **GitLab Project → Settings → Webhooks**:
+
+#### duo-comment-responder
+- **URL**: `http://mesh.blueflyagents.com/webhook/duo-comment-responder`
+- **Secret Token**: (from WEBHOOK_SECRET)
+- **Events**: ☑️ Comments, ☑️ Merge requests
+- **SSL verification**: ☐ Disable (internal network)
+
+#### mr-reviewer
+- **URL**: `http://mesh.blueflyagents.com/webhook/mr-reviewer`
+- **Secret Token**: (from WEBHOOK_SECRET)
+- **Events**: ☑️ Merge requests
+- **SSL verification**: ☐ Disable
+
+#### pipeline-auto-fix
+- **URL**: `http://mesh.blueflyagents.com/webhook/pipeline-auto-fix`
+- **Secret Token**: (from WEBHOOK_SECRET)
+- **Events**: ☑️ Pipeline events
+- **SSL verification**: ☐ Disable
+
+### 5. Test Webhooks
+
+```bash
+# Test duo-comment-responder
+curl -X POST http://mesh.blueflyagents.com/webhook/duo-comment-responder \
+  -H "Content-Type: application/json" \
+  -H "X-Gitlab-Token: your-webhook-secret" \
+  -d '{
+    "object_kind": "note",
+    "project": {"id": "12345"},
+    "merge_request": {"iid": 1},
+    "object_attributes": {
+      "note": "@claude This function needs refactoring",
+      "author": {"username": "GitLab Duo Bot"}
+    }
+  }'
+
+# Check logs
+kubectl logs -n gitlab-agents -l app=duo-comment-responder --tail=50
+```
+
+## Local Development
+
+### Build Individual Agent
+
+```bash
+cd duo-comment-responder
+npm install
+npm run build
+npm start
+```
+
+### Test Locally
+
+```bash
+# Set environment variables
+export GITLAB_API_TOKEN=glpat-your-token
+export ANTHROPIC_API_KEY=sk-ant-your-key
+export WEBHOOK_SECRET=your-secret
+
+# Run in development mode
+npm run dev
+
+# Test webhook
+curl -X POST http://localhost:9090/webhook/duo-comment-responder \
+  -H "Content-Type: application/json" \
+  -H "X-Gitlab-Token: your-secret" \
+  -d @test-event.json
+```
+
+## Docker Deployment
+
+### Build Images
+
+```bash
+# Build all agents
+for agent in duo-comment-responder mr-reviewer pipeline-auto-fix daily-code-scan; do
+  docker build -t registry.gitlab.com/blueflyio/ossa/openstandardagents/$agent:latest ./$agent
+done
+
+# Push to registry
+docker login registry.gitlab.com
+for agent in duo-comment-responder mr-reviewer pipeline-auto-fix daily-code-scan; do
+  docker push registry.gitlab.com/blueflyio/ossa/openstandardagents/$agent:latest
+done
+```
+
+### Run with Docker Compose
+
+```yaml
+# docker-compose.yml
+version: '3.8'
+
+services:
+  duo-comment-responder:
+    image: registry.gitlab.com/blueflyio/ossa/openstandardagents/duo-comment-responder:latest
+    ports:
+      - "9090:9090"
+    environment:
+      GITLAB_API_TOKEN: ${GITLAB_API_TOKEN}
+      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}
+      WEBHOOK_SECRET: ${WEBHOOK_SECRET}
+    restart: always
+
+  mr-reviewer:
+    image: registry.gitlab.com/blueflyio/ossa/openstandardagents/mr-reviewer:latest
+    ports:
+      - "9091:9090"
+    environment:
+      GITLAB_API_TOKEN: ${GITLAB_API_TOKEN}
+      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}
+      WEBHOOK_SECRET: ${WEBHOOK_SECRET}
+    restart: always
+```
+
+```bash
+docker-compose up -d
+```
+
+## Monitoring
+
+### Health Checks
+
+```bash
+# Check agent health
+kubectl exec -n gitlab-agents -it duo-comment-responder-0 -- \
+  wget -O- http://localhost:9090/health
+
+# Check readiness
+kubectl exec -n gitlab-agents -it duo-comment-responder-0 -- \
+  wget -O- http://localhost:9090/ready
+```
+
+### View Logs
+
+```bash
+# Stream logs from all agents
+kubectl logs -n gitlab-agents -l app=gitlab-quality-gates -f
+
+# Logs for specific agent
+kubectl logs -n gitlab-agents -l app=duo-comment-responder -f
+```
+
+### Metrics
+
+Each agent exposes Prometheus metrics on `/metrics`:
+
+```bash
+# Scrape metrics
+curl http://mesh.blueflyagents.com/webhook/duo-comment-responder/metrics
+```
+
+## Troubleshooting
+
+### Agent Not Starting
+
+```bash
+# Check pod status
+kubectl describe pod -n gitlab-agents duo-comment-responder-0
+
+# Check logs
+kubectl logs -n gitlab-agents duo-comment-responder-0
+
+# Common issues:
+# - Missing secrets: Verify GITLAB_API_TOKEN and ANTHROPIC_API_KEY
+# - Image pull error: Check registry credentials
+# - Port conflict: Ensure port 9090 is available
+```
+
+### Webhook Not Receiving Events
+
+```bash
+# Verify ingress
+kubectl get ingress -n gitlab-agents
+
+# Check service endpoints
+kubectl get endpoints -n gitlab-agents
+
+# Test webhook directly
+kubectl port-forward -n gitlab-agents svc/duo-comment-responder 9090:80
+curl -X POST http://localhost:9090/webhook/duo-comment-responder \
+  -H "X-Gitlab-Token: your-secret" \
+  -d '{}'
+```
+
+### Agent Not Responding to GitLab
+
+```bash
+# Check agent logs for errors
+kubectl logs -n gitlab-agents -l app=duo-comment-responder --tail=100
+
+# Verify GitLab token has correct permissions
+curl -H "PRIVATE-TOKEN: $GITLAB_API_TOKEN" \
+  https://gitlab.com/api/v4/user
+
+# Test LLM connectivity
+kubectl exec -n gitlab-agents duo-comment-responder-0 -- \
+  curl https://api.anthropic.com/v1/messages
+```
+
+## Scaling
+
+### Horizontal Pod Autoscaling
+
+```yaml
+apiVersion: autoscaling/v2
+kind: HorizontalPodAutoscaler
+metadata:
+  name: duo-comment-responder
+  namespace: gitlab-agents
+spec:
+  scaleTargetRef:
+    apiVersion: agents.bluefly.io/v1
+    kind: KAgent
+    name: duo-comment-responder
+  minReplicas: 2
+  maxReplicas: 10
+  metrics:
+    - type: Resource
+      resource:
+        name: cpu
+        target:
+          type: Utilization
+          averageUtilization: 70
+```
+
+## Uninstall
+
+```bash
+# Remove all agents
+kubectl delete -f k8s/deploy-all.yaml
+
+# Remove namespace
+kubectl delete namespace gitlab-agents
+```
+
+## Architecture
+
+```
+GitLab Project
+      ↓ (webhook)
+mesh.blueflyagents.com (Ingress)
+      ↓
+KAgent Controller
+      ↓
+Agent Pods (Express.js)
+      ↓
+├─ GitLab API (@gitbeaker)
+└─ Anthropic API (@anthropic-ai/sdk)
+```
+
+## Generated from OSSA
+
+All agents were generated using:
+
+```bash
+ossa export agents/gitlab/{agent}.ossa.yaml \
+  --platform gitlab-agent \
+  --output ./examples/gitlab-agents/{agent}
+```
+
+## Support
+
+- GitLab Issues: https://gitlab.com/blueflyio/ossa/openstandardagents/-/issues
+- Documentation: https://openstandardagents.org
+- KAgent Docs: https://github.com/blueflyio/kagent

package/examples/gitlab-agents/daily-code-scan/.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/daily-code-scan/.gitlab-ci.yml

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

package/examples/gitlab-agents/daily-code-scan/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/daily-code-scan/README.md

@@ -0,0 +1,80 @@
+# daily-code-scan
+
+Daily comprehensive code quality scan. Creates issues for regressions, tracks metrics over time, and identifies technical debt. Runs at 2am daily.
+
+
+## Generated from OSSA Manifest
+
+This agent was auto-generated from an OSSA v0.4.1 manifest using:
+
+```bash
+ossa export agents/gitlab/daily-code-scan.ossa.yaml --platform gitlab-agent --output ./daily-code-scan
+```
+
+## 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 daily-code-scan .
+docker run -p 9090:9090 --env-file .env daily-code-scan
+```
+
+### 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/daily-code-scan/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@bluefly/daily-code-scan",
+  "version": "1.0.0",
+  "description": "Daily comprehensive code quality scan. Creates issues for regressions, tracks metrics over time, and identifies technical debt. Runs at 2am daily.\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"
+  }
+}