M17: ground knowledge and integration evidence

contracts/openapi.yaml

@@ -19,6 +19,32 @@ paths:
                   type: string
                 type: object
                 title: Response Health Health Get
+  /health/live:
+    get:
+      summary: Liveness
+      description: Process liveness only; external dependencies deliberately do not affect it.
+      operationId: liveness_health_live_get
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema:
+                additionalProperties:
+                  type: string
+                type: object
+                title: Response Liveness Health Live Get
+  /health/ready:
+    get:
+      summary: Readiness
+      description: 'Traffic readiness: the API is useful only while its canonical database responds.'
+      operationId: readiness_health_ready_get
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema: {}
   /api/v1/system/status:
     get:
       summary: System Status
@@ -1436,6 +1462,34 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/HTTPValidationError'
+  /api/v1/knowledge/feedback:
+    post:
+      tags:
+      - knowledge
+      summary: Record Feedback
+      operationId: record_feedback_api_v1_knowledge_feedback_post
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/KnowledgeFeedbackRequest'
+        required: true
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema:
+                additionalProperties:
+                  type: string
+                type: object
+                title: Response Record Feedback Api V1 Knowledge Feedback Post
+        '422':
+          description: Validation Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
   /api/v1/knowledge/status:
     get:
       tags:
@@ -2882,6 +2936,20 @@ components:
       - n8n
       - mcp_hub
       title: IntegrationStatusOut
+    KnowledgeFeedbackRequest:
+      properties:
+        correlation_id:
+          type: string
+          format: uuid
+          title: Correlation Id
+        helpful:
+          type: boolean
+          title: Helpful
+      type: object
+      required:
+      - correlation_id
+      - helpful
+      title: KnowledgeFeedbackRequest
     KnowledgeHealth:
       properties:
         provider:
@@ -3853,6 +3921,11 @@ components:
         type:
           type: string
           title: Error Type
+        input:
+          title: Input
+        ctx:
+          type: object
+          title: Context
       type: object
       required:
       - loc