npm - smashspace - Versions diffs - 0.4.0 → 0.7.0 - Mend

smashspace 0.4.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/smash.mjs CHANGED Viewed

@@ -3398,6 +3398,40 @@ import { createInterface } from "node:readline/promises";
 import { relative, join as join3, dirname as dirname3, basename } from "node:path";
 import { stdin, stdout } from "node:process";
+// ../../shared/assignee-id.ts
+function normalizeAssigneeName(name) {
+  return name.trim().toLowerCase();
+}
+function findAssigneeByName(known, name) {
+  const needle = normalizeAssigneeName(name);
+  return known.find((a) => normalizeAssigneeName(a.display_name) === needle);
+}
+function hash32(input) {
+  let h = 2166136261;
+  for (let i = 0; i < input.length; i += 1) {
+    h ^= input.charCodeAt(i);
+    h = Math.imul(h, 16777619) >>> 0;
+  }
+  return h >>> 0;
+}
+function stableAssigneeId(kind, name) {
+  const normalized = normalizeAssigneeName(name);
+  const ascii = normalized.replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 32);
+  const suffix = ascii.length >= 2 ? ascii : hash32(normalized).toString(36).padStart(7, "0");
+  return `${kind}_${suffix}`;
+}
+function resolveAssignee(known, input) {
+  const existing = input.explicitId ? known.find((a) => a.id === input.explicitId) : findAssigneeByName(known, input.name);
+  const id = input.explicitId ?? existing?.id ?? stableAssigneeId(input.kind, input.name);
+  const emoji = input.emoji ?? existing?.avatar_emoji;
+  return {
+    kind: input.kind,
+    id,
+    display_name: input.name.trim(),
+    ...emoji ? { avatar_emoji: emoji } : {}
+  };
+}
 // ../../shared/board-registry.ts
 var BOARD_ID_PATTERN = /^(?:board_|b_|s_)[a-z0-9]+$/i;
 var URL_BOARD_PATTERN = /^(https?:\/\/[^/]+)\/(?:board|space)\/((?:board_|b_|s_)[a-z0-9]+)/i;
