contribute-now 0.9.0-dev.8626d97 → 0.9.0-dev.987ca85

package/README.md

@@ -1,6 +1,6 @@
 # contribute-now
 
-![GitHub Repo Banner](https://ghrb.waren.build/banner?header=contribute-now+%F0%9F%94%84&subheader=Any+workflow.+Clean+commits.+Zero+friction.&bg=0D1117-21262D&color=FFFFFF&headerfont=Google+Sans+Code&subheaderfont=Sour+Gummy&support=true)
+![GitHub Repo Banner](https://ghrb.waren.build/banner?header=>_contribute-now&subheader=Ship+faster+with+clean+git+flow&bg=431586-9231A8&color=FFFFFF&headerfont=Google+Sans+Code&subheaderfont=Google+Sans+Code&support=true)
 <!-- Created with GitHub Repo Banner by Waren Gonzaga: https://ghrb.waren.build -->
 
 **contribute-now** is a developer CLI that automates git workflows — branching, syncing, staging, committing, and opening PRs — so you can focus on shipping, not on memorizing git commands.
@@ -274,6 +274,8 @@ List branches with workflow-aware labels and tracking status.
 cn branch             # local branches
 cn branch --all       # local + remote branches
 cn branch --remote    # remote branches only
+cn branch --sync      # sync refs (friendly alias of --prune)
+cn branch --prune     # fetch remotes + prune deleted remote branches
 ```
 
 Branches are annotated with workflow labels (e.g., base, dev, feature) and tracking info (upstream, gone, no remote).

package/dist/cli.js

@@ -2949,7 +2949,9 @@ var init_tips = __esm(() => {
         { command: "cn branch --help", description: "learn branch list modes and filters" },
         { command: "cn branch", description: "list local branches and tracking info" },
         { command: "cn branch --all", description: "include local and remote branches" },
-        { command: "cn branch --remote", description: "show only remote branches" }
+        { command: "cn branch --remote", description: "show only remote branches" },
+        { command: "cn branch --sync", description: "sync remote refs before listing branches" },
+        { command: "cn branch --prune", description: "fetch remotes and prune deleted refs first" }
       ]
     },
     hook: {
@@ -9182,6 +9184,9 @@ async function runMain(cmd, opts = {}) {
   }
 }
 
+// src/cli.ts
+var import_picocolors26 = __toESM(require_picocolors(), 1);
+
 // src/commands/branch.ts
 init_config();
 var import_picocolors2 = __toESM(require_picocolors(), 1);
@@ -9308,6 +9313,9 @@ async function addRemote(name, url) {
 async function fetchAll() {
   return run(["fetch", "--all", "--quiet"]);
 }
+async function fetchAllPrune() {
+  return run(["fetch", "--all", "--prune", "--quiet"]);
+}
 async function checkoutBranch(branch) {
   return run(["checkout", branch]);
 }
@@ -9765,10 +9773,16 @@ function isBranchProtected(branch, config) {
 }
 
 // src/commands/branch.ts
+function shouldPruneBranchRefs(args) {
+  return Boolean(args.prune || args.sync);
+}
+function shouldWarnDeletedRemoteBranch(params) {
+  return params.isCurrent && params.gone && (params.hasUncommitted || params.uniqueCommitsAheadOfBase > 0);
+}
 var branch_default = defineCommand({
   meta: {
     name: "branch",
-    description: "List branches with workflow-aware labels and status"
+    description: "List branches with workflow-aware labels and optional remote pruning"
   },
   args: {
     all: {
@@ -9782,6 +9796,18 @@ var branch_default = defineCommand({
       alias: "r",
       description: "Show only remote branches",
       default: false
+    },
+    prune: {
+      type: "boolean",
+      alias: "p",
+      description: "Fetch all remotes and prune deleted remote-tracking branches first",
+      default: false
+    },
+    sync: {
+      type: "boolean",
+      alias: "s",
+      description: "Sync remote branch refs before listing (alias of --prune)",
+      default: false
     }
   },
   async run({ args }) {
@@ -9794,10 +9820,45 @@ var branch_default = defineCommand({
     const currentBranch = await getCurrentBranch();
     const showRemoteOnly = args.remote;
     const showAll = args.all;
+    const shouldPrune = shouldPruneBranchRefs(args);
     await projectHeading("branch", "\uD83C\uDF3F");
+    if (shouldPrune) {
+      info("Fetching remotes and pruning stale remote-tracking branches...");
+      const pruneResult = await fetchAllPrune();
+      if (pruneResult.exitCode === 0) {
+        success("Remote refs refreshed and stale branches pruned.");
+      } else {
+        warn(`Could not fully prune remote refs: ${pruneResult.stderr.trim() || "git fetch --all --prune failed"}`);
+      }
+    }
     console.log();
     if (!showRemoteOnly) {
       const localBranches = await getLocalBranches();
+      const currentLocalBranch = localBranches.find((b2) => b2.isCurrent);
+      if (currentLocalBranch?.gone) {
+        const hasUncommitted = await hasUncommittedChanges();
+        let uniqueCommitsAheadOfBase = 0;
+        if (config) {
+          const syncSource = getSyncSource(config);
+          uniqueCommitsAheadOfBase = await countCommitsAhead(currentLocalBranch.name, syncSource.ref);
+        }
+        if (shouldWarnDeletedRemoteBranch({
+          isCurrent: currentLocalBranch.isCurrent,
+          gone: currentLocalBranch.gone,
+          hasUncommitted,
+          uniqueCommitsAheadOfBase
+        })) {
+          warn(`Current branch ${import_picocolors2.default.bold(currentLocalBranch.name)} was deleted remotely but still has local work.`);
+          if (hasUncommitted) {
+            info("You have uncommitted local changes.");
+          }
+          if (uniqueCommitsAheadOfBase > 0) {
+            info(`You have ${uniqueCommitsAheadOfBase} local commit(s) not in the base sync branch.`);
+          }
+          info(`Run ${import_picocolors2.default.bold("cn update")} to move your work to a fresh branch safely.`, "");
+          console.log();
+        }
+      }
       if (localBranches.length === 0) {
         console.log(import_picocolors2.default.dim("  No local branches found."));
       } else {
@@ -13705,7 +13766,7 @@ var import_picocolors12 = __toESM(require_picocolors(), 1);
 // package.json
 var package_default = {
   name: "contribute-now",
-  version: "0.9.0-dev.8626d97",
+  version: "0.9.0-dev.987ca85",
   description: "Developer CLI that automates git workflows \u2014 branching, syncing, committing, and PRs \u2014 with multi-workflow and commit convention support.",
   type: "module",
   bin: {
@@ -17710,7 +17771,7 @@ function getAuthor() {
 function showBanner(variant = "small") {
   console.log(import_picocolors25.default.cyan(`
 ${LOGO}`));
-  console.log(`  ${import_picocolors25.default.dim(`v${getVersion()}`)} ${import_picocolors25.default.dim("\u2014")} ${import_picocolors25.default.dim(`Built by ${getAuthor()}`)}`);
+  console.log(`  ${import_picocolors25.default.white(`v${getVersion()}`)} ${import_picocolors25.default.white("\u2014")} ${import_picocolors25.default.white(`Built by ${getAuthor()}`)}`);
   const announcements = getActiveAnnouncements();
   if (announcements.length > 0) {
     console.log();
@@ -17794,8 +17855,8 @@ ${LOGO}`));
     }
     console.log(`  ${import_picocolors25.default.dim(`\u2514${"\u2500".repeat(contentWidth + 2)}\u2518`)}`);
     console.log();
