Add Task Manager integration mutations and types

Introduces GraphQL types and mutations for managing Task Manager integration in projects, including disconnecting and updating settings. Updates the project model to support partial updates, extends resolvers for new mutations, and adds comprehensive tests for these features.

Author: neSpecc

src/models/project.ts

@@ -465,9 +465,16 @@ export default class ProjectModel extends AbstractModel<ProjectDBScheme> impleme
 
   /**
    * Updates project data in DataBase
-   * @param projectData - projectData to save
-   */
-  public async updateProject(projectData: ProjectDBScheme): Promise<ProjectDBScheme> {
+   * Performs partial update - can update one or several properties without requiring full project object
+   *
+   * @param projectData - partial project data containing one or more properties to update.
+   *                     Only provided properties will be updated; others will remain unchanged.
+   *                     Example: `{ name: 'New Name' }` will update only the name field.
+   *                     Example: `{ taskManager: null }` will remove the taskManager field.
+   * @returns {Promise<ProjectDBScheme>} Updated project data
+   * @throws {Error} If project update fails or project not found
+   */
+  public async updateProject(projectData: Partial<ProjectDBScheme>): Promise<ProjectDBScheme> {
     let result;
 
     try {

src/resolvers/project.js

@@ -391,6 +391,102 @@ module.exports = {
 
       return userModel.updateLastProjectVisit(projectId);
     },
+
+    /**
+     * Disconnect Task Manager integration from project
+     *
+     * @param {ResolverObj} _obj
+     * @param {string} projectId - project ID to disconnect Task Manager from
+     * @param {UserInContext} user - current authorized user {@see ../index.js}
+     * @param {ContextFactories} factories - factories for working with models
+     *
+     * @returns {Project}
+     */
+    async disconnectTaskManager(_obj, { projectId }, { user, factories }) {
+      const project = await factories.projectsFactory.findById(projectId);
+
+      if (!project) {
+        throw new ApolloError('There is no project with that id');
+      }
+
+      if (project.workspaceId.toString() === '6213b6a01e6281087467cc7a') {
+        throw new ApolloError('Unable to update demo project');
+      }
+
+      try {
+        /**
+         * Remove taskManager field from project
+         * Set updatedAt to current date
+         */
+        return await project.updateProject({
+          taskManager: null,
+        });
+      } catch (err) {
+        throw new ApolloError('Failed to disconnect Task Manager', { originalError: err });
+      }
+    },
+
+    /**
+     * Update Task Manager settings for project
+     *
+     * @param {ResolverObj} _obj
+     * @param {Object} input - Task Manager settings input
+     * @param {string} input.projectId - project ID to update
+     * @param {boolean} input.autoTaskEnabled - enable automatic task creation
+     * @param {number} input.taskThresholdTotalCount - threshold for auto task creation
+     * @param {boolean} input.assignAgent - assign agent (e.g. Copilot) to tasks
+     * @param {UserInContext} user - current authorized user {@see ../index.js}
+     * @param {ContextFactories} factories - factories for working with models
+     *
+     * @returns {Project}
+     */
+    async updateTaskManagerSettings(_obj, { input }, { user, factories }) {
+      const { projectId, autoTaskEnabled, taskThresholdTotalCount, assignAgent } = input;
+
+      const project = await factories.projectsFactory.findById(projectId);
+
+      if (!project) {
+        throw new ApolloError('There is no project with that id');
+      }
+
+      if (project.workspaceId.toString() === '6213b6a01e6281087467cc7a') {
+        throw new ApolloError('Unable to update demo project');
+      }
+
+      /**
+       * Check if taskManager is configured
+       */
+      if (!project.taskManager) {
+        throw new UserInputError('Task Manager is not configured for this project');
+      }
+
+      /**
+       * Validate taskThresholdTotalCount
+       */
+      if (typeof taskThresholdTotalCount !== 'number' || taskThresholdTotalCount <= 0) {
+        throw new UserInputError('taskThresholdTotalCount must be a positive integer greater than 0');
+      }
+
+      try {
+        /**
+         * Update taskManager settings
+         * Keep existing config and usage, update only settings
+         */
+        const updatedTaskManager = {
+          ...project.taskManager,
+          autoTaskEnabled,
+          taskThresholdTotalCount,
+          assignAgent,
+          updatedAt: new Date(),
+        };
+
+        return await project.updateProject({
+          taskManager: updatedTaskManager,
+        });
+      } catch (err) {
+        throw new ApolloError('Failed to update Task Manager settings', { originalError: err });
+      }
+    },
   },
   Project: {
     /**

src/typeDefs/index.ts

@@ -9,6 +9,8 @@ import projectNotificationsMutations from './projectNotificationsMutations';
 import projectEventGroupingPattern from './projectEventGroupingPattern';
 import projectEventGroupingPatternMutations from './projectEventGroupingPatternMutations';
 import project from './project';
+import taskManager from './taskManager';
+import projectTaskManagerMutations from './projectTaskManagerMutations';
 import user from './user';
 import userNotifications from './userNotifications';
 import userNotificationsMutations from './userNotificationsMutations';
@@ -93,6 +95,8 @@ const typeDefinitions = [
   projectNotifications,
   projectNotificationsMutations,
   project,
+  taskManager,
+  projectTaskManagerMutations,
   user,
   userNotifications,
   userNotificationsMutations,

src/typeDefs/project.ts

@@ -402,6 +402,11 @@ type Project {
   Detailed info for a specific release
   """
   releaseDetails(release: String!): ProjectReleaseDetails!
+
+  """
+  Task Manager integration configuration
+  """
+  taskManager: TaskManager
 }
 
 extend type Query {

src/typeDefs/projectTaskManagerMutations.ts

@@ -0,0 +1,50 @@
+import { gql } from 'apollo-server-express';
+
+export default gql`
+  """
+  Input type for updating task manager settings
+  """
+  input UpdateTaskManagerSettingsInput {
+    """
+    Project ID to update
+    """
+    projectId: ID!
+
+    """
+    Enable automatic task creation by scheduled worker
+    """
+    autoTaskEnabled: Boolean!
+
+    """
+    Threshold for auto task creation (minimum totalCount)
+    """
+    taskThresholdTotalCount: Int!
+
+    """
+    Assign agent (e.g. Copilot) to newly created tasks
+    """
+    assignAgent: Boolean!
+  }
+
+  extend type Mutation {
+    """
+    Disconnect Task Manager integration from project
+    """
+    disconnectTaskManager(
+      """
+      Project ID to disconnect Task Manager from
+      """
+      projectId: ID!
+    ): Project! @requireAdmin
+
+    """
+    Update Task Manager settings for project
+    """
+    updateTaskManagerSettings(
+      """
+      Task Manager settings input
+      """
+      input: UpdateTaskManagerSettingsInput!
+    ): Project! @requireAdmin
+  }
+`;

src/typeDefs/taskManager.ts

@@ -0,0 +1,83 @@
+import { gql } from 'apollo-server-express';
+
+export default gql`
+  """
+  Task Manager usage tracking for daily auto-task budget
+  """
+  type TaskManagerUsage {
+    """
+    UTC day boundary (e.g. 2026-01-17T00:00:00.000Z)
+    """
+    dayStartUtc: DateTime!
+
+    """
+    Number of auto-created tasks since dayStartUtc
+    """
+    autoTasksCreated: Int!
+  }
+
+  """
+  GitHub Task Manager specific configuration
+  """
+  type GitHubTaskManagerConfig {
+    """
+    GitHub App installation ID
+    """
+    installationId: String!
+
+    """
+    Repository ID
+    """
+    repoId: String!
+
+    """
+    Repository full name (owner/repo)
+    """
+    repoFullName: String!
+  }
+
+  """
+  Task Manager configuration for project
+  """
+  type TaskManager {
+    """
+    Type of task manager (currently only 'github' is supported)
+    """
+    type: String!
+
+    """
+    Enable automatic task creation by scheduled worker
+    """
+    autoTaskEnabled: Boolean!
+
+    """
+    Threshold for auto task creation (minimum totalCount)
+    """
+    taskThresholdTotalCount: Int!
+
+    """
+    Assign agent (e.g. Copilot) to newly created tasks
+    """
+    assignAgent: Boolean!
+
+    """
+    Usage tracking for daily auto-task budget
+    """
+    usage: TaskManagerUsage
+
+    """
+    Date when integration was connected
+    """
+    connectedAt: DateTime!
+
+    """
+    Date when configuration was last updated
+    """
+    updatedAt: DateTime!
+
+    """
+    Task manager specific configuration (typed by type)
+    """
+    config: GitHubTaskManagerConfig!
+  }
+`;