@omnicoreos/planka-mcp 0.2.0 → 0.3.0

package/dist/operations/comments.js

@@ -30,24 +30,107 @@ export async function updateComment(input) {
  */
 export async function deleteComment(input) {
     const { commentId } = parseInput(CommentIdSchema, input);
-    await plankaClient.delete(`/api/comments/${commentId}`);
+    const body = await plankaClient.delete(`/api/comments/${commentId}`);
+    const parsed = CommentResponse.safeParse(body);
+    return parsed.success ? parsed.data.item : null;
 }
 /**
- * Get all comments for a card, newest first.
- * PLANKA 2.x serves comments only from the dedicated endpoint — the card
- * response's `included` never carries them.
+ * Planka 2.x serves comments 50 at a time and IGNORES ?limit / ?page. The only
+ * cursor is `?beforeId=<id>`, and the order is id DESC (newest first).
+ * Measured against the live instance — see docs/planka-2x-gotchas.md.
  */
-export async function getCommentsForCard(input) {
-    const { cardId } = parseInput(CardIdSchema, input);
-    const response = await plankaClient.get(`/api/cards/${cardId}/comments`);
+export const COMMENTS_PAGE_SIZE = 50;
+/** Ceiling for `all: true`: 10 pages = 500 comments, then `truncated`. */
+export const COMMENTS_MAX_PAGES = 10;
+/**
+ * One page of a card's comments (max 50), newest first.
+ * `beforeId` walks backwards in time: it returns comments OLDER than that id.
+ */
+export async function getCommentsPage(input) {
+    const { cardId } = parseInput(CardIdSchema, { cardId: input.cardId });
+    const query = input.beforeId
+        ? `?beforeId=${encodeURIComponent(input.beforeId)}`
+        : "";
+    const response = await plankaClient.get(`/api/cards/${cardId}/comments${query}`);
     const parsed = CommentsResponse.parse(response);
     const included = CommentsIncludedSchema.parse(response.included || {});
     const users = included.users || [];
-    return parsed.items
+    const comments = parsed.items
         .map((c) => ({
         ...c,
         authorName: users.find((u) => u.id === c.userId)?.name,
     }))
         .sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    return {
+        comments,
+        full: parsed.items.length >= COMMENTS_PAGE_SIZE,
+        nextBeforeId: comments[comments.length - 1]?.id,
+    };
+}
+/**
+ * The FIRST page of a card's comments, newest first (max 50).
+ *
+ * Kept as the cheap read used by write verification: a comment that was just
+ * created or edited is on page 1 by definition. Anything that has to be
+ * complete — or honest about not being — goes through `getComments`.
+ */
+export async function getCommentsForCard(input) {
+    const { cardId } = parseInput(CardIdSchema, input);
+    const page = await getCommentsPage({ cardId });
+    return page.comments;
+}
+/**
+ * Read a card's comments with honest paging.
+ *
+ * - `limit`     how many to return (1..50 per server page; default up to the caller)
+ * - `beforeId`  cursor from a previous call — returns comments OLDER than it
+ * - `all`       walk every page up to COMMENTS_MAX_PAGES, then say `truncated`
+ * - `order`     "asc" (oldest first, the reading order) or "desc" (newest first)
+ *
+ * `hasMore` is never guessed: it is true only when Planka handed back a full
+ * page, or when a page carried more comments than the caller asked for.
+ */
+export async function getComments(input) {
+    const order = input.order ?? "asc";
+    if (input.all) {
+        const maxPages = Math.max(1, input.maxPages ?? COMMENTS_MAX_PAGES);
+        const collected = [];
+        let beforeId = input.beforeId;
+        let pagesFetched = 0;
+        let full = false;
+        while (pagesFetched < maxPages) {
+            const page = await getCommentsPage({ cardId: input.cardId, beforeId });
+            pagesFetched += 1;
+            collected.push(...page.comments);
+            full = page.full;
+            beforeId = page.nextBeforeId;
+            if (!page.full || !beforeId)
+                break;
+        }
+        // Ran out of pages while Planka still had more to give.
+        const truncated = full && pagesFetched >= maxPages;
+        return {
+            comments: order === "asc" ? [...collected].reverse() : collected,
+            hasMore: truncated,
+            ...(truncated && beforeId ? { nextBeforeId: beforeId } : {}),
+            truncated,
+            pagesFetched,
+        };
+    }
+    const page = await getCommentsPage({
+        cardId: input.cardId,
+        beforeId: input.beforeId,
+    });
+    const limit = Math.max(1, Math.min(input.limit ?? COMMENTS_PAGE_SIZE, COMMENTS_PAGE_SIZE));
+    const slice = page.comments.slice(0, limit);
+    const hasMore = page.comments.length > slice.length || page.full;
+    const nextBeforeId = slice[slice.length - 1]?.id;
+    return {
+        comments: order === "asc" ? [...slice].reverse() : slice,
+        hasMore,
+        ...(hasMore && nextBeforeId ? { nextBeforeId } : {}),
+        truncated: false,
+        pagesFetched: 1,
+    };
 }
 //# sourceMappingURL=comments.js.map

package/dist/operations/comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../src/operations/comments.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EACL,YAAY,EAEZ,eAAe,EAEf,mBAAmB,EAEnB,yBAAyB,GAE1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAUpG;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAyB;IAC3D,MAAM,SAAS,GAAG,UAAU,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAEzD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CACtC,cAAc,SAAS,CAAC,MAAM,WAAW,EACzC;QACE,IAAI,EAAE,SAAS,CAAC,IAAI;KACrB,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAA+B;IAE/B,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAE/E,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,CACvC,iBAAiB,SAAS,EAAE,EAC5B,OAAO,CACR,CAAC;IAEF,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAqB;IACvD,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACzD,MAAM,YAAY,CAAC,MAAM,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAkB;IAElB,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,CACrC,cAAc,MAAM,WAAW,CAChC,CAAC;IACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAC1C,QAAoC,CAAC,QAAQ,IAAI,EAAE,CACrD,CAAC;IACF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;IAEnC,OAAO,MAAM,CAAC,KAAK;SAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,GAAG,CAAC;QACJ,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI;KACvD,CAAC,CAAC;SACF,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAC5E,CAAC;AACN,CAAC"}
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../src/operations/comments.ts"],"names":[],"mappings":"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"}

package/dist/operations/duplicate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Duplicate a card. `position` defaults to Planka's usual end-of-column value.
+ */
+export declare function duplicateCard(input: {
+    cardId: string;
+    listId?: string;
+    boardId?: string;
+    name?: string;
+    position?: number;
+}): Promise<{
+    id: string;
+    name: string;
+    listId: string;
+    boardId: string;
+}>;
+//# sourceMappingURL=duplicate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate.d.ts","sourceRoot":"","sources":["../../src/operations/duplicate.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBzE"}

package/dist/operations/duplicate.js

@@ -0,0 +1,43 @@
+/**
+ * Card duplication.
+ *
+ * `POST /api/cards/:id/duplicate` is a real Planka 2.x endpoint and it copies
+ * more than the card row: verified live on 2.2.1, the response's `included`
+ * came back with the card's memberships, labels, task lists, tasks and custom
+ * field values. Attachments are NOT re-uploaded. The copy lands in the SAME
+ * list unless `listId` (and optionally `boardId`) say otherwise, and Planka
+ * appends its own suffix to the name unless `name` is given.
+ *
+ * The counts reported to the caller come from re-reading the new card, not
+ * from this response: the point of the tool is to say what the copy actually
+ * carries.
+ */
+import { z } from "zod";
+import { plankaClient } from "../client.js";
+import { assertBoardAllowed, assertListWritable } from "../config/policy.js";
+import { CardBriefSchema } from "./card-brief.js";
+const DuplicateResponse = z.object({ item: CardBriefSchema });
+/**
+ * Duplicate a card. `position` defaults to Planka's usual end-of-column value.
+ */
+export async function duplicateCard(input) {
+    assertListWritable(input.listId, undefined, "duplicate cards into");
+    if (input.boardId)
+        assertBoardAllowed(input.boardId);
+    const body = { position: input.position ?? 65536 };
+    if (input.listId)
+        body.listId = input.listId;
+    if (input.boardId)
+        body.boardId = input.boardId;
+    if (input.name !== undefined)
+        body.name = input.name;
+    const response = await plankaClient.post(`/api/cards/${input.cardId}/duplicate`, body);
+    const item = DuplicateResponse.parse(response).item;
+    return {
+        id: item.id,
+        name: item.name,
+        listId: item.listId,
+        boardId: item.boardId,
+    };
+}
+//# sourceMappingURL=duplicate.js.map

package/dist/operations/duplicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate.js","sourceRoot":"","sources":["../../src/operations/duplicate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAMnC;IACC,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC;IACpE,IAAI,KAAK,CAAC,OAAO;QAAE,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAErD,MAAM,IAAI,GAA4B,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC;IAC5E,IAAI,KAAK,CAAC,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7C,IAAI,KAAK,CAAC,OAAO;QAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAChD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAErD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CACtC,cAAc,KAAK,CAAC,MAAM,YAAY,EACtC,IAAI,CACL,CAAC;IACF,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IAEpD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC"}

package/dist/operations/labels.d.ts

@@ -11,7 +11,7 @@ export declare function updateLabel(input: UpdateLabelParamsInput): Promise<Labe
 /**
  * Delete a label.
  */
-export declare function deleteLabel(input: LabelIdInput): Promise<void>;
+export declare function deleteLabel(input: LabelIdInput): Promise<Label | null>;
 /**
  * Add a label to a card.
  * Uses PLANKA 2.0 /card-labels endpoint.

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

@@ -1 +1 @@
-{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/operations/labels.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAEL,mBAAmB,EAEnB,gBAAgB,EAEhB,YAAY,EAEZ,wBAAwB,EAExB,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAIhC;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAgBzE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,KAAK,CAAC,CAUhB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAYnF;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,4EAA4E;IAC5E,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,2DAA2D;IAC3D,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAwF9B"}
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/operations/labels.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAEL,mBAAmB,EAEnB,gBAAgB,EAEhB,YAAY,EAEZ,wBAAwB,EAExB,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAIhC;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAgBzE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,KAAK,CAAC,CAUhB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAK5E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAYnF;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,4EAA4E;IAC5E,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,2DAA2D;IAC3D,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAyF9B"}

package/dist/operations/labels.js

@@ -6,7 +6,7 @@ import { withBoardId } from "./board-id.js";
 import { parseInput } from "../errors.js";
 import { AddLabelToCardSchema, CreateLabelSchema, LabelIdSchema, RemoveLabelFromCardSchema, SetCardLabelsSchema, UpdateLabelParamsSchema, } from "../schemas/requests.js";
 import { LabelResponse, CardLabelResponse } from "../schemas/responses.js";
-import { getCard } from "./cards.js";
+import { getCardLight } from "./cards.js";
 /**
  * Create a new label on a board.
  */
@@ -36,7 +36,9 @@ export async function updateLabel(input) {
  */
 export async function deleteLabel(input) {
     const { labelId } = parseInput(LabelIdSchema, input);
-    await plankaClient.delete(`/api/labels/${labelId}`);
+    const body = await plankaClient.delete(`/api/labels/${labelId}`);
+    const parsed = LabelResponse.safeParse(body);
+    return parsed.success ? parsed.data.item : null;
 }
 /**
  * Add a label to a card.
@@ -72,7 +74,8 @@ export async function setCardLabels(input) {
     const { cardId, addLabelIds, removeLabelIds } = parseInput(SetCardLabelsSchema, input);
     const toAdd = addLabelIds ?? [];
     const toRemove = removeLabelIds ?? [];
-    const before = await getCard({ cardId });
+    // Light read: comparing label ids never needed the card's comments.
+    const before = await getCardLight({ cardId });
     const presentBefore = new Set(before.cardLabels.map((cl) => cl.labelId));
     const result = {
         added: [],
@@ -117,7 +120,7 @@ export async function setCardLabels(input) {
         }
     }
     // Verify against the card itself: this is what makes the report trustworthy.
-    const after = await getCard({ cardId });
+    const after = await getCardLight({ cardId });
     const presentAfter = new Set(after.cardLabels.map((cl) => cl.labelId));
     result.finalLabelIds = [...presentAfter];
     result.added = toAdd.filter((id) => presentAfter.has(id) && !presentBefore.has(id));

package/dist/operations/labels.js.map

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

package/dist/operations/lists.d.ts

@@ -11,5 +11,67 @@ export declare function updateList(input: UpdateListParamsInput): Promise<List>;
 /**
  * Delete a list.
  */
-export declare function deleteList(input: ListIdInput): Promise<void>;
+export declare function deleteList(input: ListIdInput): Promise<List | null>;
+/** What a column holds right now, and what kind of column it is. */
+export interface ListState {
+    id: string;
+    /** "active" | "closed" | "archive" | "trash", when Planka will say. */
+    type: string | null;
+    boardId: string | null;
+    cardIds: string[];
+    /** Card id -> its position, so a per-card move can preserve the order. */
+    positions: Map<string, number | null>;
+    count: number;
+}
+/**
+ * Reads a column: its type, its board and every card in it.
+ *
+ * `GET /api/lists/:id` returns the WHOLE column in `included.cards` — no 50-item
+ * page, unlike `GET /api/lists/:id/cards` — which is what makes it usable both
+ * as a counter and as the source of a per-card move.
+ *
+ * Returns `null` for a column Planka refuses to show: the hidden `archive` and
+ * `trash` lists answer 404 here. That is not an error, it is information.
+ */
+export declare function readListState(listId: string): Promise<ListState | null>;
+/** How many cards a column holds. `null` when the column cannot be read. */
+export declare function countListCards(listId: string): Promise<number | null>;
+/**
+ * Planka's own bulk move — and the ONLY thing it can do.
+ *
+ * `POST /api/lists/:id/move-cards` reads like a general "move every card from
+ * A to B", and it is not: `server/api/controllers/lists/move-cards.js` in 2.2.1
+ * refuses anything but archiving a whole closed column —
+ *
+ *     if (list.type !== List.Types.CLOSED)      throw NOT_ENOUGH_RIGHTS;   // 403
+ *     if (nextList.type !== List.Types.ARCHIVE) throw LIST_NOT_FOUND;      // 404
+ *
+ * so an active -> active call comes back 403 "Not enough rights", which reads
+ * like a permission problem and is not one. Callers that need the general move
+ * fall back to `moveCardsOneByOne`.
+ */
+export declare function bulkMoveClosedListToArchive(input: {
+    fromListId: string;
+    toListId: string;
+}): Promise<void>;
+/**
+ * The general move: one PATCH per card.
+ *
+ * Each card keeps the position it had, so the relative order survives. A card
+ * whose position is null (it came out of the archive) gets one, because Planka
+ * rejects a move without it.
+ *
+ * Returns the cards that could not be moved, with the reason — a partial move
+ * has to be visible, not silently reported as a smaller success.
+ */
+export declare function moveCardsOneByOne(input: {
+    cards: Array<{
+        id: string;
+        position: number | null;
+    }>;
+    toListId: string;
+}): Promise<Array<{
+    cardId: string;
+    reason: string;
+}>>;
 //# sourceMappingURL=lists.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../src/operations/lists.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,OAAO,EAEL,eAAe,EAEf,WAAW,EAEX,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBtE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE"}
+{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../src/operations/lists.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,OAAO,EAEL,eAAe,EAEf,WAAW,EAEX,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBtE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAMzE;AAED,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0EAA0E;IAC1E,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA2B7E;AAED,4EAA4E;AAC5E,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACtD,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAkBrD"}

package/dist/operations/lists.js

@@ -3,7 +3,8 @@
  */
 import { plankaClient } from "../client.js";
 import { withBoardId } from "./board-id.js";
-import { parseInput } from "../errors.js";
+import { PlankaError, parseInput } from "../errors.js";
+import { assertListWritable } from "../config/policy.js";
 import { ListResponse } from "../schemas/responses.js";
 import { CreateListSchema, ListIdSchema, UpdateListParamsSchema, } from "../schemas/requests.js";
 /**
@@ -26,6 +27,7 @@ export async function createList(input) {
  */
 export async function updateList(input) {
     const { listId, ...updates } = parseInput(UpdateListParamsSchema, input);
+    assertListWritable(listId, undefined, "edit");
     const response = await plankaClient.patch(`/api/lists/${listId}`, updates);
     const parsed = ListResponse.parse(response);
     return parsed.item;
@@ -35,6 +37,99 @@ export async function updateList(input) {
  */
 export async function deleteList(input) {
     const { listId } = parseInput(ListIdSchema, input);
-    await plankaClient.delete(`/api/lists/${listId}`);
+    assertListWritable(listId, undefined, "delete");
+    const body = await plankaClient.delete(`/api/lists/${listId}`);
+    const parsed = ListResponse.safeParse(body);
+    return parsed.success ? parsed.data.item : null;
+}
+/**
+ * Reads a column: its type, its board and every card in it.
+ *
+ * `GET /api/lists/:id` returns the WHOLE column in `included.cards` — no 50-item
+ * page, unlike `GET /api/lists/:id/cards` — which is what makes it usable both
+ * as a counter and as the source of a per-card move.
+ *
+ * Returns `null` for a column Planka refuses to show: the hidden `archive` and
+ * `trash` lists answer 404 here. That is not an error, it is information.
+ */
+export async function readListState(listId) {
+    let response;
+    try {
+        response = await plankaClient.get(`/api/lists/${listId}`);
+    }
+    catch (error) {
+        if (error instanceof PlankaError && error.status === 404)
+            return null;
+        throw error;
+    }
+    const cards = response?.included?.cards ?? [];
+    const positions = new Map();
+    for (const card of cards) {
+        if (card?.id)
+            positions.set(card.id, card.position ?? null);
+    }
+    return {
+        id: listId,
+        type: response?.item?.type ?? null,
+        boardId: response?.item?.boardId ?? null,
+        cardIds: [...positions.keys()],
+        positions,
+        count: positions.size,
+    };
+}
+/** How many cards a column holds. `null` when the column cannot be read. */
+export async function countListCards(listId) {
+    const state = await readListState(listId);
+    return state ? state.count : null;
+}
+/**
+ * Planka's own bulk move — and the ONLY thing it can do.
+ *
+ * `POST /api/lists/:id/move-cards` reads like a general "move every card from
+ * A to B", and it is not: `server/api/controllers/lists/move-cards.js` in 2.2.1
+ * refuses anything but archiving a whole closed column —
+ *
+ *     if (list.type !== List.Types.CLOSED)      throw NOT_ENOUGH_RIGHTS;   // 403
+ *     if (nextList.type !== List.Types.ARCHIVE) throw LIST_NOT_FOUND;      // 404
+ *
+ * so an active -> active call comes back 403 "Not enough rights", which reads
+ * like a permission problem and is not one. Callers that need the general move
+ * fall back to `moveCardsOneByOne`.
+ */
+export async function bulkMoveClosedListToArchive(input) {
+    assertListWritable(input.toListId, undefined, "move cards into");
+    assertListWritable(input.fromListId, undefined, "move cards out of");
+    await plankaClient.post(`/api/lists/${input.fromListId}/move-cards`, {
+        listId: input.toListId,
+    });
+}
+/**
+ * The general move: one PATCH per card.
+ *
+ * Each card keeps the position it had, so the relative order survives. A card
+ * whose position is null (it came out of the archive) gets one, because Planka
+ * rejects a move without it.
+ *
+ * Returns the cards that could not be moved, with the reason — a partial move
+ * has to be visible, not silently reported as a smaller success.
+ */
+export async function moveCardsOneByOne(input) {
+    assertListWritable(input.toListId, undefined, "move cards into");
+    const failed = [];
+    for (const card of input.cards) {
+        try {
+            await plankaClient.patch(`/api/cards/${card.id}`, {
+                listId: input.toListId,
+                position: card.position ?? 65536,
+            });
+        }
+        catch (error) {
+            failed.push({
+                cardId: card.id,
+                reason: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return failed;
 }
 //# sourceMappingURL=lists.js.map

package/dist/operations/lists.js.map

@@ -1 +1 @@
-{"version":3,"file":"lists.js","sourceRoot":"","sources":["../../src/operations/lists.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,gBAAgB,EAEhB,YAAY,EAEZ,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,MAAM,SAAS,GAAG,UAAU,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAEtD,OAAO,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACtD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CACtC,eAAe,OAAO,QAAQ,EAC9B;YACE,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,+CAA+C;SACtE,CACF,CAAC;QAEF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAA4B;IAE5B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IAEzE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,CACvC,cAAc,MAAM,EAAE,EACtB,OAAO,CACR,CAAC;IAEF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAkB;IACjD,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACnD,MAAM,YAAY,CAAC,MAAM,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"lists.js","sourceRoot":"","sources":["../../src/operations/lists.ts"],"names":[],"mappings":"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"}

package/dist/operations/members.d.ts

@@ -0,0 +1,39 @@
+/** Put a user on a card. */
+export declare function addCardMember(input: {
+    cardId: string;
+    userId: string;
+}): Promise<{
+    id: string;
+    userId: string;
+}>;
+/** Take a user off a card. */
+export declare function removeCardMember(input: {
+    cardId: string;
+    userId: string;
+}): Promise<void>;
+export interface SetCardMembersResult {
+    /** Users this call put on the card. */
+    added: string[];
+    /** Users asked for that were already there. */
+    alreadyPresent: string[];
+    /** Users this call took off the card. */
+    removed: string[];
+    /** Users asked to be removed that were not on the card. */
+    notPresent: string[];
+    /** Requests that did NOT reach the desired state. */
+    failed: Array<{
+        userId: string;
+        reason: string;
+    }>;
+    /** Every member of the card once the operation finished. */
+    finalMemberIds: string[];
+}
+/**
+ * Add and/or remove card members, then re-read to report what really landed.
+ */
+export declare function setCardMembers(input: {
+    cardId: string;
+    add?: string[];
+    remove?: string[];
+}): Promise<SetCardMembersResult>;
+//# sourceMappingURL=members.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../src/operations/members.ts"],"names":[],"mappings":"AAuBA,4BAA4B;AAC5B,wBAAsB,aAAa,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAM1C;AAED,8BAA8B;AAC9B,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhB;AAED,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,qDAAqD;IACrD,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,4DAA4D;IAC5D,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+EhC"}

package/dist/operations/members.js

@@ -0,0 +1,107 @@
+/**
+ * Card members (assignees).
+ *
+ * The mirror image of `setCardLabels`, and for the same reason: a 200 on
+ * `POST /card-memberships` proves the request was accepted, not that the
+ * person is on the card. A userId that is not a member of the board answers
+ * 404 (Planka's "not found" for "not allowed"), and reporting the REQUESTED
+ * assignment would leave an agent believing a card is assigned to nobody.
+ *
+ * So this writes, re-reads `included.cardMemberships`, and reports the final
+ * membership set.
+ *
+ * The DELETE path is Planka's criteria syntax, `userId:<id>` — a literal colon
+ * in the URL, not the membership record's own id.
+ */
+import { z } from "zod";
+import { plankaClient } from "../client.js";
+import { getCardBrief } from "./card-brief.js";
+const MembershipResponse = z.object({
+    item: z.object({ id: z.string(), cardId: z.string(), userId: z.string() }).passthrough(),
+});
+/** Put a user on a card. */
+export async function addCardMember(input) {
+    const response = await plankaClient.post(`/api/cards/${input.cardId}/card-memberships`, { userId: input.userId });
+    return MembershipResponse.parse(response).item;
+}
+/** Take a user off a card. */
+export async function removeCardMember(input) {
+    await plankaClient.delete(`/api/cards/${input.cardId}/card-memberships/userId:${input.userId}`);
+}
+/**
+ * Add and/or remove card members, then re-read to report what really landed.
+ */
+export async function setCardMembers(input) {
+    const toAdd = [...new Set(input.add ?? [])];
+    const toRemove = [...new Set(input.remove ?? [])];
+    const before = await getCardBrief({ cardId: input.cardId });
+    const presentBefore = new Set(before.memberIds);
+    const result = {
+        added: [],
+        alreadyPresent: [],
+        removed: [],
+        notPresent: [],
+        failed: [],
+        finalMemberIds: [],
+    };
+    // Remove first, so one call can hand a card over from one person to another.
+    for (const userId of toRemove) {
+        if (!presentBefore.has(userId)) {
+            result.notPresent.push(userId);
+            continue;
+        }
+        try {
+            await removeCardMember({ cardId: input.cardId, userId });
+        }
+        catch (error) {
+            result.failed.push({
+                userId,
+                reason: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    for (const userId of toAdd) {
+        if (presentBefore.has(userId)) {
+            result.alreadyPresent.push(userId);
+            continue;
+        }
+        try {
+            await addCardMember({ cardId: input.cardId, userId });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            // Already assigned is the desired state, not a failure.
+            if (message.toLowerCase().includes("already")) {
+                result.alreadyPresent.push(userId);
+                continue;
+            }
+            result.failed.push({
+                userId,
+                reason: message +
+                    (message.includes("404")
+                        ? " (a 404 here usually means the user is not a member of this board)"
+                        : ""),
+            });
+        }
+    }
+    const after = await getCardBrief({ cardId: input.cardId });
+    const presentAfter = new Set(after.memberIds);
+    result.finalMemberIds = [...presentAfter];
+    result.added = toAdd.filter((id) => presentAfter.has(id) && !presentBefore.has(id));
+    result.removed = toRemove.filter((id) => !presentAfter.has(id) && presentBefore.has(id));
+    // Anything asked for that the re-read contradicts is a failure, even if the
+    // HTTP call came back 200.
+    const reported = new Set(result.failed.map((f) => f.userId));
+    for (const userId of toAdd) {
+        if (!presentAfter.has(userId) && !reported.has(userId)) {
+            result.failed.push({ userId, reason: "still not a member of the card after the write" });
+        }
+    }
+    for (const userId of toRemove) {
+        if (presentAfter.has(userId) && !reported.has(userId)) {
+            result.failed.push({ userId, reason: "still a member of the card after the write" });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=members.js.map