@@ -4135,7 +4169,7 @@ cardCmd.command("move <cardId>").description("Move a card to a list (and optiona
 );
 cardCmd.command("delete <cardId>").description("Delete a card").action(async (cardId) => {
   await api(`/api/cards/${cardId}`, { method: "DELETE" });
-  console.log(`\u2713 card ${cardId} deleted`);
+  console.log(`\u2713 card ${cardId} archived (restore with: smash archive restore ${cardId})`);
 });
 cardCmd.command("search <query>").description(
   "Search cards by case-insensitive substring match (title + description). Use --board to search one board, or set SMASH_BOARDS env var to search all registered boards."
@@ -4225,6 +4259,57 @@ cardCmd.command("comment <cardId> <body>").description("Add a comment to a card"
 function collectRepeated(value, previous) {
   return [...previous, value];
 }
+program2.command("done <cardId>").description(
+  "Mark a card done \u2014 moves it to the board's done list (it stays on the board). Not the same as `smash archive`, which takes it off."
+).action(async (cardId) => {
+  const result = await api(`/api/cards/${cardId}/complete`, {
+    method: "POST"
+  });
+  show(result.card, [`\u2713 card ${result.card.id} \u2192 ${result.listTitle}`]);
+});
+program2.command("cards").description(
+  "List cards on the resolved board \u2014 light by default (no description). Filter by list/assignee, pick columns with --fields."
+).option("-b, --board <label>", "board label from config").option("--board-id <id>", "explicit board id (bypass config)").option("-l, --list <name>", "only cards in this list (name or id)").option("--assignee <idOrName>", "only cards assigned to this id or display name").option("--status <status>", "open (skip cards in lists marked done) | done | all (default)").option(
+  "--fields <list>",
+  "comma-separated columns (default: id,title,listId,listTitle,updatedAt). Add description only when you need bodies."
+).option("--limit <n>", "max cards per page (default 100, max 500)").option("--cursor <cursor>", "continue from a previous response's cursor").action(async (opts) => {
+  if (opts.status && !["open", "done", "all"].includes(opts.status)) {
+    console.error("--status must be one of: open, done, all");
+    process.exit(1);
+  }
+  const ctx = resolveContext(opts);
+  const params = new URLSearchParams();
+  if (opts.list)
+    params.set("list", opts.list);
+  if (opts.assignee)
+    params.set("assignee", opts.assignee);
+  if (opts.status)
+    params.set("status", opts.status);
+  if (opts.fields)
+    params.set("fields", opts.fields);
+  if (opts.limit)
+    params.set("limit", opts.limit);
+  if (opts.cursor)
+    params.set("cursor", opts.cursor);
+  const qs = params.toString();
+  const result = await api(
+    `/api/boards/${ctx.boardId}/cards${qs ? `?${qs}` : ""}`,
+    void 0,
+    ctx.baseUrl
+  );
+  if (getOpts().json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  for (const card of result.cards) {
+    const listTitle = typeof card.listTitle === "string" ? `[${card.listTitle}] ` : "";
+    console.log(`${listTitle}${String(card.title ?? "")}  (${String(card.id ?? "")})`);
+  }
+  console.log(
+    `
+${result.cards.length} of ${result.total}${result.cursor ? `  next: --cursor ${result.cursor}` : ""}`
+  );
+});
 program2.command("inbox").description(
   `New comments across the resolved board (${CONFIG_FILENAME}). Poll with --since <cursor> to read only what you have not seen.`
 ).option("-b, --board <label>", "board label from config").option("--board-id <id>", "explicit board id (bypass config)").option("--since <iso>", "only comments created after this ISO timestamp (exclusive)").option("--to <id>", "only comments addressed to this assignee id").option("--limit <n>", "max comments to read (default 100, max 500)").action(async (opts) => {
@@ -4493,6 +4578,13 @@ tokenCmd.command("revoke <boardId> <tokenId>").description("Revoke a write token
   );
   show(revoked, [`\u2713 token ${revoked.id} revoked at ${revoked.revokedAt}`]);
 });
+listCmd.command("done <listId>").description("Mark a list as done (cards in it are excluded by `smash cards --status open`)").option("--no-done", "unmark it instead").action(async (listId, opts) => {
+  const list = await api(`/api/lists/${listId}`, {
+    method: "PATCH",
+    body: JSON.stringify({ isDone: opts.done })
+  });
+  show(list, [`\u2713 list ${list.id} (${list.title}) isDone=${list.isDone}`]);
+});
 var labelCmd = program2.command("label").description("Labels");
 labelCmd.command("create <boardId> <name>").description("Create a board label").option(
   "--color <color>",
@@ -4698,23 +4790,31 @@ assigneesCmd.command("add <cardId>").description("Append a single assignee (read
     console.error("--name must not be empty");
     process.exit(1);
   }
-  const id = opts.id ?? `${opts.kind}_${Math.random().toString(36).slice(2, 10)}`;
   const detail = await api(`/api/cards/${cardId}`);
   const current = detail.card.assignees ?? [];
-  const next = [
+  const board = await api(
+    `/api/boards/${detail.card.boardId}/cards?fields=assignees&limit=500`
+  );
+  const known = [
     ...current,
-    {
-      kind: opts.kind,
-      id,
-      display_name: opts.name,
-      ...opts.emoji ? { avatar_emoji: opts.emoji } : {}
-    }
+    ...board.cards.flatMap(
+      (c) => Array.isArray(c.assignees) ? c.assignees : []
+    )
   ];
+  const entry = resolveAssignee(known, {
+    kind: opts.kind,
+    name: opts.name,
+    explicitId: opts.id,
+    emoji: opts.emoji
+  });
+  const next = [...current, entry];
   const card = await api(`/api/cards/${cardId}`, {
     method: "PATCH",
     body: JSON.stringify({ assignees: next })
   });
-  show(card, [`\u2713 card ${card.id} assignees now has ${next.length} entries`]);
+  show(card, [
+    `\u2713 card ${card.id} assignees now has ${next.length} entries (${entry.display_name} \u2192 ${entry.id})`
+  ]);
 });
 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) {

package/dist/smashspace-mcp.mjs CHANGED Viewed

@@ -15509,7 +15509,7 @@ var tools = [
   },
   {
     name: "smash_get_board",
-    description: "Get full board detail including lists, cards (with labelIds), and labels.",
+    description: "Get full board detail including lists, cards (with labelIds), and labels. This returns every card's full description and can run to six figures of characters on a busy board \u2014 prefer smash_list_cards when you only need to find cards, and come back here for the whole structure.",
     inputSchema: {
       type: "object",
       properties: {
@@ -15553,18 +15553,25 @@ var tools = [
   },
   {
     name: "smash_rename_list",
-    description: "Rename a list.",
+    description: "Rename a list, and/or mark it as a done list. Cards in a list with isDone=true are excluded by smash_list_cards({status: 'open'}), so an agent can ask for open work without knowing the board's list names.",
     inputSchema: {
       type: "object",
       properties: {
         listId: { type: "string" },
-        title: { type: "string" }
+        title: { type: "string" },
+        isDone: {
+          type: "boolean",
+          description: "Treat cards in this list as done"
+        }
       },
-      required: ["listId", "title"]
+      required: ["listId"]
     },
     handler: async (args) => api(`/api/lists/${args.listId}`, {
       method: "PATCH",
-      body: JSON.stringify({ title: args.title })
+      body: JSON.stringify({
+        ...typeof args.title === "string" ? { title: args.title } : {},
+        ...typeof args.isDone === "boolean" ? { isDone: args.isDone } : {}
+      })
     })
   },
   {
@@ -15653,7 +15660,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}. 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.",
+    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}. REUSE THE SAME id for the same role across cards (e.g. always 'platform', not a fresh random id): ids are how anyone filters cards later, and a role that gets a new id per card cannot be filtered at all. Check smash_list_cards with fields=['assignees'] to see which ids the board already uses. 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: {
@@ -15701,6 +15708,48 @@ var tools = [
       body: JSON.stringify({ externalRefs: args.externalRefs ?? null })
     })
   },
+  {
+    name: "smash_list_cards",
+    description: "List a board's cards WITHOUT their descriptions \u2014 use this instead of smash_get_board when you only need to find cards. smash_get_board returns every card body and can exceed a tool-output limit on a busy board. Filter with `list` and `assignee` (matches an assignee id or display name), and pick columns with `fields` (default: id, title, listId, listTitle, updatedAt). Pass fields including 'description' only when you truly need bodies; otherwise fetch one card with smash_get_card. Paginate with the returned `cursor`.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        boardId: { type: "string" },
+        list: { type: "string", description: "List name (case-insensitive) or list id" },
+        assignee: { type: "string", description: "Assignee id or display name" },
+        status: {
+          type: "string",
+          enum: ["open", "done", "all"],
+          description: "open skips cards sitting in a list marked done (a flag on the list, not a name match); done keeps only those. Default all."
+        },
+        fields: {
+          type: "array",
+          items: { type: "string" },
+          description: "Columns to return: id, boardId, title, description, listId, listTitle, position, dueAt, labelIds, checklistTitle, agentMeta, externalRefs, assignees, customData, createdAt, updatedAt"
+        },
+        limit: { type: "number", description: "Max cards per page (default 100, max 500)" },
+        cursor: { type: "string", description: "Cursor from a previous response" }
+      },
+      required: ["boardId"]
+    },
+    handler: async (args) => {
+      const params = new URLSearchParams();
+      if (typeof args.list === "string" && args.list)
+        params.set("list", args.list);
+      if (typeof args.assignee === "string" && args.assignee)
+        params.set("assignee", args.assignee);
+      if (typeof args.status === "string" && args.status)
+        params.set("status", args.status);
+      if (Array.isArray(args.fields) && args.fields.length > 0)
+        params.set("fields", args.fields.join(","));
+      if (typeof args.limit === "number")
+        params.set("limit", String(args.limit));
+      if (typeof args.cursor === "string" && args.cursor)
+        params.set("cursor", args.cursor);
+      const qs = params.toString();
+      return api(`/api/boards/${args.boardId}/cards${qs ? `?${qs}` : ""}`);
+    }
+  },
   {
     name: "smash_set_assignees",
     description: "Set or clear a card's assignees (humans + external agents listed together). Pass assignees=null to clear. Each entry: {kind: 'human'|'agent', id: string, display_name: string, avatar_emoji?: string}. Extra keys are accepted for forward-compat.",
@@ -15751,9 +15800,19 @@ var tools = [
       })
     })
   },
