@bluefly/openstandardagents 0.4.8 → 0.5.0

package/openapi/agent-taxonomy.yaml

@@ -9,19 +9,21 @@ info:
     - Domain expertise (devops, security, data, ml, etc.)
     - Capability level (tier_1_read, tier_2_write, tier_3_full, tier_4_policy)
     - Runtime environment (kubernetes, docker, serverless, local)
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 servers:
   - url: http://localhost:3000/api/v1
     description: Local development
-
 paths:
   /taxonomy/categories:
     get:
       summary: List all taxonomy categories
       operationId: listTaxonomyCategories
-      tags: [Taxonomy]
+      tags:
+        - Taxonomy
       responses:
-        '200':
+        "200":
           description: List of taxonomy categories
           content:
             application/json:
@@ -31,32 +33,40 @@ paths:
                   categories:
                     type: array
                     items:
-                      $ref: '#/components/schemas/TaxonomyCategory'
+                      $ref: "#/components/schemas/TaxonomyCategory"
                   total:
                     type: integer
+      x-ossa-capability: list-taxonomy-categories
+      description: List all taxonomy categories
     post:
       summary: Create new category
       operationId: createTaxonomyCategory
-      tags: [Taxonomy]
+      tags:
+        - Taxonomy
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/TaxonomyCategoryInput'
+              $ref: "#/components/schemas/TaxonomyCategoryInput"
       responses:
-        '201':
+        "201":
           description: Category created
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/TaxonomyCategory'
-
+                $ref: "#/components/schemas/TaxonomyCategory"
+      x-ossa-capability: create-taxonomy-category
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Create new category
   /taxonomy/categories/{categoryId}:
     get:
       summary: Get category by ID
       operationId: getTaxonomyCategory
-      tags: [Taxonomy]
+      tags:
+        - Taxonomy
       parameters:
         - name: categoryId
           in: path
@@ -64,19 +74,21 @@ paths:
           schema:
             type: string
       responses:
-        '200':
+        "200":
           description: Taxonomy category details
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/TaxonomyCategory'
-        '404':
+                $ref: "#/components/schemas/TaxonomyCategory"
+        "404":
           description: Category not found
-
+      x-ossa-capability: get-taxonomy-category
+      description: Get category by ID
     put:
       summary: Update category
       operationId: updateTaxonomyCategory
-      tags: [Taxonomy]
+      tags:
+        - Taxonomy
       parameters:
         - name: categoryId
           in: path
@@ -88,19 +100,24 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/TaxonomyCategoryInput'
+              $ref: "#/components/schemas/TaxonomyCategoryInput"
       responses:
-        '200':
+        "200":
           description: Category updated
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/TaxonomyCategory'
-
+                $ref: "#/components/schemas/TaxonomyCategory"
+      x-ossa-capability: update-taxonomy-category
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Update category
     delete:
       summary: Delete category
       operationId: deleteTaxonomyCategory
-      tags: [Taxonomy]
+      tags:
+        - Taxonomy
       parameters:
         - name: categoryId
           in: path
@@ -108,16 +125,21 @@ paths:
           schema:
             type: string
       responses:
-        '204':
+        "204":
           description: Category deleted
-        '404':
+        "404":
           description: Category not found
-
+      x-ossa-capability: delete-taxonomy-category
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Delete category
   /taxonomy/classify:
     post:
       summary: Classify an agent manifest
       operationId: classifyAgent
-      tags: [Taxonomy]
+      tags:
+        - Taxonomy
       requestBody:
         required: true
         content:
@@ -129,18 +151,23 @@ paths:
                   type: object
                   description: OSSA agent manifest to classify
       responses:
-        '200':
+        "200":
           description: Classification result
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AgentClassification'
-
+                $ref: "#/components/schemas/AgentClassification"
+      x-ossa-capability: classify-agent
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Classify an agent manifest
   /taxonomy/validate:
     post:
       summary: Validate taxonomy assignment
       operationId: validateTaxonomy
-      tags: [Taxonomy]
+      tags:
+        - Taxonomy
       requestBody:
         required: true
         content:
@@ -153,13 +180,17 @@ paths:
                 manifest:
                   type: object
       responses:
