@joshski/dust 0.1.70 → 0.1.72

package/dist/artifacts/index.d.ts

@@ -33,10 +33,10 @@ export interface ArtifactsRepository {
         ideaSlug: string;
         description?: string;
     }): Promise<CreateIdeaTransitionTaskResult>;
-    createCaptureIdeaTask(options: {
+    createIdeaTask(options: {
         title: string;
         description: string;
-        buildItNow?: boolean;
+        expedite?: boolean;
     }): Promise<CreateIdeaTransitionTaskResult>;
     findWorkflowTaskForIdea(options: {
         ideaSlug: string;

package/dist/artifacts/workflow-tasks.d.ts

@@ -1,7 +1,7 @@
 import type { FileSystem, ReadableFileSystem } from '../filesystem/types';
 export declare const IDEA_TRANSITION_PREFIXES: string[];
 export declare const CAPTURE_IDEA_PREFIX = "Add Idea: ";
-export declare const BUILD_IDEA_PREFIX = "Decompose Idea: ";
+export declare const EXPEDITE_IDEA_PREFIX = "Expedite Idea: ";
 export interface IdeaInProgress {
     taskSlug: string;
     ideaTitle: string;
@@ -9,7 +9,7 @@ export interface IdeaInProgress {
 export interface ParsedCaptureIdeaTask {
     ideaTitle: string;
     ideaDescription: string;
-    buildItNow: boolean;
+    expedite: boolean;
 }
 export declare function findAllCaptureIdeaTasks(fileSystem: ReadableFileSystem, dustPath: string): Promise<IdeaInProgress[]>;
 /**
@@ -49,9 +49,9 @@ export interface DecomposeIdeaOptions {
 export declare function createRefineIdeaTask(fileSystem: FileSystem, dustPath: string, ideaSlug: string, description?: string): 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, options: {
+export declare function createIdeaTask(fileSystem: FileSystem, dustPath: string, options: {
     title: string;
     description: string;
-    buildItNow?: boolean;
+    expedite?: boolean;
 }): Promise<CreateIdeaTransitionTaskResult>;
 export declare function parseCaptureIdeaTask(fileSystem: ReadableFileSystem, dustPath: string, taskSlug: string): Promise<ParsedCaptureIdeaTask | null>;

package/dist/artifacts.js

@@ -272,7 +272,7 @@ async function parseTask(fileSystem, dustPath, slug) {
 
 // lib/artifacts/workflow-tasks.ts
 var CAPTURE_IDEA_PREFIX = "Add Idea: ";
-var BUILD_IDEA_PREFIX = "Decompose Idea: ";
+var EXPEDITE_IDEA_PREFIX = "Expedite Idea: ";
 async function findAllCaptureIdeaTasks(fileSystem, dustPath) {
   const tasksPath = `${dustPath}/tasks`;
   if (!fileSystem.exists(tasksPath))
@@ -290,10 +290,10 @@ async function findAllCaptureIdeaTasks(fileSystem, dustPath) {
         taskSlug: file.replace(/\.md$/, ""),
         ideaTitle: title.slice(CAPTURE_IDEA_PREFIX.length)
       });
-    } else if (title.startsWith(BUILD_IDEA_PREFIX) && !content.includes("## Decomposes Idea")) {
+    } else if (title.startsWith(EXPEDITE_IDEA_PREFIX)) {
       results.push({
         taskSlug: file.replace(/\.md$/, ""),
-        ideaTitle: title.slice(BUILD_IDEA_PREFIX.length)
+        ideaTitle: title.slice(EXPEDITE_IDEA_PREFIX.length)
       });
     }
   }
@@ -351,10 +351,10 @@ async function findAllWorkflowTasks(fileSystem, dustPath) {
         taskSlug,
         ideaTitle: title.slice(CAPTURE_IDEA_PREFIX.length)
       });
-    } else if (title.startsWith(BUILD_IDEA_PREFIX) && !content.includes("## Decomposes Idea")) {
+    } else if (title.startsWith(EXPEDITE_IDEA_PREFIX)) {
       captureIdeaTasks.push({
         taskSlug,
-        ideaTitle: title.slice(BUILD_IDEA_PREFIX.length)
+        ideaTitle: title.slice(EXPEDITE_IDEA_PREFIX.length)
       });
     }
     for (const { type, heading } of WORKFLOW_SECTION_HEADINGS) {
@@ -444,7 +444,7 @@ ${definitionOfDone.map((item) => `- [ ] ${item}`).join(`
 `)}
 `;
 }
-async function createIdeaTask(fileSystem, dustPath, prefix, ideaSlug, openingSentenceTemplate, definitionOfDone, ideaSectionHeading, taskOptions) {
+async function createIdeaTransitionTask(fileSystem, dustPath, prefix, ideaSlug, openingSentenceTemplate, definitionOfDone, ideaSectionHeading, taskOptions) {
   const ideaTitle = await readIdeaTitle(fileSystem, dustPath, ideaSlug);
   const taskTitle = `${prefix}${ideaTitle}`;
   const filename = titleToFilename(taskTitle);
@@ -459,7 +459,7 @@ 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. Review \`.dust/principles/\` for alignment and \`.dust/facts/\` for relevant design decisions. See [${ideaTitle}](../ideas/${ideaSlug}.md). If you add open questions, use \`## Open Questions\` with \`### Question?\` headings and one or more \`#### Option\` headings beneath each question, and only add questions that are meaningful decisions worth asking.`, [
+  return createIdeaTransitionTask(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/principles/\` for alignment and \`.dust/facts/\` for relevant design decisions. See [${ideaTitle}](../ideas/${ideaSlug}.md). If you add open questions, use \`## Open Questions\` with \`### Question?\` headings and one or more \`#### Option\` headings beneath each question, and only add questions that are meaningful decisions worth asking.`, [
     "Idea is thoroughly researched with relevant codebase context",
     "Open questions are added for any ambiguous or underspecified aspects",
     "Open questions follow the required heading format and focus on high-value decisions",
@@ -467,7 +467,7 @@ async function createRefineIdeaTask(fileSystem, dustPath, ideaSlug, description)
   ], "Refines Idea", { description });
 }
 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 that each deliver a thin but complete vertical slice of working software -- a path through the system that can be tested end-to-end -- rather than component-oriented tasks (like "add schema" or "build endpoint") that only work once all tasks are done. Split the idea into multiple tasks if it covers more than one logical change. Review \`.dust/principles/\` to link relevant principles and \`.dust/facts/\` for design decisions that should inform the task. See [${ideaTitle}](../ideas/${options.ideaSlug}.md).`, [
+  return createIdeaTransitionTask(fileSystem, dustPath, "Decompose Idea: ", options.ideaSlug, (ideaTitle) => `Create one or more well-defined tasks from this idea. Prefer smaller, narrowly scoped tasks that each deliver a thin but complete vertical slice of working software -- a path through the system that can be tested end-to-end -- rather than component-oriented tasks (like "add schema" or "build endpoint") that only work once all tasks are done. Split the idea into multiple tasks if it covers more than one logical change. Review \`.dust/principles/\` to link relevant principles 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 Principles section links to relevant principles from .dust/principles/",
     "The original idea is deleted or updated to reflect remaining scope"
@@ -477,18 +477,18 @@ async function decomposeIdea(fileSystem, dustPath, options) {
   });
 }
 async function createShelveIdeaTask(fileSystem, dustPath, ideaSlug, description) {
-  return createIdeaTask(fileSystem, dustPath, "Shelve Idea: ", ideaSlug, (ideaTitle) => `Archive this idea and remove it from the active backlog. See [${ideaTitle}](../ideas/${ideaSlug}.md).`, ["Idea file is deleted", "Rationale is recorded in the commit message"], "Shelves Idea", { description });
+  return createIdeaTransitionTask(fileSystem, dustPath, "Shelve Idea: ", ideaSlug, (ideaTitle) => `Archive this idea and remove it from the active backlog. See [${ideaTitle}](../ideas/${ideaSlug}.md).`, ["Idea file is deleted", "Rationale is recorded in the commit message"], "Shelves Idea", { description });
 }
-async function createCaptureIdeaTask(fileSystem, dustPath, options) {
-  const { title, description, buildItNow } = options;
+async function createIdeaTask(fileSystem, dustPath, options) {
+  const { title, description, expedite } = options;
   if (!title || !title.trim()) {
     throw new Error("title is required and must not be whitespace-only");
   }
   if (!description || !description.trim()) {
     throw new Error("description is required and must not be whitespace-only");
   }
-  if (buildItNow) {
-    const taskTitle2 = `${BUILD_IDEA_PREFIX}${title}`;
+  if (expedite) {
+    const taskTitle2 = `${EXPEDITE_IDEA_PREFIX}${title}`;
     const filename2 = titleToFilename(taskTitle2);
     const filePath2 = `${dustPath}/tasks/${filename2}`;
     const content2 = `# ${taskTitle2}
@@ -550,13 +550,13 @@ async function parseCaptureIdeaTask(fileSystem, dustPath, taskSlug) {
   }
   const title = titleMatch[1].trim();
   let ideaTitle;
-  let buildItNow;
-  if (title.startsWith(BUILD_IDEA_PREFIX)) {
-    ideaTitle = title.slice(BUILD_IDEA_PREFIX.length);
-    buildItNow = true;
+  let expedite;
+  if (title.startsWith(EXPEDITE_IDEA_PREFIX)) {
+    ideaTitle = title.slice(EXPEDITE_IDEA_PREFIX.length);
+    expedite = true;
   } else if (title.startsWith(CAPTURE_IDEA_PREFIX)) {
     ideaTitle = title.slice(CAPTURE_IDEA_PREFIX.length);
-    buildItNow = false;
+    expedite = false;
   } else {
     return null;
   }
@@ -565,7 +565,7 @@ async function parseCaptureIdeaTask(fileSystem, dustPath, taskSlug) {
     return null;
   }
   const ideaDescription = descriptionMatch[1];
-  return { ideaTitle, ideaDescription, buildItNow };
+  return { ideaTitle, ideaDescription, expedite };
 }
 
 // lib/artifacts/index.ts
@@ -624,8 +624,8 @@ function buildArtifactsRepository(fileSystem, dustPath) {
     async createShelveIdeaTask(options) {
       return createShelveIdeaTask(fileSystem, dustPath, options.ideaSlug, options.description);
     },
-    async createCaptureIdeaTask(options) {
-      return createCaptureIdeaTask(fileSystem, dustPath, options);
+    async createIdeaTask(options) {
+      return createIdeaTask(fileSystem, dustPath, options);
     },
     async findWorkflowTaskForIdea(options) {
       return findWorkflowTaskForIdea(fileSystem, dustPath, options.ideaSlug);

package/dist/dust.js

@@ -275,7 +275,7 @@ async function loadSettings(cwd, fileSystem) {
 }
 
 // lib/version.ts
-var DUST_VERSION = "0.1.70";
+var DUST_VERSION = "0.1.72";
 
 // lib/session.ts
 var DUST_UNATTENDED = "DUST_UNATTENDED";
@@ -2285,7 +2285,7 @@ var IDEA_TRANSITION_PREFIXES = [
   "Decompose Idea: ",
   "Shelve Idea: "
 ];
-var BUILD_IDEA_PREFIX = "Decompose Idea: ";
+var EXPEDITE_IDEA_PREFIX = "Expedite Idea: ";
 function titleToFilename(title) {
   return `${title.toLowerCase().replace(/\./g, "-").replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "")}.md`;
 }
@@ -2294,7 +2294,7 @@ function titleToFilename(title) {
 function buildImplementationInstructions(bin, hooksInstalled, taskTitle) {
   const steps = [];
   let step = 1;
-  const hasIdeaFile = !taskTitle?.startsWith(BUILD_IDEA_PREFIX);
+  const hasIdeaFile = !taskTitle?.startsWith(EXPEDITE_IDEA_PREFIX);
   steps.push(`Note: Do NOT run \`${bin} agent\`.`, "");
   steps.push(`${step}. Run \`${bin} check\` to verify the project is in a good state`);
   step++;

package/dist/filesystem/emulator.d.ts

@@ -0,0 +1,41 @@
+/**
+ * In-memory FileSystem emulator for testing and cache-backed use cases.
+ *
+ * Provides a complete FileSystem + GlobScanner implementation backed by
+ * an in-memory file tree, with write tracking for test assertions.
+ */
+import type { FileSystem, GlobScanner } from './types';
+export type FileSystemTree = {
+    [name: string]: string | FileSystemTree;
+};
+/**
+ * Extended file system with write tracking for assertions.
+ * Also implements GlobScanner by scanning over known files.
+ */
+export interface FileSystemEmulator extends FileSystem, GlobScanner {
+    createdDirs: string[];
+    writtenFiles: Map<string, string>;
+    /** Internal files map - exposed for tests that need to modify file system state */
+    files: Map<string, string>;
+    /** File permissions set via chmod - maps path to mode */
+    permissions: Map<string, number>;
+}
+/**
+ * Creates a file system emulator with optional file contents and write tracking.
+ * Implements both FileSystem and GlobScanner interfaces - the scan() method
+ * iterates over the files the emulator knows about.
+ *
+ * @param tree - Nested object representing file system hierarchy
+ * @returns FileSystemEmulator with tracking for created directories and written files
+ *
+ * @example
+ * createFileSystemEmulator({
+ *   project: {
+ *     '.dust': {
+ *       principles: { 'my-principle.md': '# My Principle' },
+ *       ideas: {}  // empty directory
+ *     }
+ *   }
+ * })
+ */
+export declare function createFileSystemEmulator(tree?: FileSystemTree): FileSystemEmulator;

package/dist/filesystem-emulator.js

@@ -0,0 +1,137 @@
+// lib/filesystem/emulator.ts
+function flattenFileSystemTree(tree, basePath = "") {
+  const files = new Map;
+  const paths = new Set;
+  for (const [name, value] of Object.entries(tree)) {
+    const fullPath = basePath ? `${basePath}/${name}` : `/${name}`;
+    if (typeof value === "string") {
+      files.set(fullPath, value);
+      paths.add(fullPath);
+    } else {
+      paths.add(fullPath);
+      const nested = flattenFileSystemTree(value, fullPath);
+      for (const [path, content] of nested.files) {
+        files.set(path, content);
+      }
+      for (const path of nested.paths) {
+        paths.add(path);
+      }
+    }
+  }
+  for (const path of [...files.keys(), ...paths]) {
+    let dir = path;
+    while (dir.includes("/")) {
+      dir = dir.substring(0, dir.lastIndexOf("/"));
+      if (dir)
+        paths.add(dir);
+    }
+  }
+  return { files, paths };
+}
+function createFileSystemEmulator(tree = {}) {
+  const { files, paths } = flattenFileSystemTree(tree);
+  const createdDirs = [];
+  const writtenFiles = new Map;
+  const permissions = new Map;
+  const creationTimes = new Map;
+  let nextCreationTime = 1000;
+  for (const path of files.keys()) {
+    creationTimes.set(path, nextCreationTime++);
+  }
+  return {
+    exists: (path) => paths.has(path),
+    isDirectory: (path) => paths.has(path) && !files.has(path),
+    readFile: async (path) => {
+      if (!files.has(path)) {
+        const error = new Error(`ENOENT: no such file or directory, open '${path}'`);
+        error.code = "ENOENT";
+        throw error;
+      }
+      return files.get(path);
+    },
+    writeFile: async (path, content, options) => {
+      if (options?.flag === "wx" && paths.has(path)) {
+        const error = new Error(`EEXIST: file already exists, open '${path}'`);
+        error.code = "EEXIST";
+        throw error;
+      }
+      writtenFiles.set(path, content);
+      paths.add(path);
+      files.set(path, content);
+      if (!creationTimes.has(path)) {
+        creationTimes.set(path, nextCreationTime++);
+      }
+    },
+    mkdir: async (path) => {
+      createdDirs.push(path);
+    },
+    readdir: async (path) => {
+      const prefix = `${path}/`;
+      const entries = new Set;
+      for (const f of files.keys()) {
+        if (f.startsWith(prefix)) {
+          const relativePath = f.slice(prefix.length);
+          if (!relativePath.includes("/")) {
+            entries.add(relativePath);
+          } else {
+            entries.add(relativePath.split("/")[0]);
+          }
+        }
+      }
+      return Array.from(entries);
+    },
+    chmod: async (path, mode) => {
+      permissions.set(path, mode);
+    },
+    getFileCreationTime: (path) => {
+      return creationTimes.get(path) ?? 0;
+    },
+    scan: async function* (dir) {
+      if (!paths.has(dir)) {
+        const error = new Error(`ENOENT: no such file or directory, scandir '${dir}'`);
+        error.code = "ENOENT";
+        throw error;
+      }
+      const prefix = `${dir}/`;
+      for (const file of files.keys()) {
+        if (file.startsWith(prefix)) {
+          yield file.slice(prefix.length);
+        }
+      }
+    },
+    rename: async (oldPath, newPath) => {
+      const entriesToMove = [];
+      const pathsToUpdate = [];
+      for (const [path, content] of files.entries()) {
+        if (path === oldPath || path.startsWith(`${oldPath}/`)) {
+          const relativePath = path.slice(oldPath.length);
+          const newFilePath = `${newPath}${relativePath}`;
+          entriesToMove.push([path, newFilePath]);
+          files.set(newFilePath, content);
+          paths.add(newFilePath);
+        }
+      }
+      for (const path of paths) {
+        if (path === oldPath || path.startsWith(`${oldPath}/`)) {
+          pathsToUpdate.push(path);
+          const relativePath = path.slice(oldPath.length);
+          paths.add(`${newPath}${relativePath}`);
+        }
+      }
+      for (const [oldFilePath] of entriesToMove) {
+        files.delete(oldFilePath);
+        paths.delete(oldFilePath);
+      }
+      for (const oldPathEntry of pathsToUpdate) {
+        paths.delete(oldPathEntry);
+      }
+    },
+    createdDirs,
+    writtenFiles,
+    files,
+    permissions
+  };
+}
+export {
+  createFileSystemEmulator
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.70",
+  "version": "0.1.72",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {
@@ -29,6 +29,10 @@
     "./filesystem": {
       "types": "./dist/filesystem/types.d.ts"
     },
+    "./filesystem/emulator": {
+      "import": "./dist/filesystem-emulator.js",
+      "types": "./dist/filesystem/emulator.d.ts"
+    },
     "./istanbul/minimal-reporter": "./lib/istanbul/minimal-reporter.cjs",
     "./biome": {
       "import": "./dist/biome.js",