@joshski/dust 0.1.29 → 0.1.31

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({
@@ -582,12 +589,28 @@ function validateIdeaOpenQuestions(filePath, content) {
           line: currentQuestionLine
         });
       }
+      const headingText = line.slice(3).trimEnd();
+      if (headingText.toLowerCase() === "open questions" && headingText !== "Open Questions") {
+        violations.push({
+          file: filePath,
+          message: `Heading "${line.trimEnd()}" should be "## Open Questions"`,
+          line: i + 1
+        });
+      }
       inOpenQuestions = line === "## Open Questions";
       currentQuestionLine = null;
       continue;
     }
     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 +1165,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 +1205,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 +1875,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 +1900,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 +1919,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 +2163,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 +2182,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/dist/workflow-tasks.js

@@ -105,15 +105,16 @@ async function createIdeaTask(fileSystem, dustPath, prefix, ideaSlug, openingSen
   return { filePath };
 }
 async function createRefineIdeaTask(fileSystem, dustPath, ideaSlug, description) {
-  return createIdeaTask(fileSystem, dustPath, "Refine Idea: ", ideaSlug, (ideaTitle) => `Thoroughly research this idea and refine it into a well-defined proposal. Read the idea file, explore the codebase for relevant context, and identify any ambiguity. Where aspects are unclear or could go multiple ways, add open questions to the idea file. See [${ideaTitle}](../ideas/${ideaSlug}.md).`, [
+  return createIdeaTask(fileSystem, dustPath, "Refine Idea: ", ideaSlug, (ideaTitle) => `Thoroughly research this idea and refine it into a well-defined proposal. Read the idea file, explore the codebase for relevant context, and identify any ambiguity. Where aspects are unclear or could go multiple ways, add open questions to the idea file. Review \`.dust/goals/\` for alignment and \`.dust/facts/\` for relevant design decisions. See [${ideaTitle}](../ideas/${ideaSlug}.md).`, [
     "Idea is thoroughly researched with relevant codebase context",
     "Open questions are added for any ambiguous or underspecified aspects",
     "Idea file is updated with findings"
   ], { description });
 }
 async function createTaskFromIdea(fileSystem, dustPath, options) {
-  return createIdeaTask(fileSystem, dustPath, "Create Task From Idea: ", options.ideaSlug, (ideaTitle) => `Create a well-defined task from this idea. See [${ideaTitle}](../ideas/${options.ideaSlug}.md).`, [
+  return createIdeaTask(fileSystem, dustPath, "Create Task From Idea: ", options.ideaSlug, (ideaTitle) => `Create a well-defined task from this idea. Review \`.dust/goals/\` to link relevant goals and \`.dust/facts/\` for design decisions that should inform the task. See [${ideaTitle}](../ideas/${options.ideaSlug}.md).`, [
     "A new task is created in .dust/tasks/",
+    "Task's Goals section links to relevant goals from .dust/goals/",
     "The original idea is deleted or updated to reflect remaining scope"
   ], {
     description: options.description,
@@ -135,7 +136,7 @@ async function createCaptureIdeaTask(fileSystem, dustPath, title, description) {
   const filePath = `${dustPath}/tasks/${filename}`;
   const ideaFilename = titleToFilename(title);
   const ideaPath = `.dust/ideas/${ideaFilename}`;
-  const content = renderTask(taskTitle, `Research this idea thoroughly, then create an idea file at \`${ideaPath}\`. Read the codebase for relevant context, flesh out the description, and identify any ambiguity. Where aspects are unclear or could go multiple ways, add open questions to the idea file. The idea should have the title "${title}" and start from the following description:`, [
+  const content = renderTask(taskTitle, `Research this idea thoroughly, then create an idea file at \`${ideaPath}\`. Read the codebase for relevant context, flesh out the description, and identify any ambiguity. Where aspects are unclear or could go multiple ways, add open questions to the idea file. Review \`.dust/goals/\` and \`.dust/facts/\` for relevant context. The idea should have the title "${title}" and start from the following description:`, [
     `Idea file exists at ${ideaPath}`,
     `Idea file has an H1 title matching "${title}"`,
     "Idea includes relevant context from codebase exploration",

package/lib/istanbul/minimal-reporter.cjs

@@ -0,0 +1,90 @@
+const { ReportBase } = require('istanbul-lib-report')
+
+function isFull(metrics) {
+  return (
+    metrics.statements.pct === 100 &&
+    metrics.branches.pct === 100 &&
+    metrics.functions.pct === 100 &&
+    metrics.lines.pct === 100
+  )
+}
+
+function formatMetrics(metrics) {
+  const parts = []
+  if (metrics.lines.pct < 100) parts.push(`${metrics.lines.pct}% lines`)
+  if (metrics.statements.pct < 100)
+    parts.push(`${metrics.statements.pct}% statements`)
+  if (metrics.branches.pct < 100)
+    parts.push(`${metrics.branches.pct}% branches`)
+  if (metrics.functions.pct < 100)
+    parts.push(`${metrics.functions.pct}% functions`)
+  return parts.join(', ')
+}
+
+function getUncoveredLines(fileCoverage) {
+  const lineCoverage = fileCoverage.getLineCoverage()
+  const ranges = []
+  let rangeStart = null
+  let rangeEnd = null
+
+  for (const [lineStr, hits] of Object.entries(lineCoverage)) {
+    const line = Number.parseInt(lineStr, 10)
+    if (hits === 0) {
+      if (rangeStart === null) {
+        rangeStart = line
+        rangeEnd = line
+      } else if (line === rangeEnd + 1) {
+        rangeEnd = line
+      } else {
+        ranges.push([rangeStart, rangeEnd])
+        rangeStart = line
+        rangeEnd = line
+      }
+    }
+  }
+
+  if (rangeStart !== null) {
+    ranges.push([rangeStart, rangeEnd])
+  }
+
+  return ranges.map(([start, end]) =>
+    start === end ? `Line ${start}` : `Lines ${start}-${end}`
+  )
+}
+
+class IncompleteCoverageReporter extends ReportBase {
+  execute(context) {
+    const incompleteFiles = []
+    context.getTree().visit({
+      onDetail(node) {
+        const metrics = node.getCoverageSummary()
+        if (!metrics.isEmpty() && !isFull(metrics)) {
+          incompleteFiles.push({
+            name: node.getQualifiedName(),
+            metrics,
+            fileCoverage: node.getFileCoverage(),
+          })
+        }
+      },
+    })
+
+    if (incompleteFiles.length === 0) return
+
+    const cw = context.writer.writeFile(null)
+    const count = incompleteFiles.length
+    const label = count === 1 ? '1 file has' : `${count} files have`
+    cw.println(`${label} < 100% coverage:`)
+
+    for (const file of incompleteFiles) {
+      cw.println('')
+      cw.println(`${file.name} (${formatMetrics(file.metrics)})`)
+      for (const line of getUncoveredLines(file.fileCoverage)) {
+        cw.println(`- ${line}`)
+      }
+    }
+
+    cw.close()
+  }
+}
+
+module.exports = IncompleteCoverageReporter

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {
@@ -10,12 +10,14 @@
     "./workflow-tasks": {
       "import": "./dist/workflow-tasks.js",
       "types": "./dist/workflow-tasks.d.ts"
-    }
+    },
+    "./istanbul/minimal-reporter": "./lib/istanbul/minimal-reporter.cjs"
   },
   "files": [
     "dist",
     "bin",
-    "templates"
+    "templates",
+    "lib/istanbul/minimal-reporter.cjs"
   ],
   "repository": {
     "type": "git",

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`