@bluefly/openstandardagents 0.3.6 → 0.4.0

package/openapi/{dev-cli.openapi.yml → dev-cli/openapi.yaml}

@@ -50,7 +50,7 @@ paths:
       summary: Validate version consistency
       description: |
         Validates that all version references are consistent.
-        Checks .version.json, package.json, and all files with {{VERSION}}.
+        Checks .version.json, package.json, and all files with 0.3.6.
       tags:
         - Version Management
       responses:
@@ -68,7 +68,7 @@ paths:
       operationId: versionAudit
       summary: Audit for hardcoded versions
       description: |
-        Finds all hardcoded versions (not using {{VERSION}} placeholder).
+        Finds all hardcoded versions (not using 0.3.6 placeholder).
         Returns list of files that need to be updated.
       tags:
         - Version Management
@@ -78,7 +78,7 @@ paths:
           schema:
             type: boolean
             default: false
-          description: Automatically replace hardcoded versions with {{VERSION}}
+          description: Automatically replace hardcoded versions with 0.3.6
       responses:
         '200':
           description: Audit results
@@ -87,12 +87,50 @@ paths:
               schema:
                 $ref: '#/components/schemas/VersionAuditResponse'
 
+  /version/status:
+    get:
+      operationId: versionStatus
+      summary: Get version status and health
+      description: |
+        Shows comprehensive version status including:
+        - Current version from .version.json
+        - Git tag status
+        - Package.json version
+        - Schema files status
+        - Placeholder usage statistics
+      tags:
+        - Version Management
+      responses:
+        '200':
+          description: Version status
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/VersionStatusResponse'
+
+  /version/check:
+    get:
+      operationId: versionCheck
+      summary: Quick version consistency check
+      description: |
+        Fast check for version consistency across critical files.
+        Returns OK/WARN/ERROR status.
+      tags:
+        - Version Management
+      responses:
+        '200':
+          description: Check results
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/VersionCheckResponse'
+
   /version/sync:
     post:
       operationId: versionSync
-      summary: Sync {{VERSION}} placeholders
+      summary: Sync 0.3.6 placeholders
       description: |
-        Replaces {{VERSION}} placeholders with actual version from .version.json.
+        Replaces 0.3.6 placeholders with actual version from .version.json.
         Used during build/CI.
       tags:
         - Version Management
@@ -348,7 +386,70 @@ components:
           description: Line with hardcoded version
         suggested:
           type: string
-          description: Suggested replacement with {{VERSION}}
+          description: Suggested replacement with 0.3.6
+
+    VersionStatusResponse:
+      type: object
+      required:
+        - current
+        - packageJson
+        - gitTag
+        - schemaExists
+        - placeholderStats
+      properties:
+        current:
+          type: string
+          description: Current version from .version.json
+        packageJson:
+          type: string
+          description: Version from package.json
+        gitTag:
+          type: string
+          description: Latest git tag
+        schemaExists:
+          type: boolean
+          description: Whether schema files exist for current version
+        specPath:
+          type: string
+          description: Path to spec directory
+        schemaFile:
+          type: string
+          description: Schema filename
+        placeholderStats:
+          type: object
+          properties:
+            total:
+              type: integer
+              description: Total files with placeholders
+            hardcoded:
+              type: integer
+              description: Files with hardcoded versions
+        health:
+          type: string
+          enum: [healthy, warning, error]
+          description: Overall version health status
+
+    VersionCheckResponse:
+      type: object
+      required:
+        - status
+        - consistent
+      properties:
+        status:
+          type: string
+          enum: [OK, WARN, ERROR]
+          description: Check status
+        consistent:
+          type: boolean
+          description: Whether versions are consistent
+        issues:
+          type: array
+          items:
+            type: string
+          description: List of consistency issues
+        message:
+          type: string
+          description: Human-readable status message
 
     VersionSyncRequest:
       type: object