@commandable/integration-data 0.0.6 → 0.1.0

package/integrations/jira/schemas/create_issue.json

@@ -0,0 +1,49 @@
+{
+  "type": "object",
+  "properties": {
+    "projectKey": {
+      "type": "string",
+      "description": "Project key, e.g. \"PROJ\"."
+    },
+    "summary": {
+      "type": "string",
+      "description": "Issue summary/title."
+    },
+    "descriptionText": {
+      "type": "string",
+      "description": "Markdown issue description. The handler converts this to Jira ADF."
+    },
+    "issueTypeName": {
+      "type": "string",
+      "description": "Issue type name, e.g. \"Task\", \"Bug\", \"Story\"."
+    },
+    "issueTypeId": {
+      "type": "string",
+      "description": "Issue type ID (alternative to issueTypeName)."
+    },
+    "priorityName": {
+      "type": "string",
+      "description": "Priority name, e.g. \"High\"."
+    },
+    "priorityId": {
+      "type": "string",
+      "description": "Priority ID (alternative to priorityName)."
+    },
+    "labels": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional labels to apply."
+    },
+    "assigneeAccountId": {
+      "type": "string",
+      "description": "Optional assignee accountId. Use search_users to find accountIds."
+    }
+  },
+  "required": ["projectKey", "summary"],
+  "anyOf": [
+    { "required": ["issueTypeName"] },
+    { "required": ["issueTypeId"] }
+  ],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/create_sprint.json

