@staff0rd/assist 0.54.0 → 0.56.0

package/README.md

@@ -32,6 +32,7 @@ After installation, the `assist` command will be available globally.
 
 - `/commit` - Commit only relevant files from the session
 - `/devlog` - Generate devlog entry for the next unversioned day
+- `/next-backlog-item` - Pick and implement the next backlog item
 - `/refactor` - Run refactoring checks for code quality
 - `/restructure` - Analyze and restructure tightly-coupled files
 - `/review-comments` - Process PR review comments one by one

package/claude/commands/next-backlog-item.md

@@ -0,0 +1,17 @@
+---
+description: Pick and implement the next backlog item
+---
+
+Run `assist backlog list --status todo --verbose 2>&1` to see all available backlog items.
+
+Choose ONE item to implement. You may pick whichever item you like. Read the item's name, description, and acceptance criteria carefully. If anything is unclear or ambiguous, ask the user for clarification before proceeding.
+
+Once you have chosen an item, run `assist backlog start <id>` to mark it as in-progress.
+
+Implement the item fully, satisfying ALL acceptance criteria. Do not skip any.
+
+When implementation is complete, run `/verify` and fix any issues until it passes.
+
+Then stop and wait for the user. Do NOT call `assist backlog done` yet. Inform the user the item is ready and wait for them to call `/commit`.
+
+Only after the user has called `/commit` and the commit succeeds, run `assist backlog done <id>` to mark the item as done.

package/claude/settings.json

@@ -20,6 +20,9 @@
 			"Bash(assist refactor:*)",
 			"Bash(assist prs list-comments:*)",
 			"Bash(assist verify:*)",
+			"Bash(assist backlog list:*)",
+			"Bash(assist backlog start:*)",
+			"Bash(assist backlog done:*)",
 			"Bash(assist transcript summarise:*)",
 			"Bash(assist transcript format:*)",
 			"Bash(git add:*)",
@@ -30,6 +33,7 @@
 			"Bash(gh pr view:*)",
 			"Bash(gh pr diff:*)",
 			"Bash(gh run view:*)",
+			"SlashCommand(/next-backlog-item)",
 			"SlashCommand(/verify)",
 			"SlashCommand(/commit)",
 			"SlashCommand(/devlog)",
@@ -37,6 +41,7 @@
 			"SlashCommand(/review-comments)",
 			"SlashCommand(/transcript-format)",
 			"SlashCommand(/transcript-summarise)",
+			"Skill(next-backlog-item)",
 			"Skill(verify)",
 			"Skill(commit)",
 			"Skill(devlog)",

package/dist/index.js

@@ -7,7 +7,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.54.0",
+  version: "0.56.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -1874,6 +1874,10 @@ function getNextId(items) {
 }
 
 // src/commands/backlog/add/shared.ts