-    console.log(`  ${import_picocolors25.default.dim("Star or contribute:")} ${import_picocolors25.default.dim(linkify("gh.waren.build/contribute-now", "https://gh.waren.build/contribute-now"))}`);
-    console.log(`  ${import_picocolors25.default.dim("Sponsor:")} ${import_picocolors25.default.dim(linkify("warengonzaga.com/sponsor", "https://warengonzaga.com/sponsor"))}`);
+    console.log(`  \uD83E\uDD1D ${import_picocolors25.default.white("Contribute:")} ${import_picocolors25.default.dim(linkify("gh.waren.build/contribute-now", "https://gh.waren.build/contribute-now"))}`);
+    console.log(`  \uD83D\uDE4F ${import_picocolors25.default.white("Sponsor:")} ${import_picocolors25.default.dim(linkify("warengonzaga.com/sponsor", "https://warengonzaga.com/sponsor"))}`);
   }
   console.log();
 }
@@ -17882,6 +17943,112 @@ function getAnnouncementTone(kind) {
 }
 
 // src/cli.ts
+var CLI_SUBCOMMANDS = {
+  setup: setup_default,
+  config: config_default,
+  sync: sync_default,
+  start: start_default,
+  commit: commit_default,
+  update: update_default,
+  submit: submit_default,
+  switch: switch_default,
+  discard: discard_default,
+  save: save_default,
+  branch: branch_default,
+  clean: clean_default,
+  status: status_default,
+  log: log_default,
+  hook: hook_default,
+  validate: validate_default,
+  doctor: doctor_default,
+  label: label_default
+};
+function formatVersionInfo() {
+  return `Contribute Now v${getVersion()} - Built by Waren Gonzaga`;
+}
+function cmd(name, desc) {
+  return `  ${import_picocolors26.default.cyan(name.padEnd(12))}${import_picocolors26.default.white(desc)}`;
+}
+function showCompactRootHelp() {
+  console.log(`${import_picocolors26.default.bold("USAGE")}  ${import_picocolors26.default.cyan("cn <command> [options]")}`);
+  console.log();
+  console.log(import_picocolors26.default.bold("WORKFLOW"));
+  console.log(cmd("setup", "Initialize your local environment and GitHub access"));
+  console.log(cmd("start", "Create a new branch for your contribution"));
+  console.log(cmd("commit", "Stage and commit changes with guided prompts"));
+  console.log(cmd("update", "Sync your branch and update the PR description"));
+  console.log(cmd("submit", "Push and open a pull request on GitHub"));
+  console.log();
+  console.log(import_picocolors26.default.bold("BRANCH & COMMITS"));
+  console.log(cmd("branch", "List local/remote branches and optionally prune remotes"));
+  console.log(cmd("switch", "Switch to a different branch"));
+  console.log(cmd("save", "Stash uncommitted changes for later"));
+  console.log(cmd("discard", "Discard uncommitted changes"));
+  console.log();
+  console.log(import_picocolors26.default.bold("GITHUB"));
+  console.log(cmd("sync", "Sync the default branch and rebase your work"));
+  console.log(cmd("label", "Suggest and apply labels on issues and PRs"));
+  console.log(cmd("config", "View or update your Contribute Now config"));
+  console.log();
+  console.log(import_picocolors26.default.bold("UTILITIES"));
+  console.log(cmd("status", "Show current branch and working tree status"));
+  console.log(cmd("log", "Display a compact commit log"));
+  console.log(cmd("clean", "Remove stale branches and tidy up"));
+  console.log(cmd("validate", "Check branch name and commit message format"));
+  console.log(cmd("hook", "Install or uninstall Git hooks"));
+  console.log(cmd("doctor", "Diagnose and fix common setup issues"));
+  console.log();
+  console.log(`${import_picocolors26.default.bold("FLAGS")}  ${import_picocolors26.default.cyan("-v, --version")}  ${import_picocolors26.default.dim("Show version")}`);
+  console.log();
+  console.log(import_picocolors26.default.dim("Run cn <command> --help for detailed options and examples."));
+}
+function formatArgLabel(name, arg) {
+  if (arg.type === "positional") {
+    return arg.required ? `<${name}>` : `[${name}]`;
+  }
+  const flags = [];
+  if (arg.alias) {
+    flags.push(`-${arg.alias}`);
+  }
+  flags.push(`--${name}`);
+  const needsValue = arg.type && arg.type !== "boolean";
+  const valueHint = needsValue ? ` <${arg.type}>` : "";
+  return `${flags.join(", ")}${valueHint}`;
+}
+function findRequestedSubCommand(argv2) {
+  const names = Object.keys(CLI_SUBCOMMANDS);
+  for (const token of argv2) {
+    if (names.includes(token)) {
+      return token;
+    }
+  }
+  return null;
+}
+function showCompactSubCommandHelp(commandName) {
+  const command = CLI_SUBCOMMANDS[commandName];
+  const description = command.meta?.description ?? `Run ${commandName} command`;
+  const args = command.args ?? {};
+  const positionalArgs = Object.entries(args).filter(([, arg]) => arg.type === "positional");
+  const optionArgs = Object.entries(args).filter(([, arg]) => arg.type !== "positional");
+  console.log(description);
+  console.log();
+  const positionalUsage = positionalArgs.map(([name, arg]) => formatArgLabel(name, arg)).join(" ").trim();
+  const usageSuffix = positionalUsage.length > 0 ? ` ${positionalUsage}` : " [OPTIONS]";
+  console.log(`${import_picocolors26.default.bold("USAGE")}  ${import_picocolors26.default.cyan(`cn ${commandName}${usageSuffix}`)}`);
+  if (optionArgs.length > 0) {
+    console.log();
+    console.log(import_picocolors26.default.bold("OPTIONS"));
+    console.log();
+    const labels = optionArgs.map(([name, arg]) => formatArgLabel(name, arg));
+    const maxLabel = labels.reduce((max, label) => Math.max(max, label.length), 0);
+    optionArgs.forEach(([, arg], index) => {
+      const label = labels[index].padEnd(maxLabel + 2);
+      const desc = arg.description ?? "";
+      console.log(`  ${import_picocolors26.default.cyan(label)}${desc}`);
+    });
+  }
+  console.log();
+}
 function normalizeCliArgs(argv2) {
   return argv2.map((arg, index) => {
     const previous = argv2[index - 1];
@@ -17897,32 +18064,23 @@ function normalizeCliArgs(argv2) {
 }
 process.argv = normalizeCliArgs(process.argv);
 var isVersion = process.argv.includes("--version") || process.argv.includes("-v");
+var subCommands = Object.keys(CLI_SUBCOMMANDS);
+var isHelp = process.argv.includes("--help") || process.argv.includes("-h");
+var hasSubCommand = subCommands.some((cmd2) => process.argv.includes(cmd2));
+var isRootHelp = isHelp && !hasSubCommand;
+var requestedSubCommand = isHelp ? findRequestedSubCommand(process.argv) : null;
 if (!isVersion) {
-  const subCommands = [
-    "setup",
-    "config",
-    "sync",
-    "start",
-    "commit",
-    "update",
-    "submit",
-    "switch",
-    "discard",
-    "save",
-    "clean",
-    "status",
-    "log",
-    "branch",
-    "hook",
-    "validate",
-    "doctor",
-    "label"
-  ];
-  const isHelp = process.argv.includes("--help") || process.argv.includes("-h");
-  const hasSubCommand = subCommands.some((cmd) => process.argv.includes(cmd));
-  const useBigBanner = isHelp || !hasSubCommand;
+  const useBigBanner = !hasSubCommand && !isHelp;
   showBanner(useBigBanner ? "big" : "small");
 }
+if (isRootHelp) {
+  showCompactRootHelp();
+  process.exit(0);
+}
+if (isHelp && requestedSubCommand) {
+  showCompactSubCommandHelp(requestedSubCommand);
+  process.exit(0);
+}
 var main = defineCommand({
   meta: {
     name: "cn",
@@ -17937,28 +18095,11 @@ var main = defineCommand({
     }
   },
   subCommands: {
-    setup: setup_default,
-    config: config_default,
-    sync: sync_default,
-    start: start_default,
-    commit: commit_default,
-    update: update_default,
-    submit: submit_default,
-    switch: switch_default,
-    discard: discard_default,
-    save: save_default,
-    branch: branch_default,
-    clean: clean_default,
-    status: status_default,
-    log: log_default,
-    hook: hook_default,
-    validate: validate_default,
-    doctor: doctor_default,
-    label: label_default
+    ...CLI_SUBCOMMANDS
   },
   run({ args }) {
     if (args.version) {
-      console.log(`cn v${getVersion()}`);
+      console.log(formatVersionInfo());
     }
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contribute-now",
-  "version": "0.9.0-dev.8626d97",
+  "version": "0.9.0-dev.987ca85",
   "description": "Developer CLI that automates git workflows — branching, syncing, committing, and PRs — with multi-workflow and commit convention support.",
   "type": "module",
   "bin": {