@staff0rd/assist 0.237.0 → 0.238.1

package/README.md

@@ -116,7 +116,7 @@ The first backlog command in a repository that still has a local `.assist/backlo
 - `assist backlog update-phase <id> <phase> [--name <n>] [--task <t...>] [--manual-check <c...>]` - Modify a plan phase (name, tasks, or manual checks)
 - `assist backlog update-phase <id> <phase> [--add-task <text>] [--edit-task <n> <text>] [--remove-task <n>] [--add-check <text>] [--edit-check <n> <text>] [--remove-check <n>]` - Granular task and manual-check edits using 1-based indices matching `backlog show`: `--add-*` appends (repeatable), `--edit-*` replaces entry n in place, `--remove-*` deletes entry n and renumbers the rest (task ops cannot be combined with `--task`; check ops cannot be combined with `--manual-check`)
 - `assist backlog remove-phase <id> <phase>` - Remove a plan phase from a backlog item
-- `assist backlog next` - Pick and run the next backlog item, or open `/draft` if none remain
+- `assist backlog next [id]` - Pick and run the next backlog item, or open `/draft` if none remain; pass an `id` to run that item first, then continue chaining
 - `assist backlog refine [id]` - Alias for `refine`
 - `assist backlog start <id>` - Set a backlog item to in-progress
 - `assist backlog stop` - Revert all in-progress backlog items to todo and reset their phase to 1
@@ -237,7 +237,7 @@ The first backlog command in a repository that still has a local `.assist/backlo
 - `assist sessions` - Start the web dashboard (same as `sessions web`)
 - `assist sessions web [-p, --port <number>]` - Start the web dashboard with Sessions and Backlog tabs, xterm.js terminals (default port 3100)
 - `assist sessions summarise [-f, --force] [-n, --limit <count>]` - Generate one-line summaries for unsummarised Claude sessions (force re-generates all; limit caps how many to process)
-- `assist next` - Alias for `backlog next`
+- `assist next [id]` - Alias for `backlog next [id]`
 - `assist draft` (alias: `feat`) - Launch Claude in `/draft` mode, chain into next on `/next` signal
 - `assist bug` - Launch Claude in `/bug` mode, chain into next on `/next` signal
 - `assist refine [id]` - Launch Claude in `/refine` mode to refine a backlog item; prompts for selection when no id given

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.237.0",
+  version: "0.238.1",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -3798,12 +3798,14 @@ async function pickItem(items2, firstPick = false) {
   const todo = items2.filter((i) => i.status === "todo");
   return selectItem(todo, items2);
 }
