@bluefly/openstandardagents 0.2.4 → 0.2.7

package/infrastructure/k8s/monitoring/01-prometheus.yaml

@@ -0,0 +1,142 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: prometheus-config
+  namespace: monitoring
+data:
+  prometheus.yml: |
+    global:
+      scrape_interval: 15s
+      evaluation_interval: 15s
+    
+    scrape_configs:
+      - job_name: 'prometheus'
+        static_configs:
+          - targets: ['localhost:9090']
+      
+      - job_name: 'gitlab-agent'
+        kubernetes_sd_configs:
+          - role: pod
+            namespaces:
+              names:
+                - gitlab-agent
+        relabel_configs:
+          - source_labels: [__meta_kubernetes_pod_label_app]
+            regex: gitlab-agent
+            action: keep
+          - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]
+            action: keep
+            regex: true
+          - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_port]
+            action: replace
+            target_label: __address__
+            regex: ([^:]+)(?::\d+)?;(\d+)
+            replacement: $1:$2
+      
+      - job_name: 'ossa-agents'
+        kubernetes_sd_configs:
+          - role: pod
+            namespaces:
+              names:
+                - ossa-agents
+        relabel_configs:
+          - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]
+            action: keep
+            regex: true
+          - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_path]
+            action: replace
+            target_label: __metrics_path__
+            regex: (.+)
+          - source_labels: [__address__, __meta_kubernetes_pod_annotation_prometheus_io_port]
+            action: replace
+            regex: ([^:]+)(?::\d+)?;(\d+)
+            replacement: $1:$2
+            target_label: __address__
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: prometheus
+  namespace: monitoring
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: prometheus
+  template:
+    metadata:
+      labels:
+        app: prometheus
+    spec:
+      serviceAccountName: prometheus
+      containers:
+      - name: prometheus
+        image: prom/prometheus:latest
+        args:
+          - '--config.file=/etc/prometheus/prometheus.yml'
+          - '--storage.tsdb.path=/prometheus'
+          - '--web.console.libraries=/usr/share/prometheus/console_libraries'
+          - '--web.console.templates=/usr/share/prometheus/consoles'
+        ports:
+        - containerPort: 9090
+        volumeMounts:
+        - name: config
+          mountPath: /etc/prometheus
+        - name: storage
+          mountPath: /prometheus
+      volumes:
+      - name: config
+        configMap:
+          name: prometheus-config
+      - name: storage
+        emptyDir: {}
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: prometheus
+  namespace: monitoring
+spec:
+  selector:
+    app: prometheus
+  ports:
+  - port: 9090
+    targetPort: 9090
+---
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: prometheus
+  namespace: monitoring
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRole
+metadata:
+  name: prometheus
+rules:
+- apiGroups: [""]
+  resources:
+  - nodes
+  - nodes/proxy
+  - services
+  - endpoints
+  - pods
+  verbs: ["get", "list", "watch"]
+- apiGroups:
+  - extensions
+  resources:
+  - ingresses
+  verbs: ["get", "list", "watch"]
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRoleBinding
+metadata:
+  name: prometheus
+roleRef:
+  apiGroup: rbac.authorization.k8s.io
+  kind: ClusterRole
+  name: prometheus
+subjects:
+- kind: ServiceAccount
+  name: prometheus
+  namespace: monitoring

package/infrastructure/k8s/monitoring/02-grafana.yaml

@@ -0,0 +1,63 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: grafana-datasources
+  namespace: monitoring
+data:
+  prometheus.yaml: |
+    apiVersion: 1
+    datasources:
+    - name: Prometheus
+      type: prometheus
+      access: proxy
+      url: http://prometheus:9090
+      isDefault: true
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: grafana
+  namespace: monitoring
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: grafana
+  template:
+    metadata:
+      labels:
+        app: grafana
+    spec:
+      containers:
+      - name: grafana
+        image: grafana/grafana:latest
+        ports:
+        - containerPort: 3000
+        env:
+        - name: GF_SECURITY_ADMIN_PASSWORD
+          value: "admin"
+        - name: GF_USERS_ALLOW_SIGN_UP
+          value: "false"
+        volumeMounts:
+        - name: grafana-storage
+          mountPath: /var/lib/grafana
+        - name: grafana-datasources
+          mountPath: /etc/grafana/provisioning/datasources
+      volumes:
+      - name: grafana-storage
+        emptyDir: {}
+      - name: grafana-datasources
+        configMap:
+          name: grafana-datasources
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: grafana
+  namespace: monitoring
+spec:
+  selector:
+    app: grafana
+  ports:
+  - port: 3000
+    targetPort: 3000

package/infrastructure/k8s/monitoring/03-lightweight.yaml

