exponential-cli 1.18.1 → 1.19.0

package/README.md

@@ -140,6 +140,7 @@ and live under `goals kr`.
 exponential goals list --workspace clear --period Q3-2026
 exponential goals list --workspace clear --tree
 exponential goals list --all-workspaces       # "what am I neglecting" is cross-workspace
+exponential goals list --project <cuid>       # objectives (yours) linked to a project
 
 exponential goals get 46
 exponential goals create --workspace clear --title "Ship the CLI" --period Q3-2026
@@ -312,6 +313,27 @@ exponential projects update --id <cuid> --product none
 exponential projects delete --id <cuid> [--force]
 ```
 
+### Products, tickets, epics and user stories
+
+```bash
+# Products take a slug or a CUID
+exponential products list --workspace clear
+exponential products update <slug|cuid> --workspace clear --description "..." [--fun-ticket-ids|--no-fun-ticket-ids]
+# Deleting a product cascades its features, tickets and epics: refuses unless --force
+exponential products delete <slug|cuid> --workspace clear [--force]
+
+# Free-text ticket search within a product: title, shortId or ticket number
+exponential tickets search "login redirect" --product <slug|cuid> --workspace clear [--limit 50]
+
+# Epics: their tickets and actions are unlinked, not deleted
+exponential epics delete --id <cuid>
+
+# A feature's native user stories
+exponential features stories list --feature <cuid>
+exponential features stories update --id <story-cuid> --i-want "..." [--scope <scope-cuid>|null]
+exponential features stories rm --id <story-cuid>
+```
+
 ### Workspaces
 
 ```bash

package/dist/index.js

@@ -1187,6 +1187,41 @@ Tickets (${tickets.length} total)`));
   }
   console.log();
 }
+function transformTicketSearchHit(hit) {
+  return {
+    id: hit.id,
+    number: hit.number,
+    shortId: hit.shortId,
+    title: hit.title,
+    status: hit.status,
+    priority: hit.priority,
+    assignee: hit.assignee ?? null
+  };
+}
+function outputTicketSearchJson(hits, query) {
+  console.log(JSON.stringify({
+    query,
+    tickets: hits.map(transformTicketSearchHit),
+    total: hits.length
+  }, null, 2));
+}
+function outputTicketSearchPretty(hits, query) {
+  if (hits.length === 0) {
+    console.log(chalk3.gray(`No tickets match "${query}".`));
+    return;
+  }
+  console.log(chalk3.bold(`
+Tickets matching "${query}" (${hits.length})`));
+  console.log(chalk3.gray("\u2500".repeat(50)));
+  for (const t of hits) {
+    const id = t.shortId ?? (t.number != null ? `#${t.number}` : "?");
+    const statusBadge2 = chalk3[getTicketStatusColor(t.status)](`[${t.status}]`);
+    const assignee = t.assignee ? chalk3.gray(` \u2014 ${t.assignee.name ?? t.assignee.id}`) : "";
+    console.log(`  ${statusBadge2} ${chalk3.bold(id)} ${t.title}${assignee}`);
+    console.log(chalk3.gray(`    ID: ${t.id}`));
+  }
+  console.log();
+}
 function transformTicket(ticket) {
   const detail = ticket;
   return {
@@ -3959,6 +3994,23 @@ function createEpicsCommand() {
       }
     }
   );
+  epics.command("delete").description(
+    "Delete an epic. Its tickets and actions are unlinked from it (epicId is cleared), not deleted. Only workspace owners/admins and the epic owner can delete."
+  ).requiredOption("--id <id>", "Epic CUID").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      const client = getClient();
+      await client.epics.delete(options.id);
+      if (useJson) {
+        console.log(JSON.stringify({ deleted: true, id: options.id }, null, 2));
+      } else {
+        console.log("\n\u2713 Epic deleted");
+      }
+    } catch (error) {
+      handleError(error, useJson);
+    }
+  });
   return epics;
 }
 
@@ -4069,6 +4121,42 @@ function createStoriesCommand() {
       }
     }
   );
+  stories.command("update").description("Update a user story. Only the fields you pass are written.").requiredOption("--id <id>", "User story 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 (or "null" to ungroup)').action(
+    async (options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const client = getClient();
+        const story = await client.userStories.update({
+          id: options.id,
+          asA: options.asA,
+          iWant: options.iWant,
+          soThat: options.soThat,
+          acceptanceCriteria: options.acceptance,
+          scopeId: options.scope === "null" ? null : options.scope
+        });
+        if (useJson) outputUserStoryJson(story);
+        else {
+          console.log("\n\u2713 User story updated");
+          outputUserStoryPretty(story);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  stories.command("rm").description("Delete a user story").requiredOption("--id <id>", "User story CUID").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      const client = getClient();
+      const result = await client.userStories.delete(options.id);
+      if (useJson) console.log(JSON.stringify(result, null, 2));
+      else console.log("\n\u2713 User story deleted");
+    } catch (error) {
+      handleError(error, useJson);
+    }
+  });
   return stories;
 }
 
@@ -5635,6 +5723,84 @@ function createProductsCommand() {
       }
     }
   );
+  products.command("update <slugOrId>").description("Update a product. Only the fields you pass are written.").option("-n, --name <name>", "New name").option("-d, --description <text>", "New description").option("--icon <icon>", "Icon shortcode").option("--color <color>", "Color").option("--fun-ticket-ids", "Use fun ticket ids (e.g. prime.toucan) for new tickets").option("--no-fun-ticket-ids", "Use numbered ticket ids for new tickets").option("--workspace <slug|id>", "Workspace (required when using a slug)").action(
+    async (slugOrId, 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 existing = await client.products.resolve(workspaceId, slugOrId);
+        const product = await client.products.update({
+          id: existing.id,
+          name: options.name,
+          description: options.description,
+          icon: options.icon,
+          color: options.color,
+          funTicketIds: options.funTicketIds
+        });
+        if (useJson) outputProductJson(product);
+        else {
+          console.log("\n\u2713 Product updated");
+          outputProductPretty(product);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
+  products.command("delete <slugOrId>").description(
+    "Delete a product. Deleting a product deletes everything under it \u2014 its features, tickets, epics, research and retrospectives cascade \u2014 so this refuses while it still has any of them, unless --force."
+  ).option("--force", "Delete anyway, taking everything under it with it (destructive)").option("--workspace <slug|id>", "Workspace (required when using a slug)").action(
+    async (slugOrId, 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 product = await client.products.resolve(workspaceId, slugOrId);
+        const counts = product._count ?? {};
+        const blockers = [
+          counts.features ? `${counts.features} feature(s)` : null,
+          counts.tickets ? `${counts.tickets} ticket(s)` : null,
+          counts.researches ? `${counts.researches} research item(s)` : null,
+          counts.retrospectives ? `${counts.retrospectives} retrospective(s)` : null
+        ].filter(Boolean);
+        if (blockers.length > 0 && !options.force) {
+          const payload2 = {
+            deleted: false,
+            id: product.id,
+            slug: product.slug,
+            reason: `has ${blockers.join(", ")}`,
+            counts
+          };
+          if (useJson) console.log(JSON.stringify(payload2, null, 2));
+          else {
+            console.error(
+              `Product "${product.name}" has ${blockers.join(", ")}. Deleting it deletes them too.
+Re-run with --force to delete it anyway.`
+            );
+          }
+          process.exitCode = 1;
+          return;
+        }
+        await client.products.delete(product.id);
+        const payload = {
+          deleted: true,
+          id: product.id,
+          slug: product.slug,
+          counts
+        };
+        if (useJson) console.log(JSON.stringify(payload, null, 2));
+        else {
+          console.log("\n\u2713 Product deleted");
+          if (blockers.length) console.log(`  ${blockers.join(", ")} went with it`);
+        }
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
   return products;
 }
 
@@ -5995,6 +6161,49 @@ function createTicketsCommand() {
       }
     }
   );
+  tickets.command("search <query>").description(
+    [
+      "Find tickets in a product by free text \u2014 the same picker search the app uses",
+      "when you link a dependency. Matches title (case-insensitive substring), shortId",
+      '(word-order-insensitive, so "toucan.prime" finds prime.toucan) or an exact',
+      "ticket number. Most recently updated first. Returns slim rows (id, number,",
+      "shortId, title, status, priority, assignee); use `tickets get` for the rest."
+    ].join("\n")
+  ).requiredOption("--product <slug|id>", "Product slug or CUID").option("--workspace <slug|id>", "Workspace (required when --product is a slug)").option("--limit <n>", "Max results, 1-50 (default 20)").option("--exclude <id>", "Ticket CUID to leave out of the results").action(
+    async (query, options, cmd) => {
+      const globalOpts = cmd.optsWithGlobals();
+      const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+      try {
+        const trimmed = query.trim();
+        if (!trimmed) {
+          throw new Error("Search query is empty. Use `tickets list` to list a product's tickets.");
+        }
+        if (trimmed.length > 200) {
+          throw new Error("Search query is too long (max 200 characters).");
+        }
+        let limit;
+        if (options.limit !== void 0) {
+          limit = Number(options.limit);
+          if (!Number.isInteger(limit) || limit < 1 || limit > 50) {
+            throw new Error(`Invalid --limit "${options.limit}". Use a whole number from 1 to 50.`);
+          }
+        }
+        const client = getClient();
+        const workspaceId = await resolveWorkspaceId(client, options.workspace);
+        const productId = await resolveProductId(client, workspaceId, options.product);
+        const hits = await client.tickets.search({
+          productId,
+          query: trimmed,
+          excludeTicketId: options.exclude,
+          limit
+        });
+        if (useJson) outputTicketSearchJson(hits, trimmed);
+        else outputTicketSearchPretty(hits, trimmed);
+      } catch (error) {
+        handleError(error, useJson);
+      }
+    }
+  );
   tickets.command("get <id>").description("Show a ticket with dependencies, actions, and comments").action(async (id, _options, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
@@ -7092,13 +7301,34 @@ function createGoalsCommand() {
   );
   goals.command("list").description(
     "List objectives, each with the projects linked to it \u2014 the join that ties an action (which carries a projectId) back to a goal."
-  ).option("-w, --workspace <slug|id>", "Workspace slug or ID (defaults to your default workspace)").option("--all-workspaces", "List across every workspace you belong to").option("--period <period>", "Filter by period, e.g. Q3-2026").option("--status <status>", `Filter by status: ${GOAL_STATUSES.join(", ")}`).option("--tree", "Render the parent/child cascade instead of a flat list").action(
+  ).option("-w, --workspace <slug|id>", "Workspace slug or ID (defaults to your default workspace)").option("--all-workspaces", "List across every workspace you belong to").option("--period <period>", "Filter by period, e.g. Q3-2026").option("--status <status>", `Filter by status: ${GOAL_STATUSES.join(", ")}`).option("--tree", "Render the parent/child cascade instead of a flat list").option(
+    "--project <cuid>",
+    "Only objectives linked to this project (yours only \u2014 the server scopes this lookup to objectives you created). Not combinable with --workspace, --all-workspaces or --tree."
+  ).action(
     async (options, cmd) => {
       const globalOpts = cmd.optsWithGlobals();
       const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
       try {
         const status = validateGoalStatus(options.status);
         const client = getClient();
+        if (options.project) {
+          const conflicting = [
+            options.workspace ? "--workspace" : null,
+            options.allWorkspaces ? "--all-workspaces" : null,
+            options.tree ? "--tree" : null
+          ].filter(Boolean);
+          if (conflicting.length > 0) {
+            throw new Error(
+              `--project can't be combined with ${conflicting.join(", ")}.`
+            );
+          }
+          const list2 = (await client.goals.listByProject(options.project)).filter(
+            (g) => (!options.period || g.period === options.period) && (!status || g.status === status)
+          );
+          if (useJson) outputGoalsJson(list2);
+          else outputGoalsPretty(list2);
+          return;
+        }
         const workspaces = await targetWorkspaces(client, options);
         if (options.tree) {
           const trees = await fanOutByWorkspace(