Linear

Instructions

Implementation Reference

• src/tools/handlers/initiative-handlers.ts:109-123 (handler)

  The core handler function for the linear_getInitiativeProjects tool. It validates the input arguments using a type guard, logs the action, calls the LinearService to fetch associated projects, and returns them.

  export function getInitiativeProjectsHandler(linearService: LinearService) {
    return async (args: unknown) => {
      if (!isGetInitiativeProjectsInput(args)) {
        throw new Error('Invalid input for getInitiativeProjects');
      }
  
      console.log(`[getInitiativeProjects] Fetching projects for initiative: ${args.initiativeId}`);
      const projects = await linearService.getInitiativeProjects(
        args.initiativeId,
        args.includeArchived,
      );
      console.log(`[getInitiativeProjects] Retrieved ${projects.length} projects`);
      return projects;
    };
  }

• src/tools/definitions/initiative-tools.ts:273-316 (schema)

  The tool definition (MCPToolDefinition) specifying the name, description, input schema, and output schema for linear_getInitiativeProjects.

    name: 'linear_getInitiativeProjects',
    description: 'Get all projects associated with an initiative',
    input_schema: {
      type: 'object',
      properties: {
        initiativeId: {
          type: 'string',
          description: 'The ID of the initiative',
        },
        includeArchived: {
          type: 'boolean',
          description: 'Include archived projects in the results',
          default: false,
        },
      },
      required: ['initiativeId'],
    },
    output_schema: {
      type: 'array',
      items: {
        type: 'object',
        properties: {
          id: { type: 'string' },
          name: { type: 'string' },
          description: { type: 'string' },
          state: { type: 'string' },
          progress: { type: 'number' },
          startDate: { type: 'string' },
          targetDate: { type: 'string' },
          teams: {
            type: 'array',
            items: {
              type: 'object',
              properties: {
                id: { type: 'string' },
                name: { type: 'string' },
              },
            },
          },
          url: { type: 'string' },
        },
      },
    },
  },

• src/tools/handlers/index.ts:97-100 (registration)

  Registration of the linear_getInitiativeProjects handler within the registerToolHandlers function's return object.

  linear_deleteInitiative: deleteInitiativeHandler(linearService),
  linear_getInitiativeProjects: getInitiativeProjectsHandler(linearService),
  linear_addProjectToInitiative: addProjectToInitiativeHandler(linearService),
  linear_removeProjectFromInitiative: removeProjectFromInitiativeHandler(linearService),

• src/tools/type-guards.ts:844-856 (helper)

  Type guard function isGetInitiativeProjectsInput used by the handler to validate input arguments.

  export function isGetInitiativeProjectsInput(args: unknown): args is {
    initiativeId: string;
    includeArchived?: boolean;
  } {
    return (
      typeof args === 'object' &&
      args !== null &&
      'initiativeId' in args &&
      typeof (args as { initiativeId: string }).initiativeId === 'string' &&
      (!('includeArchived' in args) ||
        typeof (args as { includeArchived: boolean }).includeArchived === 'boolean')
    );
  }

• src/tools/handlers/index.ts:179-179 (registration)

  Export of the getInitiativeProjectsHandler function from handlers/index.ts.

  getInitiativeProjectsHandler,