smashspace 0.2.1 → 0.3.0

package/README.md

@@ -95,7 +95,13 @@ smash --help                     # full command list (board/list/card/…)
 ```
 
 Output is a concise line by default; add `--json` for machine-readable output on
-any command. For agents:
+any command.
+
+**Field naming** (three concepts, three names — not a typo): a card's is
+`title`, an artifact's is `name` (`--name`), a file/attachment's is `filename`
+(with `sizeBytes`).
+
+For agents:
 
 ```bash
 smash scan --full                              # or --fields description,agentMeta

package/dist/smash.mjs

@@ -3654,6 +3654,10 @@ Use \`smash <group> --help\` for the full surface (\`board\`/\`list\`/\`card\`/
 \`comment\`/\`checklist\`/\`label\`/\`artifact\`/\`attachment\`/\`agent-meta\`/
 \`external-refs\`/\`assignees\`).
 
+**Field naming** (three concepts, three names \u2014 not a typo): a card's is
+\`title\`, an artifact's is \`name\` (\`--name\`), a file/attachment's is
+\`filename\` (with \`sizeBytes\`).
+
 ## List matching
 
 Use exact canonical names when present. For Todo-like selection, match
@@ -4406,18 +4410,56 @@ labelCmd.command("create <boardId> <name>").description("Create a board label").
     show(label, [`\u2713 label ${label.id} created (${label.name}/${label.color})`]);
   }
 );
-labelCmd.command("attach <cardId> <labelId>").description("Attach a label to a card").action(async (cardId, labelId) => {
+labelCmd.command("list [boardId]").description(`List a board's labels (id, name, color, card count). Board from ${CONFIG_FILENAME} when omitted`).option("-b, --board <label>", "board label from config").option("--board-id <id>", "explicit board id (bypass config)").action(async (boardIdArg, opts) => {
+  const ctx = resolveContext({ board: opts.board, boardId: boardIdArg ?? opts.boardId });
+  const detail = await fetchBoard(ctx.boardId, ctx.baseUrl);
+  const counts = /* @__PURE__ */ new Map();
+  for (const l of detail.lists)
+    for (const c of l.cards)
+      for (const id of c.labelIds)
+        counts.set(id, (counts.get(id) ?? 0) + 1);
+  const rows = detail.labels.map((l) => ({ ...l, cardCount: counts.get(l.id) ?? 0 }));
+  if (getOpts().json) {
+    console.log(JSON.stringify(rows, null, 2));
+    return;
+  }
+  if (rows.length === 0) {
+    console.log("(no labels)");
+    return;
+  }
+  for (const r of rows)
+    console.log(`${r.id}  ${r.name}  (${r.color ?? "none"})  ${r.cardCount} cards`);
+});
+async function resolveCardLabel(cardId, idOrName) {
+  const detail = await api(`/api/cards/${cardId}`);
+  const labels = await api(`/api/boards/${detail.card.boardId}/labels`);
+  const byId = labels.find((l) => l.id === idOrName);
+  if (byId)
+    return byId;
+  const lc = idOrName.toLowerCase();
+  const byName = labels.filter((l) => l.name.toLowerCase() === lc);
+  if (byName.length === 1)
+    return byName[0];
+  if (byName.length > 1)
+    throw new Error(`Label name "${idOrName}" matches ${byName.length} labels; pass the id (${byName.map((l) => l.id).join(", ")})`);
+  throw new Error(
+    `Label "${idOrName}" not found on this board. Labels: ${labels.map((l) => l.name).join(", ") || "(none)"}`
+  );
+}
+labelCmd.command("attach <cardId> <label>").description("Attach a label to a card (label id or name)").action(async (cardId, idOrName) => {
+  const label = await resolveCardLabel(cardId, idOrName);
   await api(`/api/cards/${cardId}/labels`, {
     method: "POST",
-    body: JSON.stringify({ labelId })
+    body: JSON.stringify({ labelId: label.id })
   });
-  console.log(`\u2713 label ${labelId} attached to ${cardId}`);
+  console.log(`\u2713 label ${label.name} (${label.id}) attached to ${cardId}`);
 });
