@bluefly/openstandardagents 0.3.1 → 0.3.2

package/spec/v0.3.2/examples/tasks/publish-content.ossa.yaml

@@ -0,0 +1,125 @@
+# ============================================================================
+# OSSA Task: Content Publishing
+# ============================================================================
+# Deterministic task for publishing content - no LLM decision-making
+# Use kind: Task for pure functions, batch operations, and system integrations
+#
+# @see https://openstandardagents.org/spec/v0.3.2/task
+# ============================================================================
+
+apiVersion: ossa/v0.3.2
+kind: Task
+metadata:
+  name: publish-content
+  version: 1.0.0
+  labels:
+    domain: content-management
+    tier: tier_2_write_limited
+  annotations:
+    ossa.io/description: "Publish content to production with validation"
+    ossa.io/category: "content"
+    ossa.io/compliance: "SOC2"
+
+spec:
+  # Execution configuration
+  execution:
+    type: transactional  # all-or-nothing (rollback on failure)
+    runtime: drupal      # target runtime
+    entrypoint: "Drupal\\ossa_content\\Task\\PublishContentTask::execute"
+    timeout_seconds: 60
+
+  # Required capabilities (bound at runtime)
+  capabilities:
+    - publish_content
+    - invalidate_cache
+    - send_notification
+
+  # Input validation schema
+  input:
+    type: object
+    required:
+      - content_id
+      - content_type
+    properties:
+      content_id:
+        type: string
+        pattern: "^[a-zA-Z0-9_-]+$"
+        description: "Unique content identifier"
+      content_type:
+        type: string
+        enum:
+          - article
+          - page
+          - product
+          - announcement
+      notify_subscribers:
+        type: boolean
+        default: true
+      schedule_at:
+        type: string
+        format: date-time
+        description: "Optional scheduled publish time"
+
+  # Output schema
+  output:
+    type: object
+    required:
+      - success
+      - published_url
+    properties:
+      success:
+        type: boolean
+      published_url:
+        type: string
+        format: uri
+      published_at:
+        type: string
+        format: date-time
+      cache_invalidated:
+        type: boolean
+      notifications_sent:
+        type: integer
+        minimum: 0
+
+  # Batch processing support
+  batch:
+    enabled: true
+    parallelism: 5
+    retry: 3
+    backoff_seconds: 10
+
+  # Error handling
+  error_handling:
+    on_failure: rollback
+    retryable_errors:
+      - NETWORK_TIMEOUT
+      - DATABASE_LOCK
+      - CACHE_UNAVAILABLE
+    fatal_errors:
+      - CONTENT_NOT_FOUND
+      - VALIDATION_ERROR
+      - PERMISSION_DENIED
+
+# Runtime bindings (how capabilities map to concrete implementations)
+runtime:
+  drupal:
+    publish_content:
+      service: "@content_moderation.moderation_information"
+      method: "transitionContent"
+    invalidate_cache:
+      service: "@cache.render"
+      method: "invalidateAll"
+    send_notification:
+      service: "@ossa_notifications.subscriber_notifier"
+      method: "notifySubscribers"
+
+  symfony:
+    publish_content:
+      service: "App\\Service\\ContentPublisher"
+      method: "publish"
+    invalidate_cache:
+      service: "symfony.cache.adapter.redis"
+      method: "clear"
+    send_notification:
+      service: "App\\Notification\\SubscriberNotifier"
+      method: "send"

package/spec/v0.3.2/examples/workflows/content-publishing.ossa.yaml

