@bragduck/cli 2.38.2 → 2.39.0

package/dist/bin/bragduck.js

@@ -104,6 +104,11 @@ var init_constants = __esm({
       ORGANISATIONS: {
         LIST: "/v1/users/{userId}/organisations"
       },
+      STORIES: {
+        LIST: "/v1/users/{userId}/stories",
+        CREATE: "/v1/users/{userId}/stories",
+        DELETE: "/v1/users/{userId}/stories/{storyId}"
+      },
       VERSION: "/v1/cli/version",
       /**
        * @deprecated Use BRAGS.REFINE instead
@@ -1622,6 +1627,70 @@ var init_api_service = __esm({
           throw _error;
         }
       }
+      /**
+       * List user's stories
+       */
+      async listStories(userId, params = {}) {
+        const { page = 1, perPage = 20, search, competency, orgId } = params;
+        logger.debug(`Listing stories: page=${page}, perPage=${perPage}`);
+        try {
+          const queryParams = new URLSearchParams6({
+            page: page.toString(),
+            perPage: perPage.toString()
+          });
+          if (search) queryParams.append("search", search);
+          if (competency) queryParams.append("competency", competency);
+          if (orgId) queryParams.append("orgId", orgId);
+          const url = `${API_ENDPOINTS.STORIES.LIST.replace("{userId}", userId)}?${queryParams.toString()}`;
+          const response = await this.makeRequest(url, {
+            method: "GET"
+          });
+          logger.debug(
+            `Successfully fetched ${response.items.length} stories (total: ${response.total})`
+          );
+          return response;
+        } catch (_error) {
+          logger.debug("Failed to list stories");
+          throw _error;
+        }
+      }
+      /**
+       * Create a story
+       */
+      async createStory(userId, body) {
+        logger.debug(`Creating story: ${body.title}`);
+        try {
+          const url = API_ENDPOINTS.STORIES.CREATE.replace("{userId}", userId);
+          const response = await this.makeRequest(url, {
+            method: "POST",
+            body
+          });
+          logger.debug(`Successfully created story: ${response.id}`);
+          return response;
+        } catch (_error) {
+          logger.debug("Failed to create story");
+          throw _error;
+        }
+      }
+      /**
+       * Delete a story (soft delete)
+       */
+      async deleteStory(userId, storyId) {
+        logger.debug(`Deleting story: ${storyId}`);
+        try {
+          const url = API_ENDPOINTS.STORIES.DELETE.replace("{userId}", userId).replace(
+            "{storyId}",
+            storyId
+          );
+          await this.makeRequest(url, {
+            method: "DELETE"
+          });
+          logger.debug(`Successfully deleted story: ${storyId}`);
+        } catch (_error) {
+          logger.debug("Failed to delete story");
+          throw _error;
+        }
+      }
       /**
        * List user's organisations
        */
@@ -5970,6 +6039,12 @@ async function promptConfirm(message, defaultValue = true) {
     default: defaultValue
   });
 }
+async function promptInput(message, defaultValue) {
+  return await input2({
+    message,
+    default: defaultValue
+  });
+}
 async function promptDaysToScan(defaultDays = 30) {
   const choices = [
     { name: "1 day", value: "1", description: "Last 24 hours" },
@@ -6217,6 +6292,13 @@ function createFetchSpinner(text) {
     spinner: "bouncingBar"
   });
 }