+import { spawnSync } from "child_process";
+import { mkdtempSync, readFileSync as readFileSync10, unlinkSync as unlinkSync2, writeFileSync as writeFileSync11 } from "fs";
+import { tmpdir } from "os";
+import { join as join9 } from "path";
 import enquirer4 from "enquirer";
 async function promptName() {
   const { name } = await enquirer4.prompt({
@@ -1885,12 +1889,35 @@ async function promptName() {
   return name.trim();
 }
 async function promptDescription() {
-  const { description } = await enquirer4.prompt({
-    type: "input",
-    name: "description",
-    message: "Description (optional):"
+  const { useEditor } = await enquirer4.prompt({
+    type: "confirm",
+    name: "useEditor",
+    message: "Open editor for description?",
+    initial: false
   });
-  return description.trim() || void 0;
+  if (!useEditor) {
+    const { description } = await enquirer4.prompt({
+      type: "input",
+      name: "description",
+      message: "Description (optional):"
+    });
+    return description.trim() || void 0;
+  }
+  return openEditor();
+}
+function openEditor() {
+  const editor = process.env.EDITOR || process.env.VISUAL || "vi";
+  const dir = mkdtempSync(join9(tmpdir(), "assist-"));
+  const filePath = join9(dir, "description.md");
+  writeFileSync11(filePath, "");
+  const result = spawnSync(editor, [filePath], { stdio: "inherit" });
+  if (result.status !== 0) {
+    unlinkSync2(filePath);
+    return void 0;
+  }
+  const content = readFileSync10(filePath, "utf-8").trim();
+  unlinkSync2(filePath);
+  return content || void 0;
 }
 async function promptAcceptanceCriteria() {
   const criteria = [];
@@ -2510,7 +2537,7 @@ function registerComplexity(program2) {
 }
 
 // src/commands/deploy/redirect.ts
-import { existsSync as existsSync15, readFileSync as readFileSync10, writeFileSync as writeFileSync11 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync11, writeFileSync as writeFileSync12 } from "fs";
 import chalk34 from "chalk";
 var TRAILING_SLASH_SCRIPT = `    <script>
       if (!window.location.pathname.endsWith('/')) {
@@ -2523,7 +2550,7 @@ function redirect() {
     console.log(chalk34.yellow("No index.html found"));
     return;
   }
-  const content = readFileSync10(indexPath, "utf-8");
+  const content = readFileSync11(indexPath, "utf-8");
   if (content.includes("window.location.pathname.endsWith('/')")) {
     console.log(chalk34.dim("Trailing slash script already present"));
     return;
@@ -2534,7 +2561,7 @@ function redirect() {
     return;
   }
   const newContent = content.slice(0, headCloseIndex) + TRAILING_SLASH_SCRIPT + "\n  " + content.slice(headCloseIndex);
-  writeFileSync11(indexPath, newContent);
+  writeFileSync12(indexPath, newContent);
   console.log(chalk34.green("Added trailing slash redirect to index.html"));
 }
 
@@ -2554,16 +2581,16 @@ import { execSync as execSync11 } from "child_process";
 import chalk35 from "chalk";
 
 // src/commands/devlog/loadDevlogEntries.ts
-import { readdirSync, readFileSync as readFileSync11 } from "fs";
+import { readdirSync, readFileSync as readFileSync12 } from "fs";
 import { homedir } from "os";
-import { join as join9 } from "path";
-var DEVLOG_DIR = join9(homedir(), "git/blog/src/content/devlog");
+import { join as join10 } from "path";
+var DEVLOG_DIR = join10(homedir(), "git/blog/src/content/devlog");
 function loadDevlogEntries(repoName) {
   const entries = /* @__PURE__ */ new Map();
   try {
     const files = readdirSync(DEVLOG_DIR).filter((f) => f.endsWith(".md"));
     for (const file of files) {
-      const content = readFileSync11(join9(DEVLOG_DIR, file), "utf-8");
+      const content = readFileSync12(join10(DEVLOG_DIR, file), "utf-8");
       const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
       if (frontmatterMatch) {
         const frontmatter = frontmatterMatch[1];
@@ -2918,29 +2945,29 @@ import { execSync as execSync17 } from "child_process";
 
 // src/commands/prs/resolveCommentWithReply.ts
 import { execSync as execSync16 } from "child_process";
-import { unlinkSync as unlinkSync3, writeFileSync as writeFileSync12 } from "fs";
-import { tmpdir } from "os";
-import { join as join11 } from "path";
+import { unlinkSync as unlinkSync4, writeFileSync as writeFileSync13 } from "fs";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join12 } from "path";
 
 // src/commands/prs/loadCommentsCache.ts
-import { existsSync as existsSync16, readFileSync as readFileSync12, unlinkSync as unlinkSync2 } from "fs";
-import { join as join10 } from "path";
+import { existsSync as existsSync16, readFileSync as readFileSync13, unlinkSync as unlinkSync3 } from "fs";
+import { join as join11 } from "path";
 import { parse } from "yaml";
 function getCachePath(prNumber) {
-  return join10(process.cwd(), ".assist", `pr-${prNumber}-comments.yaml`);
+  return join11(process.cwd(), ".assist", `pr-${prNumber}-comments.yaml`);
 }
 function loadCommentsCache(prNumber) {
   const cachePath = getCachePath(prNumber);
   if (!existsSync16(cachePath)) {
     return null;
   }
-  const content = readFileSync12(cachePath, "utf-8");
+  const content = readFileSync13(cachePath, "utf-8");
   return parse(content);
 }
 function deleteCommentsCache(prNumber) {
   const cachePath = getCachePath(prNumber);
   if (existsSync16(cachePath)) {
-    unlinkSync2(cachePath);
+    unlinkSync3(cachePath);
     console.log("No more unresolved line comments. Cache dropped.");
   }
 }
@@ -2990,15 +3017,15 @@ function replyToComment(org, repo, prNumber, commentId, message) {
 }
 function resolveThread(threadId) {
   const mutation = `mutation($threadId: ID!) { resolveReviewThread(input: {threadId: $threadId}) { thread { isResolved } } }`;
-  const queryFile = join11(tmpdir(), `gh-mutation-${Date.now()}.graphql`);
-  writeFileSync12(queryFile, mutation);
+  const queryFile = join12(tmpdir2(), `gh-mutation-${Date.now()}.graphql`);
+  writeFileSync13(queryFile, mutation);
   try {
     execSync16(
       `gh api graphql -F query=@${queryFile} -f threadId="${threadId}"`,
       { stdio: "inherit" }
     );
   } finally {
-    unlinkSync3(queryFile);
+    unlinkSync4(queryFile);
   }
 }
 function requireCache(prNumber) {
@@ -3071,8 +3098,8 @@ function fixed(commentId, sha) {
 }
 
 // src/commands/prs/listComments/index.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync4, writeFileSync as writeFileSync14 } from "fs";
-import { join as join13 } from "path";
+import { existsSync as existsSync17, mkdirSync as mkdirSync4, writeFileSync as writeFileSync15 } from "fs";
+import { join as join14 } from "path";
 import { stringify } from "yaml";
 
 // src/lib/isClaudeCode.ts
@@ -3082,13 +3109,13 @@ function isClaudeCode() {
 
 // src/commands/prs/fetchThreadIds.ts
 import { execSync as execSync18 } from "child_process";
-import { unlinkSync as unlinkSync4, writeFileSync as writeFileSync13 } from "fs";
-import { tmpdir as tmpdir2 } from "os";
-import { join as join12 } from "path";
+import { unlinkSync as unlinkSync5, writeFileSync as writeFileSync14 } from "fs";
+import { tmpdir as tmpdir3 } from "os";
+import { join as join13 } from "path";
 var THREAD_QUERY = `query($owner: String!, $repo: String!, $prNumber: Int!) { repository(owner: $owner, name: $repo) { pullRequest(number: $prNumber) { reviewThreads(first: 100) { nodes { id isResolved comments(first: 100) { nodes { databaseId } } } } } } }`;
 function fetchThreadIds(org, repo, prNumber) {
-  const queryFile = join12(tmpdir2(), `gh-query-${Date.now()}.graphql`);
-  writeFileSync13(queryFile, THREAD_QUERY);
+  const queryFile = join13(tmpdir3(), `gh-query-${Date.now()}.graphql`);
+  writeFileSync14(queryFile, THREAD_QUERY);
   try {
     const result = execSync18(
       `gh api graphql -F query=@${queryFile} -F owner="${org}" -F repo="${repo}" -F prNumber=${prNumber}`,
@@ -3107,7 +3134,7 @@ function fetchThreadIds(org, repo, prNumber) {
     }
     return { threadMap, resolvedThreadIds };
   } finally {
-    unlinkSync4(queryFile);
+    unlinkSync5(queryFile);
   }
 }
 
@@ -3190,7 +3217,7 @@ function printComments(comments) {
   }
 }
 function writeCommentsCache(prNumber, comments) {
-  const assistDir = join13(process.cwd(), ".assist");
+  const assistDir = join14(process.cwd(), ".assist");
   if (!existsSync17(assistDir)) {
     mkdirSync4(assistDir, { recursive: true });
   }
@@ -3199,8 +3226,8 @@ function writeCommentsCache(prNumber, comments) {
     fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
     comments
   };
-  const cachePath = join13(assistDir, `pr-${prNumber}-comments.yaml`);
-  writeFileSync14(cachePath, stringify(cacheData));
+  const cachePath = join14(assistDir, `pr-${prNumber}-comments.yaml`);
+  writeFileSync15(cachePath, stringify(cacheData));
 }
 function handleKnownErrors(error) {
   if (isGhNotInstalled(error)) {
@@ -4162,7 +4189,7 @@ function registerRefactor(program2) {
 
 // src/commands/transcript/shared.ts
 import { existsSync as existsSync18, readdirSync as readdirSync2, statSync } from "fs";
-import { basename as basename4, join as join14, relative } from "path";
+import { basename as basename4, join as join15, relative } from "path";
 import * as readline2 from "readline";
 var DATE_PREFIX_REGEX = /^\d{4}-\d{2}-\d{2}/;
 function getDatePrefix(daysOffset = 0) {
@@ -4180,7 +4207,7 @@ function collectFiles(dir, extension) {
   if (!existsSync18(dir)) return [];
   const results = [];
   for (const entry of readdirSync2(dir)) {
-    const fullPath = join14(dir, entry);
+    const fullPath = join15(dir, entry);
     if (statSync(fullPath).isDirectory()) {
       results.push(...collectFiles(fullPath, extension));
     } else if (entry.endsWith(extension)) {
@@ -4277,11 +4304,11 @@ async function configure() {
 import { existsSync as existsSync20 } from "fs";
 
 // src/commands/transcript/format/fixInvalidDatePrefixes/index.ts
-import { dirname as dirname12, join as join16 } from "path";
+import { dirname as dirname12, join as join17 } from "path";
 
 // src/commands/transcript/format/fixInvalidDatePrefixes/promptForDateFix.ts
 import { renameSync } from "fs";
-import { join as join15 } from "path";
+import { join as join16 } from "path";
 async function resolveDate(rl, choice) {
   if (choice === "1") return getDatePrefix(0);
   if (choice === "2") return getDatePrefix(-1);
@@ -4296,7 +4323,7 @@ async function resolveDate(rl, choice) {
 }
 function renameWithPrefix(vttDir, vttFile, prefix) {
   const newFilename = `${prefix}.${vttFile}`;
-  renameSync(join15(vttDir, vttFile), join15(vttDir, newFilename));
+  renameSync(join16(vttDir, vttFile), join16(vttDir, newFilename));
   console.log(`Renamed to: ${newFilename}`);
   return newFilename;
 }
@@ -4330,12 +4357,12 @@ async function fixInvalidDatePrefixes(vttFiles) {
       const vttFileDir = dirname12(vttFile.absolutePath);
       const newFilename = await promptForDateFix(vttFile.filename, vttFileDir);
       if (newFilename) {
-        const newRelativePath = join16(
+        const newRelativePath = join17(
           dirname12(vttFile.relativePath),
           newFilename
         );
         vttFiles[i] = {
-          absolutePath: join16(vttFileDir, newFilename),
+          absolutePath: join17(vttFileDir, newFilename),
           relativePath: newRelativePath,
           filename: newFilename
         };
@@ -4348,8 +4375,8 @@ async function fixInvalidDatePrefixes(vttFiles) {
 }
 
 // src/commands/transcript/format/processVttFile/index.ts
-import { existsSync as existsSync19, mkdirSync as mkdirSync5, readFileSync as readFileSync13, writeFileSync as writeFileSync15 } from "fs";
-import { basename as basename5, dirname as dirname13, join as join17 } from "path";
+import { existsSync as existsSync19, mkdirSync as mkdirSync5, readFileSync as readFileSync14, writeFileSync as writeFileSync16 } from "fs";
+import { basename as basename5, dirname as dirname13, join as join18 } from "path";
 
 // src/commands/transcript/cleanText.ts
 function cleanText(text) {
@@ -4559,17 +4586,17 @@ function toMdFilename(vttFilename) {
   return `${basename5(vttFilename, ".vtt").replace(/\s*Transcription\s*/g, " ").trim()}.md`;
 }
 function resolveOutputDir(relativeDir, transcriptsDir) {
-  return relativeDir === "." ? transcriptsDir : join17(transcriptsDir, relativeDir);
+  return relativeDir === "." ? transcriptsDir : join18(transcriptsDir, relativeDir);
 }
 function buildOutputPaths(vttFile, transcriptsDir) {
   const mdFile = toMdFilename(vttFile.filename);
   const relativeDir = dirname13(vttFile.relativePath);
   const outputDir = resolveOutputDir(relativeDir, transcriptsDir);
-  const outputPath = join17(outputDir, mdFile);
+  const outputPath = join18(outputDir, mdFile);
   return { outputDir, outputPath, mdFile, relativeDir };
 }
 function logSkipped(relativeDir, mdFile) {
-  console.log(`Skipping (already exists): ${join17(relativeDir, mdFile)}`);
+  console.log(`Skipping (already exists): ${join18(relativeDir, mdFile)}`);
   return "skipped";
 }
 function ensureDirectory(dir, label) {
@@ -4596,10 +4623,10 @@ function logReduction(cueCount, messageCount) {
 }
 function readAndParseCues(inputPath) {
   console.log(`Reading: ${inputPath}`);
-  return processCues(readFileSync13(inputPath, "utf-8"));
+  return processCues(readFileSync14(inputPath, "utf-8"));
 }
 function writeFormatted(outputPath, content) {
-  writeFileSync15(outputPath, content, "utf-8");
+  writeFileSync16(outputPath, content, "utf-8");
   console.log(`Written: ${outputPath}`);
 }
 function convertVttToMarkdown(inputPath, outputPath) {
@@ -4668,17 +4695,17 @@ async function format() {
 
 // src/commands/transcript/summarise/index.ts
 import { existsSync as existsSync22 } from "fs";
-import { basename as basename6, dirname as dirname15, join as join19, relative as relative2 } from "path";
+import { basename as basename6, dirname as dirname15, join as join20, relative as relative2 } from "path";
 
 // src/commands/transcript/summarise/processStagedFile/index.ts
 import {
   existsSync as existsSync21,
   mkdirSync as mkdirSync6,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync15,
   renameSync as renameSync2,
   rmSync
 } from "fs";
-import { dirname as dirname14, join as join18 } from "path";
+import { dirname as dirname14, join as join19 } from "path";
 
 // src/commands/transcript/summarise/processStagedFile/validateStagedContent.ts
 import chalk48 from "chalk";
@@ -4707,7 +4734,7 @@ function validateStagedContent(filename, content) {
 }
 
 // src/commands/transcript/summarise/processStagedFile/index.ts
-var STAGING_DIR = join18(process.cwd(), ".assist", "transcript");
+var STAGING_DIR = join19(process.cwd(), ".assist", "transcript");
 function processStagedFile() {
   if (!existsSync21(STAGING_DIR)) {
     return false;
@@ -4718,7 +4745,7 @@ function processStagedFile() {
   }
   const { transcriptsDir, summaryDir } = getTranscriptConfig();
   const stagedFile = stagedFiles[0];
-  const content = readFileSync14(stagedFile.absolutePath, "utf-8");
+  const content = readFileSync15(stagedFile.absolutePath, "utf-8");
   validateStagedContent(stagedFile.filename, content);
   const stagedBaseName = getTranscriptBaseName(stagedFile.filename);
   const transcriptFiles = findMdFilesRecursive(transcriptsDir);
@@ -4731,7 +4758,7 @@ function processStagedFile() {
     );
     process.exit(1);
   }
-  const destPath = join18(summaryDir, matchingTranscript.relativePath);
+  const destPath = join19(summaryDir, matchingTranscript.relativePath);
   const destDir = dirname14(destPath);
   if (!existsSync21(destDir)) {
     mkdirSync6(destDir, { recursive: true });
@@ -4747,7 +4774,7 @@ function processStagedFile() {
 // src/commands/transcript/summarise/index.ts
 function buildRelativeKey(relativePath, baseName) {
   const relDir = dirname15(relativePath);
-  return relDir === "." ? baseName : join19(relDir, baseName);
+  return relDir === "." ? baseName : join20(relDir, baseName);
 }
 function buildSummaryIndex(summaryDir) {
   const summaryFiles = findMdFilesRecursive(summaryDir);
@@ -4781,8 +4808,8 @@ function summarise() {
   }
   const next2 = missing[0];
   const outputFilename = `${getTranscriptBaseName(next2.filename)}.md`;
-  const outputPath = join19(STAGING_DIR, outputFilename);
-  const summaryFileDir = join19(summaryDir, dirname15(next2.relativePath));
+  const outputPath = join20(STAGING_DIR, outputFilename);
+  const summaryFileDir = join20(summaryDir, dirname15(next2.relativePath));
   const relativeTranscriptPath = encodeURI(
     relative2(summaryFileDir, next2.absolutePath).replace(/\\/g, "/")
   );

package/package.json

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