@bluefly/openstandardagents 0.1.9

package/public/src/api/web-eval-mcp.openapi.yml

@@ -0,0 +1,426 @@
+openapi: 3.1.0
+info:
+  title: Web Eval Agent MCP Server API
+  description: |
+    Web Eval Agent MCP Server - Quality assessment and evaluation tools for OSSA v0.1.9.
+    Provides comprehensive web application evaluation, performance analysis, and quality scoring.
+  version: "@bluefly/ossa/v0.1.9"
+  contact:
+    name: OSSA Framework
+    url: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard
+  license:
+    name: MIT
+    url: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/blob/main/LICENSE
+
+servers:
+  - url: mcp://web-eval
+    description: Web Eval Agent MCP Server
+
+paths:
+  /eval/website:
+    post:
+      summary: Evaluate website quality
+      description: Comprehensive evaluation of website performance, accessibility, and quality
+      operationId: evaluateWebsite
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/WebsiteEvalRequest'
+      responses:
+        '200':
+          description: Website evaluation completed
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/WebsiteEvalResponse'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+
+  /eval/performance:
+    post:
+      summary: Performance evaluation
+      description: Detailed performance analysis of web applications
+      operationId: evaluatePerformance
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PerformanceEvalRequest'
+      responses:
+        '200':
+          description: Performance evaluation completed
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PerformanceEvalResponse'
+
+  /eval/accessibility:
+    post:
+      summary: Accessibility evaluation
+      description: WCAG compliance and accessibility assessment
+      operationId: evaluateAccessibility
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AccessibilityEvalRequest'
+      responses:
+        '200':
+          description: Accessibility evaluation completed
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AccessibilityEvalResponse'
+
+  /eval/security:
+    post:
+      summary: Security evaluation
+      description: Security vulnerability assessment and recommendations
+      operationId: evaluateSecurity
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SecurityEvalRequest'
+      responses:
+        '200':
+          description: Security evaluation completed
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SecurityEvalResponse'
+
+  /eval/reports/{evalId}:
+    get:
+      summary: Get evaluation report
+      operationId: getEvaluationReport
+      parameters:
+        - name: evalId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: format
+          in: query
+          schema:
+            type: string
+            enum: [json, html, pdf]
+            default: json
+      responses:
+        '200':
+          description: Evaluation report
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EvaluationReport'
+            text/html:
+              schema:
+                type: string
+            application/pdf:
+              schema:
+                type: string
+                format: binary
+
+components:
+  schemas:
+    WebsiteEvalRequest:
+      type: object
+      required:
+        - url
+      properties:
+        url:
+          type: string
+          format: uri
+        evalTypes:
+          type: array
+          items:
+            type: string
+            enum: [performance, accessibility, security, seo, usability]
+          default: [performance, accessibility, security]
+        device:
+          type: string
+          enum: [desktop, mobile, tablet]
+          default: desktop
+        options:
+          type: object
+          additionalProperties: true
+
+    WebsiteEvalResponse:
+      type: object
+      properties:
+        evalId:
+          type: string
+        url:
+          type: string
+        overallScore:
+          type: number
+          minimum: 0
+          maximum: 100
+        scores:
+          type: object
+          properties:
+            performance:
+              type: number
+            accessibility:
+              type: number
+            security:
+              type: number
+            seo:
+              type: number
+            usability:
+              type: number
+        recommendations:
+          type: array
+          items:
+            $ref: '#/components/schemas/Recommendation'
+        reportUrl:
+          type: string
+
+    PerformanceEvalRequest:
+      type: object
+      required:
+        - url
+      properties:
+        url:
+          type: string
+          format: uri
+        metrics:
+          type: array
+          items:
+            type: string
+            enum: [FCP, LCP, FID, CLS, TTFB, SI]
+        device:
+          type: string
+          enum: [desktop, mobile]
+
+    PerformanceEvalResponse:
+      type: object
+      properties:
+        evalId:
+          type: string
+        metrics:
+          type: object
+          properties:
+            FCP:
+              $ref: '#/components/schemas/PerformanceMetric'
+            LCP:
+              $ref: '#/components/schemas/PerformanceMetric'
+            FID:
+              $ref: '#/components/schemas/PerformanceMetric'
+            CLS:
+              $ref: '#/components/schemas/PerformanceMetric'
+            TTFB:
+              $ref: '#/components/schemas/PerformanceMetric'
+            SI:
+              $ref: '#/components/schemas/PerformanceMetric'
+        overallScore:
+          type: number
+        opportunities:
+          type: array
+          items:
+            $ref: '#/components/schemas/Opportunity'
+
+    AccessibilityEvalRequest:
+      type: object
+      required:
+        - url
+      properties:
+        url:
+          type: string
+          format: uri
+        wcagLevel:
+          type: string
+          enum: [A, AA, AAA]
+          default: AA
+        includeWarnings:
+          type: boolean
+          default: true
+
+    AccessibilityEvalResponse:
+      type: object
+      properties:
+        evalId:
+          type: string
+        score:
+          type: number
+        violations:
+          type: array
+          items:
+            $ref: '#/components/schemas/AccessibilityViolation'
+        warnings:
+          type: array
+          items:
+            $ref: '#/components/schemas/AccessibilityWarning'
+        passedTests:
+          type: integer
+
+    SecurityEvalRequest:
+      type: object
+      required:
+        - url
+      properties:
+        url:
+          type: string
+          format: uri
+        checkTypes:
+          type: array
+          items:
+            type: string
+            enum: [headers, ssl, vulnerabilities, content]
+
+    SecurityEvalResponse:
+      type: object
+      properties:
+        evalId:
+          type: string
+        securityScore:
+          type: number
+        vulnerabilities:
+          type: array
+          items:
+            $ref: '#/components/schemas/SecurityVulnerability'
+        recommendations:
+          type: array
+          items:
+            $ref: '#/components/schemas/SecurityRecommendation'
+
+    EvaluationReport:
+      type: object
+      properties:
+        evalId:
+          type: string
+        url:
+          type: string
+        timestamp:
+          type: string
+          format: date-time
+        summary:
+          $ref: '#/components/schemas/EvaluationSummary'
+        details:
+          type: object
+          additionalProperties: true
+
+    PerformanceMetric:
+      type: object
+      properties:
+        value:
+          type: number
+        unit:
+          type: string
+        score:
+          type: number
+        rating:
+          type: string
+          enum: [good, needs-improvement, poor]
+
+    Opportunity:
+      type: object
+      properties:
+        title:
+          type: string
+        description:
+          type: string
+        impact:
+          type: string
+          enum: [low, medium, high]
+        effort:
+          type: string
+          enum: [low, medium, high]
+
+    AccessibilityViolation:
+      type: object
+      properties:
+        rule:
+          type: string
+        description:
+          type: string
+        severity:
+          type: string
+          enum: [minor, moderate, serious, critical]
+        elements:
+          type: array
+          items:
+            type: string
+        helpUrl:
+          type: string
+
+    AccessibilityWarning:
+      type: object
+      properties:
+        rule:
+          type: string
+        description:
+          type: string
+        elements:
+          type: array
+          items:
+            type: string
+
+    SecurityVulnerability:
+      type: object
+      properties:
+        type:
+          type: string
+        severity:
+          type: string
+          enum: [low, medium, high, critical]
+        description:
+          type: string
+        solution:
+          type: string
+
+    SecurityRecommendation:
+      type: object
+      properties:
+        category:
+          type: string
+        recommendation:
+          type: string
+        priority:
+          type: string
+          enum: [low, medium, high]
+
+    EvaluationSummary:
+      type: object
+      properties:
+        overallScore:
+          type: number
+        passedChecks:
+          type: integer
+        failedChecks:
+          type: integer
+        warnings:
+          type: integer
+
+    Recommendation:
+      type: object
+      properties:
+        category:
+          type: string
+        title:
+          type: string
+        description:
+          type: string
+        priority:
+          type: string
+          enum: [low, medium, high, critical]
+        impact:
+          type: string
+
+  responses:
+    BadRequest:
+      description: Bad request
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              error:
+                type: string
+              message:
+                type: string

