Michael Czechowski
59411ede0f
JSON Schema definitions for all pipeline handover contracts including issue analysis, research, enhancement, and sync flows. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
85 lines
2.4 KiB
JSON
85 lines
2.4 KiB
JSON
{
|
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
"title": "GitHub Comment Result",
|
|
"description": "Result of posting research report as a GitHub issue comment",
|
|
"type": "object",
|
|
"required": ["success", "issue_reference", "timestamp"],
|
|
"properties": {
|
|
"success": {
|
|
"type": "boolean",
|
|
"description": "Whether the comment was successfully posted"
|
|
},
|
|
"issue_reference": {
|
|
"type": "object",
|
|
"required": ["issue_number", "repository"],
|
|
"properties": {
|
|
"issue_number": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"description": "Issue number that was commented on"
|
|
},
|
|
"repository": {
|
|
"type": "string",
|
|
"pattern": "^[^/]+/[^/]+$",
|
|
"description": "Repository full name"
|
|
},
|
|
"issue_url": {
|
|
"type": "string",
|
|
"format": "uri",
|
|
"description": "URL to the issue"
|
|
}
|
|
}
|
|
},
|
|
"comment": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"description": "GitHub comment ID"
|
|
},
|
|
"url": {
|
|
"type": "string",
|
|
"format": "uri",
|
|
"description": "Direct URL to the posted comment"
|
|
},
|
|
"body_length": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"description": "Length of the posted comment body in characters"
|
|
},
|
|
"created_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "When the comment was created"
|
|
}
|
|
},
|
|
"description": "Details of the posted comment (only present if success=true)"
|
|
},
|
|
"error": {
|
|
"type": "object",
|
|
"properties": {
|
|
"code": {
|
|
"type": "string",
|
|
"enum": ["authentication_failed", "rate_limit_exceeded", "issue_not_found", "issue_locked", "permission_denied", "comment_too_long", "network_error", "api_error", "unknown_error"],
|
|
"description": "Error code"
|
|
},
|
|
"message": {
|
|
"type": "string",
|
|
"description": "Human-readable error message"
|
|
},
|
|
"retryable": {
|
|
"type": "boolean",
|
|
"description": "Whether the operation can be retried"
|
|
}
|
|
},
|
|
"description": "Error details (only present if success=false)"
|
|
},
|
|
"timestamp": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "Operation timestamp"
|
|
}
|
|
}
|
|
}
|