@@ -0,0 +1,190 @@
+# ============================================================================
+# OSSA Workflow: Content Publishing Pipeline
+# ============================================================================
+# Composes Tasks and Agents into an executable content publishing pipeline
+# Demonstrates step dependencies, conditional execution, and error handling
+#
+# @see https://openstandardagents.org/spec/v0.3.2/workflow
+# ============================================================================
+
+apiVersion: ossa/v0.3.2
+kind: Workflow
+metadata:
+  name: content-publishing-pipeline
+  version: 1.0.0
+  labels:
+    domain: content-management
+    tier: tier_3_write_elevated
+  annotations:
+    ossa.io/description: "End-to-end content publishing with review and approval"
+    ossa.io/category: "publishing"
+    ossa.io/compliance: "SOC2,GDPR"
+
+spec:
+  # Workflow triggers
+  triggers:
+    - type: webhook
+      endpoint: /api/v1/publish
+      methods: [POST]
+      authentication:
+        type: bearer
+        scope: publish:content
+    - type: schedule
+      cron: "0 9 * * 1-5"  # Weekdays at 9am
+      timezone: "America/New_York"
+    - type: event
+      source: cms
+      event_type: content.ready_for_publish
+
+  # Input schema
+  inputs:
+    type: object
+    required:
+      - content_id
+    properties:
+      content_id:
+        type: string
+      priority:
+        type: string
+        enum: [low, normal, high, critical]
+        default: normal
+      skip_review:
+        type: boolean
+        default: false
+      notify_channels:
+        type: array
+        items:
+          type: string
+          enum: [email, slack, teams, webhook]
+        default: [email]
+
+  # Output schema
+  outputs:
+    type: object
+    properties:
+      published_url:
+        type: string
+        format: uri
+      review_comments:
+        type: array
+        items:
+          type: string
+      notifications_sent:
+        type: integer
+      total_duration_ms:
+        type: integer
+
+  # Workflow steps
+  steps:
+    # Step 1: Validate content (Task - deterministic)
+    - id: validate
+      name: "Validate Content"
+      ref: tasks/validate-content
+      kind: Task
+      input:
+        content_id: "${{ inputs.content_id }}"
+        strict: true
+      on_failure: halt
+
+    # Step 2: AI Review (Agent - agentic, conditional)
+    - id: review
+      name: "AI Content Review"
+      ref: agents/content-reviewer
+      kind: Agent
+      condition: "${{ !inputs.skip_review }}"
+      input:
+        content: "${{ steps.validate.output.content }}"
+        guidelines: "brand-voice,accessibility,seo"
+      timeout_seconds: 120
+      on_failure: continue
+      output_mapping:
+        review_score: "${{ output.score }}"
+        suggestions: "${{ output.suggestions }}"
+
+    # Step 3: Human approval gate (conditional on review score)
+    - id: approval
+      name: "Human Approval"
+      type: approval
+      condition: "${{ steps.review.output.review_score < 0.8 }}"
+      approvers:
+        - role: content-manager
+        - role: editor-in-chief
+      require: 1
+      timeout_hours: 24
+      escalation:
+        after_hours: 4
+        to: [senior-editor]
+
+    # Step 4: Publish content (Task - transactional)
+    - id: publish
+      name: "Publish Content"
+      ref: tasks/publish-content
+      kind: Task
+      depends_on: [validate, review]
+      input:
+        content_id: "${{ inputs.content_id }}"
+        content_type: "${{ steps.validate.output.content_type }}"
+        notify_subscribers: true
+      on_failure: rollback
+
+    # Step 5: Send notifications (Task - batch)
+    - id: notify
+      name: "Send Notifications"
+      ref: tasks/send-notifications
+      kind: Task
+      depends_on: [publish]
+      input:
+        channels: "${{ inputs.notify_channels }}"
+        message:
+          title: "New content published"
+          url: "${{ steps.publish.output.published_url }}"
+          priority: "${{ inputs.priority }}"
+      on_failure: continue
+
+    # Step 6: Analytics tracking (parallel, fire-and-forget)
+    - id: analytics
+      name: "Track Analytics"
+      ref: tasks/track-analytics
+      kind: Task
+      depends_on: [publish]
+      async: true
+      input:
+        event: content_published
+        properties:
+          content_id: "${{ inputs.content_id }}"
+          published_at: "${{ steps.publish.output.published_at }}"
+
+  # Shared workflow context
+  context:
+    variables:
+      environment: "${{ env.ENVIRONMENT }}"
+      trace_id: "${{ uuid() }}"
+    secrets:
+      - name: CMS_API_KEY
+        ref: vault://secret/cms/api-key
+      - name: NOTIFICATION_TOKEN
+        ref: vault://secret/notifications/token
+
+  # Concurrency control
+  concurrency:
+    group: "publish-${{ inputs.content_id }}"
+    cancel_in_progress: false
+
+  # Error handling
+  error_handling:
+    on_failure: compensate
+    compensation_steps:
+      - id: rollback-publish
+        name: "Rollback Publication"
+        ref: tasks/unpublish-content
+        kind: Task
+        input:
+          content_id: "${{ inputs.content_id }}"
+      - id: notify-failure
+        name: "Notify Team"
+        ref: tasks/send-alert
+        kind: Task
+        input:
+          channel: ops-alerts
+          message: "Publishing workflow failed for ${{ inputs.content_id }}"
+          severity: high