@@ -0,0 +1,121 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: prometheus-lite
+  namespace: monitoring
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: prometheus-lite
+  template:
+    metadata:
+      labels:
+        app: prometheus-lite
+    spec:
+      tolerations:
+      - key: "node.kubernetes.io/disk-pressure"
+        operator: "Exists"
+        effect: "NoSchedule"
+      containers:
+      - name: prometheus
+        image: prom/prometheus:latest
+        args:
+          - '--config.file=/etc/prometheus/prometheus.yml'
+          - '--storage.tsdb.path=/prometheus'
+          - '--storage.tsdb.retention.time=1h'
+          - '--storage.tsdb.retention.size=100MB'
+        ports:
+        - containerPort: 9090
+        resources:
+          requests:
+            memory: "128Mi"
+            cpu: "100m"
+          limits:
+            memory: "256Mi"
+            cpu: "200m"
+        volumeMounts:
+        - name: config
+          mountPath: /etc/prometheus
+        - name: storage
+          mountPath: /prometheus
+      volumes:
+      - name: config
+        configMap:
+          name: prometheus-config
+      - name: storage
+        emptyDir:
+          sizeLimit: 200Mi
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: prometheus-lite
+  namespace: monitoring
+spec:
+  selector:
+    app: prometheus-lite
+  ports:
+  - port: 9090
+    targetPort: 9090
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: grafana-lite
+  namespace: monitoring
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: grafana-lite
+  template:
+    metadata:
+      labels:
+        app: grafana-lite
+    spec:
+      tolerations:
+      - key: "node.kubernetes.io/disk-pressure"
+        operator: "Exists"
+        effect: "NoSchedule"
+      containers:
+      - name: grafana
+        image: grafana/grafana:latest
+        ports:
+        - containerPort: 3000
+        env:
+        - name: GF_SECURITY_ADMIN_PASSWORD
+          value: "admin"
+        - name: GF_USERS_ALLOW_SIGN_UP
+          value: "false"
+        resources:
+          requests:
+            memory: "128Mi"
+            cpu: "100m"
+          limits:
+            memory: "256Mi"
+            cpu: "200m"
+        volumeMounts:
+        - name: grafana-storage
+          mountPath: /var/lib/grafana
+        - name: grafana-datasources
+          mountPath: /etc/grafana/provisioning/datasources
+      volumes:
+      - name: grafana-storage
+        emptyDir:
+          sizeLimit: 100Mi
+      - name: grafana-datasources
+        configMap:
+          name: grafana-datasources
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: grafana-lite
+  namespace: monitoring
+spec:
+  selector:
+    app: grafana-lite
+  ports:
+  - port: 3000
+    targetPort: 3000

package/infrastructure/k8s/monitoring/README.md

@@ -0,0 +1,73 @@
+# OSSA Monitoring Stack
+
+Prometheus + Grafana monitoring for OSSA agents and GitLab agent.
+
+## Quick Deploy
+
+```bash
+# Deploy everything
+./deploy.sh
+
+# Or manually
+kubectl apply -f 00-namespace.yaml
+kubectl apply -f 01-prometheus.yaml
+kubectl apply -f 02-grafana.yaml
+```
+
+## Access Dashboards
+
+### Prometheus
+```bash
+kubectl port-forward -n monitoring svc/prometheus 9090:9090
+```
+Open: http://localhost:9090
+
+### Grafana
+```bash
+kubectl port-forward -n monitoring svc/grafana 3000:3000
+```
+Open: http://localhost:3000  
+Default: `admin` / `admin`
+
+## What's Monitored
+
+- **GitLab Agent** (gitlab-agent namespace)
+- **OSSA Agents** (ossa-agents namespace)
+- **Kubernetes Metrics**
+
+## Check Status
+
+```bash
+# Pods
+kubectl get pods -n monitoring
+
+# Services
+kubectl get svc -n monitoring
+
+# Logs
+kubectl logs -n monitoring -l app=prometheus
+kubectl logs -n monitoring -l app=grafana
+```
+
+## Cleanup
+
+```bash
+kubectl delete namespace monitoring
+```
+
+## Next Steps
+
+1. Deploy agents with metrics annotations:
+```yaml
+metadata:
+  annotations:
+    prometheus.io/scrape: "true"
+    prometheus.io/port: "9090"
+    prometheus.io/path: "/metrics"
+```
+
+2. Import Grafana dashboards
+3. Configure alerts
+4. Add Jaeger for tracing
+
+See: `.gitlab/docs/MONITORING-OBSERVABILITY.md`

package/infrastructure/k8s/monitoring/deploy.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+set -e
+
+echo "🚀 Deploying OSSA Monitoring Stack..."
+
+# Check if kubectl is available
+if ! command -v kubectl &> /dev/null; then
+    echo "❌ kubectl not found. Please install kubectl first."
+    exit 1
+fi
+
+# Deploy in order
+echo "📦 Creating namespace..."
+kubectl apply -f 00-namespace.yaml
+
+echo "📊 Deploying Prometheus..."
+kubectl apply -f 01-prometheus.yaml
+
+echo "📈 Deploying Grafana..."
+kubectl apply -f 02-grafana.yaml
+
+echo ""
+echo "✅ Monitoring stack deployed!"
+echo ""
+echo "📍 Access dashboards:"
+echo ""
+echo "Prometheus:"
+echo "  kubectl port-forward -n monitoring svc/prometheus 9090:9090"
+echo "  Then open: http://localhost:9090"
+echo ""
+echo "Grafana:"
+echo "  kubectl port-forward -n monitoring svc/grafana 3000:3000"
+echo "  Then open: http://localhost:3000"
+echo "  Default credentials: admin/admin"
+echo ""
+echo "🔍 Check status:"
+echo "  kubectl get pods -n monitoring"
+echo ""

