@aifabrix/builder 2.49.2 → 2.50.0

package/integration/github/github-datasource-issues.json

@@ -0,0 +1,399 @@
+{
+  "key": "github-issues",
+  "displayName": "GitHub Issues",
+  "description": "Repository issues via GitHub REST API: list, get, create, update, and close (GitHub does not support hard delete).",
+  "enabled": true,
+  "systemKey": "github",
+  "resourceType": "ticket",
+  "entityType": "recordStorage",
+  "version": "1.0.0",
+  "businessOrder": 1,
+  "metadataSchema": {
+    "type": "object",
+    "properties": {
+      "externalId": {
+        "type": "string",
+        "index": true,
+        "description": "Stable external record identifier (issue number as string)"
+      },
+      "number": {
+        "type": "integer",
+        "index": true,
+        "description": "Issue number within the repository"
+      },
+      "id": {
+        "type": "integer",
+        "description": "GitHub internal issue id"
+      },
+      "title": {
+        "type": "string",
+        "index": true,
+        "filter": true,
+        "description": "Issue title"
+      },
+      "body": {
+        "type": "string",
+        "description": "Issue body (markdown)"
+      },
+      "state": {
+        "type": "string",
+        "index": true,
+        "filter": true,
+        "description": "Issue state: open or closed"
+      },
+      "htmlUrl": {
+        "type": "string",
+        "format": "uri",
+        "description": "Web URL for the issue"
+      },
+      "createdAt": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Issue creation timestamp"
+      },
+      "updatedAt": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Issue last update timestamp"
+      }
+    },
+    "required": [
+      "number",
+      "title"
+    ]
+  },
+  "fieldMappings": {
+    "attributes": {
+      "externalId": {
+        "expression": "{{raw.number}}"
+      },
+      "number": {
+        "expression": "{{raw.number}}"
+      },
+      "id": {
+        "expression": "{{raw.id}}"
+      },
+      "title": {
+        "expression": "{{raw.title}}"
+      },
+      "body": {
+        "expression": "{{raw.body}}"
+      },
+      "state": {
+        "expression": "{{raw.state}}"
+      },
+      "htmlUrl": {
+        "expression": "{{raw.html_url}}"
+      },
+      "createdAt": {
+        "expression": "{{raw.created_at}}"
+      },
+      "updatedAt": {
+        "expression": "{{raw.updated_at}}"
+      }
+    }
+  },
+  "primaryKey": [
+    "number"
+  ],
+  "labelKey": [
+    "title"
+  ],
+  "exposed": {
+    "filterable": [
+      "title",
+      "state"
+    ],
+    "readonly": [
+      "number",
+      "id",
+      "htmlUrl",
+      "createdAt",
+      "updatedAt"
+    ],
+    "schema": {
+      "externalId": "metadata.externalId",
+      "number": "metadata.number",
+      "id": "metadata.id",
+      "title": "metadata.title",
+      "body": "metadata.body",
+      "state": "metadata.state",
+      "htmlUrl": "metadata.htmlUrl",
+      "createdAt": "metadata.createdAt",
+      "updatedAt": "metadata.updatedAt"
+    },
+    "profiles": {
+      "default": [
+        "number",
+        "title",
+        "body",
+        "state",
+        "htmlUrl",
+        "createdAt",
+        "updatedAt"
+      ],
+      "create": [
+        "title",
+        "body"
+      ],
+      "update": [
+        "title",
+        "body",
+        "state"
+      ]
+    }
+  },
+  "openapi": {
+    "enabled": true,
+    "autoRbac": false,
+    "operations": {
+      "list": {
+        "operationId": "list-repos-owner-repo-issues",
+        "method": "GET",
+        "path": "/repos/{GITHUB_OWNER}/{GITHUB_REPO}/issues",
+        "permissions": ["external-system:read"]
+      },
+      "get": {
+        "operationId": "get-repos-owner-repo-issues-issue-number",
+        "method": "GET",
+        "path": "/repos/{GITHUB_OWNER}/{GITHUB_REPO}/issues/{recordId}",
+        "permissions": ["external-system:read"]
+      }
+    },
+    "documentKey": "github-issues"
+  },
+  "quality": {
+    "rejectIf": [
+      {
+        "field": "number",
+        "operator": "empty",
+        "message": "Issue number cannot be empty"
+      },
+      {
+        "field": "title",
+        "operator": "empty",
+        "message": "Issue title cannot be empty"
+      }
+    ]
+  },
+  "testPayload": {
+    "payloadTemplate": {
+      "id": 100001,
+      "number": 42,
+      "title": "E2E test issue",
+      "body": "Created by AI Fabrix github integration.",
+      "state": "open",
+      "html_url": "https://github.com/octocat/Hello-World/issues/42",
+      "created_at": "2025-01-15T10:30:00Z",
+      "updated_at": "2025-01-15T10:30:00Z"
+    },
+    "expectedResult": {
+      "number": 42,
+      "title": "E2E test issue",
+      "body": "Created by AI Fabrix github integration.",
+      "state": "open",
+      "htmlUrl": "https://github.com/octocat/Hello-World/issues/42"
+    }
+  },
+  "execution": {
+    "engine": "cip",
+    "cip": {
+      "version": "1.0",
+      "inputType": "void",
+      "outputType": "records",
+      "operations": {
+        "list": {
+          "enabled": true,
+          "description": "List open issues for the configured repository (pull requests excluded)",
+          "steps": [
+            {
+              "fetch": {
+                "source": "openapi",
+                "openapiRef": "list",
+                "query": {
+                  "state": "open",
+                  "per_page": "100"
+                }
+              }
+            },
+            {
+              "filter": {
+                "abac": {
+                  "mode": "disabled"
+                },
+                "expression": "[?pull_request==`null`][]",
+                "expressionLanguage": "jmespath",
+                "maxComplexity": 50
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        },
+        "get": {
+          "enabled": true,
+          "description": "Get issue by issue number",
+          "steps": [
+            {
+              "fetch": {
+                "source": "openapi",
+                "openapiRef": "get"
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        },
+        "create": {
+          "enabled": true,
+          "description": "Create a new issue in the configured repository",
+          "steps": [
+            {
+              "fetch": {
+                "source": "http",
+                "method": "POST",
+                "path": "/repos/{{GITHUB_OWNER}}/{{GITHUB_REPO}}/issues",
+                "headers": {
+                  "Accept": "application/vnd.github+json",
+                  "X-GitHub-Api-Version": "2022-11-28",
+                  "Content-Type": "application/json"
+                },
+                "bodyTemplate": {
+                  "title": "{{parameters.title}}",
+                  "body": "{{parameters.body}}"
+                }
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        },
+        "update": {
+          "enabled": true,
+          "description": "Update issue title, body, or state",
+          "steps": [
+            {
+              "fetch": {
+                "source": "http",
+                "method": "PATCH",
+                "path": "/repos/{{GITHUB_OWNER}}/{{GITHUB_REPO}}/issues/{{recordId}}",
+                "headers": {
+                  "Accept": "application/vnd.github+json",
+                  "X-GitHub-Api-Version": "2022-11-28",
+                  "Content-Type": "application/json"
+                },
+                "bodyTemplate": {
+                  "title": "{{parameters.title}}",
+                  "body": "{{parameters.body}}",
+                  "state": "{{parameters.state}}"
+                }
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        },
+        "delete": {
+          "enabled": true,
+          "description": "Close issue (GitHub REST API does not support hard delete; maps delete to state=closed)",
+          "steps": [
+            {
+              "fetch": {
+                "source": "http",
+                "method": "PATCH",
+                "path": "/repos/{{GITHUB_OWNER}}/{{GITHUB_REPO}}/issues/{{recordId}}",
+                "headers": {
+                  "Accept": "application/vnd.github+json",
+                  "X-GitHub-Api-Version": "2022-11-28",
+                  "Content-Type": "application/json"
+                },
+                "bodyTemplate": {
+                  "state": "closed"
+                }
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        }
+      }
+    }
+  },
+  "capabilities": [
+    {
+      "key": "list",
+      "description": "List open repository issues",
+      "riskLevel": "low",
+      "approvalRequired": false
+    },
+    {
+      "key": "get",
+      "description": "Get issue by number",
+      "riskLevel": "low",
+      "approvalRequired": false
+    },
+    {
+      "key": "create",
+      "description": "Create a repository issue",
+      "riskLevel": "medium",
+      "approvalRequired": false
+    },
+    {
+      "key": "update",
+      "description": "Update issue title, body, or state",
+      "riskLevel": "medium",
+      "approvalRequired": false
+    },
+    {
+      "key": "delete",
+      "description": "Close issue (GitHub has no hard delete)",
+      "riskLevel": "medium",
+      "approvalRequired": false
+    }
+  ]
+}