exponential-cli 1.2.0 → 1.4.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command12 } 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,11 +2092,12 @@ function createFeaturesCommand() {
       }
     }
   );
+  features.addCommand(createStoriesCommand());
   return features;
 }
 
 // src/commands/labels.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 import chalk4 from "chalk";
 var TRIAGE_LABELS = [
   { slug: "needs-triage", name: "needs-triage", color: "avatar-orange" },
@@ -1937,7 +2151,7 @@ async function resolveLabelIds(client, workspaceId, values) {
   return [...byId, ...resolvedFromSlugs];
 }
 function createLabelsCommand() {
-  const labels = new Command7("labels").description(
+  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(
@@ -2040,9 +2254,9 @@ function createLabelsCommand() {
 }
 
 // src/commands/products.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 function createProductsCommand() {
-  const products = new Command8("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) => {
@@ -2105,9 +2319,9 @@ function createProductsCommand() {
 }
 
 // src/commands/projects.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 function createProjectsCommand() {
-  const projects = new Command9("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);
@@ -2130,7 +2344,7 @@ function createProjectsCommand() {
 }
 
 // src/commands/tickets.ts
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 function collectRepeatable(value, previous) {
   return [...previous, value];
 }
@@ -2173,10 +2387,21 @@ function validateTicketType(value) {
   return value;
 }
 function createTicketsCommand() {
-  const tickets = new Command10("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").option(
+  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,
@@ -2188,20 +2413,32 @@ function createTicketsCommand() {
       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
         });
         let filtered = list;
         if (options.label.length > 0) {
@@ -2463,7 +2700,7 @@ function createTicketsCommand() {
       handleError(error, useJson);
     }
   });
-  const comment = new Command10("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);
@@ -2502,10 +2739,10 @@ function createTicketsCommand() {
 }
 
 // src/commands/workspaces.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 import chalk5 from "chalk";
 function createWorkspacesCommand() {
-  const workspaces = new Command11("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);
@@ -2551,7 +2788,7 @@ function createWorkspacesCommand() {
 }
 
 // src/index.ts
-var program = new Command12();
+var program = new Command13();
 program.name("exponential").description(
   [
     "CLI to interact with Exponential productivity app.",