-        '200':
+        "200":
           description: Validation result
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ValidationResult'
-
+                $ref: "#/components/schemas/ValidationResult"
+      x-ossa-capability: validate-taxonomy
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Validate taxonomy assignment
 components:
   schemas:
     TaxonomyCategory:
@@ -184,7 +215,12 @@ components:
           description: Category description
         type:
           type: string
-          enum: [role, domain, capability, runtime, custom]
+          enum:
+            - role
+            - domain
+            - capability
+            - runtime
+            - custom
           description: Category type
         level:
           type: integer
@@ -211,7 +247,6 @@ components:
         updated_at:
           type: string
           format: date-time
-
     TaxonomyCategoryInput:
       type: object
       required:
@@ -225,7 +260,12 @@ components:
           type: string
         type:
           type: string
-          enum: [role, domain, capability, runtime, custom]
+          enum:
+            - role
+            - domain
+            - capability
+            - runtime
+            - custom
         level:
           type: integer
           minimum: 1
@@ -241,7 +281,6 @@ components:
           type: array
           items:
             type: string
-
     AgentClassification:
       type: object
       required:
@@ -280,7 +319,6 @@ components:
           items:
             type: string
           description: Suggested categories based on manifest analysis
-
     ValidationResult:
       type: object
       required:
@@ -304,7 +342,10 @@ components:
                 type: string
               severity:
                 type: string
-                enum: [error, warning, info]
+                enum:
+                  - error
+                  - warning
+                  - info
         warnings:
           type: array
           items:
@@ -319,3 +360,19 @@ components:
           items:
             type: string
           description: Recommendations for improving taxonomy fit
+x-ossa-metadata:
+  version: 0.3.6
+  compliance:
+    level: standard
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
+x-ossa:
+  version: 0.5.0
+  agent:
+    id: agent-taxonomy-api
+    type: specialist
+tags:
+  - name: Taxonomy
+    description: Taxonomy operations

package/openapi/agents-md-service.yaml

@@ -3,11 +3,12 @@ info:
   title: OSSA AGENTS.md Generation Service
   description: Service for generating and managing agents.md documentation files for repositories.
   version: 1.0.0
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 servers:
   - url: /api/v1/agents-md
     description: v1 API root
-
 paths:
   /generate:
     post:
@@ -38,17 +39,23 @@ paths:
                   type: boolean
                   default: false
       responses:
-        '200':
+        "200":
           description: Successfully generated AGENTS.md
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/GenerationResult'
-        '400':
+                $ref: "#/components/schemas/GenerationResult"
+        "400":
           description: Invalid request
-        '500':
+        "500":
           description: Internal server error
-
+      x-ossa-capability: agents-md-generate-agents-md
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Generate AGENTS.md for a repository
+      tags:
+        - Generate
   /batch:
     post:
       summary: Batch generate AGENTS.md for multiple repositories
@@ -65,12 +72,12 @@ paths:
                 repos:
                   type: array
                   items:
-                    $ref: '#/components/schemas/RepoConfig'
+                    $ref: "#/components/schemas/RepoConfig"
                 parallel:
                   type: boolean
                   default: true
       responses:
-        '200':
+        "200":
           description: Batch generation completed
           content:
             application/json:
@@ -80,7 +87,7 @@ paths:
                   results:
                     type: array
                     items:
-                      $ref: '#/components/schemas/GenerationResult'
+                      $ref: "#/components/schemas/GenerationResult"
                   summary:
                     type: object
                     properties:
@@ -90,7 +97,13 @@ paths:
                         type: integer
                       failed:
                         type: integer
-
+      x-ossa-capability: agents-md-batch-generate-agents-md
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Batch generate AGENTS.md for multiple repositories
+      tags:
+        - Batch
   /:
     get:
       summary: List all repositories with AGENTS.md status
@@ -100,10 +113,13 @@ paths:
           in: query
           schema:
             type: string
-            enum: [has_agents_md, missing_agents_md, all]
+            enum:
+              - has_agents_md
+              - missing_agents_md
+              - all
             default: all
       responses:
-        '200':
+        "200":
           description: List of repository statuses
           content:
             application/json:
@@ -124,7 +140,10 @@ paths:
                           format: date-time
                         validates:
                           type: boolean