@@ -0,0 +1,29 @@
+{
+  "type": "object",
+  "properties": {
+    "boardId": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Origin board ID to create the sprint in (sent to Jira as originBoardId)."
+    },
+    "name": {
+      "type": "string",
+      "description": "Sprint name."
+    },
+    "startDate": {
+      "type": "string",
+      "description": "Optional start date (ISO 8601)."
+    },
+    "endDate": {
+      "type": "string",
+      "description": "Optional end date (ISO 8601)."
+    },
+    "goal": {
+      "type": "string",
+      "description": "Optional sprint goal."
+    }
+  },
+  "required": ["boardId", "name"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/delete_issue.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "issueIdOrKey": {
+      "type": "string",
+      "description": "Issue key like \"PROJ-123\" or numeric issue ID."
+    }
+  },
+  "required": ["issueIdOrKey"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/empty.json

@@ -0,0 +1,6 @@
+{
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/get_backlog_issues.json

@@ -0,0 +1,33 @@
+{
+  "type": "object",
+  "properties": {
+    "boardId": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Board ID."
+    },
+    "jql": {
+      "type": "string",
+      "description": "Optional additional JQL to filter backlog issues."
+    },
+    "fields": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional issue fields to include."
+    },
+    "startAt": {
+      "type": "integer",
+      "minimum": 0,
+      "default": 0
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "default": 50
+    }
+  },
+  "required": ["boardId"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/get_board.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "boardId": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Board ID."
+    }
+  },
+  "required": ["boardId"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/get_issue.json

@@ -0,0 +1,23 @@
+{
+  "type": "object",
+  "properties": {
+    "issueIdOrKey": {
+      "type": "string",
+      "title": "Issue key or ID",
+      "description": "Issue key like \"PROJ-123\" or numeric issue ID."
+    },
+    "fields": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional list of fields to request. If omitted, a reasonable default set is used."
+    },
+    "expand": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional expand values supported by Jira (e.g. [\"renderedFields\"])."
+    }
+  },
+  "required": ["issueIdOrKey"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/get_issue_comments.json

@@ -0,0 +1,23 @@
+{
+  "type": "object",
+  "properties": {
+    "issueIdOrKey": {
+      "type": "string",
+      "description": "Issue key like \"PROJ-123\" or numeric issue ID."
+    },
+    "startAt": {
+      "type": "integer",
+      "minimum": 0,
+      "default": 0
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "default": 50
+    }
+  },
+  "required": ["issueIdOrKey"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/get_project.json

@@ -0,0 +1,17 @@
+{
+  "type": "object",
+  "properties": {
+    "projectIdOrKey": {
+      "type": "string",
+      "description": "Project key like \"PROJ\" or numeric project ID."
+    },
+    "expandIssueTypes": {
+      "type": "boolean",
+      "default": true,
+      "description": "If true, expands the project response to include issue types."
+    }
+  },
+  "required": ["projectIdOrKey"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/get_sprint.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "sprintId": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Sprint ID."
+    }
+  },
+  "required": ["sprintId"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/get_sprint_issues.json

@@ -0,0 +1,33 @@
+{
+  "type": "object",
+  "properties": {
+    "sprintId": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Sprint ID."
+    },
+    "jql": {
+      "type": "string",
+      "description": "Optional additional JQL to filter sprint issues."
+    },
+    "fields": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional issue fields to include."
+    },
+    "startAt": {
+      "type": "integer",
+      "minimum": 0,
+      "default": 0
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "default": 50
+    }
+  },
+  "required": ["sprintId"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/get_transitions.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "issueIdOrKey": {
+      "type": "string",
+      "description": "Issue key like \"PROJ-123\" or numeric issue ID."
+    }
+  },
+  "required": ["issueIdOrKey"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/list_boards.json

@@ -0,0 +1,27 @@
+{
+  "type": "object",
+  "properties": {
+    "projectKeyOrId": {
+      "type": "string",
+      "description": "Optional project key (e.g. \"PROJ\") or project ID to filter boards."
+    },
+    "type": {
+      "type": "string",
+      "enum": ["scrum", "kanban"],
+      "description": "Optional board type filter."
+    },
+    "startAt": {
+      "type": "integer",
+      "minimum": 0,
+      "default": 0
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50,
+      "default": 50
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/list_projects.json

@@ -0,0 +1,22 @@
+{
+  "type": "object",
+  "properties": {
+    "query": {
+      "type": "string",
+      "description": "Optional search text to filter projects by name or key."
+    },
+    "startAt": {
+      "type": "integer",
+      "minimum": 0,
+      "default": 0
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50,
+      "default": 50
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/list_sprints.json

@@ -0,0 +1,29 @@
+{
+  "type": "object",
+  "properties": {
+    "boardId": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Board ID."
+    },
+    "state": {
+      "type": "array",
+      "items": { "type": "string", "enum": ["future", "active", "closed"] },
+      "description": "Optional sprint states to include. If omitted, Jira returns all."
+    },
+    "startAt": {
+      "type": "integer",
+      "minimum": 0,
+      "default": 0
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50,
+      "default": 50
+    }
+  },
+  "required": ["boardId"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/move_issues_to_sprint.json

@@ -0,0 +1,19 @@
+{
+  "type": "object",
+  "properties": {
+    "sprintId": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Sprint ID."
+    },
+    "issueKeys": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" },
+      "description": "Issue keys to move into the sprint, e.g. [\"PROJ-1\",\"PROJ-2\"]."
+    }
+  },
+  "required": ["sprintId", "issueKeys"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/search_issues.json

@@ -0,0 +1,28 @@
+{
+  "type": "object",
+  "properties": {
+    "jql": {
+      "type": "string",
+      "title": "JQL",
+      "description": "Jira Query Language string, e.g. \"project = PROJ AND status != Done ORDER BY updated DESC\"."
+    },
+    "fields": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional list of fields to include (e.g. [\"summary\",\"status\",\"assignee\"]). If omitted, Jira uses its default set."
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 200,
+      "default": 50
+    },
+    "nextPageToken": {
+      "type": ["string", "null"],
+      "description": "Token from a previous response to fetch the next page."
+    }
+  },
+  "required": ["jql"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/search_users.json

@@ -0,0 +1,18 @@
+{
+  "type": "object",
+  "properties": {
+    "query": {
+      "type": "string",
+      "description": "Free-text query (name or email) to search users."
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "default": 50
+    }
+  },
+  "required": ["query"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/transition_issue.json

@@ -0,0 +1,38 @@
+{
+  "type": "object",
+  "properties": {
+    "issueIdOrKey": {
+      "type": "string",
+      "description": "Issue key like \"PROJ-123\" or numeric issue ID."
+    },
+    "transitionId": {
+      "type": "string",
+      "description": "Transition ID to apply. If omitted, provide transitionName."
+    },
+    "transitionName": {
+      "type": "string",
+      "description": "Human-readable transition name (case-insensitive). If provided, the handler will resolve it to an ID via get_transitions."
+    },
+    "commentText": {
+      "type": "string",
+      "description": "Optional comment to add during the transition (plain text, converted to ADF)."
+    },
+    "fields": {
+      "type": "object",
+      "description": "Optional Jira fields to set during the transition.",
+      "additionalProperties": true
+    },
+    "update": {
+      "type": "object",
+      "description": "Optional Jira update operations to apply during the transition.",
+      "additionalProperties": true
+    }
+  },
+  "required": ["issueIdOrKey"],
+  "anyOf": [
+    { "required": ["transitionId"] },
+    { "required": ["transitionName"] }
+  ],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/update_issue.json

@@ -0,0 +1,47 @@
+{
+  "type": "object",
+  "properties": {
+    "issueIdOrKey": {
+      "type": "string",
+      "description": "Issue key like \"PROJ-123\" or numeric issue ID."
+    },
+    "summary": {
+      "type": "string",
+      "description": "Set the issue summary/title."
+    },
+    "descriptionText": {
+      "type": "string",
+      "description": "Set the issue description as plain text (converted to ADF)."
+    },
+    "labels": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Set the full labels array (replaces existing labels)."
+    },
+    "priorityName": {
+      "type": "string",
+      "description": "Set priority by name."
+    },
+    "priorityId": {
+      "type": "string",
+      "description": "Set priority by ID."
+    },
+    "assigneeAccountId": {
+      "type": ["string", "null"],
+      "description": "Assign to this accountId, or null to unassign."
+    },
+    "fields": {
+      "type": "object",
+      "description": "Advanced: direct Jira fields object. This is passed through to the Jira API. Use only if you know Jira field formats.",
+      "additionalProperties": true
+    },
+    "update": {
+      "type": "object",
+      "description": "Advanced: Jira update operations object. Use for add/remove operations on fields like labels.",
+      "additionalProperties": true
+    }
+  },
+  "required": ["issueIdOrKey"],
+  "additionalProperties": false
+}
+

package/integrations/jira/schemas/update_sprint.json

@@ -0,0 +1,33 @@
+{
+  "type": "object",
+  "properties": {
+    "sprintId": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Sprint ID to update."
+    },
+    "name": {
+      "type": "string",
+      "description": "New sprint name."
+    },
+    "goal": {
+      "type": "string",
+      "description": "Sprint goal."
+    },
+    "state": {
+      "type": "string",
+      "enum": ["future", "active", "closed"],
+      "description": "Sprint state. Use 'active' to start a sprint, 'closed' to end it. Transitioning to 'active' requires startDate."
+    },
+    "startDate": {
+      "type": "string",
+      "description": "Sprint start date (ISO 8601, e.g. 2024-01-15). Required when starting a sprint (state: active)."
+    },
+    "endDate": {
+      "type": "string",
+      "description": "Sprint end date (ISO 8601, e.g. 2024-01-29). Required when starting a sprint (state: active)."
+    }
+  },
+  "required": ["sprintId"],
+  "additionalProperties": false
+}