@bluefly/openstandardagents 0.3.2 → 0.3.3

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

@@ -1,13 +1,4 @@
-# ============================================================================
-# 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
+apiVersion: ossa/v0.3.3
 kind: Task
 metadata:
   name: publish-content
@@ -16,25 +7,21 @@ metadata:
     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"
-
+    ossa.io/description: Publish content to production with validation
+    ossa.io/category: content
+    ossa.io/compliance: SOC2
+    ossa.io/migration: v0.3.3-to-v0.3.3
+    ossa.io/migrated-date: 2026-01-07
 spec:
-  # Execution configuration
   execution:
-    type: transactional  # all-or-nothing (rollback on failure)
-    runtime: drupal      # target runtime
-    entrypoint: "Drupal\\ossa_content\\Task\\PublishContentTask::execute"
+    type: transactional
+    runtime: drupal
+    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:
@@ -43,8 +30,8 @@ spec:
     properties:
       content_id:
         type: string
-        pattern: "^[a-zA-Z0-9_-]+$"
-        description: "Unique content identifier"
+        pattern: ^[a-zA-Z0-9_-]+$
+        description: Unique content identifier
       content_type:
         type: string
         enum:
@@ -58,9 +45,7 @@ spec:
       schedule_at:
         type: string
         format: date-time
-        description: "Optional scheduled publish time"
-
-  # Output schema
+        description: Optional scheduled publish time
   output:
     type: object
     required:
@@ -80,15 +65,11 @@ spec:
       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:
@@ -99,27 +80,24 @@ spec:
       - 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"
+      method: transitionContent
     invalidate_cache:
       service: "@cache.render"
-      method: "invalidateAll"
+      method: invalidateAll
     send_notification:
       service: "@ossa_notifications.subscriber_notifier"
-      method: "notifySubscribers"
-
+      method: notifySubscribers
   symfony:
     publish_content:
-      service: "App\\Service\\ContentPublisher"
-      method: "publish"
+      service: App\Service\ContentPublisher
+      method: publish
     invalidate_cache:
-      service: "symfony.cache.adapter.redis"
-      method: "clear"
+      service: symfony.cache.adapter.redis
+      method: clear
     send_notification:
-      service: "App\\Notification\\SubscriberNotifier"
-      method: "send"
+      service: App\Notification\SubscriberNotifier
+      method: send

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

@@ -1,13 +1,4 @@
-# ============================================================================
-# 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
+apiVersion: ossa/v0.3.3
 kind: Workflow
 metadata:
   name: content-publishing-pipeline
@@ -16,27 +7,26 @@ metadata:
     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"
-
+    ossa.io/description: End-to-end content publishing with review and approval
+    ossa.io/category: publishing
+    ossa.io/compliance: SOC2,GDPR
+    ossa.io/migration: v0.3.3-to-v0.3.3
+    ossa.io/migrated-date: 2026-01-07
 spec:
-  # Workflow triggers
   triggers:
     - type: webhook
       endpoint: /api/v1/publish
-      methods: [POST]
+      methods:
+        - POST
       authentication:
         type: bearer
         scope: publish:content
     - type: schedule
-      cron: "0 9 * * 1-5"  # Weekdays at 9am
-      timezone: "America/New_York"
+      cron: 0 9 * * 1-5
+      timezone: America/New_York
     - type: event
       source: cms
       event_type: content.ready_for_publish
-
-  # Input schema
   inputs:
     type: object
     required:
@@ -46,7 +36,11 @@ spec:
         type: string
       priority:
         type: string
-        enum: [low, normal, high, critical]
+        enum:
+          - low
+          - normal
+          - high
+          - critical
         default: normal
       skip_review:
         type: boolean
@@ -55,10 +49,13 @@ spec:
         type: array
         items:
           type: string
-          enum: [email, slack, teams, webhook]
-        default: [email]
-
-  # Output schema
+          enum:
+            - email
+            - slack
+            - teams
+            - webhook
+        default:
+          - email
   outputs:
     type: object
     properties:
@@ -73,39 +70,32 @@ spec:
         type: integer
       total_duration_ms:
         type: integer
-
-  # Workflow steps
   steps:
-    # Step 1: Validate content (Task - deterministic)
     - id: validate
-      name: "Validate Content"
+      name: Validate Content
       ref: tasks/validate-content
       kind: Task
       input:
-        content_id: "${{ inputs.content_id }}"
+        content_id: ${{ inputs.content_id }}
         strict: true
       on_failure: halt
-
-    # Step 2: AI Review (Agent - agentic, conditional)
     - id: review
-      name: "AI Content Review"
+      name: AI Content Review
       ref: agents/content-reviewer
       kind: Agent
-      condition: "${{ !inputs.skip_review }}"
+      condition: ${{ !inputs.skip_review }}
       input:
-        content: "${{ steps.validate.output.content }}"
-        guidelines: "brand-voice,accessibility,seo"
+        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)
+        review_score: ${{ output.score }}
+        suggestions: ${{ output.suggestions }}
     - id: approval
-      name: "Human Approval"
+      name: Human Approval
       type: approval