package/openapi/CHANGELOG.md

@@ -0,0 +1,21 @@
+# OpenAPI Specifications Changelog
+
+## v0.2.5-RC (2025-11-25)
+
+### Changed
+- Reorganized OpenAPI specs into `/core`, `/reference-implementations`, and `/internal` directories
+- Updated all core and reference implementation specs to version 0.2.5-RC
+- Moved internal project APIs to `/internal` directory (not part of public standard)
+
+### Added
+- Comprehensive README documenting structure and usage
+- Clear separation between standard APIs and internal tooling
+
+### Structure
+- **Core APIs**: Standard OSSA specification APIs
+- **Reference Implementations**: Example integration patterns
+- **Internal**: Project infrastructure (GitLab, release automation)
+
+## v0.2.4 (Previous)
+
+See `internal/CHANGELOG-0.2.4.md` for historical changes.

package/openapi/README.md

@@ -0,0 +1,46 @@
+# OSSA OpenAPI Specifications
+
+OpenAPI 3.1 specifications for OSSA core APIs and reference implementations.
+
+## Structure
+
+### `/core` - Core OSSA APIs
+Standard APIs that define the OSSA specification:
+- `ossa-core-api.openapi.yaml` - Core OSSA runtime API
+- `ossa-registry-api.openapi.yaml` - Agent registry API
+- `ossa-registry.openapi.yaml` - Registry service specification
+- `unified-agent-gateway.openapi.yaml` - Gateway API for agent orchestration
+
+### `/reference-implementations` - Example Implementations
+Reference implementations showing OSSA integration patterns:
+- `drupal-agent-api.openapi.yaml` - Drupal CMS integration
+- `helm-generator.openapi.yaml` - Kubernetes Helm chart generator
+- `self-evolving-ecosystem.openapi.yaml` - Self-evolving agent system
+
+## Internal APIs
+
+Internal project infrastructure APIs are located in `.gitlab/docs/infrastructure/openapi/`
+
+## Version
+
+Current version: **0.2.5-RC**
+
+## Usage
+
+Validate specs:
+```bash
+npm run validate:openapi
+```
+
+Generate types:
+```bash
+npm run gen:types
+```
+
+## Standards
+
+All OpenAPI specs follow:
+- OpenAPI 3.1 specification
+- JSON Schema Draft 2020-12
+- OSSA naming conventions
+- Semantic versioning

package/openapi/{ossa-core-api.openapi.yaml → core/ossa-core-api.openapi.yaml}

@@ -19,7 +19,7 @@ info:
 
   contact:
     name: Bluefly.io LLM Platform Team
-    url: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard
+    url: https://github.com/blueflyio/openstandardagents
   license:
     name: MIT
     url: https://opensource.org/licenses/MIT
@@ -40,8 +40,19 @@ security:
 paths:
   # Health & Status
   /health:
-    $ref: './src/api/specification.openapi.yml#/paths/~1health'
+    get:
 
+      summary: Health check
+      tags: [Health]
+      operationId: healthCheck
+      security: []
+      responses:
+        '200':
+          $ref: '#/components/responses/HealthCheck'
+        '503':
+          $ref: '#/components/responses/ServiceUnavailable'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
   /health/ready:
     get:
       summary: Readiness check
@@ -52,7 +63,9 @@ paths:
         '200':
           $ref: '#/components/responses/HealthCheck'
         '503':
-          description: Service not ready
+          $ref: '#/components/responses/ServiceUnavailable'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
 
   /health/live:
     get:
@@ -63,6 +76,10 @@ paths:
       responses:
         '200':
           $ref: '#/components/responses/HealthCheck'
+        '503':
+          $ref: '#/components/responses/ServiceUnavailable'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
 
   # Agent Registry
   /agents:
@@ -242,7 +259,31 @@ paths:
 
   # Specification & Validation
   /specification/validate:
-    $ref: './src/api/specification.openapi.yml#/paths/~1specification~1validate'
+    post:
+      summary: Validate agent manifest
+      description: Validate an OSSA agent manifest against the specification
+      tags: [Specification]
+      operationId: validateManifest
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AgentManifest'
+          application/yaml:
+            schema:
+              $ref: '#/components/schemas/AgentManifest'
+      responses:
+        '200':
+          description: Validation result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ValidationResult'
+        '400':
+          $ref: '#/components/responses/ValidationError'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
 
   /specification/taxonomies:
     get:
@@ -1408,6 +1449,20 @@ components:
           schema:
             $ref: '#/components/schemas/Problem'
 
+    ServiceUnavailable:
+      description: Service unavailable
+      content:
+        application/problem+json:
+          schema:
+            $ref: '#/components/schemas/Problem'
+
+    InternalServerError:
+      description: Internal server error
+      content:
+        application/problem+json:
+          schema:
+            $ref: '#/components/schemas/Problem'
+
 tags:
   - name: Health
     description: Service health and status