@joshski/dust 0.1.19 → 0.1.20

package/dist/dust.js

@@ -162,23 +162,21 @@ function createHooksManager(cwd, fileSystem, settings) {
   return {
     isGitRepo: () => fileSystem.exists(gitDir),
     isHookInstalled: async () => {
-      if (!fileSystem.exists(prePushPath)) {
-        return false;
-      }
       try {
         const content = await fileSystem.readFile(prePushPath);
         return content.includes(DUST_HOOK_START);
-      } catch {
-        return false;
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          return false;
+        }
+        throw error;
       }
     },
     installHook: async () => {
-      if (!fileSystem.exists(hooksDir)) {
-        await fileSystem.mkdir(hooksDir, { recursive: true });
-      }
+      await fileSystem.mkdir(hooksDir, { recursive: true });
       const hookContent = generateHookContent(settings.dustCommand);
       let finalContent;
-      if (fileSystem.exists(prePushPath)) {
+      try {
         const existingContent = await fileSystem.readFile(prePushPath);
         if (existingContent.includes(DUST_HOOK_START)) {
           const withoutDust = removeDustSection(existingContent);
@@ -195,19 +193,20 @@ ${hookContent}
 ${hookContent}
 `;
         }
-      } else {
-        finalContent = `#!/bin/sh
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          finalContent = `#!/bin/sh
 
 ${hookContent}
 `;
+        } else {
+          throw error;
+        }
       }
       await fileSystem.writeFile(prePushPath, finalContent);
       await fileSystem.chmod(prePushPath, 493);
     },
     getHookBinaryPath: async () => {
-      if (!fileSystem.exists(prePushPath)) {
-        return null;
-      }
       try {
         const content = await fileSystem.readFile(prePushPath);
         const dustSection = extractDustSection(content);
@@ -216,15 +215,23 @@ ${hookContent}
         }
         const match = dustSection.match(/^(.+) pre push$/m);
         return match ? match[1] : null;
-      } catch {
-        return null;
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          return null;
+        }
+        throw error;
       }
     },
     updateHookBinaryPath: async (newPath) => {
-      if (!fileSystem.exists(prePushPath)) {
-        return;
+      let content;
+      try {
+        content = await fileSystem.readFile(prePushPath);
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          return;
+        }
+        throw error;
       }
-      const content = await fileSystem.readFile(prePushPath);
       const dustSection = extractDustSection(content);
       if (!dustSection) {
         return;
@@ -657,34 +664,63 @@ function validateNoCycles(allGoalRelationships) {
   }
   return violations;
 }
+async function safeScanDir(glob, dirPath) {
+  const files = [];
+  try {
+    for await (const file of glob.scan(dirPath)) {
+      files.push(file);
+    }
+    return { files, exists: true };
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return { files: [], exists: false };
+    }
+    throw error;
+  }
+}
 async function lintMarkdown(dependencies) {
   const { context, fileSystem, globScanner: glob } = dependencies;
   const dustPath = `${context.cwd}/.dust`;
-  if (!fileSystem.exists(dustPath)) {
+  const dustScan = await safeScanDir(glob, dustPath);
+  if (!dustScan.exists) {
     context.stderr("Error: .dust directory not found");
     context.stderr("Run 'dust init' to initialize a Dust repository");
     return { exitCode: 1 };
   }
+  const dustFiles = dustScan.files;
   const violations = [];
   context.stdout("Validating links in .dust/...");
-  for await (const file of glob.scan(dustPath)) {
+  for (const file of dustFiles) {
     if (!file.endsWith(".md"))
       continue;
     const filePath = `${dustPath}/${file}`;
-    const content = await fileSystem.readFile(filePath);
-    violations.push(...validateLinks(filePath, content, fileSystem));
+    try {
+      const content = await fileSystem.readFile(filePath);
+      violations.push(...validateLinks(filePath, content, fileSystem));
+    } catch (error) {
+      if (error.code !== "ENOENT") {
+        throw error;
+      }
+    }
   }
   const contentDirs = ["goals", "facts", "ideas", "tasks"];
   context.stdout("Validating content files...");
   for (const dir of contentDirs) {
     const dirPath = `${dustPath}/${dir}`;
-    if (!fileSystem.exists(dirPath))
-      continue;
-    for await (const file of glob.scan(dirPath)) {
+    const { files } = await safeScanDir(glob, dirPath);
+    for (const file of files) {
       if (!file.endsWith(".md"))
         continue;
       const filePath = `${dirPath}/${file}`;
-      const content = await fileSystem.readFile(filePath);
+      let content;
+      try {
+        content = await fileSystem.readFile(filePath);
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          continue;
+        }
+        throw error;
+      }
       const openingSentenceViolation = validateOpeningSentence(filePath, content);
       if (openingSentenceViolation) {
         violations.push(openingSentenceViolation);
@@ -700,13 +736,22 @@ async function lintMarkdown(dependencies) {
     }
   }
   const tasksPath = `${dustPath}/tasks`;
-  if (fileSystem.exists(tasksPath)) {
+  const { files: taskFiles } = await safeScanDir(glob, tasksPath);
+  if (taskFiles.length > 0) {
     context.stdout("Validating task files in .dust/tasks/...");
-    for await (const file of glob.scan(tasksPath)) {
+    for (const file of taskFiles) {
       if (!file.endsWith(".md"))
         continue;
       const filePath = `${tasksPath}/${file}`;
-      const content = await fileSystem.readFile(filePath);
+      let content;
+      try {
+        content = await fileSystem.readFile(filePath);
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          continue;
+        }
+        throw error;
+      }
       const filenameViolation = validateFilename(filePath);
       if (filenameViolation) {
         violations.push(filenameViolation);
@@ -716,14 +761,23 @@ async function lintMarkdown(dependencies) {
     }
   }
   const goalsPath = `${dustPath}/goals`;
-  if (fileSystem.exists(goalsPath)) {
+  const { files: goalFiles } = await safeScanDir(glob, goalsPath);
+  if (goalFiles.length > 0) {
     context.stdout("Validating goal hierarchy in .dust/goals/...");
     const allGoalRelationships = [];
-    for await (const file of glob.scan(goalsPath)) {
+    for (const file of goalFiles) {
       if (!file.endsWith(".md"))
         continue;
       const filePath = `${goalsPath}/${file}`;
-      const content = await fileSystem.readFile(filePath);
+      let content;
+      try {
+        content = await fileSystem.readFile(filePath);
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          continue;
+        }
+        throw error;
+      }
       violations.push(...validateGoalHierarchySections(filePath, content));
       violations.push(...validateGoalHierarchyLinks(filePath, content));
       allGoalRelationships.push(extractGoalRelationships(filePath, content));
@@ -934,37 +988,59 @@ async function init(dependencies) {
   const dustPath = `${context.cwd}/.dust`;
   const dustCommand = detectDustCommand(context.cwd, fileSystem);
   const agentInstruction = `Always immediately run \`${dustCommand} agent\` when you start working in this repository.`;
-  if (fileSystem.exists(dustPath)) {
-    context.stdout(`${colors.yellow}\uD83D\uDCE6 Note:${colors.reset} ${colors.cyan}.dust${colors.reset} directory already exists, skipping creation`);
-  } else {
-    await fileSystem.mkdir(dustPath, { recursive: true });
-    for (const dir of DUST_DIRECTORIES) {
-      await fileSystem.mkdir(`${dustPath}/${dir}`, { recursive: true });
+  await fileSystem.mkdir(dustPath, { recursive: true });
+  for (const dir of DUST_DIRECTORIES) {
+    await fileSystem.mkdir(`${dustPath}/${dir}`, { recursive: true });
+  }
+  let dustDirCreated = false;
+  try {
+    await fileSystem.writeFile(`${dustPath}/facts/use-dust-for-planning.md`, USE_DUST_FACT, { flag: "wx" });
+    dustDirCreated = true;
+  } catch (error) {
+    if (error.code !== "EEXIST") {
+      throw error;
     }
-    await fileSystem.writeFile(`${dustPath}/facts/use-dust-for-planning.md`, USE_DUST_FACT);
+  }
+  try {
     const settings = generateSettings(context.cwd, fileSystem);
     await fileSystem.writeFile(`${dustPath}/config/settings.json`, `${JSON.stringify(settings, null, 2)}
-`);
+`, { flag: "wx" });
+  } catch (error) {
+    if (error.code !== "EEXIST") {
+      throw error;
+    }
+  }
+  if (dustDirCreated) {
     context.stdout(`${colors.green}✨ Initialized${colors.reset} Dust repository in ${colors.cyan}.dust/${colors.reset}`);
     context.stdout(`${colors.green}\uD83D\uDCC1 Created directories:${colors.reset} ${colors.dim}${DUST_DIRECTORIES.join(", ")}${colors.reset}`);
     context.stdout(`${colors.green}\uD83D\uDCC4 Created initial fact:${colors.reset} ${colors.cyan}.dust/facts/use-dust-for-planning.md${colors.reset}`);
     context.stdout(`${colors.green}⚙️  Created settings:${colors.reset} ${colors.cyan}.dust/config/settings.json${colors.reset}`);
+  } else {
+    context.stdout(`${colors.yellow}\uD83D\uDCE6 Note:${colors.reset} ${colors.cyan}.dust${colors.reset} directory already exists, skipping creation`);
   }
   const claudeMdPath = `${context.cwd}/CLAUDE.md`;
-  if (fileSystem.exists(claudeMdPath)) {
-    context.stdout(`${colors.yellow}⚠️  Warning:${colors.reset} ${colors.cyan}CLAUDE.md${colors.reset} already exists. Consider adding: ${colors.dim}"${agentInstruction}"${colors.reset}`);
-  } else {
+  try {
     const claudeContent = loadTemplate("claude-md", { dustCommand });
-    await fileSystem.writeFile(claudeMdPath, claudeContent);
+    await fileSystem.writeFile(claudeMdPath, claudeContent, { flag: "wx" });
     context.stdout(`${colors.green}\uD83D\uDCC4 Created${colors.reset} ${colors.cyan}CLAUDE.md${colors.reset} with agent instructions`);
+  } catch (error) {
+    if (error.code === "EEXIST") {
+      context.stdout(`${colors.yellow}⚠️  Warning:${colors.reset} ${colors.cyan}CLAUDE.md${colors.reset} already exists. Consider adding: ${colors.dim}"${agentInstruction}"${colors.reset}`);
+    } else {
+      throw error;
+    }
   }
   const agentsMdPath = `${context.cwd}/AGENTS.md`;
-  if (fileSystem.exists(agentsMdPath)) {
-    context.stdout(`${colors.yellow}⚠️  Warning:${colors.reset} ${colors.cyan}AGENTS.md${colors.reset} already exists. Consider adding: ${colors.dim}"${agentInstruction}"${colors.reset}`);
-  } else {
+  try {
     const agentsContent = loadTemplate("agents-md", { dustCommand });
-    await fileSystem.writeFile(agentsMdPath, agentsContent);
+    await fileSystem.writeFile(agentsMdPath, agentsContent, { flag: "wx" });
     context.stdout(`${colors.green}\uD83D\uDCC4 Created${colors.reset} ${colors.cyan}AGENTS.md${colors.reset} with agent instructions`);
+  } catch (error) {
+    if (error.code === "EEXIST") {
+      context.stdout(`${colors.yellow}⚠️  Warning:${colors.reset} ${colors.cyan}AGENTS.md${colors.reset} already exists. Consider adding: ${colors.dim}"${agentInstruction}"${colors.reset}`);
+    } else {
+      throw error;
+    }
   }
   const runner = dustCommand.split(" ")[0];
   context.stdout("");
@@ -1608,13 +1684,14 @@ function formatEvent(event) {
     case "loop.started":
       return `\uD83D\uDD04 Starting dust loop claude (max ${event.maxIterations} iterations)...`;
     case "loop.syncing":
-      return "\uD83D\uDD04 Syncing with remote...";
+      return "\uD83C\uDF0D Syncing with remote";
     case "loop.sync_skipped":
       return `Note: git pull skipped (${event.reason})`;
     case "loop.checking_tasks":
-      return "\uD83D\uDD0D Checking for available tasks...";
+      return null;
     case "loop.no_tasks":
-      return "\uD83D\uDCA4 No tasks available. Sleeping...";
+      return `\uD83D\uDE34 No tasks available. Sleeping...
+`;
     case "loop.tasks_found":
       return "✨ Found task(s). \uD83E\uDD16 Starting Claude...";
     case "claude.started":
@@ -2066,7 +2143,10 @@ function createFileSystem(primitives) {
   return {
     exists: primitives.existsSync,
     readFile: (path) => primitives.readFile(path, "utf-8"),
-    writeFile: (path, content) => primitives.writeFile(path, content, "utf-8"),
+    writeFile: (path, content, options) => primitives.writeFile(path, content, {
+      encoding: "utf-8",
+      flag: options?.flag
+    }),
     mkdir: async (path, options) => {
       await primitives.mkdir(path, options);
     },

package/package.json

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

package/templates/agent-implement-task.txt

@@ -4,10 +4,11 @@
 {{/if}}{{#unless isClaudeCodeWeb}}Follow these steps:
 {{/unless}}
 1. Run `{{bin}} next` to identify the (unblocked) task the user is referring to
-2. Run `{{bin}} check` to verify the project is in a good state
-3. Implement the task
-{{#unless hooksInstalled}}4. Run `{{bin}} check` before committing
-5.{{/unless}}{{#if hooksInstalled}}4.{{/if}} Create a single atomic commit that includes:
+2. Run `{{bin}} focus "<task name>"` (so everyone knows you're working on it)
+3. Run `{{bin}} check` to verify the project is in a good state
+4. Implement the task
+{{#unless hooksInstalled}}5. Run `{{bin}} check` before committing
+6.{{/unless}}{{#if hooksInstalled}}5.{{/if}} Create a single atomic commit that includes:
    - All implementation changes
    - Deletion of the completed task file
    - Updates to any facts that changed
@@ -20,6 +21,6 @@
    Add validation for user input
    ```
 
-{{#unless hooksInstalled}}6.{{/unless}}{{#if hooksInstalled}}5.{{/if}} Push your commit to the remote repository
+{{#unless hooksInstalled}}7.{{/unless}}{{#if hooksInstalled}}6.{{/if}} Push your commit to the remote repository
 
 Keep your change small and focused. One task, one commit.

package/templates/agent-pick-task.txt

@@ -4,4 +4,4 @@ Follow these steps:
 
 1. Run `{{bin}} next` to see available tasks
 2. Pick ONE task and read its file to understand the requirements
-3. Run `{{bin}} agent implement task` for instructions about how to implement
+3. Run `{{bin}} implement task` for instructions about how to implement

package/templates/templates/agent-implement-task.txt

@@ -4,10 +4,11 @@
 {{/if}}{{#unless isClaudeCodeWeb}}Follow these steps:
 {{/unless}}
 1. Run `{{bin}} next` to identify the (unblocked) task the user is referring to
-2. Run `{{bin}} check` to verify the project is in a good state
-3. Implement the task
-{{#unless hooksInstalled}}4. Run `{{bin}} check` before committing
-5.{{/unless}}{{#if hooksInstalled}}4.{{/if}} Create a single atomic commit that includes:
+2. Run `{{bin}} focus "<task name>"` (so everyone knows you're working on it)
+3. Run `{{bin}} check` to verify the project is in a good state
+4. Implement the task
+{{#unless hooksInstalled}}5. Run `{{bin}} check` before committing
+6.{{/unless}}{{#if hooksInstalled}}5.{{/if}} Create a single atomic commit that includes:
    - All implementation changes
    - Deletion of the completed task file
    - Updates to any facts that changed
@@ -20,6 +21,6 @@
    Add validation for user input
    ```
 
-{{#unless hooksInstalled}}6.{{/unless}}{{#if hooksInstalled}}5.{{/if}} Push your commit to the remote repository
+{{#unless hooksInstalled}}7.{{/unless}}{{#if hooksInstalled}}6.{{/if}} Push your commit to the remote repository
 
 Keep your change small and focused. One task, one commit.

package/templates/templates/agent-pick-task.txt

@@ -4,4 +4,4 @@ Follow these steps:
 
 1. Run `{{bin}} next` to see available tasks
 2. Pick ONE task and read its file to understand the requirements
-3. Run `{{bin}} agent implement task` for instructions about how to implement
+3. Run `{{bin}} implement task` for instructions about how to implement