-async function next(options2) {
+async function next(options2, startId) {
   if (blockedByHandover()) return;
   pullIfConfigured();
+  let pendingId = startId;
   let firstPick = true;
   while (true) {
-    const id = await pickItem(await loadBacklog(), firstPick);
+    const id = pendingId ?? await pickItem(await loadBacklog(), firstPick);
+    pendingId = void 0;
     firstPick = false;
     if (id === void 0) return;
     const completed = await run2(id, options2);
@@ -6330,8 +6332,8 @@ function registerRefineCommand(cmd) {
   cmd.command("refine").argument("[id]", "Backlog item ID").description("Alias for refine").action((id) => refine(id));
 }
 function registerNextCommand(cmd) {
-  cmd.command("next").description("Pick and run the next backlog item, or open /draft if none").option("-w, --write", "Run Claude with auto permission mode (default)").option("--no-write", "Run Claude without auto permission mode").action(
-    (opts) => next({ allowEdits: opts.write !== false })
+  cmd.command("next").argument("[id]", "Backlog item ID to run first").description("Pick and run the next backlog item, or open /draft if none").option("-w, --write", "Run Claude with auto permission mode (default)").option("--no-write", "Run Claude without auto permission mode").action(
+    (id, opts) => next({ allowEdits: opts.write !== false }, id)
   );
 }
 var registrars = [
@@ -9677,7 +9679,7 @@ async function reviewComments(number) {
 
 // src/commands/registerLaunch.ts
 function registerLaunch(program2) {
-  program2.command("next").description("Alias for backlog next").action(() => next({ allowEdits: true }));
+  program2.command("next").argument("[id]", "Backlog item ID to run first").description("Alias for backlog next").action((id) => next({ allowEdits: true }, id));
   program2.command("draft").alias("feat").description(
     "Launch Claude in /draft mode, chain into next on /next signal"
   ).action(() => launchMode("draft"));
@@ -11405,14 +11407,42 @@ import path36 from "path";
 import chalk132 from "chalk";
 
 // src/commands/refactor/extract/applyExtraction.ts
-import { SyntaxKind as SyntaxKind3 } from "ts-morph";
+import { SyntaxKind as SyntaxKind4 } from "ts-morph";
+
+// src/commands/refactor/extract/addImportPreservingSuppressions.ts
+import {
+  SyntaxKind as SyntaxKind2
+} from "ts-morph";
+var suppressionPattern = /^\s*(\/\/|\/\*)\s*biome-ignore(-all)?\b/;
+function countLeadingSuppressions(sourceFile) {
+  let count6 = 0;
+  for (const stmt of sourceFile.getStatementsWithComments()) {
+    const kind = stmt.getKind();
+    if ((kind === SyntaxKind2.SingleLineCommentTrivia || kind === SyntaxKind2.MultiLineCommentTrivia) && suppressionPattern.test(stmt.getText())) {
+      count6++;
+    } else {
+      break;
+    }
+  }
+  return count6;
+}
+function addImportPreservingSuppressions(sourceFile, structure) {
+  if (sourceFile.getImportDeclarations().length > 0) {
+    sourceFile.addImportDeclaration(structure);
+    return;
+  }
+  sourceFile.insertImportDeclaration(
+    countLeadingSuppressions(sourceFile),
+    structure
+  );
+}
 
 // src/commands/refactor/extract/removeStaleImports.ts
-import { SyntaxKind as SyntaxKind2 } from "ts-morph";
+import { SyntaxKind as SyntaxKind3 } from "ts-morph";
 function collectReferencedNames(sourceFile) {
   const names = /* @__PURE__ */ new Set();
-  for (const id of sourceFile.getDescendantsOfKind(SyntaxKind2.Identifier)) {
-    if (id.getFirstAncestorByKind(SyntaxKind2.ImportDeclaration)) continue;
+  for (const id of sourceFile.getDescendantsOfKind(SyntaxKind3.Identifier)) {
+    if (id.getFirstAncestorByKind(SyntaxKind3.ImportDeclaration)) continue;
     names.add(id.getText());
   }
   return names;
@@ -11455,7 +11485,7 @@ function updateImporters(functionName, sourceFile, importers) {
         importDecl.remove();
       }
     }
-    importerFile.addImportDeclaration({
+    addImportPreservingSuppressions(importerFile, {
       moduleSpecifier: relPath2,
       namedImports: [alias ? { name: functionName, alias } : functionName]
     });
@@ -11464,7 +11494,7 @@ function updateImporters(functionName, sourceFile, importers) {
 
 // src/commands/refactor/extract/applyExtraction.ts
 function isNameReferencedInSource(sourceFile, name) {
-  return sourceFile.getDescendantsOfKind(SyntaxKind3.Identifier).some((id) => id.getText() === name);
+  return sourceFile.getDescendantsOfKind(SyntaxKind4.Identifier).some((id) => id.getText() === name);
 }
 async function applyExtraction(functionName, sourceFile, destPath, plan2, project) {
   project.createSourceFile(destPath, plan2.destContent, { overwrite: false });
@@ -11476,7 +11506,7 @@ async function applyExtraction(functionName, sourceFile, destPath, plan2, projec
   }
   removeStaleImports(sourceFile);
   if (isNameReferencedInSource(sourceFile, functionName)) {
-    sourceFile.addImportDeclaration({
+    addImportPreservingSuppressions(sourceFile, {
       moduleSpecifier: plan2.destRelPath,
       namedImports: [functionName]
     });
@@ -11505,19 +11535,19 @@ async function applyExtraction(functionName, sourceFile, destPath, plan2, projec
 
 // src/commands/refactor/extract/collectDependencies.ts
 import {
-  SyntaxKind as SyntaxKind7
+  SyntaxKind as SyntaxKind8
 } from "ts-morph";
 
 // src/commands/refactor/extract/collectPrivateFunctions.ts
-import { SyntaxKind as SyntaxKind4 } from "ts-morph";
+import { SyntaxKind as SyntaxKind5 } from "ts-morph";
 function isPrivate(fn) {
   return !fn.isExported() && !fn.isDefaultExport();
 }
 function getCalledFunctionNames(fn) {
   const names = /* @__PURE__ */ new Set();
-  for (const call of fn.getDescendantsOfKind(SyntaxKind4.CallExpression)) {
+  for (const call of fn.getDescendantsOfKind(SyntaxKind5.CallExpression)) {
     const expr = call.getExpression();
-    if (expr.getKind() === SyntaxKind4.Identifier) {
+    if (expr.getKind() === SyntaxKind5.Identifier) {
       names.add(expr.getText());
     }
   }
@@ -11545,10 +11575,10 @@ function collectPrivateFunctions(target, fnMap) {
 }
 
 // src/commands/refactor/extract/collectPrivateStatements.ts
-import { SyntaxKind as SyntaxKind5 } from "ts-morph";
+import { SyntaxKind as SyntaxKind6 } from "ts-morph";
 function getReferencedIdentifiers(fn) {
   const names = /* @__PURE__ */ new Set();
-  for (const id of fn.getDescendantsOfKind(SyntaxKind5.Identifier)) {
+  for (const id of fn.getDescendantsOfKind(SyntaxKind6.Identifier)) {
     names.add(id.getText());
   }
   return names;
@@ -11566,12 +11596,12 @@ function collectPrivateStatements(functions, stmtMap) {
 
 // src/commands/refactor/extract/getFunctionMap.ts
 import {
-  SyntaxKind as SyntaxKind6
+  SyntaxKind as SyntaxKind7
 } from "ts-morph";
 function getFunctionMap(sourceFile) {
   const map = /* @__PURE__ */ new Map();
   for (const fn of sourceFile.getDescendantsOfKind(
-    SyntaxKind6.FunctionDeclaration
+    SyntaxKind7.FunctionDeclaration
   )) {
     const name = fn.getName();
     if (name) map.set(name, fn);
@@ -11597,7 +11627,7 @@ function getPrivateStatementMap(sourceFile) {
 
 // src/commands/refactor/extract/collectDependencies.ts
 function getRemainingFunctions(sourceFile, extracted) {
-  return sourceFile.getDescendantsOfKind(SyntaxKind7.FunctionDeclaration).filter((fn) => !extracted.has(fn));
+  return sourceFile.getDescendantsOfKind(SyntaxKind8.FunctionDeclaration).filter((fn) => !extracted.has(fn));
 }
 function collectFnsUsedByRemaining(remaining, fnMap) {
   const used = /* @__PURE__ */ new Set();
@@ -11632,25 +11662,25 @@ function collectDependencies(target, sourceFile) {
 
 // src/commands/refactor/extract/findFunction.ts
 import {
-  SyntaxKind as SyntaxKind8
+  SyntaxKind as SyntaxKind9
 } from "ts-morph";
 function findFunction(sourceFile, functionName) {
-  return sourceFile.getDescendantsOfKind(SyntaxKind8.FunctionDeclaration).find((fn) => fn.getName() === functionName);
+  return sourceFile.getDescendantsOfKind(SyntaxKind9.FunctionDeclaration).find((fn) => fn.getName() === functionName);
 }
 
 // src/commands/refactor/extract/getExportedDependencyNames.ts
-import { SyntaxKind as SyntaxKind9 } from "ts-morph";
+import { SyntaxKind as SyntaxKind10 } from "ts-morph";
 function getExportedDependencyNames(target, sourceFile) {
   const calledNames = /* @__PURE__ */ new Set();
-  for (const call of target.getDescendantsOfKind(SyntaxKind9.CallExpression)) {
+  for (const call of target.getDescendantsOfKind(SyntaxKind10.CallExpression)) {
     const expr = call.getExpression();
-    if (expr.getKind() === SyntaxKind9.Identifier) {
+    if (expr.getKind() === SyntaxKind10.Identifier) {
       calledNames.add(expr.getText());
     }
   }
   const exported = [];
   for (const fn of sourceFile.getDescendantsOfKind(
-    SyntaxKind9.FunctionDeclaration
+    SyntaxKind10.FunctionDeclaration
   )) {
     const name = fn.getName();
     if (name && calledNames.has(name) && fn.isExported()) {
@@ -11661,9 +11691,9 @@ function getExportedDependencyNames(target, sourceFile) {
 }
 
 // src/commands/refactor/extract/getStatementNames.ts
-import { SyntaxKind as SyntaxKind10 } from "ts-morph";
+import { SyntaxKind as SyntaxKind11 } from "ts-morph";
 function getStatementNames(node) {
-  if (node.getKind() === SyntaxKind10.VariableStatement) {
+  if (node.getKind() === SyntaxKind11.VariableStatement) {
     const stmt = node;
     return stmt.getDeclarations().map((d) => d.getName());
   }
@@ -11673,7 +11703,7 @@ function getStatementNames(node) {
 
 // src/commands/refactor/extract/resolveImports.ts
 import {
-  SyntaxKind as SyntaxKind11
+  SyntaxKind as SyntaxKind12
 } from "ts-morph";
 
 // src/commands/refactor/extract/matchImport.ts
@@ -11717,7 +11747,7 @@ function matchImport(importDecl, neededNames) {
 function getReferencedNames(nodes) {
   const names = /* @__PURE__ */ new Set();
   for (const node of nodes) {
-    for (const id of node.getDescendantsOfKind(SyntaxKind11.Identifier)) {
+    for (const id of node.getDescendantsOfKind(SyntaxKind12.Identifier)) {
       names.add(id.getText());
     }
   }
@@ -11732,7 +11762,7 @@ function getLocallyDeclaredNames(functions) {
       names.add(param.getName());
     }
     for (const varDecl of fn.getDescendantsOfKind(
-      SyntaxKind11.VariableDeclaration
+      SyntaxKind12.VariableDeclaration
     )) {
       names.add(varDecl.getName());
     }
@@ -11887,16 +11917,16 @@ function rewriteImportPaths(imports, sourcePath, destPath) {
 }
 
 // src/commands/refactor/extract/sourceReferencesName.ts
-import { SyntaxKind as SyntaxKind12 } from "ts-morph";
+import { SyntaxKind as SyntaxKind13 } from "ts-morph";
 var DECLARATION_KINDS = /* @__PURE__ */ new Set([
-  SyntaxKind12.FunctionDeclaration,
-  SyntaxKind12.ImportSpecifier,
-  SyntaxKind12.ExportSpecifier
+  SyntaxKind13.FunctionDeclaration,
+  SyntaxKind13.ImportSpecifier,
+  SyntaxKind13.ExportSpecifier
 ]);
 function isInsideExtractedFunction(node, extracted) {
   let current = node;
   while (current) {
-    if (current.getKind() !== SyntaxKind12.FunctionDeclaration) {
+    if (current.getKind() !== SyntaxKind13.FunctionDeclaration) {
       current = current.getParent();
       continue;
     }
@@ -11908,7 +11938,7 @@ function isInsideExtractedFunction(node, extracted) {
 }
 function sourceReferencesName(sourceFile, functionName, extractedNames) {
   const extracted = new Set(extractedNames);
-  for (const id of sourceFile.getDescendantsOfKind(SyntaxKind12.Identifier)) {
+  for (const id of sourceFile.getDescendantsOfKind(SyntaxKind13.Identifier)) {
     if (id.getText() !== functionName) continue;
     const parent = id.getParent();
     if (!parent || DECLARATION_KINDS.has(parent.getKind())) continue;
@@ -12139,24 +12169,24 @@ async function rename(source, destination, options2 = {}) {
 import chalk135 from "chalk";
 
 // src/commands/refactor/renameSymbol/findSymbol.ts
-import { SyntaxKind as SyntaxKind13 } from "ts-morph";
+import { SyntaxKind as SyntaxKind14 } from "ts-morph";
 var declarationKinds = [
-  SyntaxKind13.VariableDeclaration,
-  SyntaxKind13.FunctionDeclaration,
-  SyntaxKind13.ClassDeclaration,
-  SyntaxKind13.InterfaceDeclaration,
-  SyntaxKind13.TypeAliasDeclaration,
-  SyntaxKind13.EnumDeclaration,
-  SyntaxKind13.PropertyDeclaration,
-  SyntaxKind13.MethodDeclaration,
-  SyntaxKind13.Parameter
+  SyntaxKind14.VariableDeclaration,
+  SyntaxKind14.FunctionDeclaration,
+  SyntaxKind14.ClassDeclaration,
+  SyntaxKind14.InterfaceDeclaration,
+  SyntaxKind14.TypeAliasDeclaration,
+  SyntaxKind14.EnumDeclaration,
+  SyntaxKind14.PropertyDeclaration,
+  SyntaxKind14.MethodDeclaration,
+  SyntaxKind14.Parameter
 ];
 function isDeclaration(identifier) {
   const parent = identifier.getParent();
   return parent !== void 0 && declarationKinds.includes(parent.getKind());
 }
 function findSymbol(sourceFile, symbolName) {
-  for (const id of sourceFile.getDescendantsOfKind(SyntaxKind13.Identifier)) {
+  for (const id of sourceFile.getDescendantsOfKind(SyntaxKind14.Identifier)) {
     if (id.getText() === symbolName && isDeclaration(id)) return id;
   }
   return void 0;

package/package.json

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