-
+      x-ossa-capability: agents-md-list-repos-status
+      description: List all repositories with AGENTS.md status
+      tags:
+        - General
   /{repoId}:
     parameters:
       - name: repoId
@@ -136,7 +155,7 @@ paths:
       summary: Get AGENTS.md status for a repository
       operationId: getRepoStatus
       responses:
-        '200':
+        "200":
           description: Repository AGENTS.md status
           content:
             application/json:
@@ -152,8 +171,12 @@ paths:
                     format: date-time
                   validates:
                     type: boolean
-        '404':
+        "404":
           description: Repository not found
+      x-ossa-capability: agents-md-get-repo-status
+      description: Get AGENTS.md status for a repository
+      tags:
+        - "{RepoId}"
     put:
       summary: Regenerate or update AGENTS.md for a repository
       operationId: updateAgentsMd
@@ -169,7 +192,7 @@ paths:
                   type: boolean
                   default: false
       responses:
-        '200':
+        "200":
           description: Successfully updated AGENTS.md
           content:
             application/json:
@@ -182,6 +205,13 @@ paths:
                     type: string
                   commit_sha:
                     type: string
+      x-ossa-capability: agents-md-update-agents-md
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Regenerate or update AGENTS.md for a repository
+      tags:
+        - "{RepoId}"
     delete:
       summary: Remove AGENTS.md from a repository
       operationId: deleteAgentsMd
@@ -195,7 +225,7 @@ paths:
                   type: boolean
                   default: false
       responses:
-        '200':
+        "200":
           description: Successfully deleted AGENTS.md
           content:
             application/json:
@@ -204,16 +234,24 @@ paths:
                 properties:
                   status:
                     type: string
-                    enum: [success, failure]
+                    enum:
+                      - success
+                      - failure
                   commit_sha:
                     type: string
-
+      x-ossa-capability: agents-md-delete-agents-md
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Remove AGENTS.md from a repository
+      tags:
+        - "{RepoId}"
   /template:
     get:
       summary: Get current AGENTS.md template
       operationId: getTemplate
       responses:
-        '200':
+        "200":
           description: Current template content and variables
           content:
             application/json:
@@ -226,6 +264,10 @@ paths:
                     type: array
                     items:
                       type: string
+      x-ossa-capability: agents-md-get-template
+      description: Get current AGENTS.md template
+      tags:
+        - Template
     put:
       summary: Update AGENTS.md template
       operationId: updateTemplate
@@ -241,7 +283,7 @@ paths:
                 template:
                   type: string
       responses:
-        '200':
+        "200":
           description: Template updated successfully
           content:
             application/json:
@@ -250,10 +292,18 @@ paths:
                 properties:
                   status:
                     type: string
-                    enum: [success, failure]
+                    enum:
+                      - success
+                      - failure
                   validation:
-                    $ref: '#/components/schemas/ValidationResult'
-
+                    $ref: "#/components/schemas/ValidationResult"
+      x-ossa-capability: agents-md-update-template
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Update AGENTS.md template
+      tags:
+        - Template
 components:
   schemas:
     RepoConfig:
@@ -277,7 +327,6 @@ components:
           type: string
         wiki_url:
           type: string
-
     GenerationResult:
       type: object
       required:
@@ -290,16 +339,17 @@ components:
           type: string
         status:
           type: string
-          enum: [success, failed]
+          enum:
+            - success
+            - failed
         content:
           type: string
         commit_sha:
           type: string
         validation:
-          $ref: '#/components/schemas/ValidationResult'
+          $ref: "#/components/schemas/ValidationResult"
         error:
           type: string
-
     ValidationResult:
       type: object
       required:
@@ -318,7 +368,6 @@ components:
           type: array
           items:
             type: string
-
     TemplateVariables:
       type: object
       properties:
@@ -336,3 +385,27 @@ components:
           type: string
         WIKI_URL:
           type: string
+x-ossa-metadata:
+  version: 1.0.0
+  compliance:
+    level: standard
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
+x-ossa:
+  version: 0.5.0
+  agent:
+    id: agents-md-service
+    type: worker
+tags:
+  - name: Batch
+    description: Batch operations
+  - name: General
+    description: General operations
+  - name: Generate
+    description: Generate operations
+  - name: Template
+    description: Template operations
+  - name: "{RepoId}"
+    description: "{RepoId} operations"