package/spec/v0.3.2/examples/workflows/deployment-pipeline.ossa.yaml

@@ -0,0 +1,247 @@
+# ============================================================================
+# OSSA Workflow: Deployment Pipeline
+# ============================================================================
+# Multi-stage deployment workflow with rollback capabilities
+# Demonstrates environment promotion, canary deployments, and approval gates
+#
+# @see https://openstandardagents.org/spec/v0.3.2/workflow
+# ============================================================================
+
+apiVersion: ossa/v0.3.2
+kind: Workflow
+metadata:
+  name: deployment-pipeline
+  version: 1.0.0
+  labels:
+    domain: infrastructure
+    tier: tier_3_write_elevated
+  annotations:
+    ossa.io/description: "Production deployment with staged rollout and monitoring"
+    ossa.io/category: "deployment"
+    ossa.io/compliance: "SOC2,ISO27001"
+
+spec:
+  triggers:
+    - type: event
+      source: ci
+      event_type: build.completed
+      filter:
+        branch: main
+        status: success
+    - type: webhook
+      endpoint: /api/v1/deploy
+      methods: [POST]
+      authentication:
+        type: bearer
+        scope: deploy:production
+
+  inputs:
+    type: object
+    required:
+      - artifact_id
+      - version
+    properties:
+      artifact_id:
+        type: string
+        description: "Container image or artifact identifier"
+      version:
+        type: string
+        pattern: "^v?[0-9]+\\.[0-9]+\\.[0-9]+"
+      environment:
+        type: string
+        enum: [staging, production]
+        default: staging
+      canary_percentage:
+        type: integer
+        minimum: 0
+        maximum: 100
+        default: 10
+      rollback_on_failure:
+        type: boolean
+        default: true
+
+  outputs:
+    type: object
+    properties:
+      deployment_id:
+        type: string
+      status:
+        type: string
+        enum: [success, partial, failed, rolled_back]
+      endpoints:
+        type: array
+        items:
+          type: string
+          format: uri
+      metrics:
+        type: object
+        properties:
+          duration_ms:
+            type: integer
+          pods_updated:
+            type: integer
+          health_check_passed:
+            type: boolean
+
+  steps:
+    # Pre-deployment validation
+    - id: validate-artifact
+      name: "Validate Artifact"
+      ref: tasks/validate-artifact
+      kind: Task
+      input:
+        artifact_id: "${{ inputs.artifact_id }}"
+        version: "${{ inputs.version }}"
+        checks:
+          - signature
+          - vulnerability-scan
+          - compliance
+
+    # Staging deployment (always runs first)
+    - id: deploy-staging
+      name: "Deploy to Staging"
+      ref: tasks/deploy-kubernetes
+      kind: Task
+      depends_on: [validate-artifact]
+      condition: "${{ inputs.environment == 'staging' || inputs.environment == 'production' }}"
+      input:
+        cluster: staging-cluster
+        namespace: "${{ env.APP_NAMESPACE }}"
+        image: "${{ inputs.artifact_id }}:${{ inputs.version }}"
+        replicas: 2
+      timeout_seconds: 300
+
+    # Staging health check
+    - id: health-staging
+      name: "Staging Health Check"
+      ref: tasks/health-check
+      kind: Task
+      depends_on: [deploy-staging]
+      input:
+        endpoints:
+          - "${{ steps.deploy-staging.output.service_url }}/health"
+          - "${{ steps.deploy-staging.output.service_url }}/ready"
+        timeout_seconds: 60
+        retry: 5
+      on_failure: halt
+
+    # AI-powered smoke test (Agent)
+    - id: smoke-test
+      name: "AI Smoke Test"
+      ref: agents/test-runner
+      kind: Agent
+      depends_on: [health-staging]
+      input:
+        target_url: "${{ steps.deploy-staging.output.service_url }}"
+        test_suite: smoke
+        generate_report: true
+      timeout_seconds: 180
+
+    # Production approval gate
+    - id: prod-approval
+      name: "Production Approval"
+      type: approval
+      condition: "${{ inputs.environment == 'production' }}"
+      depends_on: [smoke-test]
+      approvers:
+        - role: sre-lead
+        - role: release-manager
+      require: 2
+      timeout_hours: 8
+      metadata:
+        staging_results: "${{ steps.smoke-test.output.report_url }}"
+        version: "${{ inputs.version }}"
+
+    # Canary deployment (production only)
+    - id: deploy-canary
+      name: "Canary Deployment"
+      ref: tasks/deploy-kubernetes
+      kind: Task
+      condition: "${{ inputs.environment == 'production' }}"
+      depends_on: [prod-approval]
+      input:
+        cluster: production-cluster
+        namespace: "${{ env.APP_NAMESPACE }}"
+        image: "${{ inputs.artifact_id }}:${{ inputs.version }}"
+        strategy: canary
+        canary_weight: "${{ inputs.canary_percentage }}"
+      timeout_seconds: 300
+
+    # Canary monitoring (Agent - observes metrics)
+    - id: monitor-canary
+      name: "Monitor Canary"
+      ref: agents/deployment-monitor
+      kind: Agent
+      condition: "${{ inputs.environment == 'production' }}"
+      depends_on: [deploy-canary]
+      input:
+        deployment_id: "${{ steps.deploy-canary.output.deployment_id }}"
+        duration_minutes: 15
+        thresholds:
+          error_rate: 0.01
+          latency_p99_ms: 500
+          success_rate: 0.99
+      timeout_seconds: 1200
+
+    # Full production rollout
+    - id: deploy-full
+      name: "Full Production Rollout"
+      ref: tasks/deploy-kubernetes
+      kind: Task
+      condition: "${{ inputs.environment == 'production' && steps.monitor-canary.output.healthy }}"
+      depends_on: [monitor-canary]
+      input:
+        cluster: production-cluster
+        namespace: "${{ env.APP_NAMESPACE }}"
+        image: "${{ inputs.artifact_id }}:${{ inputs.version }}"
+        strategy: rolling
+        max_unavailable: 1
+        max_surge: 2
+
+    # Post-deployment notification
+    - id: notify-success
+      name: "Notify Success"
+      ref: tasks/send-notifications
+      kind: Task
+      depends_on: [deploy-full]
+      input:
+        channels: [slack, email]
+        template: deployment-success
+        data:
+          version: "${{ inputs.version }}"
+          environment: "${{ inputs.environment }}"
+          endpoints: "${{ steps.deploy-full.output.endpoints }}"
+
+  context:
+    variables:
+      trace_id: "${{ uuid() }}"
+    secrets:
+      - name: KUBECONFIG
+        ref: vault://secret/k8s/kubeconfig
+      - name: REGISTRY_TOKEN
+        ref: vault://secret/registry/token
+
+  concurrency:
+    group: "deploy-${{ inputs.environment }}"
+    cancel_in_progress: false
+
+  error_handling:
+    on_failure: compensate
+    compensation_steps:
+      - id: rollback
+        name: "Rollback Deployment"
+        ref: tasks/rollback-deployment
+        kind: Task
+        condition: "${{ inputs.rollback_on_failure }}"
+        input:
+          cluster: "${{ context.last_cluster }}"
+          deployment_id: "${{ context.last_deployment_id }}"
+          target_version: "${{ context.previous_version }}"
+      - id: notify-failure
+        name: "Alert On-Call"
+        ref: tasks/send-alert
+        kind: Task
+        input:
+          channel: pagerduty
+          severity: critical
+          message: "Deployment failed for version ${{ inputs.version }}"