@staff0rd/assist 0.374.2 → 0.376.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.374.2",
+  version: "0.376.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -4589,11 +4589,80 @@ async function recordBranchActivity(branchName) {
   ]);
 }
 
+// src/commands/branch/generateBranchSlug.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+
+// src/shared/withSpinner.ts
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var TICK_MS = 80;
+async function withSpinner(text9, task) {
+  if (!process.stderr.isTTY) return task();
+  let frame = 0;
+  const render = () => {
+    process.stderr.write(`\r${SPINNER_FRAMES[frame]} ${text9}`);
+  };
+  render();
+  const timer = setInterval(() => {
+    frame = (frame + 1) % SPINNER_FRAMES.length;
+    render();
+  }, TICK_MS);
+  try {
+    return await task();
+  } finally {
+    clearInterval(timer);
+    process.stderr.write("\r\x1B[K");
+  }
+}
+
 // src/commands/branch/deriveBranchSlug.ts
+var MAX_SLUG_WORDS = 5;
 function deriveBranchSlug(name) {
-  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  const words = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").split("-").filter((word) => word.length > 0).filter((word) => !/^\d+$/.test(word));
+  const slug = words.slice(0, MAX_SLUG_WORDS).join("-");
   return slug || "story";
 }
+function isConciseSlug(slug) {
+  return slug.split("-").filter(Boolean).length <= MAX_SLUG_WORDS;
+}
+
+// src/commands/branch/generateBranchSlug.ts
+var execFileAsync = promisify(execFile);
+async function generateBranchSlug(description) {
+  const fallback = deriveBranchSlug(description);
+  const suggestion = await requestSlug(description);
+  if (!suggestion) return fallback;
+  const slug = deriveBranchSlug(suggestion);
+  return slug === "story" ? fallback : slug;
+}
+async function requestSlug(description) {
+  try {
+    const { stdout } = await withSpinner(
+      "Generating a concise branch name",
+      () => execFileAsync(
+        "claude",
+        ["-p", "--model", "haiku", buildPrompt(description)],
+        { encoding: "utf8", timeout: 3e4 }
+      )
+    );
+    const slug = stdout.trim().split("\n")[0].replace(/^["'`]|["'`]$/g, "").trim();
+    return slug || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function buildPrompt(description) {
+  return [
+    "Suggest a concise git branch name for the work described below.",
+    "Rules:",
+    "- kebab-case: lowercase letters, digits, and single hyphens only",
+    "- 2 to 4 words that capture the essence of the work",
+    "- no ticket/issue numbers and no standalone numbers",
+    "- reply with ONLY the branch name, no quotes or explanation",
+    "",
+    `Work: ${description}`
+  ].join("\n");
+}
 
 // src/commands/backlog/ensureStoryBranch.ts
 async function ensureStoryBranch(item) {
@@ -4601,7 +4670,7 @@ async function ensureStoryBranch(item) {
   if (!config.prs?.required) return;
   if (hasBranchRef(item)) return;
   process.env.ASSIST_BACKLOG_ITEM_ID = String(item.id);
-  const slug = deriveBranchSlug(item.name);
+  const slug = await generateBranchSlug(item.name);
   const { branchName } = await createBranch({ slug, jira: item.jiraKey });
   appendDaemonLog(
     `backlog run ${item.id}: prs.required set and no branch recorded; created ${branchName}`
@@ -6975,11 +7044,11 @@ function getHtml() {
 }
 
 // src/commands/sessions/web/getReviewSynthesis.ts
-import { execFile } from "child_process";
+import { execFile as execFile2 } from "child_process";
 import { readFileSync as readFileSync17 } from "fs";
 import { homedir as homedir9 } from "os";
 import { basename as basename3, join as join22 } from "path";
-import { promisify } from "util";
+import { promisify as promisify2 } from "util";
 
 // src/commands/sessions/web/findSynthesisForBranch.ts
 import { existsSync as existsSync24, readdirSync, statSync as statSync2 } from "fs";
@@ -7014,9 +7083,9 @@ function windowsCwdToWslPath(cwd) {
 }
 
 // src/commands/sessions/web/getReviewSynthesis.ts
-var execFileAsync = promisify(execFile);
+var execFileAsync2 = promisify2(execFile2);
 function runGit(cwd, args) {
-  return execFileAsync("git", args, {
+  return execFileAsync2("git", args, {
     encoding: "utf8",
     cwd: windowsCwdToWslPath(cwd)
   }).then((r) => r.stdout.trim());
@@ -7060,8 +7129,8 @@ function githubUrl(req, res) {
 }
 
 // src/commands/sessions/web/gitStatus.ts
-import { execFile as execFile2 } from "child_process";
-import { promisify as promisify2 } from "util";
+import { execFile as execFile3 } from "child_process";
+import { promisify as promisify3 } from "util";
 
 // src/commands/sessions/web/parseGitStatus.ts
 function extractPath(rest) {
@@ -7091,7 +7160,7 @@ function parseGitStatus(output) {
 }
 
 // src/commands/sessions/web/gitStatus.ts
-var execFileAsync2 = promisify2(execFile2);
+var execFileAsync3 = promisify3(execFile3);
 async function gitStatus(req, res) {
   const cwd = getCwdParam(req, res);
   if (!cwd) return;
@@ -7104,7 +7173,7 @@ async function gitStatus(req, res) {
 function runGitStatus(cwd) {
   const args = ["status", "--porcelain", "--untracked-files=all"];
   const { file, argv } = /^[A-Za-z]:[\\/]/.test(cwd) ? { file: "git.exe", argv: ["-C", cwd, ...args] } : { file: "git", argv: args };
-  return execFileAsync2(file, argv, {
+  return execFileAsync3(file, argv, {
     encoding: "utf8",
     ...file === "git" ? { cwd } : {}
   }).then((r) => r.stdout);
@@ -7303,8 +7372,8 @@ async function listUsageHistory(req, res) {
 
 // src/commands/sessions/web/openInCode.ts
 import { exec } from "child_process";
-import { promisify as promisify3 } from "util";
-var execAsync = promisify3(exec);
+import { promisify as promisify4 } from "util";
+var execAsync = promisify4(exec);
 async function openInCode(req, res) {
   const cwd = getCwdParam(req, res);
   if (!cwd) return;
@@ -7320,9 +7389,9 @@ async function openInCode(req, res) {
 }
 
 // src/commands/sessions/web/createCachedGhJson.ts
-import { execFile as execFile3 } from "child_process";
-import { promisify as promisify4 } from "util";
-var execFileAsync3 = promisify4(execFile3);
+import { execFile as execFile4 } from "child_process";
+import { promisify as promisify5 } from "util";
+var execFileAsync4 = promisify5(execFile4);
 var CACHE_TTL_MS = 3e4;
 function createCachedGhJson(args, parse3, fallback, options2 = {}) {
   const { cacheFallback = true } = options2;
@@ -7334,7 +7403,7 @@ function createCachedGhJson(args, parse3, fallback, options2 = {}) {
     if (cached && cached.expires > now) return cached.value;
     let value = fallback;
     try {
-      const { stdout } = await execFileAsync3("gh", [...args, ...extraArgs], {
+      const { stdout } = await execFileAsync4("gh", [...args, ...extraArgs], {
         encoding: "utf8",
         cwd: windowsCwdToWslPath(cwd)
       });
@@ -7378,9 +7447,9 @@ async function prList(req, res) {
 }
 
 // src/commands/sessions/web/prStatus.ts
-import { execFile as execFile4 } from "child_process";
-import { promisify as promisify5 } from "util";
-var execFileAsync4 = promisify5(execFile4);
+import { execFile as execFile5 } from "child_process";
+import { promisify as promisify6 } from "util";
+var execFileAsync5 = promisify6(execFile5);
 function toPrSummary(parsed) {
   if (typeof parsed.number !== "number") return null;
   return {
@@ -7410,7 +7479,7 @@ var getOpenPrForBranch = createCachedGhJson(
 );
 async function getCurrentBranch(cwd) {
   try {
-    const { stdout } = await execFileAsync4(
+    const { stdout } = await execFileAsync5(
       "git",
       ["rev-parse", "--abbrev-ref", "HEAD"],
       { encoding: "utf8", cwd: windowsCwdToWslPath(cwd) }
@@ -9984,14 +10053,18 @@ function validateSlug(slug) {
 
 // src/commands/branch/branch.ts
 async function branch(slug, options2) {
-  const slugError = validateSlug(slug);
+  const conciseSlug = isConciseSlug(slug) ? slug : await generateBranchSlug(slug);
+  if (conciseSlug !== slug) {
+    console.log(`Shortened "${slug}" to "${conciseSlug}"`);
+  }
+  const slugError = validateSlug(conciseSlug);
   if (slugError) {
     console.error(`Error: ${slugError}`);
     process.exit(1);
   }
   try {
     const { branchName, defaultBranch } = await createBranch({
-      slug,
+      slug: conciseSlug,
       jira: options2.jira
     });
     console.log(
@@ -18862,7 +18935,7 @@ function cachedReviewerResult(name, outputPath) {
 import { createLogUpdate as createLogUpdate2 } from "log-update";
 
 // src/commands/review/renderEntries.ts
-var SPINNER_FRAMES = [
+var SPINNER_FRAMES2 = [
   "\u280B",
   "\u2819",
   "\u2839",
@@ -18889,11 +18962,11 @@ function renderEntries(entries, frame) {
 function renderEntry(entry, frame) {
   if (entry.state === "succeeded") return `\u2714 ${entry.text}`;
   if (entry.state === "failed") return `\u2716 ${entry.text}`;
-  return `${SPINNER_FRAMES[frame]} ${entry.text}`;
+  return `${SPINNER_FRAMES2[frame]} ${entry.text}`;
 }
 
 // src/commands/review/MultiSpinner.ts
-var TICK_MS = 80;
+var TICK_MS2 = 80;
 var MultiSpinner = class {
   entries = [];
   log = createLogUpdate2(process.stdout);
@@ -18943,9 +19016,9 @@ var MultiSpinner = class {
     if (this.timer || this.finished) return;
     this.render();
     this.timer = setInterval(() => {
-      this.frame = (this.frame + 1) % SPINNER_FRAMES.length;
+      this.frame = (this.frame + 1) % SPINNER_FRAMES2.length;
       this.render();
-    }, TICK_MS);
+    }, TICK_MS2);
   }
   render() {
     this.log(renderEntries(this.entries, this.frame));
@@ -20506,7 +20579,7 @@ function askQuestion(rl, question) {
 }
 
 // src/commands/transcript/configure.ts
-function buildPrompt(label2, current) {
+function buildPrompt2(label2, current) {
   return current ? `${label2} [${current}]: ` : `${label2}: `;
 }
 function printExisting(existing) {
@@ -20519,15 +20592,15 @@ function printExisting(existing) {
 async function promptDirectories(rl, existing) {
   const vttDir = await askQuestion(
     rl,
-    buildPrompt("VTT directory", existing?.vttDir)
+    buildPrompt2("VTT directory", existing?.vttDir)
   );
   const transcriptsDir = await askQuestion(
     rl,
-    buildPrompt("Transcripts directory", existing?.transcriptsDir)
+    buildPrompt2("Transcripts directory", existing?.transcriptsDir)
   );
   const summaryDir = await askQuestion(
     rl,
-    buildPrompt("Summary directory", existing?.summaryDir)
+    buildPrompt2("Summary directory", existing?.summaryDir)
   );
   return {
     vttDir: vttDir || existing?.vttDir || "",
@@ -24871,7 +24944,7 @@ function summariseSession(jsonlPath2) {
   if (!firstMessage && backlogIds.length === 0) {
     return void 0;
   }
-  const prompt = buildPrompt2(firstMessage, backlogIds);
+  const prompt = buildPrompt3(firstMessage, backlogIds);
   try {
     const output = execFileSync10("claude", ["-p", "--model", "haiku", prompt], {
       encoding: "utf8",
@@ -24885,7 +24958,7 @@ function summariseSession(jsonlPath2) {
     return void 0;
   }
 }
-function buildPrompt2(firstMessage, backlogIds) {
+function buildPrompt3(firstMessage, backlogIds) {
   const parts = [
     "Summarise this Claude Code session in ONE short sentence (under 100 chars).",
     "Return ONLY the summary, no quotes or explanation."

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.374.2",
+	"version": "0.376.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {