@omnicoreos/planka-mcp 0.2.0

package/dist/operations/boards.d.ts

@@ -0,0 +1,143 @@
+import { Board, List, Card, Label, CardLabel, TaskList, Task } from "../schemas/entities.js";
+import { BoardIdInput, BoardSummaryInput, FindCardsInput, GetCardsForListInput, ListCardsInput } from "../schemas/requests.js";
+/**
+ * Full board details with all included entities.
+ */
+export interface BoardDetails {
+    board: Board;
+    lists: List[];
+    cards: Card[];
+    labels: Label[];
+    cardLabels: CardLabel[];
+    taskLists: TaskList[];
+    tasks: Task[];
+}
+/**
+ * Card with computed task counts.
+ */
+export interface CardWithTaskCounts extends Card {
+    taskCount: number;
+    completedTaskCount: number;
+}
+/**
+ * Get a board by ID with all included entities.
+ */
+export declare function getBoard(input: BoardIdInput): Promise<BoardDetails>;
+/**
+ * Get a board with cards enriched with task counts.
+ */
+export declare function getBoardWithTaskCounts(input: BoardIdInput): Promise<{
+    board: Board;
+    lists: List[];
+    cards: CardWithTaskCounts[];
+    labels: Label[];
+    cardLabels: CardLabel[];
+}>;
+/**
+ * Cards of one list with labels resolved and task counts — WITHOUT pulling the
+ * whole board. Uses the native GET /api/lists/:id/cards endpoint (PLANKA 2.0),
+ * which includes cardLabels/taskLists/tasks but NOT the board's labels: names
+ * come from a single extra GET on the board, and only when withLabels is set.
+ */
+export type CardWithLabels = CardWithTaskCounts & {
+    labelNames: string[];
+};
+export interface ListCardsRawResult {
+    cards: CardWithLabels[];
+    /** true when pagination stopped before the list was exhausted. */
+    truncated: boolean;
+}
+export declare function getCardsForList(input: GetCardsForListInput): Promise<ListCardsRawResult>;
+/** A list with its card count, without the cards. */
+export interface ListWithCardCount {
+    id: string;
+    name: string;
+    type?: string;
+    cardCount: number;
+}
+/** Ignores case and accents: "Necesita tu decisión" matches "decision". */
+export declare function normalizeText(text: string): string;
+/**
+ * A board seen without its cards: just the visible lists and how many cards
+ * each one holds. One GET, a handful of lines of output.
+ */
+export declare function getBoardListCounts(input: BoardIdInput): Promise<{
+    board: Board;
+    lists: ListWithCardCount[];
+    totalCards: number;
+}>;
+/** A card at its smallest: enough to decide whether to open it. */
+export interface CardDigest {
+    id: string;
+    name: string;
+    listId: string;
+    list: string;
+    labels: string[];
+    description?: string | null;
+    dueDate?: string | null;
+    isCompleted?: boolean;
+}
+export interface BoardSummary {
+    board: Board;
+    lists: ListWithCardCount[];
+    labels: {
+        id: string;
+        name: string;
+    }[];
+    highlightLabel: string;
+    cardsFrom: string[];
+    cards: (CardDigest & {
+        highlighted: boolean;
+    })[];
+    highlightedCount: number;
+    returned: number;
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Everything needed to open a working session, in one call: columns with
+ * counts, the board's labels, and the cards sitting in the column(s) waiting
+ * on a decision, flagged by whether they already got one.
+ */
+export declare function getBoardSummary(input: BoardSummaryInput): Promise<BoardSummary>;
+export interface FindCardsResult {
+    boardId: string;
+    filters: {
+        labelName?: string;
+        query?: string;
+        listId?: string;
+    };
+    total: number;
+    returned: number;
+    offset: number;
+    hasMore: boolean;
+    nextOffset?: number;
+    matches: CardDigest[];
+    /** Filled in only when the requested filter does not exist on the board. */
+    warning?: string;
+}
+/**
+ * Searches a board's cards by label and/or text. Text matches both name and
+ * description, case- and accent-insensitive.
+ */
+export declare function findCards(input: FindCardsInput): Promise<FindCardsResult>;
+export interface ListCardsResult {
+    listId: string;
+    listName?: string;
+    total: number;
+    totalInList: number;
+    returned: number;
+    offset: number;
+    hasMore: boolean;
+    nextOffset?: number;
+    truncated: boolean;
+    labelFilter?: string;
+    cards: CardWithLabels[];
+}
+/**
+ * Cards of ONE list, paginated outward. `limit`/`offset` are output-side:
+ * Planka's API accepts neither, so the whole list is resolved through its
+ * cursor and clipped here — the only way to report an honest `total`.
+ */
+export declare function listCards(input: ListCardsInput): Promise<ListCardsResult>;
+//# sourceMappingURL=boards.d.ts.map

package/dist/operations/boards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.d.ts","sourceRoot":"","sources":["../../src/operations/boards.ts"],"names":[],"mappings":"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"}

package/dist/operations/boards.js

@@ -0,0 +1,391 @@
+/**
+ * Board operations for PLANKA API.
+ */
+import { plankaClient } from "../client.js";
+import { parseInput } from "../errors.js";
+import { withBoardId } from "./board-id.js";
+import { BoardResponse, BoardIncludedSchema, CardsResponse, } from "../schemas/responses.js";
+import { BoardIdSchema, BoardSummarySchema, FindCardsSchema, GetCardsForListSchema, ListCardsSchema, } from "../schemas/requests.js";
+/**
+ * Get a board by ID with all included entities.
+ */
+export async function getBoard(input) {
+    const { boardId } = parseInput(BoardIdSchema, input);
+    return withBoardId(boardId, async (id) => {
+        const response = await plankaClient.get(`/api/boards/${id}`);
+        const parsed = BoardResponse.parse(response);
+        const included = BoardIncludedSchema.parse(response.included || {});
+        return {
+            board: parsed.item,
+            lists: (included.lists || []).sort((a, b) => (a.position ?? Infinity) - (b.position ?? Infinity)),
+            cards: included.cards || [],
+            labels: (included.labels || []).sort((a, b) => a.position - b.position),
+            cardLabels: included.cardLabels || [],
+            taskLists: (included.taskLists || []).sort((a, b) => a.position - b.position),
+            tasks: included.tasks || [],
+        };
+    });
+}
+/**
+ * Get a board with cards enriched with task counts.
+ */
+export async function getBoardWithTaskCounts(input) {
+    const { boardId } = parseInput(BoardIdSchema, input);
+    const details = await getBoard({ boardId });
+    // Build taskList -> cardId mapping (PLANKA 2.0: tasks belong to taskLists, not cards directly)
+    const taskListToCard = new Map();
+    for (const taskList of details.taskLists) {
+        taskListToCard.set(taskList.id, taskList.cardId);
+    }
+    // Build task count map by card
+    const taskCountsByCard = new Map();
+    for (const task of details.tasks) {
+        // Get cardId via the taskList
+        const cardId = taskListToCard.get(task.taskListId);
+        if (!cardId)
+            continue;
+        const counts = taskCountsByCard.get(cardId) || {
+            total: 0,
+            completed: 0,
+        };
+        counts.total++;
+        if (task.isCompleted) {
+            counts.completed++;
+        }
+        taskCountsByCard.set(cardId, counts);
+    }
+    // Enrich cards with task counts
+    const cardsWithCounts = details.cards.map((card) => {
+        const counts = taskCountsByCard.get(card.id) || { total: 0, completed: 0 };
+        return {
+            ...card,
+            taskCount: counts.total,
+            completedTaskCount: counts.completed,
+        };
+    });
+    return {
+        board: details.board,
+        lists: details.lists,
+        cards: cardsWithCounts,
+        labels: details.labels,
+        cardLabels: details.cardLabels,
+    };
+}
+/**
+ * Page size of GET /api/lists/:id/cards in Planka 2.x. It is not
+ * configurable: `limit` is ignored and `before` is a composite cursor
+ * (`before[id]` + `before[listChangedAt]`). Verified against the live API.
+ *
+ * Without following that cursor, a column of 77 cards answers 50 and says
+ * nothing about the other 27.
+ */
+const LIST_CARDS_PAGE_SIZE = 50;
+/** Safety ceiling: 20 pages = 1000 cards. */
+const LIST_CARDS_MAX_PAGES = 20;
+export async function getCardsForList(input) {
+    const { listId, withLabels } = parseInput(GetCardsForListSchema, input);
+    const rawCards = [];
+    const cardLabels = [];
+    const taskLists = [];
+    const tasks = [];
+    let cursor = null;
+    let truncated = false;
+    for (let page = 0; page < LIST_CARDS_MAX_PAGES; page++) {
+        let path = `/api/lists/${listId}/cards`;
+        if (cursor) {
+            const query = new URLSearchParams({
+                "before[id]": cursor.id,
+                "before[listChangedAt]": cursor.listChangedAt,
+            });
+            path += `?${query.toString()}`;
+        }
+        const response = await plankaClient.get(path);
+        const parsed = CardsResponse.parse(response);
+        const included = BoardIncludedSchema.parse(response.included || {});
+        rawCards.push(...parsed.items);
+        cardLabels.push(...(included.cardLabels || []));
+        taskLists.push(...(included.taskLists || []));
+        tasks.push(...(included.tasks || []));
+        if (parsed.items.length < LIST_CARDS_PAGE_SIZE)
+            break;
+        const last = parsed.items[parsed.items.length - 1];
+        if (!last.listChangedAt) {
+            // No listChangedAt means no cursor is possible: warn instead of lying.
+            truncated = true;
+            break;
+        }
+        cursor = { id: last.id, listChangedAt: last.listChangedAt };
+        if (page === LIST_CARDS_MAX_PAGES - 1)
+            truncated = true;
+    }
+    const cards = rawCards.sort((a, b) => a.position - b.position);
+    // labelId -> name (labels live on the board; one extra GET)
+    let labelNameById = new Map();
+    if (withLabels && cards.length > 0 && cardLabels.length > 0) {
+        const board = await getBoard({ boardId: cards[0].boardId });
+        labelNameById = new Map(board.labels.map((l) => [l.id, l.name ?? l.color]));
+    }
+    const taskListToCard = new Map(taskLists.map((tl) => [tl.id, tl.cardId]));
+    const counts = new Map();
+    for (const task of tasks) {
+        const cardId = taskListToCard.get(task.taskListId);
+        if (!cardId)
+            continue;
+        const c = counts.get(cardId) || { total: 0, completed: 0 };
+        c.total++;
+        if (task.isCompleted)
+            c.completed++;
+        counts.set(cardId, c);
+    }
+    return {
+        truncated,
+        cards: cards.map((card) => {
+            const c = counts.get(card.id) || { total: 0, completed: 0 };
+            return {
+                ...card,
+                taskCount: c.total,
+                completedTaskCount: c.completed,
+                labelNames: cardLabels
+                    .filter((cl) => cl.cardId === card.id)
+                    .map((cl) => labelNameById.get(cl.labelId))
+                    .filter((n) => n !== undefined),
+            };
+        }),
+    };
+}
+/** Ignores case and accents: "Necesita tu decisión" matches "decision". */
+export function normalizeText(text) {
+    return text
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase();
+}
+/**
+ * A board seen without its cards: just the visible lists and how many cards
+ * each one holds. One GET, a handful of lines of output.
+ */
+export async function getBoardListCounts(input) {
+    const { boardId } = parseInput(BoardIdSchema, input);
+    const details = await getBoard({ boardId });
+    const countByList = new Map();
+    for (const card of details.cards) {
+        countByList.set(card.listId, (countByList.get(card.listId) ?? 0) + 1);
+    }
+    // name === null means archive/trash: those are not board columns.
+    const lists = details.lists
+        .filter((list) => list.name !== null)
+        .map((list) => ({
+        id: list.id,
+        name: list.name,
+        ...(list.type ? { type: list.type } : {}),
+        cardCount: countByList.get(list.id) ?? 0,
+    }));
+    return {
+        board: details.board,
+        lists,
+        totalCards: details.cards.length,
+    };
+}
+/** Clips the description so a preview does not eat the size advantage. */
+const DESCRIPTION_PREVIEW = 200;
+function digest(card, listName, labelNames, withDescription) {
+    const description = card.description ?? null;
+    return {
+        id: card.id,
+        name: card.name,
+        listId: card.listId,
+        list: listName,
+        labels: labelNames,
+        ...(withDescription && description
+            ? {
+                description: description.length > DESCRIPTION_PREVIEW
+                    ? `${description.slice(0, DESCRIPTION_PREVIEW)}…`
+                    : description,
+            }
+            : {}),
+        ...(card.dueDate ? { dueDate: card.dueDate } : {}),
+        ...(card.isCompleted ? { isCompleted: true } : {}),
+    };
+}
+/**
+ * Indexes derived from a single GET on the board: list names, label names per
+ * card, and the cards ordered the way the board shows them.
+ */
+async function indexBoard(boardId) {
+    const details = await getBoard({ boardId });
+    const listById = new Map(details.lists.map((l) => [l.id, l]));
+    const labelById = new Map(details.labels.map((l) => [l.id, l]));
+    const labelNamesByCard = new Map();
+    for (const cl of details.cardLabels) {
+        const label = labelById.get(cl.labelId);
+        if (!label)
+            continue;
+        const names = labelNamesByCard.get(cl.cardId) ?? [];
+        names.push(label.name ?? label.color);
+        labelNamesByCard.set(cl.cardId, names);
+    }
+    // Same order a human sees: by list position, then by card position.
+    const listPosition = new Map(details.lists.map((l) => [l.id, l.position ?? Number.MAX_SAFE_INTEGER]));
+    const cards = [...details.cards].sort((a, b) => {
+        const byList = (listPosition.get(a.listId) ?? 0) - (listPosition.get(b.listId) ?? 0);
+        return byList !== 0 ? byList : a.position - b.position;
+    });
+    return { details, listById, labelById, labelNamesByCard, cards };
+}
+/**
+ * The lists whose cards the caller asked for. Each entry matches an exact id
+ * or a name fragment (accent- and case-insensitive).
+ */
+function selectLists(lists, wanted) {
+    const selected = [];
+    for (const list of lists) {
+        if (list.name === null)
+            continue;
+        const name = normalizeText(list.name);
+        const hit = wanted.some((w) => w === list.id || name.includes(normalizeText(w)));
+        if (hit)
+            selected.push(list);
+    }
+    return selected;
+}
+/**
+ * Default for `cardsFrom`: the column where cards waiting on a decision pile
+ * up. Matched by name so it works on any board, whatever the language.
+ */
+const DECISION_LIST_HINTS = ["decision", "decide", "blocked", "bloquead"];
+/**
+ * Everything needed to open a working session, in one call: columns with
+ * counts, the board's labels, and the cards sitting in the column(s) waiting
+ * on a decision, flagged by whether they already got one.
+ */
+export async function getBoardSummary(input) {
+    const { boardId, cardsFrom, highlightLabel, limit } = parseInput(BoardSummarySchema, input);
+    const { details, listById, labelNamesByCard, cards } = await indexBoard(boardId);
+    const countByList = new Map();
+    for (const card of details.cards) {
+        countByList.set(card.listId, (countByList.get(card.listId) ?? 0) + 1);
+    }
+    const visibleLists = details.lists.filter((list) => list.name !== null);
+    const wanted = cardsFrom ?? DECISION_LIST_HINTS;
+    const selected = selectLists(visibleLists, wanted);
+    const selectedIds = new Set(selected.map((l) => l.id));
+    const highlight = normalizeText(highlightLabel);
+    const matching = cards
+        .filter((card) => selectedIds.has(card.listId))
+        .map((card) => {
+        const labels = labelNamesByCard.get(card.id) ?? [];
+        return {
+            ...digest(card, listById.get(card.listId)?.name ?? "", labels, false),
+            highlighted: labels.some((l) => normalizeText(l) === highlight),
+        };
+    });
+    // Unblocked first: that is what gets picked up at the start of a session.
+    matching.sort((a, b) => Number(b.highlighted) - Number(a.highlighted));
+    const page = matching.slice(0, limit);
+    return {
+        board: details.board,
+        lists: visibleLists.map((list) => ({
+            id: list.id,
+            name: list.name,
+            ...(list.type ? { type: list.type } : {}),
+            cardCount: countByList.get(list.id) ?? 0,
+        })),
+        labels: details.labels.map((l) => ({ id: l.id, name: l.name ?? l.color })),
+        highlightLabel,
+        cardsFrom: selected.map((l) => l.name ?? l.id),
+        cards: page,
+        highlightedCount: matching.filter((c) => c.highlighted).length,
+        returned: page.length,
+        total: matching.length,
+        hasMore: page.length < matching.length,
+    };
+}
+/**
+ * Searches a board's cards by label and/or text. Text matches both name and
+ * description, case- and accent-insensitive.
+ */
+export async function findCards(input) {
+    const { boardId, labelName, query, listId, withDescription, limit, offset } = parseInput(FindCardsSchema, input);
+    const { details, listById, labelById, labelNamesByCard, cards } = await indexBoard(boardId);
+    const warnings = [];
+    // labelName -> ids. A board can carry the same name on two labels.
+    let labelIds = null;
+    if (labelName) {
+        const wanted = normalizeText(labelName);
+        const hits = details.labels.filter((l) => normalizeText(l.name ?? l.color) === wanted);
+        if (hits.length === 0) {
+            warnings.push(`No label named "${labelName}" on this board. Existing labels: ` +
+                details.labels.map((l) => l.name ?? l.color).join(", "));
+        }
+        labelIds = new Set(hits.map((l) => l.id));
+    }
+    if (listId && !listById.has(listId)) {
+        warnings.push(`No list ${listId} on this board.`);
+    }
+    const needle = query ? normalizeText(query) : null;
+    const matched = cards.filter((card) => {
+        if (listId && card.listId !== listId)
+            return false;
+        if (labelIds) {
+            const cardLabelIds = details.cardLabels
+                .filter((cl) => cl.cardId === card.id)
+                .map((cl) => cl.labelId);
+            if (!cardLabelIds.some((id) => labelIds.has(id)))
+                return false;
+        }
+        if (needle) {
+            const haystack = normalizeText(`${card.name}\n${card.description ?? ""}`);
+            if (!haystack.includes(needle))
+                return false;
+        }
+        return true;
+    });
+    const page = matched.slice(offset, offset + limit);
+    const hasMore = offset + page.length < matched.length;
+    return {
+        boardId,
+        filters: {
+            ...(labelName ? { labelName } : {}),
+            ...(query ? { query } : {}),
+            ...(listId ? { listId } : {}),
+        },
+        total: matched.length,
+        returned: page.length,
+        offset,
+        hasMore,
+        ...(hasMore ? { nextOffset: offset + page.length } : {}),
+        matches: page.map((card) => digest(card, listById.get(card.listId)?.name ?? "", labelNamesByCard.get(card.id) ?? [], withDescription)),
+        ...(warnings.length > 0 ? { warning: warnings.join(" ") } : {}),
+    };
+}
+/**
+ * Cards of ONE list, paginated outward. `limit`/`offset` are output-side:
+ * Planka's API accepts neither, so the whole list is resolved through its
+ * cursor and clipped here — the only way to report an honest `total`.
+ */
+export async function listCards(input) {
+    const { listId, withLabels, labelFilter, limit, offset } = parseInput(ListCardsSchema, input);
+    const { cards, truncated } = await getCardsForList({
+        listId,
+        withLabels: labelFilter !== undefined ? true : withLabels,
+    });
+    const wanted = labelFilter ? normalizeText(labelFilter) : null;
+    const matched = wanted
+        ? cards.filter((c) => c.labelNames.some((l) => normalizeText(l) === wanted))
+        : cards;
+    const page = matched.slice(offset, offset + limit);
+    const hasMore = offset + page.length < matched.length;
+    return {
+        listId,
+        total: matched.length,
+        totalInList: cards.length,
+        returned: page.length,
+        offset,
+        hasMore,
+        ...(hasMore ? { nextOffset: offset + page.length } : {}),
+        truncated,
+        ...(labelFilter ? { labelFilter } : {}),
+        cards: page,
+    };
+}
+//# sourceMappingURL=boards.js.map

package/dist/operations/boards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.js","sourceRoot":"","sources":["../../src/operations/boards.ts"],"names":[],"mappings":"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"}

package/dist/operations/cards.d.ts

@@ -0,0 +1,36 @@
+import { Card, TaskList, Task, Label, CardLabel, Attachment } from "../schemas/entities.js";
+import { CardIdInput, CreateCardInput, MoveCardInput, UpdateCardParamsInput } from "../schemas/requests.js";
+import { CommentWithAuthor } from "./comments.js";
+/**
+ * Card details with all related entities.
+ */
+export interface CardDetails {
+    card: Card;
+    taskLists: TaskList[];
+    tasks: Task[];
+    comments: CommentWithAuthor[];
+    labels: Label[];
+    cardLabels: CardLabel[];
+    attachments: Attachment[];
+}
+/**
+ * Create a new card in a list.
+ */
+export declare function createCard(input: CreateCardInput): Promise<Card>;
+/**
+ * Get a card by ID with all related entities.
+ */
+export declare function getCard(input: CardIdInput): Promise<CardDetails>;
+/**
+ * Update a card's properties.
+ */
+export declare function updateCard(input: UpdateCardParamsInput): Promise<Card>;
+/**
+ * Move a card to a different list/position.
+ */
+export declare function moveCard(input: MoveCardInput): Promise<Card>;
+/**
+ * Delete a card.
+ */
+export declare function deleteCard(input: CardIdInput): Promise<void>;
+//# sourceMappingURL=cards.d.ts.map

package/dist/operations/cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/operations/cards.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAW,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACrG,OAAO,EAEL,WAAW,EAEX,eAAe,EAEf,aAAa,EAEb,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAsB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBtE;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CA4BtE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBlE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE"}