codecks-mcp

Instructions

Implementation Reference

• src/tools/mutation.ts:124-151 (registration)

  Tool registration for 'mark_done' with input schema (card_ids array) and handler that validates UUIDs and calls client.markDone()

  server.registerTool(
    "mark_done",
    {
      title: "Mark Done",
      description: "Mark cards as done.",
      inputSchema: z.object({
        card_ids: z.array(z.string()).describe("Full 36-char UUIDs"),
      }),
    },
    async (args) => {
      try {
        validateUuidList(args.card_ids);
        const result = await client.markDone(args.card_ids);
        return {
          content: [{ type: "text", text: JSON.stringify(finalizeToolResult(result)) }],
        };
      } catch (err) {
        return {
          content: [
            {
              type: "text",
              text: JSON.stringify(finalizeToolResult(handleError(err))),
            },
          ],
        };
      }
    },
  );

• src/client.ts:450-452 (handler)

  Implementation of markDone method that delegates to updateCards with status='done'

  async markDone(cardIds: string[]): Promise<Record<string, unknown>> {
    return this.updateCards({ cardIds, status: "done" });
  }

• src/client.ts:403-448 (handler)

  Core updateCards implementation that iterates through cardIds and dispatches 'cards/update' API calls for each card

  async updateCards(options: {
    cardIds: string[];
    status?: string;
    priority?: string;
    effort?: string;
    deck?: string;
    title?: string;
    content?: string;
    milestone?: string;
    hero?: string;
    owner?: string;
    tags?: string;
    doc?: string;
    continueOnError?: boolean;
  }): Promise<Record<string, unknown>> {
    const updates: Record<string, unknown> = {};
    if (options.status) updates.status = options.status;
    if (options.priority) {
      updates.priority = options.priority === "null" ? null : options.priority;
    }
    if (options.effort) {
      updates.effort = options.effort === "null" ? null : parseInt(options.effort, 10);
    }
    if (options.title) updates.title = options.title;
    if (options.content !== undefined) updates.content = options.content;
  
    const results: Record<string, unknown>[] = [];
    let updated = 0;
  
    for (const cardId of options.cardIds) {
      try {
        const r = await dispatch("cards/update", {
          cardId,
          update: updates,
        });
        results.push({ card_id: cardId, ok: true, result: r });
        updated++;
      } catch (err) {
        const msg = err instanceof Error ? err.message : String(err);
        results.push({ card_id: cardId, ok: false, error: msg });
        if (!options.continueOnError) break;
      }
    }
  
    return { ok: updated > 0, updated, results };
  }