@joshski/dust 0.1.29 → 0.1.30

package/dist/dust.js

@@ -572,8 +572,15 @@ function validateIdeaOpenQuestions(filePath, content) {
 `);
   let inOpenQuestions = false;
   let currentQuestionLine = null;
+  let inCodeBlock = false;
   for (let i = 0;i < lines.length; i++) {
     const line = lines[i];
+    if (line.startsWith("```")) {
+      inCodeBlock = !inCodeBlock;
+      continue;
+    }
+    if (inCodeBlock)
+      continue;
     if (line.startsWith("## ")) {
       if (inOpenQuestions && currentQuestionLine !== null) {
         violations.push({
@@ -588,6 +595,14 @@ function validateIdeaOpenQuestions(filePath, content) {
     }
     if (!inOpenQuestions)
       continue;
+    if (/^[-*] /.test(line.trimStart())) {
+      violations.push({
+        file: filePath,
+        message: "Open Questions must use ### headings for questions and #### headings for options, not bullet points. Run `dust new idea` to see the expected format.",
+        line: i + 1
+      });
+      continue;
+    }
     if (line.startsWith("### ")) {
       if (currentQuestionLine !== null) {
         violations.push({
@@ -1142,14 +1157,34 @@ async function check(dependencies, shellRunner = defaultShellRunner) {
 
 // lib/cli/commands/focus.ts
 async function focus(dependencies) {
-  const { context } = dependencies;
+  const { context, settings } = dependencies;
   const objective = dependencies.arguments.join(" ").trim();
   if (!objective) {
     context.stderr("Error: No objective provided");
     context.stderr('Usage: dust focus "your objective here"');
     return { exitCode: 1 };
   }
+  const hooksInstalled = await manageGitHooks(dependencies);
+  const vars = templateVariables(settings, hooksInstalled);
   context.stdout(`\uD83C\uDFAF Focus: ${objective}`);
+  context.stdout("");
+  const steps = [];
+  let step = 1;
+  steps.push(`${step}. Run \`${vars.bin} check\` to verify the project is in a good state`);
+  step++;
+  steps.push(`${step}. Implement the task`);
+  step++;
+  if (!hooksInstalled) {
+    steps.push(`${step}. Run \`${vars.bin} check\` before committing`);
+    step++;
+  }
+  steps.push(`${step}. Create a single atomic commit that includes:`, "   - All implementation changes", "   - Deletion of the completed task file", "   - Updates to any facts that changed", "   - Deletion of any ideas that were fully realized", "", '   Use the task title as the commit message. Task titles are written in imperative form, which is the recommended style for git commit messages. Do not add prefixes like "Complete task:" - use the title directly.', "", '   Example: If the task title is "Add validation for user input", the commit message should be:', "   ```", "   Add validation for user input", "   ```", "");
+  step++;
+  steps.push(`${step}. Push your commit to the remote repository`);
+  steps.push("");
+  steps.push("Keep your change small and focused. One task, one commit.");
+  context.stdout(steps.join(`
+`));
   return { exitCode: 0 };
 }
 
@@ -1162,17 +1197,14 @@ async function help(dependencies) {
   return { exitCode: 0 };
 }
 
-// lib/cli/template-command.ts
-var createTemplateCommand = (templateName) => async (dependencies) => {
+// lib/cli/commands/implement-task.ts
+async function implementTask(dependencies) {
   const { context, settings } = dependencies;
   const hooksInstalled = await manageGitHooks(dependencies);
   const vars = templateVariables(settings, hooksInstalled);
-  context.stdout(loadTemplate(templateName, vars));
+  context.stdout(`Run \`${vars.bin} focus "<task name>"\` to set your focus and see implementation instructions.`);
   return { exitCode: 0 };
-};
-
-// lib/cli/commands/implement-task.ts
-var implementTask = createTemplateCommand("agent-implement-task");
+}
 
 // lib/cli/colors.ts
 var ANSI_COLORS = {
@@ -1835,26 +1867,22 @@ function extractBlockedBy(content) {
   }
   return blockers;
 }
-async function next(dependencies) {
-  const { context, fileSystem } = dependencies;
-  const dustPath = `${context.cwd}/.dust`;
-  const colors = getColors();
+async function findUnblockedTasks(cwd, fileSystem) {
+  const dustPath = `${cwd}/.dust`;
   if (!fileSystem.exists(dustPath)) {
-    context.stderr("Error: .dust directory not found");
-    context.stderr("Run 'dust init' to initialize a Dust repository");
-    return { exitCode: 1 };
+    return { error: ".dust directory not found", tasks: [] };
   }
   const tasksPath = `${dustPath}/tasks`;
   if (!fileSystem.exists(tasksPath)) {
-    return { exitCode: 0 };
+    return { tasks: [] };
   }
   const files = await fileSystem.readdir(tasksPath);
   const mdFiles = files.filter((f) => f.endsWith(".md")).sort();
   if (mdFiles.length === 0) {
-    return { exitCode: 0 };
+    return { tasks: [] };
   }
   const existingTasks = new Set(mdFiles);
-  const unblockedTasks = [];
+  const tasks = [];
   for (const file of mdFiles) {
     const filePath = `${tasksPath}/${file}`;
     const content = await fileSystem.readFile(filePath);
@@ -1864,15 +1892,16 @@ async function next(dependencies) {
       const title = extractTitle(content);
       const openingSentence = extractOpeningSentence(content);
       const relativePath = `.dust/tasks/${file}`;
-      unblockedTasks.push({ path: relativePath, title, openingSentence });
+      tasks.push({ path: relativePath, title, openingSentence });
     }
   }
-  if (unblockedTasks.length === 0) {
-    return { exitCode: 0 };
-  }
+  return { tasks };
+}
+function printTaskList(context, tasks) {
+  const colors = getColors();
   context.stdout("\uD83D\uDCCB Next tasks");
   context.stdout("");
-  for (const task of unblockedTasks) {
+  for (const task of tasks) {
     const parts = task.path.split("/");
     const displayTitle = task.title || parts[parts.length - 1].replace(".md", "");
     context.stdout(`${colors.bold}# ${displayTitle}${colors.reset}`);
@@ -1882,6 +1911,19 @@ async function next(dependencies) {
     context.stdout(`${colors.cyan}→ ${task.path}${colors.reset}`);
     context.stdout("");
   }
+}
+async function next(dependencies) {
+  const { context, fileSystem } = dependencies;
+  const result = await findUnblockedTasks(context.cwd, fileSystem);
+  if (result.error) {
+    context.stderr(`Error: ${result.error}`);
+    context.stderr("Run 'dust init' to initialize a Dust repository");
+    return { exitCode: 1 };
+  }
+  if (result.tasks.length === 0) {
+    return { exitCode: 0 };
+  }
+  printTaskList(context, result.tasks);
   return { exitCode: 0 };
 }
 
@@ -2113,6 +2155,15 @@ async function loopClaude(dependencies, loopDependencies = createDefaultDependen
   return { exitCode: 0 };
 }
 
+// lib/cli/template-command.ts
+var createTemplateCommand = (templateName) => async (dependencies) => {
+  const { context, settings } = dependencies;
+  const hooksInstalled = await manageGitHooks(dependencies);
+  const vars = templateVariables(settings, hooksInstalled);
+  context.stdout(loadTemplate(templateName, vars));
+  return { exitCode: 0 };
+};
+
 // lib/cli/commands/new-goal.ts
 var newGoal = createTemplateCommand("agent-new-goal");
 
@@ -2123,7 +2174,26 @@ var newIdea = createTemplateCommand("agent-new-idea");
 var newTask = createTemplateCommand("agent-new-task");
 
 // lib/cli/commands/pick-task.ts
-var pickTask = createTemplateCommand("agent-pick-task");
+async function pickTask(dependencies) {
+  const { context, fileSystem, settings } = dependencies;
+  await manageGitHooks(dependencies);
+  const result = await findUnblockedTasks(context.cwd, fileSystem);
+  if (result.error) {
+    context.stderr(`Error: ${result.error}`);
+    context.stderr("Run 'dust init' to initialize a Dust repository");
+    return { exitCode: 1 };
+  }
+  if (result.tasks.length === 0) {
+    context.stdout("No unblocked tasks found.");
+    return { exitCode: 0 };
+  }
+  context.stdout("## Pick a Task");
+  context.stdout("");
+  printTaskList(context, result.tasks);
+  const vars = templateVariables(settings, false);
+  context.stdout(`Pick ONE task, read its file to understand the requirements, then run \`${vars.bin} focus "<task name>"\`.`);
+  return { exitCode: 0 };
+}
 
 // lib/cli/commands/pre-push.ts
 function parseGitDiffNameStatus(output) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {

package/templates/agent-greeting.txt

@@ -13,7 +13,7 @@ Determine the user's intent and run the matching command NOW:
 1. **Pick up work from the backlog** → `{{bin}} pick task`
    User wants to start working. Examples: "work", "go", "pick a task", "what's next?"
 
-2. **Implement a specific task** → `{{bin}} implement task`
+2. **Implement a specific task** → `{{bin}} focus "<task name>"`
    User mentions a particular task by name. Examples: "implement the auth task", "work on caching"
 
 3. **Capture a new task** → `{{bin}} new task`

package/templates/templates/agent-greeting.txt

@@ -13,7 +13,7 @@ Determine the user's intent and run the matching command NOW:
 1. **Pick up work from the backlog** → `{{bin}} pick task`
    User wants to start working. Examples: "work", "go", "pick a task", "what's next?"
 
-2. **Implement a specific task** → `{{bin}} implement task`
+2. **Implement a specific task** → `{{bin}} focus "<task name>"`
    User mentions a particular task by name. Examples: "implement the auth task", "work on caching"
 
 3. **Capture a new task** → `{{bin}} new task`