@joshski/dust 0.1.30 → 0.1.32

package/dist/dust.js

@@ -435,7 +435,7 @@ function extractOpeningSentence(content) {
 // lib/workflow-tasks.ts
 var IDEA_TRANSITION_PREFIXES = [
   "Refine Idea: ",
-  "Create Task From Idea: ",
+  "Decompose Idea: ",
   "Shelve Idea: "
 ];
 function titleToFilename(title) {
@@ -589,6 +589,14 @@ 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;
@@ -1042,25 +1050,33 @@ async function lintMarkdown(dependencies) {
 
 // lib/cli/commands/check.ts
 var DEFAULT_CHECK_TIMEOUT_MS = 13000;
+async function runSingleCheck(check, cwd, runner) {
+  const timeoutMs = check.timeoutMilliseconds ?? DEFAULT_CHECK_TIMEOUT_MS;
+  const startTime = Date.now();
+  const result = await runner.run(check.command, cwd, timeoutMs);
+  const durationMs = Date.now() - startTime;
+  return {
+    name: check.name,
+    command: check.command,
+    exitCode: result.exitCode,
+    output: result.output,
+    hints: check.hints,
+    durationMs,
+    timedOut: result.timedOut,
+    timeoutSeconds: timeoutMs / 1000
+  };
+}
 async function runConfiguredChecks(checks, cwd, runner) {
-  const promises = checks.map(async (check) => {
-    const timeoutMs = check.timeoutMilliseconds ?? DEFAULT_CHECK_TIMEOUT_MS;
-    const startTime = Date.now();
-    const result = await runner.run(check.command, cwd, timeoutMs);
-    const durationMs = Date.now() - startTime;
-    return {
-      name: check.name,
-      command: check.command,
-      exitCode: result.exitCode,
-      output: result.output,
-      hints: check.hints,
-      durationMs,
-      timedOut: result.timedOut,
-      timeoutSeconds: timeoutMs / 1000
-    };
-  });
+  const promises = checks.map((check) => runSingleCheck(check, cwd, runner));
   return Promise.all(promises);
 }
+async function runConfiguredChecksSerially(checks, cwd, runner) {
+  const results = [];
+  for (const check of checks) {
+    results.push(await runSingleCheck(check, cwd, runner));
+  }
+  return results;
+}
 async function runValidationCheck(dependencies) {
   const outputLines = [];
   const bufferedContext = {
@@ -1123,7 +1139,13 @@ function displayResults(results, context) {
   return failed.length > 0 ? 1 : 0;
 }
 async function check(dependencies, shellRunner = defaultShellRunner) {
-  const { context, fileSystem, settings } = dependencies;
+  const {
+    arguments: commandArguments,
+    context,
+    fileSystem,
+    settings
+  } = dependencies;
+  const serial = commandArguments.includes("--serial");
   if (!settings.checks || settings.checks.length === 0) {
     context.stderr("Error: No checks configured in .dust/config/settings.json");
     context.stderr("");
@@ -1136,9 +1158,20 @@ async function check(dependencies, shellRunner = defaultShellRunner) {
     context.stderr("  }");
     return { exitCode: 1 };
   }
-  const checkPromises = [];
   const dustPath = `${context.cwd}/.dust`;
-  if (fileSystem.exists(dustPath)) {
+  const hasDustDir = fileSystem.exists(dustPath);
+  if (serial) {
+    const results2 = [];
+    if (hasDustDir) {
+      results2.push(await runValidationCheck(dependencies));
+    }
+    const configuredResults = await runConfiguredChecksSerially(settings.checks, context.cwd, shellRunner);
+    results2.push(...configuredResults);
+    const exitCode2 = displayResults(results2, context);
+    return { exitCode: exitCode2 };
+  }
+  const checkPromises = [];
+  if (hasDustDir) {
     checkPromises.push(runValidationCheck(dependencies));
   }
   checkPromises.push(runConfiguredChecks(settings.checks, context.cwd, shellRunner));

package/dist/workflow-tasks.d.ts

@@ -16,12 +16,13 @@ export declare function findAllCaptureIdeaTasks(fileSystem: FileSystem, dustPath
  * 6. Add .md extension
  */
 export declare function titleToFilename(title: string): string;
-export type WorkflowTaskType = 'refine' | 'create-task' | 'shelve';
+export type WorkflowTaskType = 'refine' | 'decompose-idea' | 'shelve';
 export interface WorkflowTaskMatch {
     type: WorkflowTaskType;
+    ideaSlug: string;
     taskSlug: string;
 }
-export declare function findWorkflowTask(fileSystem: FileSystem, dustPath: string, ideaSlug: string): Promise<WorkflowTaskMatch | null>;
+export declare function findWorkflowTaskForIdea(fileSystem: FileSystem, dustPath: string, ideaSlug: string): Promise<WorkflowTaskMatch | null>;
 export interface CreateIdeaTransitionTaskResult {
     filePath: string;
 }
@@ -29,12 +30,12 @@ export interface OpenQuestionResponse {
     question: string;
     chosenOption: string;
 }
-export interface CreateTaskFromIdeaOptions {
+export interface DecomposeIdeaOptions {
     ideaSlug: string;
     description?: string;
     openQuestionResponses?: OpenQuestionResponse[];
 }
 export declare function createRefineIdeaTask(fileSystem: FileSystem, dustPath: string, ideaSlug: string, description?: string): Promise<CreateIdeaTransitionTaskResult>;
-export declare function createTaskFromIdea(fileSystem: FileSystem, dustPath: string, options: CreateTaskFromIdeaOptions): Promise<CreateIdeaTransitionTaskResult>;
+export declare function decomposeIdea(fileSystem: FileSystem, dustPath: string, options: DecomposeIdeaOptions): Promise<CreateIdeaTransitionTaskResult>;
 export declare function createShelveIdeaTask(fileSystem: FileSystem, dustPath: string, ideaSlug: string, description?: string): Promise<CreateIdeaTransitionTaskResult>;
 export declare function createCaptureIdeaTask(fileSystem: FileSystem, dustPath: string, title: string, description: string): Promise<CreateIdeaTransitionTaskResult>;

package/dist/workflow-tasks.js

@@ -1,7 +1,7 @@
 // lib/workflow-tasks.ts
 var IDEA_TRANSITION_PREFIXES = [
   "Refine Idea: ",
-  "Create Task From Idea: ",
+  "Decompose Idea: ",
   "Shelve Idea: "
 ];
 var CAPTURE_IDEA_PREFIX = "Add Idea: ";
@@ -31,17 +31,17 @@ function titleToFilename(title) {
 }
 var WORKFLOW_TASK_TYPES = [
   { type: "refine", prefix: "Refine Idea: " },
-  { type: "create-task", prefix: "Create Task From Idea: " },
+  { type: "decompose-idea", prefix: "Decompose Idea: " },
   { type: "shelve", prefix: "Shelve Idea: " }
 ];
-async function findWorkflowTask(fileSystem, dustPath, ideaSlug) {
+async function findWorkflowTaskForIdea(fileSystem, dustPath, ideaSlug) {
   const ideaTitle = await readIdeaTitle(fileSystem, dustPath, ideaSlug);
   for (const { type, prefix } of WORKFLOW_TASK_TYPES) {
     const filename = titleToFilename(`${prefix}${ideaTitle}`);
     const filePath = `${dustPath}/tasks/${filename}`;
     if (fileSystem.exists(filePath)) {
       const taskSlug = filename.replace(/\.md$/, "");
-      return { type, taskSlug };
+      return { type, ideaSlug, taskSlug };
     }
   }
   return null;
@@ -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).`, [
-    "A new task is created in .dust/tasks/",
+async function decomposeIdea(fileSystem, dustPath, options) {
+  return createIdeaTask(fileSystem, dustPath, "Decompose Idea: ", options.ideaSlug, (ideaTitle) => `Create one or more well-defined tasks from this idea. Prefer smaller, narrowly scoped tasks -- split the idea into multiple tasks if it covers more than one logical change. Review \`.dust/goals/\` to link relevant goals and \`.dust/facts/\` for design decisions that should inform the task. See [${ideaTitle}](../ideas/${options.ideaSlug}.md).`, [
+    "One or more new tasks are 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",
@@ -146,9 +147,9 @@ async function createCaptureIdeaTask(fileSystem, dustPath, title, description) {
 }
 export {
   titleToFilename,
-  findWorkflowTask,
+  findWorkflowTaskForIdea,
   findAllCaptureIdeaTasks,
-  createTaskFromIdea,
+  decomposeIdea,
   createShelveIdeaTask,
   createRefineIdeaTask,
   createCaptureIdeaTask,

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.30",
+  "version": "0.1.32",
   "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

@@ -1,10 +1,4 @@
 🤖 Hello {{agentName}}, welcome to dust!
-{{#if agentInstructions}}
-
-## Project Instructions
-
-{{agentInstructions}}
-{{/if}}
 
 CRITICAL: You MUST run exactly ONE of the commands below before doing anything else.
 
@@ -29,3 +23,9 @@ Determine the user's intent and run the matching command NOW:
    If none of the above clearly apply, run this to see all available commands.
 
 Do NOT proceed without running one of these commands.
+{{#if agentInstructions}}
+
+---
+
+{{agentInstructions}}
+{{/if}}

package/templates/templates/agent-greeting.txt

@@ -1,10 +1,4 @@
 🤖 Hello {{agentName}}, welcome to dust!
-{{#if agentInstructions}}
-
-## Project Instructions
-
-{{agentInstructions}}
-{{/if}}
 
 CRITICAL: You MUST run exactly ONE of the commands below before doing anything else.
 
@@ -29,3 +23,9 @@ Determine the user's intent and run the matching command NOW:
    If none of the above clearly apply, run this to see all available commands.
 
 Do NOT proceed without running one of these commands.
+{{#if agentInstructions}}
+
+---
+
+{{agentInstructions}}
+{{/if}}