trelly 0.2.1 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trelly",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "trelly — fast Trello CLI with multi-profile auth, MCP server, and kanban TUI",
   "type": "module",
   "license": "MIT",

package/skills/trelly/SKILL.md

@@ -40,6 +40,8 @@ Credentials: `~/.config/trelly/config.json` (migrates from `~/.config/trello-cli
 | Pretty JSON | `--json --pretty` |
 
 - **Scripts:** always `--json` if parsing stdout.
+- **Token cost:** raw `--json` returns full Trello objects (a board list ≈ 10k tokens) — trim with `jq` (e.g. `| jq '.data[] | {id,name}'`) or request fewer fields (`--fields`, `--query "fields=id,name"`).
+- **Showing cards to a human?** Render one markdown line per card: `[name](shortUrl)` + non-zero badges `💬 n · 📎 n · ✓ x/y · ⏰ due` + labels as colored dots (red 🔴 orange 🟠 yellow 🟡 green 🟢 blue 🔵 purple 🟣). Slim the JSON first: `jq '.data[] | {name, shortUrl, labels: [.labels[] | {name, color}], badges: {comments: .badges.comments, attachments: .badges.attachments, checkItems: .badges.checkItems, checkItemsChecked: .badges.checkItemsChecked}, due, dueComplete}'`.
 - **`--pretty` alone** does not emit JSON; it only indents `--json` output.
 - Errors: red `✗` in human mode; exit code `1`.
 

package/skills/trelly-mcp/SKILL.md

@@ -12,6 +12,28 @@ MCP server for Trello (npm package **trelly**, bin **`trelly-mcp`**). Returns JS
 envelope on every tool: `{ ok, profile, data }` /
 `{ ok: false, error, status?, details? }`. Never uses CLI human/Ink output.
 
+List/get tools default to lean `fields` (id, name, url, due, …) to keep responses
+token-cheap; pass `fields: "all"` or a comma list when you need more.
+`trello_list_cards` and `trello_card_get` also include slim `badges`
+(comments/attachments/checkItems counts) and `labels` for rich rendering.
+
+## Rendering card lists for humans
+
+When the user asks to **see** cards (not automation), render one markdown line per
+card — title linked to the card, then only the badges that are non-zero:
+
+```
+1. [Publish module behavior](https://trello.com/c/1jH2UTAu) 🔴 `Priority: Highest` · 💬 4 · 📎 2 · ✓ 2/5 · ⏰ Jul 5
+```
+
+- Title → `[name](shortUrl)`. Counts from `badges`: 💬 comments · 📎 attachments · ✓ checkItemsChecked/checkItems.
+- Due: `⏰ Jul 5`, add `(overdue)` if past and not `dueComplete`; `✓` if complete.
+- Labels: colored dot + name in backticks. Trello color → emoji: red 🔴 · orange 🟠 · yellow 🟡 · green/lime 🟢 · blue/sky 🔵 · purple/pink 🟣 · black ⚫ · none ⚪.
+- Whole board: add `fields: "…,badges,labels"` to `trello_board_cards` (lean by default).
+- Custom-field chips (e.g. `Priority: Highest`): fetch defs once via `trello_api` GET
+  `/boards/{boardId}/customFields`, request `customFieldItems` on cards, match
+  `idValue` → option text/color. Skip unless the user wants them — it's an extra call.
+
 ## Setup
 
 ### 1. Auth (CLI, once)

package/src/mcp/handlers.ts

@@ -19,11 +19,49 @@ export const profileField = z.string().optional().describe("Auth profile name");
 export function toolResult(envelope: ToolEnvelope): CallToolResult {
   return {
     structuredContent: envelope,
-    content: [{ type: "text", text: JSON.stringify(envelope, null, 2) }],
+    content: [{ type: "text", text: JSON.stringify(envelope) }],
     isError: envelope.ok === false,
   };
 }
 
+// Trello's badges object is ~400 chars of mostly unused keys; keep the 4 that matter.
+const BADGE_KEYS = ["comments", "attachments", "checkItems", "checkItemsChecked"];
+
+function slimCard(card: Record<string, unknown>): Record<string, unknown> {
+  const out = { ...card };
+  if (out.badges && typeof out.badges === "object" && !Array.isArray(out.badges)) {
+    const badges = out.badges as Record<string, unknown>;
+    out.badges = Object.fromEntries(
+      BADGE_KEYS.filter((key) => badges[key] !== undefined).map((key) => [
+        key,
+        badges[key],
+      ]),
+    );
+  }
+  if (Array.isArray(out.labels)) {
+    out.labels = out.labels.map((label) => {
+      const { id, name, color } = label as Record<string, unknown>;
+      return { id, name, color };
+    });
+  }
+  return out;
+}
+
+/** Slim badges/labels on a card or card array returned by Trello. */
+export function slimCards(data: unknown): unknown {
+  if (Array.isArray(data)) {
+    return data.map((item) =>
+      item && typeof item === "object"
+        ? slimCard(item as Record<string, unknown>)
+        : item,
+    );
+  }
+  if (data && typeof data === "object") {
+    return slimCard(data as Record<string, unknown>);
+  }
+  return data;
+}
+
 export async function withClient<T>(
   profile: string | undefined,
   fn: (client: TrelloClient, profileName: string) => Promise<T>,

package/src/mcp/tools/boards.ts

@@ -1,6 +1,11 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { profileField, toolEnvelopeSchema, withClient } from "../handlers.ts";
+import {
+  profileField,
+  slimCards,
+  toolEnvelopeSchema,
+  withClient,
+} from "../handlers.ts";
 
 export function registerBoardTools(server: McpServer): void {
   const outputSchema = toolEnvelopeSchema;
@@ -25,7 +30,10 @@ export function registerBoardTools(server: McpServer): void {
           ])
           .optional()
           .default("open"),
-        fields: z.string().optional(),
+        fields: z
+          .string()
+          .default("id,name,shortUrl,closed")
+          .describe('comma-separated fields, "all" for everything'),
       },
       annotations: { readOnlyHint: true },
       outputSchema,
@@ -41,7 +49,10 @@ export function registerBoardTools(server: McpServer): void {
       inputSchema: {
         profile: profileField,
         boardId: z.string().min(1),
-        fields: z.string().optional(),
+        fields: z
+          .string()
+          .default("id,name,desc,shortUrl,closed")
+          .describe('comma-separated fields, "all" for everything'),
       },
       annotations: { readOnlyHint: true },
       outputSchema,
@@ -94,23 +105,38 @@ export function registerBoardTools(server: McpServer): void {
         profile: profileField,
         boardId: z.string().min(1),
         filter: z.string().optional().default("open"),
+        fields: z
+          .string()
+          .default("id,name,closed,pos")
+          .describe('comma-separated fields, "all" for everything'),
       },
       annotations: { readOnlyHint: true },
       outputSchema,
     },
-    async ({ profile, boardId, filter }) =>
-      withClient(profile, (client) => client.boardLists(boardId, { filter })),
+    async ({ profile, boardId, filter, fields }) =>
+      withClient(profile, (client) => client.boardLists(boardId, { filter, fields })),
   );
 
   server.registerTool(
     "trello_board_cards",
     {
       description: "List all cards on a board.",
-      inputSchema: { profile: profileField, boardId: z.string().min(1) },
+      inputSchema: {
+        profile: profileField,
+        boardId: z.string().min(1),
+        fields: z
+          .string()
+          .default("id,name,idList,due,dueComplete,shortUrl,closed")
+          .describe(
+            'comma-separated fields, "all" for everything; add "badges,labels" for rich lists',
+          ),
+      },
       annotations: { readOnlyHint: true },
       outputSchema,
     },
-    async ({ profile, boardId }) =>
-      withClient(profile, (client) => client.boardCards(boardId)),
+    async ({ profile, boardId, fields }) =>
+      withClient(profile, async (client) =>
+        slimCards(await client.boardCards(boardId, { fields })),
+      ),
   );
 }

package/src/mcp/tools/cards.ts

@@ -1,6 +1,11 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { profileField, toolEnvelopeSchema, withClient } from "../handlers.ts";
+import {
+  profileField,
+  slimCards,
+  toolEnvelopeSchema,
+  withClient,
+} from "../handlers.ts";
 
 export function registerCardTools(server: McpServer): void {
   const outputSchema = toolEnvelopeSchema;
@@ -12,13 +17,18 @@ export function registerCardTools(server: McpServer): void {
       inputSchema: {
         profile: profileField,
         cardId: z.string().min(1),
-        fields: z.string().optional(),
+        fields: z
+          .string()
+          .default("id,name,desc,due,dueComplete,idList,shortUrl,labels,badges")
+          .describe('comma-separated fields, "all" for everything'),
       },
       annotations: { readOnlyHint: true },
       outputSchema,
     },
     async ({ profile, cardId, fields }) =>
-      withClient(profile, (client) => client.cardGet(cardId, { fields })),
+      withClient(profile, async (client) =>
+        slimCards(await client.cardGet(cardId, { fields })),
+      ),
   );
 
   server.registerTool(

package/src/mcp/tools/lists.ts

@@ -1,6 +1,11 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { profileField, toolEnvelopeSchema, withClient } from "../handlers.ts";
+import {
+  profileField,
+  slimCards,
+  toolEnvelopeSchema,
+  withClient,
+} from "../handlers.ts";
 
 export function registerListTools(server: McpServer): void {
   const outputSchema = toolEnvelopeSchema;
@@ -27,11 +32,20 @@ export function registerListTools(server: McpServer): void {
     "trello_list_cards",
     {
       description: "List cards in a list.",
-      inputSchema: { profile: profileField, listId: z.string().min(1) },
+      inputSchema: {
+        profile: profileField,
+        listId: z.string().min(1),
+        fields: z
+          .string()
+          .default("id,name,idList,due,dueComplete,shortUrl,closed,badges,labels")
+          .describe('comma-separated fields, "all" for everything'),
+      },
       annotations: { readOnlyHint: true },
       outputSchema,
     },
-    async ({ profile, listId }) =>
-      withClient(profile, (client) => client.listCards(listId)),
+    async ({ profile, listId, fields }) =>
+      withClient(profile, async (client) =>
+        slimCards(await client.listCards(listId, { fields })),
+      ),
   );
 }

package/src/mcp/tools/search.ts

@@ -15,16 +15,28 @@ export function registerSearchTools(server: McpServer): void {
         modelTypes: z.string().optional(),
         cardsLimit: z.number().int().positive().optional(),
         boardsLimit: z.number().int().positive().optional(),
+        cardFields: z.string().default("id,name,idList,shortUrl"),
+        boardFields: z.string().default("id,name,shortUrl"),
       },
       annotations: { readOnlyHint: true },
       outputSchema,
     },
-    async ({ profile, query, modelTypes, cardsLimit, boardsLimit }) =>
+    async ({
+      profile,
+      query,
+      modelTypes,
+      cardsLimit,
+      boardsLimit,
+      cardFields,
+      boardFields,
+    }) =>
       withClient(profile, (client) =>
         client.search(query, {
           modelTypes,
           cards_limit: cardsLimit,
           boards_limit: boardsLimit,
+          card_fields: cardFields,
+          board_fields: boardFields,
         }),
       ),
   );