package/pyrightconfig.json

@@ -0,0 +1,13 @@
+{
+  "exclude": [
+    "**/node_modules/**",
+    "**/__pycache__/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/examples/**",
+    "**/tests/fixtures/**"
+  ],
+  "reportMissingImports": false,
+  "reportMissingTypeStubs": false,
+  "useLibraryCodeForTypes": false
+}

package/redocly.yaml

@@ -0,0 +1,56 @@
+# Redocly Configuration - LLM Organization OpenAPI Standards
+# This configuration enforces consistent OpenAPI compliance across all projects
+
+extends:
+  - recommended
+
+apis:
+  # OSSA Project APIs
+  ossa-complete:
+    root: ./src/api/ossa-complete.openapi.yml
+  ossa-specification:
+    root: ./src/api/specification.openapi.yml
+  ossa-orchestration:
+    root: ./src/api/orchestration.openapi.yml
+
+# Organization-wide linting rules
+rules:
+  # Mandatory structure rules
+  operation-operationId: error
+  operation-operationId-unique: error
+  tag-description: error
+  info-contact: error
+  info-license: error
+  operation-description: error
+  operation-2xx-response: error
+  operation-4xx-response: warn
+  paths-kebab-case: warn
+  
+  # Security rules
+  security-defined: error
+  no-server-example.com: warn
+  no-server-trailing-slash: error
+  
+  # Schema quality rules
+  no-unresolved-refs: error
+  no-unused-components: warn
+  no-undefined-server-variable: error
+  no-invalid-media-type-examples: error
+  no-identical-paths: error
+  no-ambiguous-paths: error
+  
+  # Documentation quality
+  operation-summary: warn
+  parameter-description: warn
+  no-path-trailing-slash: error
+  
+  # Response standards
+  operation-singular-tag: warn
+  operation-tag-defined: warn
+  
+  # Additional validations
+  boolean-parameter-prefixes: off
+
+# Plugins for enhanced functionality
+plugins:
+  - "@redocly/openapi-core"