exponential-cli 1.1.0 → 1.4.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command11 } from "commander";
+import { Command as Command13 } from "commander";
 
 // src/commands/auth.ts
 import { Command } from "commander";
@@ -170,6 +170,29 @@ function createAuthCommand() {
       handleError(error);
     }
   });
+  auth.command("show").description(
+    "Print parts of the current credentials. Use --token to print the raw JWT (for piping into other tools, e.g. `gh secret set EXPONENTIAL_TOKEN < <(exponential auth show --token)`)."
+  ).option("--token", "Print the raw JWT to stdout with no trailing newline").action((options) => {
+    const config = getConfig();
+    if (options.token) {
+      if (!config.token) {
+        console.error("Not authenticated. Run `exponential auth login` first.");
+        process.exit(1);
+      }
+      process.stdout.write(config.token);
+      return;
+    }
+    console.log(chalk2.bold("\nCredentials"));
+    console.log(chalk2.gray("\u2500".repeat(40)));
+    console.log(`API URL: ${config.apiUrl || chalk2.gray("(not set)")}`);
+    console.log(
+      `Token: ${config.token ? chalk2.gray(`${config.token.substring(0, 20)}...`) : chalk2.gray("(not set)")}`
+    );
+    console.log(
+      chalk2.gray("Use `exponential auth show --token` to print the raw JWT.")
+    );
+    console.log();
+  });
   auth.command("status").description("Show detailed authentication status").action(() => {
     const config = getConfig();
     console.log(chalk2.bold("\nAuthentication Status"));
@@ -768,6 +791,87 @@ function getFeatureStatusColor(status) {
       return "gray";
   }
 }
+function transformUserStory(story) {
+  return {
+    id: story.id,
+    featureId: story.featureId,
+    scopeId: story.scopeId,
+    asA: story.asA,
+    iWant: story.iWant,
+    soThat: story.soThat,
+    acceptanceCriteria: story.acceptanceCriteria,
+    displayOrder: story.displayOrder,
+    createdAt: new Date(story.createdAt).toISOString(),
+    updatedAt: new Date(story.updatedAt).toISOString()
+  };
+}
+function outputUserStoryJson(story) {
+  console.log(JSON.stringify(transformUserStory(story), null, 2));
+}
+function outputUserStoryPretty(story) {
+  console.log(chalk3.gray("\u2500".repeat(50)));
+  const order = chalk3.gray(`#${story.displayOrder}`);
+  console.log(`
+${order} ${chalk3.bold(story.iWant ?? '(no "I want")')}`);
+  console.log(chalk3.gray(`  ID: ${story.id}`));
+  if (story.asA) console.log(`  ${chalk3.cyan("As a:")} ${story.asA}`);
+  if (story.iWant) console.log(`  ${chalk3.cyan("I want:")} ${story.iWant}`);
+  if (story.soThat) console.log(`  ${chalk3.cyan("So that:")} ${story.soThat}`);
+  if (story.acceptanceCriteria) {
+    console.log(`  ${chalk3.yellow("Acceptance:")} ${story.acceptanceCriteria}`);
+  }
+  if (story.scopeId) console.log(`  ${chalk3.magenta("Scope:")} ${story.scopeId}`);
+  console.log();
+}
+function outputUserStoriesJson(stories) {
+  console.log(JSON.stringify({
+    userStories: stories.map(transformUserStory),
+    total: stories.length
+  }, null, 2));
+}
+function outputUserStoriesPretty(stories) {
+  if (stories.length === 0) {
+    console.log(chalk3.gray("No user stories found."));
+    return;
+  }
+  console.log(chalk3.bold(`
+User stories (${stories.length} total)`));
+  console.log(chalk3.gray("\u2500".repeat(50)));
+  for (const story of stories) {
+    const order = chalk3.gray(`#${story.displayOrder}`);
+    const parts = [
+      story.asA ? `As a ${story.asA},` : null,
+      story.iWant ? `I want ${story.iWant},` : null,
+      story.soThat ? `so that ${story.soThat}.` : null
+    ].filter(Boolean).join(" ");
+    console.log(`  ${order} ${parts || chalk3.gray("(empty)")}`);
+    console.log(chalk3.gray(`    ID: ${story.id}`));
+  }
+  console.log();
+}
+function outputBatchResultsJson(results) {
+  const succeeded = results.filter((r) => r.ok).length;
+  console.log(JSON.stringify({
+    results,
+    total: results.length,
+    succeeded,
+    failed: results.length - succeeded
+  }, null, 2));
+}
+function outputBatchResultsPretty(results) {
+  const succeeded = results.filter((r) => r.ok).length;
+  console.log(chalk3.bold(`
+Added ${succeeded}/${results.length} user stories`));
+  console.log(chalk3.gray("\u2500".repeat(50)));
+  for (const r of results) {
+    if (r.ok) {
+      console.log(`  ${chalk3.green("\u2713")} [${r.index}] ${chalk3.gray(r.id ?? "")}`);
+    } else {
+      console.log(`  ${chalk3.red("\u2717")} [${r.index}] ${r.error ?? "failed"}`);
+    }
+  }
+  console.log();
+}
 function outputTicketJson(ticket) {
   console.log(JSON.stringify(transformTicket(ticket), null, 2));
 }
@@ -1767,7 +1871,116 @@ function createEpicsCommand() {
 }
 
 // src/commands/features.ts
+import { Command as Command7 } from "commander";
+
+// src/commands/stories.ts
 import { Command as Command6 } from "commander";
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+}
+function createStoriesCommand() {
+  const stories = new Command6("stories").description(
+    "Manage a feature's native, structured user stories (As a / I want / So that)."
+  );
+  stories.command("add").description(
+    [
+      "Add user stories to a feature.",
+      "",
+      "Flag mode: pass --as-a/--i-want/--so-that (plus optional --acceptance/--scope) to add one story.",
+      "Batch mode: pipe a JSON array of { asA?, iWant?, soThat?, acceptanceCriteria?, scopeId? } on stdin",
+      "            to add many at once (per-item success/failure is reported)."
+    ].join("\n")
+  ).requiredOption("--feature <id>", "Feature CUID").option("--as-a <text>", '"As a ..." actor').option("--i-want <text>", '"I want ..." capability').option("--so-that <text>", '"So that ..." outcome').option("--acceptance <text>", "Acceptance criteria").option("--scope <id>", "Feature scope CUID to group the story under").action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      const hasFlags = options.asA != null || options.iWant != null || options.soThat != null || options.acceptance != null;
+      const isBatch = !hasFlags && !process.stdin.isTTY;
+      try {
+        const client = getClient();
+        if (isBatch) {
+          const raw = await readStdin();
+          let items;
+          try {
+            const parsed = JSON.parse(raw);
+            if (!Array.isArray(parsed)) {
+              throw new Error("Expected a JSON array of story objects on stdin");
+            }
+            items = parsed;
+          } catch (parseError) {
+            throw new Error(
+              `Could not parse stdin as a JSON array: ${parseError instanceof Error ? parseError.message : String(parseError)}`
+            );
+          }
+          const results = [];
+          for (let index = 0; index < items.length; index++) {
+            const item = items[index];
+            try {
+              const story2 = await client.userStories.create({
+                featureId: options.feature,
+                asA: item.asA,
+                iWant: item.iWant,
+                soThat: item.soThat,
+                acceptanceCriteria: item.acceptanceCriteria,
+                scopeId: item.scopeId
+              });
+              results.push({ index, ok: true, id: story2.id });
+            } catch (itemError) {
+              results.push({
+                index,
+                ok: false,
+                error: itemError instanceof Error ? itemError.message : String(itemError)
+              });
+            }
+          }
+          if (useJson) outputBatchResultsJson(results);
+          else outputBatchResultsPretty(results);
+          if (results.length > 0 && results.every((r) => !r.ok)) {
+            process.exit(1);
+          }
+          return;
+        }
+        const input = {
+          featureId: options.feature,
+          asA: options.asA,
+          iWant: options.iWant,
+          soThat: options.soThat,
+          acceptanceCriteria: options.acceptance,
+          scopeId: options.scope
+        };
+        const story = await client.userStories.create(input);
+        if (useJson) outputUserStoryJson(story);
+        else {
+          console.log("\n\u2713 User story added");
+          outputUserStoryPretty(story);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  stories.command("list").description("List a feature's user stories in display order").requiredOption("--feature <id>", "Feature CUID").action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const list = await client.userStories.list({ featureId: options.feature });
+        if (useJson) outputUserStoriesJson(list);
+        else outputUserStoriesPretty(list);
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  return stories;
+}
+
+// src/commands/features.ts
 var FEATURE_STATUSES = [
   "IDEA",
   "DEFINED",
@@ -1785,7 +1998,7 @@ function validateFeatureStatus(value) {
   return value;
 }
 function createFeaturesCommand() {
-  const features = new Command6("features").description(
+  const features = new Command7("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(
@@ -1879,13 +2092,171 @@ function createFeaturesCommand() {
       }
     }
   );
+  features.addCommand(createStoriesCommand());
   return features;
 }
 
+// src/commands/labels.ts
+import { Command as Command8 } from "commander";
+import chalk4 from "chalk";
+var TRIAGE_LABELS = [
+  { slug: "needs-triage", name: "needs-triage", color: "avatar-orange" },
+  { slug: "needs-info", name: "needs-info", color: "avatar-yellow" },
+  { slug: "ready-for-agent", name: "ready-for-agent", color: "avatar-green" },
+  { slug: "ready-for-human", name: "ready-for-human", color: "avatar-lightBlue" },
+  { slug: "wontfix", name: "wontfix", color: "avatar-lightGray" }
+];
+var CUID_PATTERN = /^c[a-z0-9]{20,}$/i;
+function looksLikeCuid(value) {
+  return CUID_PATTERN.test(value);
+}
+function outputTagsPretty(tags) {
+  if (tags.length === 0) {
+    console.log(chalk4.dim("No labels found."));
+    return;
+  }
+  console.log();
+  for (const tag of tags) {
+    const scope = tag.workspaceId === null ? chalk4.cyan("global") : chalk4.magenta("workspace");
+    const category = tag.category === null ? chalk4.dim("(label)") : chalk4.dim(`(${tag.category})`);
+    console.log(
+      `  ${chalk4.bold(tag.slug)}  ${tag.name}  ${chalk4.gray(tag.color)}  ${scope}  ${category}`
+    );
+  }
+  console.log();
+}
+function outputTagPretty(tag, prefix) {
+  if (prefix) console.log(prefix);
+  console.log(`  ${chalk4.bold(tag.slug)}  ${tag.name}  ${chalk4.gray(tag.color)}`);
+}
+async function resolveLabelIds(client, workspaceId, values) {
+  if (values.length === 0) return [];
+  const bySlug = values.filter((v) => !looksLikeCuid(v));
+  const byId = values.filter((v) => looksLikeCuid(v));
+  if (bySlug.length === 0) return byId;
+  const list = await client.labels.list({ workspaceId });
+  const slugMap = new Map(list.allTags.map((t) => [t.slug, t.id]));
+  const resolvedFromSlugs = [];
+  const missing = [];
+  for (const slug of bySlug) {
+    const id = slugMap.get(slug);
+    if (id === void 0) missing.push(slug);
+    else resolvedFromSlugs.push(id);
+  }
+  if (missing.length > 0) {
+    throw new Error(
+      `Unknown label slug(s): ${missing.join(", ")}. Run \`exponential labels list --workspace <slug>\` to see available labels.`
+    );
+  }
+  return [...byId, ...resolvedFromSlugs];
+}
+function createLabelsCommand() {
+  const labels = new Command8("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(
+    "--category <category>",
+    'Filter by category. Use "label" for general labels, "null" for category-less labels, or omit to list all.'
+  ).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);
+        const category = options.category === void 0 ? void 0 : options.category === "null" ? null : options.category;
+        const result = await client.labels.list({ workspaceId, category });
+        if (useJson) {
+          console.log(JSON.stringify(result.allTags, null, 2));
+        } else {
+          outputTagsPretty(result.allTags);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  labels.command("create").description("Create a workspace-scoped label").requiredOption("-n, --name <name>", "Label name").requiredOption("--color <token>", "Color token (e.g. avatar-green, brand-primary)").option("-d, --description <text>", "Description").option("--category <category>", 'Category. Omit (or pass "null") to create a general label.').option("--workspace <slug|id>", "Workspace slug or CUID").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);
+        if (workspaceId === void 0) {
+          throw new Error(
+            "Workspace is required. Pass --workspace <slug|id> or set a default with `exponential workspaces set-default`."
+          );
+        }
+        const category = options.category === void 0 ? void 0 : options.category === "null" ? null : options.category;
+        const tag = await client.labels.create({
+          workspaceId,
+          name: options.name,
+          color: options.color,
+          description: options.description,
+          category
+        });
+        if (useJson) {
+          console.log(JSON.stringify(tag, null, 2));
+        } else {
+          outputTagPretty(tag, chalk4.green("\n\u2713 Label created"));
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  labels.command("seed-triage").description("Idempotently seed the five canonical triage labels into a workspace.").option("--workspace <slug|id>", "Workspace slug or CUID").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);
+        if (workspaceId === void 0) {
+          throw new Error(
+            "Workspace is required. Pass --workspace <slug|id> or set a default with `exponential workspaces set-default`."
+          );
+        }
+        const existing = await client.labels.list({ workspaceId });
+        const existingSlugs = new Set(existing.allTags.map((t) => t.slug));
+        const results = [];
+        for (const def of TRIAGE_LABELS) {
+          if (existingSlugs.has(def.slug)) {
+            results.push({ slug: def.slug, status: "existed" });
+            continue;
+          }
+          const tag = await client.labels.create({
+            workspaceId,
+            name: def.name,
+            color: def.color
+          });
+          results.push({ slug: def.slug, status: "created", tag });
+        }
+        if (useJson) {
+          console.log(JSON.stringify(results, null, 2));
+        } else {
+          console.log();
+          console.log(chalk4.bold("Triage labels:"));
+          for (const r of results) {
+            const tag = chalk4.bold(r.slug);
+            const status = r.status === "created" ? chalk4.green("created") : chalk4.dim("existed");
+            console.log(`  ${tag}  ${status}`);
+          }
+          console.log();
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  return labels;
+}
+
 // src/commands/products.ts
-import { Command as Command7 } from "commander";
+import { Command as Command9 } from "commander";
 function createProductsCommand() {
-  const products = new Command7("products").description(
+  const products = new Command9("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) => {
@@ -1948,9 +2319,9 @@ function createProductsCommand() {
 }
 
 // src/commands/projects.ts
-import { Command as Command8 } from "commander";
+import { Command as Command10 } from "commander";
 function createProjectsCommand() {
-  const projects = new Command8("projects").description("Manage projects");
+  const projects = new Command10("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);
@@ -1973,7 +2344,10 @@ function createProjectsCommand() {
 }
 
 // src/commands/tickets.ts
-import { Command as Command9 } from "commander";
+import { Command as Command11 } from "commander";
+function collectRepeatable(value, previous) {
+  return [...previous, value];
+}
 var TICKET_STATUSES = [
   "BACKLOG",
   "NEEDS_REFINEMENT",
@@ -2013,33 +2387,80 @@ function validateTicketType(value) {
   return value;
 }
 function createTicketsCommand() {
-  const tickets = new Command9("tickets").description(
+  const tickets = new Command11("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("List tickets 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: ${TICKET_STATUSES.join(", ")}`).option("--type <type>", `Filter by type: ${TICKET_TYPES.join(", ")}`).option("--feature <id>", "Filter by feature CUID").option("--epic <id>", "Filter by epic CUID").option("--assignee <id>", "Filter by assignee user ID").action(
+  tickets.command("list").description(
+    "List tickets in a product, or workspace-wide when --pr or --branch is supplied"
+  ).option(
+    "--product <slug|id>",
+    "Product slug or CUID (required unless --pr or --branch is supplied)"
+  ).option("--workspace <slug|id>", "Workspace (required when --product is a slug)").option("--status <status>", `Filter by status: ${TICKET_STATUSES.join(", ")}`).option("--type <type>", `Filter by type: ${TICKET_TYPES.join(", ")}`).option("--feature <id>", "Filter by feature CUID").option("--epic <id>", "Filter by epic CUID").option("--assignee <id>", "Filter by assignee user ID").option(
+    "--pr <url>",
+    "Workspace-wide lookup by Ticket.prUrl (exact match). Makes --product optional."
+  ).option(
+    "--branch <name>",
+    "Workspace-wide lookup by Ticket.branchName (exact match). Makes --product optional."
+  ).option(
+    "--label <slug-or-id>",
+    "Filter to tickets carrying this label (repeatable; AND semantics)",
+    collectRepeatable,
+    []
+  ).action(
     async (options, cmd) => {
       const globalOpts = cmd.optsWithGlobals();
       const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
       try {
         const status = validateTicketStatus(options.status);
         const type = validateTicketType(options.type);
+        const hasWorkspaceFilter = Boolean(options.pr || options.branch);
+        if (!hasWorkspaceFilter && !options.product) {
+          throw new Error(
+            "--product is required unless --pr or --branch is supplied"
+          );
+        }
         const client = getClient();
-        const workspaceId = await resolveWorkspaceId(client, options.workspace);
-        const productId = await resolveProductId(
-          client,
-          workspaceId,
-          options.product
-        );
+        let workspaceId;
+        let productId;
+        if (options.product) {
+          workspaceId = await resolveWorkspaceId(client, options.workspace);
+          productId = await resolveProductId(
+            client,
+            workspaceId,
+            options.product
+          );
+        }
         const list = await client.tickets.list({
           productId,
           status,
           type,
           featureId: options.feature,
           epicId: options.epic,
-          assigneeId: options.assignee
+          assigneeId: options.assignee,
+          prUrl: options.pr,
+          branchName: options.branch
         });
-        if (useJson) outputTicketsJson(list);
-        else outputTicketsPretty(list);
+        let filtered = list;
+        if (options.label.length > 0) {
+          const labelIds = new Set(
+            await resolveLabelIds(client, workspaceId, options.label)
+          );
+          const ticketLabelSets = await Promise.all(
+            list.map(
+              (t) => client.labels.listForEntity({ entityType: "ticket", entityId: t.id }).then((tags) => new Set(tags.map((tag) => tag.id)))
+            )
+          );
+          filtered = list.filter((_t, idx) => {
+            const tagSet = ticketLabelSets[idx];
+            if (tagSet === void 0) return false;
+            for (const id of labelIds) {
+              if (!tagSet.has(id)) return false;
+            }
+            return true;
+          });
+        }
+        if (useJson) outputTicketsJson(filtered);
+        else outputTicketsPretty(filtered);
       } catch (error) {
         handleError(error, useJson);
       }
@@ -2069,7 +2490,12 @@ function createTicketsCommand() {
       handleError(error, useJson);
     }
   });
-  tickets.command("create").description("Create a new ticket in a product").requiredOption("--product <slug|id>", "Product slug or CUID").requiredOption("-t, --title <title>", "Ticket title").option("-b, --body <text>", "Body (markdown supported)").option("--type <type>", `Ticket type: ${TICKET_TYPES.join(", ")}`).option("--status <status>", `Initial status: ${TICKET_STATUSES.join(", ")}`).option("--priority <n>", "Priority 0-4 (lower = higher)", parseInt).option("--points <n>", "Story points", parseFloat).option("--feature <id>", "Feature CUID to attach to").option("--epic <id>", "Epic CUID to attach to").option("--assignee <id>", "Assignee user ID").option("--branch <name>", "Branch name").option("--pr <url>", "Pull request URL").option("--workspace <slug|id>", "Workspace (required when --product is a slug)").action(
+  tickets.command("create").description("Create a new ticket in a product").requiredOption("--product <slug|id>", "Product slug or CUID").requiredOption("-t, --title <title>", "Ticket title").option("-b, --body <text>", "Body (markdown supported)").option("--type <type>", `Ticket type: ${TICKET_TYPES.join(", ")}`).option("--status <status>", `Initial status: ${TICKET_STATUSES.join(", ")}`).option("--priority <n>", "Priority 0-4 (lower = higher)", parseInt).option("--points <n>", "Story points", parseFloat).option("--feature <id>", "Feature CUID to attach to").option("--epic <id>", "Epic CUID to attach to").option("--assignee <id>", "Assignee user ID").option("--branch <name>", "Branch name").option("--pr <url>", "Pull request URL").option("--workspace <slug|id>", "Workspace (required when --product is a slug)").option(
+    "--label <slug-or-id>",
+    "Label to attach (repeatable)",
+    collectRepeatable,
+    []
+  ).action(
     async (options, cmd) => {
       const globalOpts = cmd.optsWithGlobals();
       const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
@@ -2097,6 +2523,14 @@ function createTicketsCommand() {
           branchName: options.branch,
           prUrl: options.pr
         });
+        if (options.label.length > 0) {
+          const tagIds = await resolveLabelIds(client, workspaceId, options.label);
+          await client.labels.setEntityTags({
+            entityType: "ticket",
+            entityId: ticket.id,
+            tagIds
+          });
+        }
         if (useJson) outputTicketJson(ticket);
         else {
           console.log("\n\u2713 Ticket created");
@@ -2107,7 +2541,17 @@ function createTicketsCommand() {
       }
     }
   );
-  tickets.command("update").description("Update an existing ticket").requiredOption("--id <id>", "Ticket CUID").option("-t, --title <title>", "New title").option("-b, --body <text>", "New body").option("--type <type>", `Type: ${TICKET_TYPES.join(", ")}`).option("--status <status>", `Status: ${TICKET_STATUSES.join(", ")}`).option("--priority <n>", 'Priority 0-4 (or "null" to clear)').option("--points <n>", 'Story points (or "null" to clear)').option("--feature <id>", 'Feature CUID (or "null" to detach)').option("--epic <id>", 'Epic CUID (or "null" to detach)').option("--assignee <id>", 'Assignee user ID (or "null" to unassign)').option("--branch <name>", 'Branch name (or "null")').option("--pr <url>", 'PR URL (or "null")').action(
+  tickets.command("update").description("Update an existing ticket").requiredOption("--id <id>", "Ticket CUID").option("-t, --title <title>", "New title").option("-b, --body <text>", "New body").option("--type <type>", `Type: ${TICKET_TYPES.join(", ")}`).option("--status <status>", `Status: ${TICKET_STATUSES.join(", ")}`).option("--priority <n>", 'Priority 0-4 (or "null" to clear)').option("--points <n>", 'Story points (or "null" to clear)').option("--feature <id>", 'Feature CUID (or "null" to detach)').option("--epic <id>", 'Epic CUID (or "null" to detach)').option("--assignee <id>", 'Assignee user ID (or "null" to unassign)').option("--branch <name>", 'Branch name (or "null")').option("--pr <url>", 'PR URL (or "null")').option(
+    "--add-label <slug-or-id>",
+    "Label to attach to this ticket (repeatable)",
+    collectRepeatable,
+    []
+  ).option(
+    "--remove-label <slug-or-id>",
+    "Label to detach from this ticket (repeatable)",
+    collectRepeatable,
+    []
+  ).action(
     async (options, cmd) => {
       const globalOpts = cmd.optsWithGlobals();
       const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
@@ -2148,6 +2592,22 @@ function createTicketsCommand() {
           branchName: parseNullableString(options.branch),
           prUrl: parseNullableString(options.pr)
         });
+        if (options.addLabel.length > 0 || options.removeLabel.length > 0) {
+          const current = await client.labels.listForEntity({
+            entityType: "ticket",
+            entityId: options.id
+          });
+          const currentIds = new Set(current.map((t) => t.id));
+          const addIds = await resolveLabelIds(client, void 0, options.addLabel);
+          const removeIds = await resolveLabelIds(client, void 0, options.removeLabel);
+          for (const id of addIds) currentIds.add(id);
+          for (const id of removeIds) currentIds.delete(id);
+          await client.labels.setEntityTags({
+            entityType: "ticket",
+            entityId: options.id,
+            tagIds: [...currentIds]
+          });
+        }
         if (useJson) outputTicketJson(ticket);
         else {
           console.log("\n\u2713 Ticket updated");
@@ -2240,7 +2700,7 @@ function createTicketsCommand() {
       handleError(error, useJson);
     }
   });
-  const comment = new Command9("comment").description("Manage comments on a ticket");
+  const comment = new Command11("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 globalOpts = cmd.optsWithGlobals();
     const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
@@ -2279,10 +2739,10 @@ function createTicketsCommand() {
 }
 
 // src/commands/workspaces.ts
-import { Command as Command10 } from "commander";
-import chalk4 from "chalk";
+import { Command as Command12 } from "commander";
+import chalk5 from "chalk";
 function createWorkspacesCommand() {
-  const workspaces = new Command10("workspaces").description("Manage workspaces");
+  const workspaces = new Command12("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);
@@ -2295,7 +2755,7 @@ function createWorkspacesCommand() {
         const config = getConfig();
         outputWorkspacesPretty(workspaces2);
         if (config.defaultWorkspaceSlug) {
-          console.log(chalk4.gray(`Default workspace: ${config.defaultWorkspaceSlug}`));
+          console.log(chalk5.gray(`Default workspace: ${config.defaultWorkspaceSlug}`));
         }
       }
     } catch (error) {
@@ -2308,10 +2768,10 @@ function createWorkspacesCommand() {
       const workspaces2 = await client.workspaces.list();
       const workspace = workspaces2.find((w) => w.slug === slug);
       if (!workspace) {
-        console.error(chalk4.red(`Workspace with slug "${slug}" not found.`));
-        console.log(chalk4.gray("Available workspaces:"));
+        console.error(chalk5.red(`Workspace with slug "${slug}" not found.`));
+        console.log(chalk5.gray("Available workspaces:"));
         workspaces2.forEach((w) => {
-          console.log(chalk4.gray(`  - ${w.slug} (${w.name})`));
+          console.log(chalk5.gray(`  - ${w.slug} (${w.name})`));
         });
         process.exit(1);
       }
@@ -2319,7 +2779,7 @@ function createWorkspacesCommand() {
         defaultWorkspaceId: workspace.id,
         defaultWorkspaceSlug: workspace.slug
       });
-      console.log(chalk4.green(`Default workspace set to: ${workspace.name} (${workspace.slug})`));
+      console.log(chalk5.green(`Default workspace set to: ${workspace.name} (${workspace.slug})`));
     } catch (error) {
       handleError(error);
     }
@@ -2328,7 +2788,7 @@ function createWorkspacesCommand() {
 }
 
 // src/index.ts
-var program = new Command11();
+var program = new Command13();
 program.name("exponential").description(
   [
     "CLI to interact with Exponential productivity app.",
@@ -2344,6 +2804,7 @@ program.addCommand(createContactsCommand());
 program.addCommand(createDealsCommand());
 program.addCommand(createEpicsCommand());
 program.addCommand(createFeaturesCommand());
+program.addCommand(createLabelsCommand());
 program.addCommand(createProductsCommand());
 program.addCommand(createProjectsCommand());
 program.addCommand(createTicketsCommand());