@staff0rd/assist 0.236.0 → 0.238.0

package/README.md

@@ -107,7 +107,7 @@ The first backlog command in a repository that still has a local `.assist/backlo
 
 - `assist backlog [--dir <path>]` - Open the backlog tab in the web dashboard (same as `backlog web`). `--dir` overrides the directory used to resolve the current repository's git origin
 - `assist backlog init` - Create an empty backlog
-- `assist backlog list [--status <type>] [-a, --all] [--all-repos] [-v]` - List backlog items with status icons (alias: `ls`). Defaults to the current repository's todo/in-progress items; `--all` includes done/wontdo, `--all-repos` lists items across all repositories
+- `assist backlog list [--status <type>] [-a, --all] [--all-repos] [-v]` - List backlog items with status icons (alias: `ls`). Defaults to the current repository's todo/in-progress items; `--all` includes done/wontdo, `--all-repos` lists items across all repositories. Also available as the top-level shortcut `assist list` / `assist ls` with the same flags
 - `assist backlog add` - Add a new backlog item interactively (prompts for type: story/bug)
 - `assist backlog add --name <n> --type <t> --desc <d> --ac <criterion...>` - Add a backlog item from CLI options (used by `/draft`)
 - `assist backlog add-phase <id> <name> --task <t...> [--manual-check <c...>] [--position <pos>]` - Add a phase (appends by default; `--position` inserts at a 1-indexed position)
@@ -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/allowed.cli-reads

@@ -33,6 +33,8 @@ assist dotnet
 assist jira ac
 assist jira auth
 assist jira view
+assist list
+assist ls
 assist news
 assist prs list-comments
 assist ravendb auth list

package/dist/allowed.cli-reads

@@ -33,6 +33,8 @@ assist dotnet
 assist jira ac
 assist jira auth
 assist jira view
+assist list
+assist ls
 assist news
 assist prs list-comments
 assist ravendb auth list

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.236.0",
+  version: "0.238.0",
   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"));
@@ -9686,6 +9688,17 @@ function registerLaunch(program2) {
   program2.command("refine").argument("[id]", "Backlog item ID").description("Launch Claude in /refine mode to refine a backlog item").action((id) => refine(id));
 }
 
+// src/commands/registerList.ts
+function registerList(program2) {
+  program2.command("list").alias("ls").description("Alias for backlog list").option(
+    "--status <type>",
+    "Filter by status (todo, in-progress, done, wontdo)"
+  ).option("-a, --all", "Include done/wontdo items").option("--all-repos", "List items across all repositories").option("-v, --verbose", "Show all item details").option("--dir <path>", "Override directory for backlog file discovery").action((options2) => {
+    setBacklogDir(options2.dir);
+    return list2(options2);
+  });
+}
+
 // src/commands/mermaid/index.ts
 import { mkdirSync as mkdirSync8, readdirSync as readdirSync5 } from "fs";
 import { resolve as resolve10 } from "path";
@@ -17093,6 +17106,7 @@ registerMermaid(program);
 registerPrs(program);
 registerRoam(program);
 registerBacklog(program);
+registerList(program);
 registerVerify(program);
 registerRefactor(program);
 registerReview(program);

package/package.json

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