同步项目看板

Instructions

Implementation Reference

• src/tools/workflow.ts:264-363 (handler)

  Core implementation of the gitea_workflow_sync_board tool. Loads workflow config, creates project board if missing, syncs columns based on config.board.columns.

  export async function workflowSyncBoard(
    ctx: WorkflowToolsContext,
    args: {
      owner?: string;
      repo?: string;
      config?: WorkflowConfig;
      board_name?: string;
    }
  ): Promise<{
    success: boolean;
    project_id?: number;
    project_name?: string;
    columns_created: string[];
    columns_existing: string[];
    error?: string;
  }> {
    logger.debug({ args: { ...args, config: args.config ? '[provided]' : undefined } }, 'Syncing board');
  
    const { owner, repo } = ctx.contextManager.resolveOwnerRepo(args.owner, args.repo);
  
    // 获取配置
    let config = args.config;
    if (!config) {
      const loadResult = await workflowLoadConfig(ctx, { owner, repo });
      if (!loadResult.success || !loadResult.config) {
        return {
          success: false,
          columns_created: [],
          columns_existing: [],
          error: loadResult.error || '无法加载配置',
        };
      }
      config = loadResult.config;
    }
  
    const boardName = args.board_name || config.board.name;
    const columnsCreated: string[] = [];
    const columnsExisting: string[] = [];
  
    try {
      // 获取现有项目
      const projects = await ctx.client.get<Array<{ id: number; title: string }>>(
        `/repos/${owner}/${repo}/projects`
      );
  
      let project = projects.find((p) => p.title === boardName);
  
      // 创建项目（如果不存在）
      if (!project) {
        project = await ctx.client.post<{ id: number; title: string }>(
          `/repos/${owner}/${repo}/projects`,
          {
            title: boardName,
          }
        );
        logger.info({ owner, repo, project_id: project.id }, 'Project created');
      }
  
      // 获取现有列
      const existingColumns = await ctx.client.get<Array<{ id: number; title: string }>>(
        `/projects/${project.id}/columns`
      );
      const existingColumnNames = new Set(existingColumns.map((c) => c.title));
  
      // 创建缺失的列
      for (const column of config.board.columns) {
        if (existingColumnNames.has(column.name)) {
          columnsExisting.push(column.name);
        } else {
          await ctx.client.post(`/projects/${project.id}/columns`, {
            title: column.name,
          });
          columnsCreated.push(column.name);
        }
      }
  
      logger.info(
        { owner, repo, project_id: project.id, created: columnsCreated.length },
        'Board synced'
      );
  
      return {
        success: true,
        project_id: project.id,
        project_name: boardName,
        columns_created: columnsCreated,
        columns_existing: columnsExisting,
      };
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : String(error);
      logger.error({ owner, repo, error: errorMessage }, 'Failed to sync board');
  
      return {
        success: false,
        columns_created: columnsCreated,
        columns_existing: columnsExisting,
        error: errorMessage,
      };
    }
  }

• src/tools-registry/workflow-registry.ts:120-150 (registration)

  Registers the gitea_workflow_sync_board tool with the MCP server, including input schema and wrapper handler that delegates to workflowSyncBoard.

  mcpServer.registerTool(
    'gitea_workflow_sync_board',
    {
      title: '同步项目看板',
      description:
        'Create or update project board with columns mapped to status labels. Columns: Backlog, In Progress, Review, Testing, Done.',
      inputSchema: z.object({
        owner: z.string().optional().describe('Repository owner. Uses context if not provided'),
        repo: z.string().optional().describe('Repository name. Uses context if not provided'),
        board_name: z.string().optional().describe('Project board name (default: from config)'),
      }),
    },
    async (args) => {
      try {
        const result = await WorkflowTools.workflowSyncBoard(
          { client: ctx.client, contextManager: ctx.contextManager },
          args
        );
        return {
          content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2) }],
          isError: !result.success,
        };
      } catch (error: unknown) {
        const errorMessage = error instanceof Error ? error.message : String(error);
        return {
          content: [{ type: 'text' as const, text: `Error: ${errorMessage}` }],
          isError: true,
        };
      }
    }
  );

• src/tools-registry/workflow-registry.ts:126-131 (schema)

  Zod input schema definition for the tool parameters.

    inputSchema: z.object({
      owner: z.string().optional().describe('Repository owner. Uses context if not provided'),
      repo: z.string().optional().describe('Repository name. Uses context if not provided'),
      board_name: z.string().optional().describe('Project board name (default: from config)'),
    }),
  },