@joshski/dust 0.1.31 → 0.1.33

package/README.md

@@ -1,4 +1,4 @@
-# Dust
+# Dust ✨
 
 **Flow state for AI coding agents.**
 

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) {
@@ -1050,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 = {
@@ -1131,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("");
@@ -1144,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

@@ -5,6 +5,10 @@ export interface IdeaInProgress {
     taskSlug: string;
     ideaTitle: string;
 }
+export interface ParsedCaptureIdeaTask {
+    ideaTitle: string;
+    ideaDescription: string;
+}
 export declare function findAllCaptureIdeaTasks(fileSystem: FileSystem, dustPath: string): Promise<IdeaInProgress[]>;
 /**
  * Converts a markdown title to the expected filename using deterministic rules:
@@ -16,12 +20,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 +34,13 @@ 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>;
+export declare function parseCaptureIdeaTask(fileSystem: FileSystem, dustPath: string, taskSlug: string): Promise<ParsedCaptureIdeaTask | null>;

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;
@@ -111,9 +111,9 @@ async function createRefineIdeaTask(fileSystem, dustPath, ideaSlug, description)
     "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. 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/",
+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"
   ], {
@@ -136,20 +136,60 @@ 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. 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",
-    "Open questions are added for any ambiguous or underspecified aspects"
-  ], { description });
+  const content = `# ${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.
+
+## Idea Description
+
+${description}
+
+## Goals
+
+(none)
+
+## Blocked By
+
+(none)
+
+## Definition of Done
+
+- [ ] Idea file exists at ${ideaPath}
+- [ ] Idea file has an H1 title matching "${title}"
+- [ ] Idea includes relevant context from codebase exploration
+- [ ] Open questions are added for any ambiguous or underspecified aspects
+`;
   await fileSystem.writeFile(filePath, content);
   return { filePath };
 }
+async function parseCaptureIdeaTask(fileSystem, dustPath, taskSlug) {
+  const filePath = `${dustPath}/tasks/${taskSlug}.md`;
+  if (!fileSystem.exists(filePath)) {
+    return null;
+  }
+  const content = await fileSystem.readFile(filePath);
+  const titleMatch = content.match(/^#\s+(.+)$/m);
+  if (!titleMatch) {
+    return null;
+  }
+  const title = titleMatch[1].trim();
+  if (!title.startsWith(CAPTURE_IDEA_PREFIX)) {
+    return null;
+  }
+  const ideaTitle = title.slice(CAPTURE_IDEA_PREFIX.length);
+  const descriptionMatch = content.match(/^## Idea Description\n\n([\s\S]*?)\n\n## /m);
+  if (!descriptionMatch) {
+    return null;
+  }
+  const ideaDescription = descriptionMatch[1];
+  return { ideaTitle, ideaDescription };
+}
 export {
   titleToFilename,
-  findWorkflowTask,
+  parseCaptureIdeaTask,
+  findWorkflowTaskForIdea,
   findAllCaptureIdeaTasks,
-  createTaskFromIdea,
+  decomposeIdea,
   createShelveIdeaTask,
   createRefineIdeaTask,
   createCaptureIdeaTask,

package/package.json

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

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}}