exponential-cli 1.9.0 → 1.10.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command19 } from "commander";
+import { Command as Command22 } from "commander";
 
 // src/commands/auth.ts
 import { Command } from "commander";
@@ -752,30 +752,59 @@ function outputStagesJson(stages) {
     total: stages.length
   }, null, 2));
 }
-function transformComment(comment) {
-  const parentKey = "actionId" in comment ? "actionId" : "ticketId";
-  const parentId = comment[parentKey];
+var COMMENT_PARENT_KEYS = ["actionId", "ticketId", "goalId", "featureId", "pageId"];
+function normalizeComment(comment) {
+  const raw = comment;
+  const parentKey = COMMENT_PARENT_KEYS.find((k) => k in raw) ?? "parentId";
+  const author = raw.author ?? raw.createdBy ?? null;
   return {
     id: comment.id,
-    [parentKey]: parentId,
-    authorId: comment.authorId,
-    content: comment.content,
-    author: comment.author,
-    createdAt: new Date(comment.createdAt).toISOString(),
-    updatedAt: new Date(comment.updatedAt).toISOString()
+    parentKey,
+    parentId: raw[parentKey],
+    authorId: raw.authorId ?? raw.createdById,
+    author,
+    content: raw.content ?? raw.body ?? "",
+    createdAt: new Date(comment.createdAt),
+    updatedAt: new Date(comment.updatedAt),
+    parentCommentId: raw.parentId ?? null,
+    threadId: raw.threadId ?? null,
+    resolvedAt: raw.resolvedAt ? new Date(raw.resolvedAt) : null
+  };
+}
+function transformComment(comment) {
+  const n = normalizeComment(comment);
+  const out = {
+    id: n.id,
+    [n.parentKey]: n.parentId,
+    authorId: n.authorId,
+    content: n.content,
+    author: n.author,
+    createdAt: n.createdAt.toISOString(),
+    updatedAt: n.updatedAt.toISOString()
   };
+  if (n.threadId !== null) out.threadId = n.threadId;
+  if (n.parentCommentId !== null && n.parentKey !== "parentId") {
+    out.parentCommentId = n.parentCommentId;
+  }
+  if (n.resolvedAt) out.resolvedAt = n.resolvedAt.toISOString();
+  return out;
 }
 function outputCommentJson(comment) {
   console.log(JSON.stringify(transformComment(comment), null, 2));
 }
 function outputCommentPretty(comment) {
-  const author = comment.author?.name ?? comment.authorId;
-  const when = formatDate(new Date(comment.createdAt));
+  const n = normalizeComment(comment);
+  const author = n.author?.name ?? n.authorId;
+  const when = formatDate(n.createdAt);
+  const badges = [
+    n.parentCommentId && n.parentKey !== "parentId" ? chalk3.gray("(reply)") : "",
+    n.resolvedAt ? chalk3.green("(resolved)") : ""
+  ].filter(Boolean).join(" ");
   console.log(chalk3.gray("\u2500".repeat(50)));
-  console.log(`${chalk3.bold(author)} ${chalk3.gray(`\u2014 ${when}`)}`);
-  console.log(chalk3.gray(`  ID: ${comment.id}`));
+  console.log(`${chalk3.bold(author)} ${chalk3.gray(`\u2014 ${when}`)}${badges ? ` ${badges}` : ""}`);
+  console.log(chalk3.gray(`  ID: ${n.id}`));
   console.log();
-  console.log(comment.content);
+  console.log(n.content);
   console.log();
 }
 function outputCommentsJson(comments) {
@@ -2235,7 +2264,7 @@ function createEpicsCommand() {
 }
 
 // src/commands/features.ts
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 
 // src/commands/stories.ts
 import { Command as Command6 } from "commander";
@@ -2656,6 +2685,240 @@ function createAreasCommand() {
   return areas;
 }
 
+// src/commands/featureComments.ts
+import { Command as Command10 } from "commander";
+
+// src/utils/mentions.ts
+function candidateLabels(member) {
+  const labels = [member.id];
+  if (member.name) {
+    labels.push(member.name);
+    const first = member.name.trim().split(/\s+/)[0];
+    if (first) labels.push(first);
+  }
+  if (member.email) {
+    labels.push(member.email);
+    const local = member.email.split("@")[0];
+    if (local) labels.push(local);
+  }
+  return labels;
+}
+function describe(member) {
+  return member.name ?? member.email ?? member.id;
+}
+function resolveMember(members, token) {
+  const needle = token.trim().toLowerCase().replace(/^@/, "");
+  const exact = members.filter(
+    (m) => m.id.toLowerCase() === needle || m.name?.toLowerCase() === needle || m.email?.toLowerCase() === needle
+  );
+  if (exact.length === 1) return exact[0];
+  if (exact.length > 1) {
+    throw new Error(
+      `"${token}" matches ${exact.length} members. Use a user id instead: ${exact.map((m) => `${describe(m)} (${m.id})`).join(", ")}`
+    );
+  }
+  const partial = members.filter(
+    (m) => candidateLabels(m).some((l) => l.toLowerCase() === needle)
+  );
+  if (partial.length === 1) return partial[0];
+  if (partial.length > 1) {
+    throw new Error(
+      `"${token}" is ambiguous \u2014 matches ${partial.map((m) => `${describe(m)} (${m.id})`).join(", ")}. Use a full name, email, or user id.`
+    );
+  }
+  const known = members.map(describe).join(", ");
+  throw new Error(
+    `No workspace member matches "${token}". Members: ${known || "(none)"}. Run \`exponential workspaces members\` to see the roster.`
+  );
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+async function applyMentions(client, workspaceId, body, mentions) {
+  if (!mentions || mentions.length === 0) return body;
+  const members = await client.workspaces.listMembers(workspaceId);
+  let result = body;
+  const prepend = [];
+  for (const token of mentions) {
+    const member = resolveMember(members, token);
+    const handle = token.trim().replace(/^@/, "");
+    const inline = new RegExp(`@${escapeRegExp(handle)}(?![\\w-])`, "gi");
+    const substituted = result.replace(inline, member.mentionSyntax);
+    if (substituted !== result) {
+      result = substituted;
+    } else if (!result.includes(member.mentionSyntax)) {
+      prepend.push(member.mentionSyntax);
+    }
+  }
+  return prepend.length > 0 ? `${prepend.join(" ")} ${result}` : result;
+}
+var MENTION_OPTION_DESCRIPTION = "Mention a workspace member by name, email, or id (repeatable). Writing @name in the message substitutes in place; otherwise the mention is prepended.";
+function collectMention(value, previous) {
+  return [...previous, value];
+}
+
+// src/commands/featureComments.ts
+function createFeatureCommentsCommand() {
+  const comment = new Command10("comment").description(
+    "Read and post comments on a feature. Mention teammates with --mention."
+  );
+  comment.command("list").description("List comments on a feature").requiredOption("--feature <id>", "Feature ID").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      const client = getClient();
+      const comments = await client.featureComments.list(options.feature);
+      if (useJson) outputCommentsJson(comments);
+      else outputCommentsPretty(comments);
+    } catch (error) {
+      handleError(error, useJson);
+    }
+  });
+  comment.command("add").description("Add a comment to a feature").requiredOption("--feature <id>", "Feature ID").requiredOption("-m, --message <text>", "Comment body (markdown supported)").option("--mention <name>", MENTION_OPTION_DESCRIPTION, collectMention, []).option(
+    "--workspace <slug|id>",
+    "Workspace used to resolve --mention (defaults to your default workspace)"
+  ).option("--scope <id>", "Attach to a scope's activity feed instead of the feature").action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const body = options.mention.length > 0 ? await applyMentions(
+          client,
+          await resolveWorkspaceId(client, options.workspace),
+          options.message,
+          options.mention
+        ) : options.message;
+        const created = await client.featureComments.create({
+          featureId: options.feature,
+          scopeId: options.scope,
+          body
+        });
+        if (useJson) {
+          outputCommentJson(created);
+        } else {
+          console.log("\n\u2713 Comment added");
+          outputCommentPretty(created);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  comment.command("reply").description("Reply to a comment on a feature").requiredOption("--comment-id <id>", "Comment ID to reply to").requiredOption("-m, --message <text>", "Reply body (markdown supported)").option("--mention <name>", MENTION_OPTION_DESCRIPTION, collectMention, []).option(
+    "--workspace <slug|id>",
+    "Workspace used to resolve --mention (defaults to your default workspace)"
+  ).action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const body = options.mention.length > 0 ? await applyMentions(
+          client,
+          await resolveWorkspaceId(client, options.workspace),
+          options.message,
+          options.mention
+        ) : options.message;
+        const created = await client.featureComments.reply({
+          parentId: options.commentId,
+          body
+        });
+        if (useJson) {
+          outputCommentJson(created);
+        } else {
+          console.log("\n\u2713 Reply added");
+          outputCommentPretty(created);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  comment.command("update").description("Update one of your own comments").requiredOption("--comment-id <id>", "Comment ID").requiredOption("-m, --message <text>", "New comment body").option("--mention <name>", MENTION_OPTION_DESCRIPTION, collectMention, []).option(
+    "--workspace <slug|id>",
+    "Workspace used to resolve --mention (defaults to your default workspace)"
+  ).action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const body = options.mention.length > 0 ? await applyMentions(
+          client,
+          await resolveWorkspaceId(client, options.workspace),
+          options.message,
+          options.mention
+        ) : options.message;
+        const updated = await client.featureComments.update({
+          commentId: options.commentId,
+          body
+        });
+        if (useJson) {
+          outputCommentJson(updated);
+        } else {
+          console.log("\n\u2713 Comment updated");
+          outputCommentPretty(updated);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  comment.command("rm").description("Delete one of your own comments").requiredOption("--comment-id <id>", "Comment ID").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      const client = getClient();
+      await client.featureComments.delete(options.commentId);
+      if (useJson) {
+        console.log(JSON.stringify({ deleted: true, id: options.commentId }, null, 2));
+      } else {
+        console.log("\u2713 Comment deleted");
+      }
+    } catch (error) {
+      handleError(error, useJson);
+    }
+  });
+  comment.command("resolve").description("Resolve an anchored comment thread").requiredOption("--feature <id>", "Feature ID").requiredOption("--thread <id>", "Thread ID (anchored comments only)").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      const client = getClient();
+      await client.featureComments.resolve({
+        featureId: options.feature,
+        threadId: options.thread
+      });
+      if (useJson) {
+        console.log(JSON.stringify({ resolved: true, threadId: options.thread }, null, 2));
+      } else {
+        console.log("\u2713 Thread resolved");
+      }
+    } catch (error) {
+      handleError(error, useJson);
+    }
+  });
+  comment.command("unresolve").description("Reopen a resolved comment thread").requiredOption("--feature <id>", "Feature ID").requiredOption("--thread <id>", "Thread ID (anchored comments only)").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      const client = getClient();
+      await client.featureComments.unresolve({
+        featureId: options.feature,
+        threadId: options.thread
+      });
+      if (useJson) {
+        console.log(JSON.stringify({ resolved: false, threadId: options.thread }, null, 2));
+      } else {
+        console.log("\u2713 Thread reopened");
+      }
+    } catch (error) {
+      handleError(error, useJson);
+    }
+  });
+  return comment;
+}
+
 // src/commands/features.ts
 var FEATURE_STATUSES = [
   "IDEA",
@@ -2686,7 +2949,7 @@ function validateFeatureStatus(value) {
   return value;
 }
 function createFeaturesCommand() {
-  const features = new Command10("features").description(
+  const features = new Command11("features").description(
     "Manage features. A feature lives under a product and groups user stories, scopes, and tickets."
   );
   features.command("list").description("List features in a product").requiredOption("--product <slug|id>", "Product slug or CUID").option("--workspace <slug|id>", "Workspace (required when --product is a slug)").option("--status <status>", `Filter by status: ${FEATURE_STATUSES.join(", ")}`).action(
@@ -2934,11 +3197,12 @@ Aborted: ${reason}. Feature "${feature.name}" was NOT deleted.`);
   features.addCommand(createScopesCommand());
   features.addCommand(createRequirementsCommand());
   features.addCommand(createAreasCommand());
+  features.addCommand(createFeatureCommentsCommand());
   return features;
 }
 
 // src/commands/labels.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 import chalk5 from "chalk";
 var TRIAGE_LABELS = [
   { slug: "needs-triage", name: "needs-triage", color: "avatar-orange" },
@@ -2992,7 +3256,7 @@ async function resolveLabelIds(client, workspaceId, values) {
   return [...byId, ...resolvedFromSlugs];
 }
 function createLabelsCommand() {
-  const labels = new Command11("labels").description(
+  const labels = new Command12("labels").description(
     "Manage labels (orthogonal tags applied to actions, tickets, features, and epics)."
   );
   labels.command("list").description("List labels visible in a workspace").option("--workspace <slug|id>", "Workspace slug or CUID").option(
@@ -3095,7 +3359,7 @@ function createLabelsCommand() {
 }
 
 // src/commands/organizations.ts
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 var VALID_SIZES = [
   "1-10",
   "11-50",
@@ -3105,7 +3369,7 @@ var VALID_SIZES = [
   "1000+"
 ];
 function createOrganizationsCommand() {
-  const organizations = new Command12("organizations").alias("orgs").description("Manage CRM organizations");
+  const organizations = new Command13("organizations").alias("orgs").description("Manage CRM organizations");
   organizations.command("list").description("List organizations").requiredOption("--workspace <id>", "Workspace ID").option("--search <query>", "Search by name or description").option("--industry <industry>", "Filter by industry").option("--limit <n>", "Max results to return", parseInt).option("--cursor <cursor>", "Pagination cursor").action(async (options, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
@@ -3174,7 +3438,105 @@ function createOrganizationsCommand() {
 
 // src/commands/pages.ts
 import { readFileSync } from "fs";
-import { Command as Command13 } from "commander";
+import { Command as Command15 } from "commander";
+
+// src/commands/pageComments.ts
+import { Command as Command14 } from "commander";
+function createPageCommentsCommand() {
+  const comment = new Command14("comment").description(
+    "Read and post comments on a page. Mention teammates with --mention."
+  );
+  comment.command("list").description("List comments on a page").requiredOption("--page <id>", "Page ID").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      const client = getClient();
+      const comments = await client.pageComments.list(options.page);
+      if (useJson) outputCommentsJson(comments);
+      else outputCommentsPretty(comments);
+    } catch (error) {
+      handleError(error, useJson);
+    }
+  });
+  comment.command("add").description("Add a comment to a page").requiredOption("--page <id>", "Page ID").requiredOption("-m, --message <text>", "Comment body (markdown supported)").option("--mention <name>", MENTION_OPTION_DESCRIPTION, collectMention, []).option(
+    "--workspace <slug|id>",
+    "Workspace used to resolve --mention (defaults to your default workspace)"
+  ).action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const body = options.mention.length > 0 ? await applyMentions(
+          client,
+          await resolveWorkspaceId(client, options.workspace),
+          options.message,
+          options.mention
+        ) : options.message;
+        const created = await client.pageComments.create({
+          pageId: options.page,
+          body
+        });
+        if (useJson) {
+          outputCommentJson(created);
+        } else {
+          console.log("\n\u2713 Comment added");
+          outputCommentPretty(created);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  comment.command("update").description("Update one of your own comments").requiredOption("--comment-id <id>", "Comment ID").requiredOption("-m, --message <text>", "New comment body").option("--mention <name>", MENTION_OPTION_DESCRIPTION, collectMention, []).option(
+    "--workspace <slug|id>",
+    "Workspace used to resolve --mention (defaults to your default workspace)"
+  ).action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const body = options.mention.length > 0 ? await applyMentions(
+          client,
+          await resolveWorkspaceId(client, options.workspace),
+          options.message,
+          options.mention
+        ) : options.message;
+        const updated = await client.pageComments.update({
+          commentId: options.commentId,
+          body
+        });
+        if (useJson) {
+          outputCommentJson(updated);
+        } else {
+          console.log("\n\u2713 Comment updated");
+          outputCommentPretty(updated);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  comment.command("rm").description("Delete one of your own comments").requiredOption("--comment-id <id>", "Comment ID").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      const client = getClient();
+      await client.pageComments.delete(options.commentId);
+      if (useJson) {
+        console.log(JSON.stringify({ deleted: true, id: options.commentId }, null, 2));
+      } else {
+        console.log("\u2713 Comment deleted");
+      }
+    } catch (error) {
+      handleError(error, useJson);
+    }
+  });
+  return comment;
+}
+
+// src/commands/pages.ts
 function readBody(body, bodyFile) {
   if (body !== void 0) return body;
   if (bodyFile === void 0) return void 0;
@@ -3182,7 +3544,7 @@ function readBody(body, bodyFile) {
   return readFileSync(bodyFile, "utf-8");
 }
 function createPagesCommand() {
-  const pages = new Command13("pages").description(
+  const pages = new Command15("pages").description(
     'Manage Knowledge pages (PRDs, research, technical specs). Link one to a feature with "features link-page".'
   );
   pages.command("list").description("List pages in a workspace").option("--workspace <slug|id>", "Workspace (defaults to the configured default)").option("--search <text>", "Filter by title/content").action(
@@ -3260,13 +3622,14 @@ function createPagesCommand() {
       }
     }
   );
+  pages.addCommand(createPageCommentsCommand());
   return pages;
 }
 
 // src/commands/products.ts
-import { Command as Command14 } from "commander";
+import { Command as Command16 } from "commander";
 function createProductsCommand() {
-  const products = new Command14("products").description(
+  const products = new Command16("products").description(
     "Manage products. A workspace contains products; a product holds features and tickets."
   );
   products.command("list").description("List products in a workspace").option("--workspace <slug|id>", "Workspace slug or CUID (defaults to configured workspace)").action(async (options, cmd) => {
@@ -3329,9 +3692,9 @@ function createProductsCommand() {
 }
 
 // src/commands/projects.ts
-import { Command as Command15 } from "commander";
+import { Command as Command17 } from "commander";
 function createProjectsCommand() {
-  const projects = new Command15("projects").description("Manage projects");
+  const projects = new Command17("projects").description("Manage projects");
   projects.command("list").description("List all projects").option("--workspace <id>", "Filter by workspace ID").option("--include-actions", "Include actions in output").action(async (options, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
@@ -3354,7 +3717,7 @@ function createProjectsCommand() {
 }
 
 // src/commands/search.ts
-import { Command as Command16 } from "commander";
+import { Command as Command18 } from "commander";
 import chalk6 from "chalk";
 var TYPE_LABELS = {
   workspace: "Workspaces",
@@ -3373,7 +3736,7 @@ var TYPE_LABELS = {
   product: "Products"
 };
 function createSearchCommand() {
-  const search = new Command16("search").description(
+  const search = new Command18("search").description(
     "Global search across projects, actions, goals, workspaces and more \u2014 same coverage as the app's Cmd+K palette"
   ).argument("<query>", "Text to search for").option("-w, --workspace <slug>", "Restrict results to one workspace (slug or ID)").option("-l, --limit <n>", "Max results per entity type (1-25, default 10)").action(async (query, options, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
@@ -3432,7 +3795,7 @@ ${TYPE_LABELS[type] ?? type}`));
 }
 
 // src/commands/tickets.ts
-import { Command as Command17 } from "commander";
+import { Command as Command19 } from "commander";
 function collectRepeatable(value, previous) {
   return [...previous, value];
 }
@@ -3475,7 +3838,7 @@ function validateTicketType(value) {
   return value;
 }
 function createTicketsCommand() {
-  const tickets = new Command17("tickets").description(
+  const tickets = new Command19("tickets").description(
     "Manage product backlog tickets. Tickets live under a product, link to features/epics, depend on each other, and can be implemented via actions."
   );
   tickets.command("list").description(
@@ -3789,25 +4152,78 @@ function createTicketsCommand() {
       handleError(error, useJson);
     }
   });
-  const comment = new Command17("comment").description("Manage comments on a ticket");
-  comment.command("add").description("Add a comment to a ticket").requiredOption("--id <id>", "Ticket CUID").requiredOption("-m, --message <text>", "Comment content (markdown supported)").action(async (options, cmd) => {
+  const comment = new Command19("comment").description("Manage comments on a ticket");
+  comment.command("list").description("List comments on a ticket").requiredOption("--id <id>", "Ticket CUID").action(async (options, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
     try {
       const client = getClient();
-      const created = await client.tickets.addComment({
-        ticketId: options.id,
-        content: options.message
-      });
-      if (useJson) outputCommentJson(created);
-      else {
-        console.log("\n\u2713 Comment added");
-        outputCommentPretty(created);
-      }
+      const ticket = await client.tickets.get(options.id);
+      const comments = ticket.comments ?? [];
+      if (useJson) outputCommentsJson(comments);
+      else outputCommentsPretty(comments);
     } catch (error) {
       handleError(error, useJson);
     }
   });
+  comment.command("add").description("Add a comment to a ticket").requiredOption("--id <id>", "Ticket CUID").requiredOption("-m, --message <text>", "Comment content (markdown supported)").option("--mention <name>", MENTION_OPTION_DESCRIPTION, collectMention, []).option(
+    "--workspace <slug|id>",
+    "Workspace used to resolve --mention (defaults to your default workspace)"
+  ).action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const content = options.mention.length > 0 ? await applyMentions(
+          client,
+          await resolveWorkspaceId(client, options.workspace),
+          options.message,
+          options.mention
+        ) : options.message;
+        const created = await client.tickets.addComment({
+          ticketId: options.id,
+          content
+        });
+        if (useJson) outputCommentJson(created);
+        else {
+          console.log("\n\u2713 Comment added");
+          outputCommentPretty(created);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  comment.command("update").description("Update one of your own ticket comments").requiredOption("--comment-id <id>", "Comment ID").requiredOption("-m, --message <text>", "New comment content").option("--mention <name>", MENTION_OPTION_DESCRIPTION, collectMention, []).option(
+    "--workspace <slug|id>",
+    "Workspace used to resolve --mention (defaults to your default workspace)"
+  ).action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const content = options.mention.length > 0 ? await applyMentions(
+          client,
+          await resolveWorkspaceId(client, options.workspace),
+          options.message,
+          options.mention
+        ) : options.message;
+        const updated = await client.tickets.updateComment({
+          id: options.commentId,
+          content
+        });
+        if (useJson) outputCommentJson(updated);
+        else {
+          console.log("\n\u2713 Comment updated");
+          outputCommentPretty(updated);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
   comment.command("delete").description("Delete one of your own ticket comments").requiredOption("--comment-id <id>", "Comment ID").action(async (options, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
@@ -3828,10 +4244,10 @@ function createTicketsCommand() {
 }
 
 // src/commands/workspaces.ts
-import { Command as Command18 } from "commander";
+import { Command as Command20 } from "commander";
 import chalk7 from "chalk";
 function createWorkspacesCommand() {
-  const workspaces = new Command18("workspaces").description("Manage workspaces");
+  const workspaces = new Command20("workspaces").description("Manage workspaces");
   workspaces.command("list").description("List all workspaces").action(async (_options, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
@@ -3873,11 +4289,172 @@ function createWorkspacesCommand() {
       handleError(error);
     }
   });
+  workspaces.command("members").description(
+    "List workspace members. Each row carries the exact @[Name](id) markup to paste into a comment to mention that person."
+  ).option("--workspace <slug|id>", "Workspace (defaults to your default workspace)").option("--search <text>", "Filter by name or email").action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const workspaceId = await resolveWorkspaceId(client, options.workspace);
+        let members = await client.workspaces.listMembers(workspaceId);
+        if (options.search) {
+          const needle = options.search.toLowerCase();
+          members = members.filter(
+            (m) => m.name?.toLowerCase().includes(needle) || m.email?.toLowerCase().includes(needle)
+          );
+        }
+        if (useJson) {
+          console.log(
+            JSON.stringify({ members, total: members.length }, null, 2)
+          );
+          return;
+        }
+        if (members.length === 0) {
+          console.log(chalk7.gray("No members found."));
+          return;
+        }
+        console.log(chalk7.bold(`
+Members (${members.length})
+`));
+        for (const m of members) {
+          const label = m.name ?? m.email ?? m.id;
+          const via = m.source === "team" ? chalk7.gray(
+            ` via team${m.teams.length ? `: ${m.teams.map((t) => t.name).join(", ")}` : ""}` + (m.teamRole ? ` [team ${m.teamRole}]` : "")
+          ) : "";
+          console.log(`${chalk7.bold(label)} ${chalk7.gray(`(${m.role})`)}${via}`);
+          if (m.email) console.log(chalk7.gray(`  ${m.email}`));
+          console.log(chalk7.gray(`  mention: ${m.mentionSyntax}`));
+          console.log();
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
   return workspaces;
 }
 
+// src/commands/goals.ts
+import { Command as Command21 } from "commander";
+function parseGoalId(value) {
+  const id = Number(value);
+  if (!Number.isInteger(id)) {
+    throw new Error(
+      `Goal id must be a whole number, got "${value}". Find one with \`exponential search "<goal title>"\`.`
+    );
+  }
+  return id;
+}
+function createGoalsCommand() {
+  const goals = new Command21("goals").description(
+    'Work with goals. Find goal ids with `exponential search "<title>"`.'
+  );
+  const comment = new Command21("comment").description(
+    "Read and post comments on a goal. Mention teammates with --mention."
+  );
+  comment.command("list").description("List comments on a goal").requiredOption("--goal <id>", "Goal ID (a number)").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      const client = getClient();
+      const comments = await client.goalComments.list(parseGoalId(options.goal));
+      if (useJson) outputCommentsJson(comments);
+      else outputCommentsPretty(comments);
+    } catch (error) {
+      handleError(error, useJson);
+    }
+  });
+  comment.command("add").description("Add a comment to a goal").requiredOption("--goal <id>", "Goal ID (a number)").requiredOption("-m, --message <text>", "Comment content (markdown supported)").option("--mention <name>", MENTION_OPTION_DESCRIPTION, collectMention, []).option(
+    "--workspace <slug|id>",
+    "Workspace used to resolve --mention (defaults to your default workspace)"
+  ).option("--parent-update <id>", "Thread under a specific goal update").action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const goalId = parseGoalId(options.goal);
+        const content = options.mention.length > 0 ? await applyMentions(
+          client,
+          await resolveWorkspaceId(client, options.workspace),
+          options.message,
+          options.mention
+        ) : options.message;
+        const created = await client.goalComments.add({
+          goalId,
+          content,
+          parentUpdateId: options.parentUpdate
+        });
+        if (useJson) {
+          outputCommentJson(created);
+        } else {
+          console.log("\n\u2713 Comment added");
+          outputCommentPretty(created);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  comment.command("update").description("Update one of your own comments").requiredOption("--comment-id <id>", "Comment ID").requiredOption("-m, --message <text>", "New comment content").option("--mention <name>", MENTION_OPTION_DESCRIPTION, collectMention, []).option(
+    "--workspace <slug|id>",
+    "Workspace used to resolve --mention (defaults to your default workspace)"
+  ).action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const content = options.mention.length > 0 ? await applyMentions(
+          client,
+          await resolveWorkspaceId(client, options.workspace),
+          options.message,
+          options.mention
+        ) : options.message;
+        const updated = await client.goalComments.update({
+          commentId: options.commentId,
+          content
+        });
+        if (useJson) {
+          outputCommentJson(updated);
+        } else {
+          console.log("\n\u2713 Comment updated");
+          outputCommentPretty(updated);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  comment.command("rm").description("Delete one of your own comments").requiredOption("--comment-id <id>", "Comment ID").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      const client = getClient();
+      await client.goalComments.delete(options.commentId);
+      if (useJson) {
+        console.log(JSON.stringify({ deleted: true, id: options.commentId }, null, 2));
+      } else {
+        console.log("\u2713 Comment deleted");
+      }
+    } catch (error) {
+      handleError(error, useJson);
+    }
+  });
+  goals.addCommand(comment);
+  return goals;
+}
+
 // src/index.ts
-var program = new Command19();
+import { readFileSync as readFileSync2 } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var PKG_VERSION = JSON.parse(
+  readFileSync2(join(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf-8")
+).version;
+var program = new Command22();
 program.name("exponential").description(
   [
     "CLI to interact with Exponential productivity app.",
@@ -3886,7 +4463,7 @@ program.name("exponential").description(
     "  workspace -> product -> feature -> ticket -> action",
     "  epics are workspace-scoped and can group tickets and actions across products."
   ].join("\n")
-).version("1.0.0").option("--json", "Output as JSON (default when piped)").option("--pretty", "Force pretty-printed output");
+).version(PKG_VERSION).option("--json", "Output as JSON (default when piped)").option("--pretty", "Force pretty-printed output");
 program.addCommand(createAuthCommand());
 program.addCommand(createActionsCommand());
 program.addCommand(createContactsCommand());
@@ -3901,5 +4478,6 @@ program.addCommand(createProjectsCommand());
 program.addCommand(createSearchCommand());
 program.addCommand(createTicketsCommand());
 program.addCommand(createWorkspacesCommand());
+program.addCommand(createGoalsCommand());
 program.parse();
 //# sourceMappingURL=index.js.map