-labelCmd.command("detach <cardId> <labelId>").description("Detach a label from a card").action(async (cardId, labelId) => {
-  await api(`/api/cards/${cardId}/labels/${labelId}`, {
+labelCmd.command("detach <cardId> <label>").description("Detach a label from a card (label id or name)").action(async (cardId, idOrName) => {
+  const label = await resolveCardLabel(cardId, idOrName);
+  await api(`/api/cards/${cardId}/labels/${label.id}`, {
     method: "DELETE"
   });
-  console.log(`\u2713 label ${labelId} detached from ${cardId}`);
+  console.log(`\u2713 label ${label.name} (${label.id}) detached from ${cardId}`);
 });
 labelCmd.command("update <labelId>").description("Update a label's name and/or color").option("--name <name>", "New label name").option("--color <color>", "Color (green/lime/yellow/orange/red/pink/purple/blue/sky/gray), or empty string to clear").action(async (labelId, opts) => {
   const patch = {};
@@ -4577,6 +4619,52 @@ assigneesCmd.command("add <cardId>").description("Append a single assignee (read
   });
   show(card, [`\u2713 card ${card.id} assignees now has ${next.length} entries`]);
 });
+assigneesCmd.command("update <cardId> <assigneeId>").description("Change an assignee's icon (emoji) and/or display name").option("--emoji <emoji>", "New avatar_emoji").option("--no-emoji", "Remove the avatar_emoji (fall back to the default icon)").option("--name <name>", "New display_name").action(async (cardId, assigneeId, opts) => {
+  if (opts.emoji === void 0 && opts.name === void 0) {
+    console.error("Pass --emoji <e>, --no-emoji, or --name <name>");
+    process.exit(1);
+  }
+  if (opts.name !== void 0 && !opts.name.trim()) {
+    console.error("--name must not be empty");
+    process.exit(1);
+  }
+  const detail = await api(`/api/cards/${cardId}`);
+  const current = detail.card.assignees ?? [];
+  if (!current.some((a) => a.id === assigneeId)) {
+    console.error(`No assignee with id "${assigneeId}" on card ${cardId}`);
+    process.exit(1);
+  }
+  const next = current.map((a) => {
+    if (a.id !== assigneeId)
+      return a;
+    const { avatar_emoji, ...rest } = a;
+    const emoji = opts.emoji === void 0 ? avatar_emoji : opts.emoji || void 0;
+    return {
+      ...rest,
+      ...opts.name !== void 0 ? { display_name: opts.name } : {},
+      ...emoji ? { avatar_emoji: emoji } : {}
+    };
+  });
+  const card = await api(`/api/cards/${cardId}`, {
+    method: "PATCH",
+    body: JSON.stringify({ assignees: next })
+  });
+  show(card, [`\u2713 card ${card.id} assignee ${assigneeId} updated`]);
+});
+assigneesCmd.command("remove <cardId> <assigneeId>").description("Remove a single assignee by id").action(async (cardId, assigneeId) => {
+  const detail = await api(`/api/cards/${cardId}`);
+  const current = detail.card.assignees ?? [];
+  const next = current.filter((a) => a.id !== assigneeId);
+  if (next.length === current.length) {
+    console.error(`No assignee with id "${assigneeId}" on card ${cardId}`);
+    process.exit(1);
+  }
+  const card = await api(`/api/cards/${cardId}`, {
+    method: "PATCH",
+    body: JSON.stringify({ assignees: next.length === 0 ? null : next })
+  });
+  show(card, [`\u2713 card ${card.id} assignees now has ${next.length} entries`]);
+});
 assigneesCmd.command("clear <cardId>").description("Clear assignees on a card (set to null)").action(async (cardId) => {
   const card = await api(`/api/cards/${cardId}`, {
     method: "PATCH",

package/dist/smashspace-mcp.mjs

@@ -15469,6 +15469,24 @@ async function api(path, init = {}, baseUrlOverride) {
     return void 0;
   return await res.json();
 }
+async function resolveCardLabel(cardId, idOrName) {
+  if (typeof idOrName !== "string" || !idOrName)
+    throw new Error("`label` (id or name) is required");
+  const detail = await api(`/api/cards/${cardId}`);
+  const labels = await api(`/api/boards/${detail.card.boardId}/labels`);
+  const byId = labels.find((l) => l.id === idOrName);
+  if (byId)
+    return byId;
+  const lc = idOrName.toLowerCase();
+  const byName = labels.filter((l) => l.name.toLowerCase() === lc);
+  if (byName.length === 1)
+    return byName[0];
+  if (byName.length > 1)
+    throw new Error(`Label name "${idOrName}" matches ${byName.length} labels; pass the id (${byName.map((l) => l.id).join(", ")})`);
+  throw new Error(
+    `Label "${idOrName}" not found on this board. Labels: ${labels.map((l) => l.name).join(", ") || "(none)"}`
+  );
+}
 var tools = [
   {
     name: "smash_create_board",
@@ -15635,7 +15653,7 @@ var tools = [
   },
   {
     name: "smash_set_agent_meta",
-    description: "Set or clear a card's agent_meta (structured field for external agents like Claude Code). Pass agentMeta=null to clear. Common shape: {primary_agent, status: 'idle'|'working'|'waiting_review'|'blocked'|'done', turn: 'human'|'agent'|'blocked', started_at, updated_at, progress (0..1), current_step}. Extra keys are accepted for forward-compat.",
+    description: "Set or clear a card's agent_meta (structured field for external agents like Claude Code). Pass agentMeta=null to clear. Common shape: {primary_agent, status: 'idle'|'working'|'waiting_review'|'blocked'|'done', turn: 'human'|'agent'|'blocked', started_at, updated_at, progress (0..1), current_step}. avatar_emoji is shown on the board's cards, so give each agent a distinct emoji (and reuse the same id) to make ownership visible at a glance. Extra keys are accepted for forward-compat.",
     inputSchema: {
       type: "object",
       properties: {
@@ -15839,42 +15857,64 @@ var tools = [
       body: JSON.stringify({ name: args.name, color: args.color })
     })
   },
+  {
+    name: "smash_list_labels",
+    description: "List a board's labels with id, name, color, and how many cards carry each. Use this to find a label before attaching it.",
+    inputSchema: {
+      type: "object",
+      properties: { boardId: { type: "string" } },
+      required: ["boardId"]
+    },
+    handler: async (args) => {
+      const detail = await api(`/api/boards/${args.boardId}`);
+      const counts = /* @__PURE__ */ new Map();
+      for (const l of detail.lists)
+        for (const c of l.cards)
+          for (const id of c.labelIds)
+            counts.set(id, (counts.get(id) ?? 0) + 1);
+      return detail.labels.map((l) => ({ ...l, cardCount: counts.get(l.id) ?? 0 }));
+    }
+  },
   {
     name: "smash_attach_label",
-    description: "Attach a board label to a card.",
+    description: "Attach a board label to a card. `label` may be the label id or its name (case-insensitive) on the card's board.",
     inputSchema: {
       type: "object",
       properties: {
         cardId: { type: "string" },
-        labelId: { type: "string" }
+        label: { type: "string", description: "Label id or name" },
+        labelId: { type: "string", description: "Deprecated alias of `label`" }
       },
-      required: ["cardId", "labelId"]
+      required: ["cardId"]
     },
     handler: async (args) => {
+      const label = await resolveCardLabel(String(args.cardId), args.label ?? args.labelId);
       await api(`/api/cards/${args.cardId}/labels`, {
         method: "POST",
-        body: JSON.stringify({ labelId: args.labelId })
+        body: JSON.stringify({ labelId: label.id })
       });
-      return { ok: true };
+      return { ok: true, label };
     }
   },
   {
     name: "smash_detach_label",
-    description: "Detach a label from a card.",
+    description: "Detach a label from a card. `label` may be the label id or its name (case-insensitive).",
     inputSchema: {
       type: "object",
       properties: {
         cardId: { type: "string" },
-        labelId: { type: "string" }
+        label: { type: "string", description: "Label id or name" },
+        labelId: { type: "string", description: "Deprecated alias of `label`" }
       },
-      required: ["cardId", "labelId"]
+      required: ["cardId"]
     },
     handler: async (args) => {
+      const label = await resolveCardLabel(String(args.cardId), args.label ?? args.labelId);
       await api(
-        `/api/cards/${args.cardId}/labels/${args.labelId}`,
+        `/api/cards/${args.cardId}/labels/${label.id}`,
         { method: "DELETE" }
       );
-      return { ok: true };
+      return { ok: true, label };
     }
   },
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smashspace",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "SmashSpace CLI + MCP — operate SmashSpace boards from your terminal, Claude Code, Cursor, and Codex.",
   "type": "module",
   "bin": {