+function createWriteSpinner(text) {
+  return ora({
+    text,
+    color: "cyan",
+    spinner: "dots"
+  });
+}
 function createValidateSpinner(text) {
   return ora({
     text,
@@ -6239,6 +6321,15 @@ function updateStepSpinner(spinner, currentStep, totalSteps, text) {
 function fetchingBragsSpinner() {
   return createFetchSpinner("Fetching your brags...");
 }
+function fetchingStoriesSpinner() {
+  return createFetchSpinner("Fetching your stories...");
+}
+function creatingStorySpinner() {
+  return createWriteSpinner("Creating story...");
+}
+function deletingStorySpinner() {
+  return createWriteSpinner("Deleting story...");
+}
 function succeedSpinner(spinner, text) {
   if (text) {
     spinner.succeed(colors.success(text));
@@ -6535,6 +6626,7 @@ async function syncSingleRepository(repo, days, sortOption, scanMode, orgId, opt
   );
   createSpinner.start();
   const createRequest = {
+    mode: options.turbo ? "turbo" : "manual",
     brags: acceptedBrags.map((refined, index) => {
       const originalCommit = selectedCommits[index];
       const repoTag = repo.name;
@@ -6963,6 +7055,7 @@ async function syncSingleService(sourceType, options, TOTAL_STEPS, sharedDays, s
   );
   createSpinner.start();
   const createRequest = {
+    mode: options.turbo ? "turbo" : "manual",
     brags: acceptedBrags.map((refined, index) => {
       const originalCommit = selectedCommits[index];
       const isGitSource = sourceType === "github" || sourceType === "gitlab" || sourceType === "bitbucket" || sourceType === "atlassian";
@@ -7680,13 +7773,15 @@ function formatBragsTable(brags) {
   return table.toString() + (links ? "\n\n" + links : "");
 }
 function formatBragLinks(brags) {
-  const lines = brags.filter((brag) => brag.url || brag.goalIds && brag.goalIds.length > 0).map((brag) => {
+  const lines = brags.filter((brag) => brag.url || brag.keyResultIds && brag.keyResultIds.length > 0).map((brag) => {
     const parts = [`  ${colors.white(brag.title)}`];
     if (brag.url) {
       parts.push(`    ${colors.info(brag.url)}`);
     }
-    if (brag.goalIds && brag.goalIds.length > 0) {
-      parts.push(`    ${colors.dim("Linked to key result:")} ${colors.primary(brag.goalIds[0])}`);
+    if (brag.keyResultIds && brag.keyResultIds.length > 0) {
+      parts.push(
+        `    ${colors.dim("Linked to key result:")} ${colors.primary(brag.keyResultIds[0])}`
+      );
     }
     return parts.join("\n");
   });
@@ -7698,9 +7793,9 @@ function formatBragsOneline(brags) {
     const date = formatDate(brag.date);
     const urlLine = brag.url ? `
   ${colors.info(brag.url)}` : "";
-    const goalLine = brag.goalIds && brag.goalIds.length > 0 ? `
-  ${colors.dim("Linked to key result:")} ${colors.primary(brag.goalIds[0])}` : "";
-    return `${colors.highlight(date)}  ${colors.white(brag.title)}${urlLine}${goalLine}`;
+    const keyResultLine = brag.keyResultIds && brag.keyResultIds.length > 0 ? `
+  ${colors.dim("Linked to key result:")} ${colors.primary(brag.keyResultIds[0])}` : "";
+    return `${colors.highlight(date)}  ${colors.white(brag.title)}${urlLine}${keyResultLine}`;
   }).join("\n");
 }
 function truncateText(text, maxLength) {
@@ -7730,14 +7825,338 @@ function getErrorHint2(error) {
   return "Try running with DEBUG=* for more information";
 }
 
+// src/commands/story.ts
+init_esm_shims();
+init_api_service();
+init_auth_service();
+import boxen8 from "boxen";
+import Table3 from "cli-table3";
+init_logger();
+async function storyCommand(subcommand, idOrOptions, _options) {
+  switch (subcommand) {
+    case "list":
+    case "ls":
+      await storyListCommand(idOrOptions || {});
+      break;
+    case "create":
+    case "add":
+      await storyCreateCommand(idOrOptions || {});
+      break;
+    case "delete":
+    case "rm":
+      if (typeof idOrOptions === "string") {
+        await storyDeleteCommand(idOrOptions);
+      } else {
+        logger.log("");
+        logger.log(
+          boxen8(
+            formatErrorMessage("Missing story ID", "Usage: bragduck story delete <id>"),
+            boxStyles.error
+          )
+        );
+        process.exit(1);
+      }
+      break;
+    default:
+      logger.log("");
+      logger.log(
+        boxen8(
+          colors.primary("Story Commands") + `
+
+  ${theme.command("bragduck story list")}     List your interview stories
+  ${theme.command("bragduck story create")}   Create a new STAR story
+  ${theme.command("bragduck story delete")}   Delete a story by ID
+
+` + colors.dim("Aliases: ls, add, rm"),
+          { ...boxStyles.info, padding: 1 }
+        )
+      );
+      break;
+  }
+}
+async function storyListCommand(options) {
+  logger.log("");
+  try {
+    const isAuthenticated = await ensureAuthenticated();
+    if (!isAuthenticated) {
+      process.exit(1);
+    }
+    const subSpinner = createValidateSpinner("Checking subscription...");
+    subSpinner.start();
+    let subscriptionStatus;
+    try {
+      subscriptionStatus = await apiService.getSubscriptionStatus();
+    } catch (error) {
+      failSpinner(subSpinner, "Failed to check subscription");
+      throw error;
+    }
+    if (subscriptionStatus.tier === "FREE") {
+      failSpinner(subSpinner, "Free plan \u2014 upgrade to use the CLI");
+      showUpgradeMessage();
+      return;
+    }
+    subSpinner.stop();
+    const userInfo = authService.getUserInfo();
+    if (!userInfo) {
+      logger.log(boxen8(formatErrorMessage("Could not retrieve user info"), boxStyles.error));
+      process.exit(1);
+    }
+    const perPage = options.limit || 20;
+    const spinner = fetchingStoriesSpinner();
+    spinner.start();
+    const response = await apiService.listStories(userInfo.id, {
+      perPage,
+      search: options.search,
+      competency: options.competency
+    });
+    if (response.items.length === 0) {
+      failSpinner(spinner, "No stories found");
+      logger.log("");
+      if (options.search || options.competency) {
+        logger.info("Try adjusting your filters or run without filters to see all stories");
+      } else {
+        logger.info(
+          theme.secondary("Run ") + theme.command("bragduck story create") + theme.secondary(" to create your first interview story")
+        );
+      }
+      return;
+    }
+    succeedSpinner(spinner, `Found ${response.total} stor${response.total > 1 ? "ies" : "y"}`);
+    showCommandHeader(userInfo);
+    logger.log("");
+    logger.log(formatStoriesTable(response.items));
+    logger.log("");
+    if (response.total > response.items.length) {
+      logger.info(`Showing ${response.items.length} of ${response.total} total stories`);
+      logger.log("");
+    }
+    if (options.search || options.competency) {
+      const filterInfo = [];
+      if (options.search) filterInfo.push(`search: "${options.search}"`);
+      if (options.competency) filterInfo.push(`competency: ${options.competency}`);
+      logger.info(theme.info(`Filters applied: ${filterInfo.join(", ")}`));
+      logger.log("");
+    }
+  } catch (error) {
+    const err = error;
+    logger.log("");
+    logger.log(boxen8(formatErrorMessage(err.message, getErrorHint3(err)), boxStyles.error));
+    process.exit(1);
+  }
+}
+async function storyCreateCommand(options) {
+  logger.log("");
+  try {
+    const isAuthenticated = await ensureAuthenticated();
+    if (!isAuthenticated) {
+      process.exit(1);
+    }
+    const subSpinner = createValidateSpinner("Checking subscription...");
+    subSpinner.start();
+    let subscriptionStatus;
+    try {
+      subscriptionStatus = await apiService.getSubscriptionStatus();
+    } catch (error) {
+      failSpinner(subSpinner, "Failed to check subscription");
+      throw error;
+    }
+    if (subscriptionStatus.tier === "FREE") {
+      failSpinner(subSpinner, "Free plan \u2014 upgrade to use the CLI");
+      showUpgradeMessage();
+      return;
+    }
+    subSpinner.stop();
+    const userInfo = authService.getUserInfo();
+    if (!userInfo) {
+      logger.log(boxen8(formatErrorMessage("Could not retrieve user info"), boxStyles.error));
+      process.exit(1);
+    }
+    logger.log(
+      boxen8(
+        colors.primary("Create Interview Story") + "\n\n" + colors.dim("Use the STAR format to structure your story:\n") + colors.dim("Situation, Task, Action, Result"),
+        { ...boxStyles.info, padding: 1 }
+      )
+    );
+    logger.log("");
+    const title = options.title || await promptInput("Story title (short summary):");
+    if (!title.trim()) {
+      logger.log(theme.error("Title is required"));
+      process.exit(1);
+    }
+    const situation = await promptInput("Situation (context and background):");
+    if (!situation.trim()) {
+      logger.log(theme.error("Situation is required"));
+      process.exit(1);
+    }
+    const task = await promptInput("Task (your responsibility or challenge):");
+    if (!task.trim()) {
+      logger.log(theme.error("Task is required"));
+      process.exit(1);
+    }
+    const action = await promptInput("Action (what you did):");
+    if (!action.trim()) {
+      logger.log(theme.error("Action is required"));
+      process.exit(1);
+    }
+    const result = await promptInput("Result (outcome and impact):");
+    if (!result.trim()) {
+      logger.log(theme.error("Result is required"));
+      process.exit(1);
+    }
+    const competenciesInput = await promptInput(
+      "Competencies (comma-separated, e.g. leadership, system design):",
+      ""
+    );
+    const competencies = competenciesInput ? competenciesInput.split(",").map((c) => c.trim()).filter(Boolean) : [];
+    let orgId;
+    try {
+      const orgsResponse = await apiService.listUserOrganisations(userInfo.id);
+      if (orgsResponse.items.length > 0) {
+        const selectedOrg = await promptSelectOrganisationWithDefault(orgsResponse.items);
+        if (selectedOrg) {
+          orgId = selectedOrg;
+        }
+      }
+    } catch {
+      logger.debug("Failed to fetch organisations, skipping org selection");
+    }
+    logger.log("");
+    logger.log(
+      boxen8(
+        colors.primary("Preview") + `
+
+${theme.label("Title")} ${colors.white(title)}
+
+${theme.label("Situation")} ${colors.white(situation)}
+
+${theme.label("Task")} ${colors.white(task)}
+
+${theme.label("Action")} ${colors.white(action)}
+
+${theme.label("Result")} ${colors.white(result)}
+
+${theme.label("Competencies")} ${competencies.length > 0 ? colors.primary(competencies.join(", ")) : colors.dim("none")}`,
+        { ...boxStyles.info, padding: 1 }
+      )
+    );
+    logger.log("");
+    const shouldCreate = await promptConfirm("Create this story?", true);
+    if (!shouldCreate) {
+      logger.log(theme.secondary("Story creation cancelled"));
+      return;
+    }
+    const spinner = creatingStorySpinner();
+    spinner.start();
+    const body = {
+      title,
+      situation,
+      task,
+      action,
+      result,
+      competencies,
+      source: "cli"
+    };
+    if (orgId) {
+      body.orgId = orgId;
+    }
+    const story = await apiService.createStory(userInfo.id, body);
+    succeedSpinner(spinner, `Story created: "${story.title}"`);
+    logger.log("");
+  } catch (error) {
+    const err = error;
+    logger.log("");
+    logger.log(boxen8(formatErrorMessage(err.message, getErrorHint3(err)), boxStyles.error));
+    process.exit(1);
+  }
+}
+async function storyDeleteCommand(storyId) {
+  logger.log("");
+  try {
+    const isAuthenticated = await ensureAuthenticated();
+    if (!isAuthenticated) {
+      process.exit(1);
+    }
+    const userInfo = authService.getUserInfo();
+    if (!userInfo) {
+      logger.log(boxen8(formatErrorMessage("Could not retrieve user info"), boxStyles.error));
+      process.exit(1);
+    }
+    const shouldDelete = await promptConfirm(`Delete story ${storyId}?`, false);
+    if (!shouldDelete) {
+      logger.log(theme.secondary("Deletion cancelled"));
+      return;
+    }
+    const spinner = deletingStorySpinner();
+    spinner.start();
+    await apiService.deleteStory(userInfo.id, storyId);
+    succeedSpinner(spinner, "Story deleted");
+    logger.log("");
+  } catch (error) {
+    const err = error;
+    logger.log("");
+    logger.log(boxen8(formatErrorMessage(err.message, getErrorHint3(err)), boxStyles.error));
+    process.exit(1);
+  }
+}
+function formatStoriesTable(stories) {
+  const table = new Table3({
+    head: [
+      colors.primary("ID"),
+      colors.primary("Title"),
+      colors.primary("Competencies"),
+      colors.primary("Updated")
+    ],
+    colWidths: [12, 35, 30, 14],
+    wordWrap: true,
+    style: tableStyles.default.style
+  });
+  stories.forEach((story) => {
+    const competencies = story.competencies.length > 0 ? story.competencies.join(", ") : colors.dim("none");
+    const updated = formatDate(story.updatedAt);
+    table.push([
+      colors.dim(story.id),
+      colors.white(story.title),
+      colors.primary(competencies),
+      colors.highlight(updated)
+    ]);
+  });
+  return table.toString();
+}
+function showUpgradeMessage() {
+  logger.log("");
+  logger.log(
+    boxen8(
+      theme.warning("CLI Access Requires Subscription") + "\n\nThe BragDuck CLI is available for Plus and Pro subscribers.\nUpgrade now to unlock:\n\n  \u2022 List and manage your interview stories\n  \u2022 Create STAR-format stories from the terminal\n  \u2022 Automatic work item scanning\n\n" + colors.highlight("Upgrade at: https://bragduck.com/app/settings/plans"),
+      {
+        ...boxStyles.warning,
+        padding: 1,
+        margin: 1
+      }
+    )
+  );
+  logger.log("");
+}
+function getErrorHint3(error) {
+  if (error.name === "TokenExpiredError" || error.name === "AuthenticationError") {
+    return 'Run "bragduck auth login" to login again';
+  }
+  if (error.name === "NetworkError") {
+    return "Check your internet connection and try again";
+  }
+  if (error.name === "ApiError") {
+    return "The server might be experiencing issues. Try again later";
+  }
+  return "Try running with DEBUG=* for more information";
+}
+
 // src/commands/config.ts
 init_esm_shims();
 init_storage_service();
 init_logger();
 init_constants();
-import boxen8 from "boxen";
+import boxen9 from "boxen";
 import chalk6 from "chalk";
-import Table3 from "cli-table3";
+import Table4 from "cli-table3";
 init_errors();
 var VALID_CONFIG_KEYS = Object.values(CONFIG_KEYS);
 async function configCommand(subcommand, key, value) {
@@ -7771,7 +8190,7 @@ async function configCommand(subcommand, key, value) {
     const err = error;
     logger.log("");
     logger.log(
-      boxen8(formatErrorMessage(err.message, getConfigHint(err)), {
+      boxen9(formatErrorMessage(err.message, getConfigHint(err)), {
         padding: 1,
         margin: 1,
         borderStyle: "round",
@@ -7791,7 +8210,7 @@ async function handleListConfig() {
     confluenceInstance: storageService.getConfig("confluenceInstance"),
     gitlabInstance: storageService.getConfig("gitlabInstance")
   };
-  const table = new Table3({
+  const table = new Table4({
     head: [chalk6.cyan("Key"), chalk6.cyan("Value"), chalk6.cyan("Default")],
     colWidths: [25, 40, 40],
     wordWrap: true,
@@ -7865,7 +8284,7 @@ async function handleSetConfig(key, value) {
   const typedValue = validateAndConvertValue(key, value);
   storageService.setConfig(key, typedValue);
   logger.log(
-    boxen8(
+    boxen9(
       `${chalk6.green.bold("\u2713 Configuration updated")}
 
 ${chalk6.white(key)}: ${chalk6.yellow(String(typedValue))}`,
@@ -7997,6 +8416,18 @@ program.command("list").description("List your existing brags").option("-l, --li
     process.exit(1);
   }
 });
+program.command("story [subcommand] [id]").description("Manage interview stories (subcommands: list, create, delete)").option("-l, --limit <number>", "Number of stories to display", (val) => parseInt(val, 10), 20).option("-s, --search <query>", "Search stories by keyword").option("-c, --competency <competency>", "Filter by competency").option("-t, --title <title>", "Story title (for create)").action(async (subcommand, id, options) => {
+  try {
+    if (subcommand === "delete" || subcommand === "rm") {
+      await storyCommand(subcommand, id, options);
+    } else {
+      await storyCommand(subcommand, options);
+    }
+  } catch (error) {
+    console.error(error);
+    process.exit(1);
+  }
+});
 program.command("logout").description("Clear stored credentials").action(async () => {
   try {
     await logoutCommand();