@bluefly/openstandardagents 0.3.2 → 0.3.5

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

@@ -1,125 +0,0 @@
-# ============================================================================
-# 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

@@ -1,190 +0,0 @@
-# ============================================================================
-# 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

@@ -1,247 +0,0 @@
-# ============================================================================
-# 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 }}"