+  {
+    name: "smash_complete_card",
+    description: "Mark a card done: it moves to the list flagged as done on its board and STAYS on the board, where people can see it. Use this when work finished. smash_delete_card is different \u2014 that archives the card off the board. Fails with a message when no list is marked done yet (mark one with smash_rename_list({listId, isDone: true})).",
+    inputSchema: {
+      type: "object",
+      properties: { cardId: { type: "string" } },
+      required: ["cardId"]
+    },
+    handler: async (args) => api(`/api/cards/${args.cardId}/complete`, { method: "POST" })
+  },
   {
     name: "smash_delete_card",
-    description: "Soft-delete a card.",
+    description: "Archive a card (soft delete) \u2014 NOT the same as marking it done. It leaves the board but is kept: it shows up in the space's archived column and smash_restore_card puts it back. Nothing is destroyed here \u2014 smash_permanently_delete_card is the irreversible one.",
     inputSchema: {
       type: "object",
       properties: { cardId: { type: "string" } },
@@ -15761,7 +15820,11 @@ var tools = [
     },
     handler: async (args) => {
       await api(`/api/cards/${args.cardId}`, { method: "DELETE" });
-      return { ok: true };
+      return {
+        ok: true,
+        archived: true,
+        note: `Archived, not destroyed. Restore with smash_restore_card({cardId: "${args.cardId}"}), or find it in the space's \u5B8C\u4E86\u6E08\u307F / Archive column.`
+      };
     }
   },
   {

package/package.json CHANGED Viewed

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