exponential-cli 1.1.0 → 1.2.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 Command12 } from "commander";
 
 // src/commands/auth.ts
 import { Command } from "commander";
@@ -1882,10 +1882,167 @@ function createFeaturesCommand() {
   return features;
 }
 
-// src/commands/products.ts
+// src/commands/labels.ts
 import { Command as Command7 } 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 Command7("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 Command8 } from "commander";
 function createProductsCommand() {
-  const products = new Command7("products").description(
+  const products = new Command8("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 +2105,9 @@ function createProductsCommand() {
 }
 
 // src/commands/projects.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 function createProjectsCommand() {
-  const projects = new Command8("projects").description("Manage projects");
+  const projects = new Command9("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 +2130,10 @@ function createProjectsCommand() {
 }
 
 // src/commands/tickets.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
+function collectRepeatable(value, previous) {
+  return [...previous, value];
+}
 var TICKET_STATUSES = [
   "BACKLOG",
   "NEEDS_REFINEMENT",
@@ -2013,10 +2173,15 @@ function validateTicketType(value) {
   return value;
 }
 function createTicketsCommand() {
-  const tickets = new Command9("tickets").description(
+  const tickets = new Command10("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").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").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);
@@ -2038,8 +2203,27 @@ function createTicketsCommand() {
           epicId: options.epic,
           assigneeId: options.assignee
         });
-        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 +2253,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 +2286,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 +2304,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 +2355,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 +2463,7 @@ function createTicketsCommand() {
       handleError(error, useJson);
     }
   });
-  const comment = new Command9("comment").description("Manage comments on a ticket");
+  const comment = new Command10("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 +2502,10 @@ function createTicketsCommand() {
 }
 
 // src/commands/workspaces.ts
-import { Command as Command10 } from "commander";
-import chalk4 from "chalk";
+import { Command as Command11 } from "commander";
+import chalk5 from "chalk";
 function createWorkspacesCommand() {
-  const workspaces = new Command10("workspaces").description("Manage workspaces");
+  const workspaces = new Command11("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 +2518,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 +2531,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 +2542,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 +2551,7 @@ function createWorkspacesCommand() {
 }
 
 // src/index.ts
-var program = new Command11();
+var program = new Command12();
 program.name("exponential").description(
   [
     "CLI to interact with Exponential productivity app.",
@@ -2344,6 +2567,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());