-      condition: "${{ steps.review.output.review_score < 0.8 }}"
+      condition: ${{ steps.review.output.review_score < 0.8 }}
       approvers:
         - role: content-manager
         - role: editor-in-chief
@@ -113,78 +103,71 @@ spec:
       timeout_hours: 24
       escalation:
         after_hours: 4
-        to: [senior-editor]
-
-    # Step 4: Publish content (Task - transactional)
+        to:
+          - senior-editor
     - id: publish
-      name: "Publish Content"
+      name: Publish Content
       ref: tasks/publish-content
       kind: Task
-      depends_on: [validate, review]
+      depends_on:
+        - validate
+        - review
       input:
-        content_id: "${{ inputs.content_id }}"
-        content_type: "${{ steps.validate.output.content_type }}"
+        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"
+      name: Send Notifications
       ref: tasks/send-notifications
       kind: Task
-      depends_on: [publish]
+      depends_on:
+        - publish
       input:
-        channels: "${{ inputs.notify_channels }}"
+        channels: ${{ inputs.notify_channels }}
         message:
-          title: "New content published"
-          url: "${{ steps.publish.output.published_url }}"
-          priority: "${{ inputs.priority }}"
+          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"
+      name: Track Analytics
       ref: tasks/track-analytics
       kind: Task
-      depends_on: [publish]
+      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
+          content_id: ${{ inputs.content_id }}
+          published_at: ${{ steps.publish.output.published_at }}
   context:
     variables:
-      environment: "${{ env.ENVIRONMENT }}"
-      trace_id: "${{ uuid() }}"
+      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 }}"
+    group: publish-${{ inputs.content_id }}
     cancel_in_progress: false
-
-  # Error handling
   error_handling:
     on_failure: compensate
     compensation_steps:
       - id: rollback-publish
-        name: "Rollback Publication"
+        name: Rollback Publication
         ref: tasks/unpublish-content
         kind: Task
         input:
-          content_id: "${{ inputs.content_id }}"
+          content_id: ${{ inputs.content_id }}
       - id: notify-failure
-        name: "Notify Team"
+        name: Notify Team
         ref: tasks/send-alert
         kind: Task
         input:
           channel: ops-alerts
-          message: "Publishing workflow failed for ${{ inputs.content_id }}"
+          message: Publishing workflow failed for ${{ inputs.content_id }}
           severity: high

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

@@ -1,13 +1,4 @@
-# ============================================================================
-# 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
+apiVersion: ossa/v0.3.3
 kind: Workflow
 metadata:
   name: deployment-pipeline
@@ -16,10 +7,11 @@ metadata:
     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"
-
+    ossa.io/description: Production deployment with staged rollout and monitoring
+    ossa.io/category: deployment
+    ossa.io/compliance: SOC2,ISO27001
+    ossa.io/migration: v0.3.3-to-v0.3.3
+    ossa.io/migrated-date: 2026-01-07
 spec:
   triggers:
     - type: event
@@ -30,11 +22,11 @@ spec:
         status: success
     - type: webhook
       endpoint: /api/v1/deploy
-      methods: [POST]
+      methods:
+        - POST
       authentication:
         type: bearer
         scope: deploy:production
-
   inputs:
     type: object
     required:
@@ -43,13 +35,15 @@ spec:
     properties:
       artifact_id:
         type: string
-        description: "Container image or artifact identifier"
+        description: Container image or artifact identifier
       version:
         type: string
-        pattern: "^v?[0-9]+\\.[0-9]+\\.[0-9]+"
+        pattern: ^v?[0-9]+\.[0-9]+\.[0-9]+
       environment:
         type: string
-        enum: [staging, production]
+        enum:
+          - staging
+          - production
         default: staging
       canary_percentage:
         type: integer
@@ -59,7 +53,6 @@ spec:
       rollback_on_failure:
         type: boolean
         default: true
-
   outputs:
     type: object
     properties:
@@ -67,7 +60,11 @@ spec:
         type: string
       status:
         type: string
-        enum: [success, partial, failed, rolled_back]
+        enum:
+          - success
+          - partial
+          - failed
+          - rolled_back
       endpoints:
         type: array
         items:
@@ -82,166 +79,157 @@ spec:
             type: integer
           health_check_passed:
             type: boolean
-
   steps:
-    # Pre-deployment validation
     - id: validate-artifact
-      name: "Validate Artifact"
+      name: Validate Artifact
       ref: tasks/validate-artifact
       kind: Task
       input:
-        artifact_id: "${{ inputs.artifact_id }}"
-        version: "${{ inputs.version }}"
+        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"
+      name: Deploy to Staging
       ref: tasks/deploy-kubernetes
       kind: Task
-      depends_on: [validate-artifact]
-      condition: "${{ inputs.environment == 'staging' || inputs.environment == 'production' }}"
+      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 }}"
+        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"
+      name: Staging Health Check
       ref: tasks/health-check
       kind: Task
-      depends_on: [deploy-staging]
+      depends_on:
+        - deploy-staging
       input:
         endpoints:
-          - "${{ steps.deploy-staging.output.service_url }}/health"
-          - "${{ steps.deploy-staging.output.service_url }}/ready"
+          - ${{ 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"
+      name: AI Smoke Test
       ref: agents/test-runner
       kind: Agent
-      depends_on: [health-staging]
+      depends_on:
+        - health-staging
       input:
-        target_url: "${{ steps.deploy-staging.output.service_url }}"
+        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"
+      name: Production Approval
       type: approval
-      condition: "${{ inputs.environment == 'production' }}"
-      depends_on: [smoke-test]
+      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)
+        staging_results: ${{ steps.smoke-test.output.report_url }}
+        version: ${{ inputs.version }}
     - id: deploy-canary
-      name: "Canary Deployment"
+      name: Canary Deployment
       ref: tasks/deploy-kubernetes
       kind: Task
-      condition: "${{ inputs.environment == 'production' }}"
-      depends_on: [prod-approval]
+      condition: ${{ inputs.environment == 'production' }}
+      depends_on:
+        - prod-approval
       input:
         cluster: production-cluster
-        namespace: "${{ env.APP_NAMESPACE }}"
-        image: "${{ inputs.artifact_id }}:${{ inputs.version }}"
+        namespace: ${{ env.APP_NAMESPACE }}
+        image: ${{ inputs.artifact_id }}:${{ inputs.version }}
         strategy: canary
-        canary_weight: "${{ inputs.canary_percentage }}"
+        canary_weight: ${{ inputs.canary_percentage }}
       timeout_seconds: 300
-
-    # Canary monitoring (Agent - observes metrics)
     - id: monitor-canary
-      name: "Monitor Canary"
+      name: Monitor Canary
       ref: agents/deployment-monitor
       kind: Agent
-      condition: "${{ inputs.environment == 'production' }}"
-      depends_on: [deploy-canary]
+      condition: ${{ inputs.environment == 'production' }}
+      depends_on:
+        - deploy-canary
       input:
-        deployment_id: "${{ steps.deploy-canary.output.deployment_id }}"
+        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"
+      name: Full Production Rollout
       ref: tasks/deploy-kubernetes
       kind: Task
-      condition: "${{ inputs.environment == 'production' && steps.monitor-canary.output.healthy }}"
-      depends_on: [monitor-canary]
+      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 }}"
+        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"
+      name: Notify Success
       ref: tasks/send-notifications
       kind: Task
-      depends_on: [deploy-full]
+      depends_on:
+        - deploy-full
       input:
-        channels: [slack, email]
+        channels:
+          - slack
+          - email
         template: deployment-success
         data:
-          version: "${{ inputs.version }}"
-          environment: "${{ inputs.environment }}"
-          endpoints: "${{ steps.deploy-full.output.endpoints }}"
-
+          version: ${{ inputs.version }}
+          environment: ${{ inputs.environment }}
+          endpoints: ${{ steps.deploy-full.output.endpoints }}
   context:
     variables:
-      trace_id: "${{ uuid() }}"
+      trace_id: ${{ uuid() }}
     secrets:
       - name: KUBECONFIG
         ref: vault://secret/k8s/kubeconfig
       - name: REGISTRY_TOKEN
         ref: vault://secret/registry/token
-
   concurrency:
-    group: "deploy-${{ inputs.environment }}"
+    group: deploy-${{ inputs.environment }}
     cancel_in_progress: false
-
   error_handling:
     on_failure: compensate
     compensation_steps:
       - id: rollback
-        name: "Rollback Deployment"
+        name: Rollback Deployment
         ref: tasks/rollback-deployment
         kind: Task
-        condition: "${{ inputs.rollback_on_failure }}"
+        condition: ${{ inputs.rollback_on_failure }}
         input:
-          cluster: "${{ context.last_cluster }}"
-          deployment_id: "${{ context.last_deployment_id }}"
-          target_version: "${{ context.previous_version }}"
+          cluster: ${{ context.last_cluster }}
+          deployment_id: ${{ context.last_deployment_id }}
+          target_version: ${{ context.previous_version }}
       - id: notify-failure
-        name: "Alert On-Call"
+        name: Alert On-Call
         ref: tasks/send-alert
         kind: Task
         input:
           channel: pagerduty
           severity: critical
-          message: "Deployment failed for version ${{ inputs.version }}"
+          message: Deployment failed for version ${{ inputs.version }}

package/spec/v0.3.2/extensions/agent-identity.yaml

@@ -1,10 +1,10 @@
-# OSSA Agent Identity Extension v0.3.1
+# OSSA Agent Identity Extension v0.3.3
 # Comprehensive specification for agent identity, authentication, and attribution
 ---
 $schema: http://json-schema.org/draft-07/schema#
-$id: https://openstandardagents.org/schemas/v0.3.1/extensions/agent-identity.json
+$id: https://openstandardagents.org/schemas/v0.3.3/extensions/agent-identity.json
 title: OSSA Agent Identity Extension
-version: 0.3.1
+version: 0.3.3
 description: |
   The Agent Identity Extension enables OSSA agents to operate with authenticated
   identities across DevOps platforms (GitLab, GitHub, Azure DevOps, Bitbucket).