@joshski/dust 0.1.76 → 0.1.78

package/dist/agent-events.d.ts

@@ -30,6 +30,7 @@ export interface EventMessage {
     timestamp: string;
     sessionId: string;
     repository: string;
+    repoId?: number;
     agentSessionId?: string;
     event: AgentSessionEvent;
 }

package/dist/artifacts/index.d.ts

@@ -3,8 +3,19 @@ import { type Fact } from './facts';
 import { type Idea, type IdeaOpenQuestion, type IdeaOption, parseOpenQuestions } from './ideas';
 import { type Principle } from './principles';
 import { type Task } from './tasks';
-import { type AllWorkflowTasks, CAPTURE_IDEA_PREFIX, type CreateIdeaTransitionTaskResult, type DecomposeIdeaOptions, findAllWorkflowTasks, type IdeaInProgress, type OpenQuestionResponse, type ParsedCaptureIdeaTask, type WorkflowTaskMatch } from './workflow-tasks';
-export type { AllWorkflowTasks, CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, Fact, Idea, IdeaOpenQuestion, IdeaOption, OpenQuestionResponse, ParsedCaptureIdeaTask, Principle, Task, WorkflowTaskMatch, };
+import { type AllWorkflowTasks, CAPTURE_IDEA_PREFIX, type CreateIdeaTransitionTaskResult, type DecomposeIdeaOptions, findAllWorkflowTasks, type IdeaInProgress, type OpenQuestionResponse, type ParsedCaptureIdeaTask, type WorkflowTaskMatch, type WorkflowTaskType } from './workflow-tasks';
+export type { AllWorkflowTasks, CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, Fact, Idea, IdeaOpenQuestion, IdeaOption, OpenQuestionResponse, ParsedCaptureIdeaTask, Principle, Task, WorkflowTaskMatch, WorkflowTaskType, };
+export interface TaskGraphNode {
+    task: Task;
+    workflowType: WorkflowTaskType | null;
+}
+export interface TaskGraph {
+    nodes: TaskGraphNode[];
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+}
 export { CAPTURE_IDEA_PREFIX, findAllWorkflowTasks, parseOpenQuestions };
 export type { IdeaInProgress };
 export interface ArtifactsRepository {
@@ -49,6 +60,7 @@ export interface ArtifactsRepository {
     parseCaptureIdeaTask(options: {
         taskSlug: string;
     }): Promise<ParsedCaptureIdeaTask | null>;
+    buildTaskGraph(): Promise<TaskGraph>;
 }
 export declare function buildArtifactsRepository(fileSystem: FileSystem, dustPath: string): ArtifactsRepository;
-export declare function buildReadOnlyArtifactsRepository(fileSystem: ReadableFileSystem, dustPath: string): Pick<ArtifactsRepository, 'parseIdea' | 'listIdeas' | 'parsePrinciple' | 'listPrinciples' | 'parseFact' | 'listFacts' | 'parseTask' | 'listTasks' | 'findWorkflowTaskForIdea' | 'parseCaptureIdeaTask'>;
+export declare function buildReadOnlyArtifactsRepository(fileSystem: ReadableFileSystem, dustPath: string): Pick<ArtifactsRepository, 'parseIdea' | 'listIdeas' | 'parsePrinciple' | 'listPrinciples' | 'parseFact' | 'listFacts' | 'parseTask' | 'listTasks' | 'findWorkflowTaskForIdea' | 'parseCaptureIdeaTask' | 'buildTaskGraph'>;

package/dist/artifacts.js

@@ -609,6 +609,27 @@ function buildArtifactsRepository(fileSystem, dustPath) {
     },
     async parseCaptureIdeaTask(options) {
       return parseCaptureIdeaTask(fileSystem, dustPath, options.taskSlug);
+    },
+    async buildTaskGraph() {
+      const taskSlugs = await this.listTasks();
+      const allWorkflowTasks = await findAllWorkflowTasks(fileSystem, dustPath);
+      const workflowTypeByTaskSlug = new Map;
+      for (const match of allWorkflowTasks.workflowTasksByIdeaSlug.values()) {
+        workflowTypeByTaskSlug.set(match.taskSlug, match.type);
+      }
+      const nodes = [];
+      const edges = [];
+      for (const slug of taskSlugs) {
+        const task = await this.parseTask({ slug });
+        nodes.push({
+          task,
+          workflowType: workflowTypeByTaskSlug.get(slug) ?? null
+        });
+        for (const blockerSlug of task.blockedBy) {
+          edges.push({ from: blockerSlug, to: slug });
+        }
+      }
+      return { nodes, edges };
     }
   };
 }
@@ -663,6 +684,27 @@ function buildReadOnlyArtifactsRepository(fileSystem, dustPath) {
     },
     async parseCaptureIdeaTask(options) {
       return parseCaptureIdeaTask(fileSystem, dustPath, options.taskSlug);
+    },
+    async buildTaskGraph() {
+      const taskSlugs = await this.listTasks();
+      const allWorkflowTasks = await findAllWorkflowTasks(fileSystem, dustPath);
+      const workflowTypeByTaskSlug = new Map;
+      for (const match of allWorkflowTasks.workflowTasksByIdeaSlug.values()) {
+        workflowTypeByTaskSlug.set(match.taskSlug, match.type);
+      }
+      const nodes = [];
+      const edges = [];
+      for (const slug of taskSlugs) {
+        const task = await this.parseTask({ slug });
+        nodes.push({
+          task,
+          workflowType: workflowTypeByTaskSlug.get(slug) ?? null
+        });
+        for (const blockerSlug of task.blockedBy) {
+          edges.push({ from: blockerSlug, to: slug });
+        }
+      }
+      return { nodes, edges };
     }
   };
 }

package/dist/audits.js

@@ -831,6 +831,75 @@ function ubiquitousLanguage() {
     - [ ] Proposed ideas for standardizing inconsistent terminology
   `;
 }
+function uxAudit() {
+  return dedent`
+    # UX Audit
+
+    Review the end user experience by capturing visual or interactive evidence at key scenarios.
+
+    ${ideasHint}
+
+    ## Scope
+
+    1. **Identify key scenarios** - What are the main user journeys? (e.g., signup, login, checkout, onboarding, core workflows)
+    2. **Capture evidence** - For each scenario:
+       - Web apps: Take screenshots at each step using browser automation (Playwright, Puppeteer, Cypress, or similar)
+       - Terminal apps: Capture command output and interactive sessions
+    3. **Review captured evidence** for UX issues:
+       - Confusing or unclear states
+       - Missing feedback or loading indicators
+       - Error messages that don't guide recovery
+       - Inconsistent styling or layout
+    4. **Document findings** with screenshots/output and specific recommendations
+
+    ## Applicability
+
+    Determine the application type and available tooling:
+    - If browser tests exist (Playwright, Puppeteer, Cypress), extend them to capture screenshots
+    - If no browser tests exist, write a standalone script for key scenarios
+    - For terminal apps, capture representative sessions using command output or terminal recording
+
+    If the project has no user-facing interface, document that finding and skip the detailed analysis.
+
+    ## Analysis Steps
+
+    1. Identify the application type (web, terminal, hybrid, no UI)
+    2. List the key user scenarios from documentation, tests, or code analysis
+    3. Capture screenshots or output at each stage of each scenario
+    4. Store artifacts in a temporary directory for review during this audit
+    5. Review each artifact for UX issues
+    6. Document findings with evidence and specific recommendations
+
+    ## Output
+
+    For each UX issue identified, provide:
+    - **Location** - Which scenario and step
+    - **Evidence** - Screenshot filename or captured output
+    - **Problem** - What's wrong from the user's perspective
+    - **Impact** - How it affects the user's ability to complete their goal
+    - **Recommendation** - Specific fix
+    - **Verification** - How to verify the fix (e.g., "Screenshot at step 3 should show success message instead of spinner")
+
+    ## Principles
+
+    - [Actionable Errors](../principles/actionable-errors.md) - Error messages should tell users what to do next
+    - [Unsurprising UX](../principles/unsurprising-ux.md) - The interface should be as guessable as possible
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] Identified the application type (web, terminal, hybrid, or no UI)
+    - [ ] Listed key user scenarios
+    - [ ] Captured screenshots or output at each stage of key scenarios
+    - [ ] Reviewed evidence for UX issues
+    - [ ] Documented findings with evidence and recommendations
+    - [ ] Included verification criteria for each issue
+    - [ ] Created ideas for any UX improvements needed
+  `;
+}
 var stockAuditFunctions = {
   "agent-developer-experience": agentDeveloperExperience,
   "component-reuse": componentReuse,
@@ -849,7 +918,8 @@ var stockAuditFunctions = {
   "slow-tests": slowTests,
   "stale-ideas": staleIdeas,
   "test-coverage": testCoverage,
-  "ubiquitous-language": ubiquitousLanguage
+  "ubiquitous-language": ubiquitousLanguage,
+  "ux-audit": uxAudit
 };
 function loadStockAudits() {
   return Object.entries(stockAuditFunctions).sort(([a], [b]) => a.localeCompare(b)).map(([name, render]) => {

package/dist/bucket/repository-loop.d.ts

@@ -30,6 +30,7 @@ export declare function buildEventMessage(parameters: {
     sequence: number;
     sessionId: string;
     repository: string;
+    repoId?: number;
     event: AgentSessionEvent;
     agentSessionId?: string;
 }): EventMessage;

package/dist/cli/colors.d.ts

@@ -17,7 +17,7 @@ interface Colors {
 /**
  * Determines whether colors should be disabled based on environment.
  */
-export declare function shouldDisableColors(): boolean;
+export declare function shouldDisableColors(env?: NodeJS.ProcessEnv): boolean;
 /**
  * Returns the appropriate colors object based on environment detection.
  */

package/dist/cli/commands/focus.d.ts

@@ -7,5 +7,5 @@
  * Usage: dust focus "add login box"
  */
 import type { CommandDependencies, CommandResult } from '../types';
-export declare function buildImplementationInstructions(bin: string, hooksInstalled: boolean, taskTitle?: string): string;
+export declare function buildImplementationInstructions(bin: string, hooksInstalled: boolean, taskTitle?: string, taskPath?: string, installCommand?: string): string;
 export declare function focus(dependencies: CommandDependencies): Promise<CommandResult>;

package/dist/config/settings.d.ts

@@ -20,15 +20,14 @@ export declare function validateSettingsJson(content: string): SettingsViolation
  */
 export declare function detectDustCommand(cwd: string, fileSystem: ReadableFileSystem): string;
 /**
- * Detects the appropriate install command based on lockfiles and environment.
- * Priority:
- * 1. bun.lockb exists → bun install
- * 2. pnpm-lock.yaml exists → pnpm install
- * 3. package-lock.json exists → npm install
- * 4. No lockfile + BUN_INSTALL env var set → bun install
- * 5. Default → npm install
+ * Detects the appropriate install command based on lockfiles.
+ * Returns null when:
+ * - No recognized lockfile is found
+ * - Multiple ecosystems are detected (requires explicit configuration)
+ *
+ * Priority within each ecosystem follows the order in LOCKFILE_COMMANDS.
  */
-export declare function detectInstallCommand(cwd: string, fileSystem: ReadableFileSystem): string;
+export declare function detectInstallCommand(cwd: string, fileSystem: ReadableFileSystem): string | null;
 /**
  * Detects the appropriate test command based on lockfiles and environment.
  * Priority:

package/dist/dust.js

@@ -170,8 +170,7 @@ function validateSettingsJson(content) {
   return violations;
 }
 var DEFAULT_SETTINGS = {
-  dustCommand: "npx dust",
-  installCommand: "npm install"
+  dustCommand: "npx dust"
 };
 function detectDustCommand(cwd, fileSystem) {
   if (fileSystem.exists(join(cwd, "bun.lockb"))) {
@@ -188,20 +187,38 @@ function detectDustCommand(cwd, fileSystem) {
   }
   return "npx dust";
 }
+var LOCKFILE_COMMANDS = [
+  { file: "bun.lockb", command: "bun install", ecosystem: "js" },
+  { file: "pnpm-lock.yaml", command: "pnpm install", ecosystem: "js" },
+  { file: "package-lock.json", command: "npm install", ecosystem: "js" },
+  { file: "Gemfile.lock", command: "bundle install", ecosystem: "ruby" },
+  { file: "poetry.lock", command: "poetry install", ecosystem: "python" },
+  { file: "Pipfile.lock", command: "pipenv install", ecosystem: "python" },
+  {
+    file: "requirements.txt",
+    command: "pip install -r requirements.txt",
+    ecosystem: "python"
+  },
+  { file: "go.sum", command: "go mod download", ecosystem: "go" },
+  { file: "Cargo.lock", command: "cargo build", ecosystem: "rust" },
+  { file: "composer.lock", command: "composer install", ecosystem: "php" },
+  { file: "mix.lock", command: "mix deps.get", ecosystem: "elixir" }
+];
 function detectInstallCommand(cwd, fileSystem) {
-  if (fileSystem.exists(join(cwd, "bun.lockb"))) {
-    return "bun install";
-  }
-  if (fileSystem.exists(join(cwd, "pnpm-lock.yaml"))) {
-    return "pnpm install";
-  }
-  if (fileSystem.exists(join(cwd, "package-lock.json"))) {
-    return "npm install";
+  const foundEcosystems = new Set;
+  let firstCommand = null;
+  for (const { file, command, ecosystem } of LOCKFILE_COMMANDS) {
+    if (fileSystem.exists(join(cwd, file))) {
+      if (firstCommand === null) {
+        firstCommand = command;
+      }
+      foundEcosystems.add(ecosystem);
+    }
   }
-  if (process.env.BUN_INSTALL) {
-    return "bun install";
+  if (foundEcosystems.size > 1) {
+    return null;
   }
-  return "npm install";
+  return firstCommand;
 }
 function detectTestCommand(cwd, fileSystem) {
   if (fileSystem.exists(join(cwd, "bun.lockb")) || fileSystem.exists(join(cwd, "bun.lock"))) {
@@ -234,9 +251,12 @@ async function loadSettings(cwd, fileSystem) {
   const settingsPath = join(cwd, ".dust", "config", "settings.json");
   if (!fileSystem.exists(settingsPath)) {
     const result = {
-      dustCommand: detectDustCommand(cwd, fileSystem),
-      installCommand: detectInstallCommand(cwd, fileSystem)
+      dustCommand: detectDustCommand(cwd, fileSystem)
     };
+    const installCommand = detectInstallCommand(cwd, fileSystem);
+    if (installCommand !== null) {
+      result.installCommand = installCommand;
+    }
     if (process.env.DUST_EVENTS_URL) {
       result.eventsUrl = process.env.DUST_EVENTS_URL;
     }
@@ -256,26 +276,37 @@ async function loadSettings(cwd, fileSystem) {
       result.dustCommand = detectDustCommand(cwd, fileSystem);
     }
     if (!parsed.installCommand) {
-      result.installCommand = detectInstallCommand(cwd, fileSystem);
+      const installCommand = detectInstallCommand(cwd, fileSystem);
+      if (installCommand !== null) {
+        result.installCommand = installCommand;
+      } else {
+        delete result.installCommand;
+      }
     }
     if (process.env.DUST_EVENTS_URL) {
       result.eventsUrl = process.env.DUST_EVENTS_URL;
     }
     return result;
-  } catch {
-    const result = {
-      dustCommand: detectDustCommand(cwd, fileSystem),
-      installCommand: detectInstallCommand(cwd, fileSystem)
-    };
-    if (process.env.DUST_EVENTS_URL) {
-      result.eventsUrl = process.env.DUST_EVENTS_URL;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      const result = {
+        dustCommand: detectDustCommand(cwd, fileSystem)
+      };
+      const installCommand = detectInstallCommand(cwd, fileSystem);
+      if (installCommand !== null) {
+        result.installCommand = installCommand;
+      }
+      if (process.env.DUST_EVENTS_URL) {
+        result.eventsUrl = process.env.DUST_EVENTS_URL;
+      }
+      return result;
     }
-    return result;
+    throw error;
   }
 }
 
 // lib/version.ts
-var DUST_VERSION = "0.1.76";
+var DUST_VERSION = "0.1.78";
 
 // lib/session.ts
 var DUST_UNATTENDED = "DUST_UNATTENDED";
@@ -460,8 +491,11 @@ async function loadAgentInstructions(cwd, fileSystem, agentType) {
   try {
     const content = await fileSystem.readFile(instructionsPath);
     return content.trim();
-  } catch {
-    return "";
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return "";
+    }
+    throw error;
   }
 }
 function templateVariables(settings, hooksInstalled, env = process.env, options) {
@@ -1378,6 +1412,75 @@ function ubiquitousLanguage() {
     - [ ] Proposed ideas for standardizing inconsistent terminology
   `;
 }
+function uxAudit() {
+  return dedent`
+    # UX Audit
+
+    Review the end user experience by capturing visual or interactive evidence at key scenarios.
+
+    ${ideasHint}
+
+    ## Scope
+
+    1. **Identify key scenarios** - What are the main user journeys? (e.g., signup, login, checkout, onboarding, core workflows)
+    2. **Capture evidence** - For each scenario:
+       - Web apps: Take screenshots at each step using browser automation (Playwright, Puppeteer, Cypress, or similar)
+       - Terminal apps: Capture command output and interactive sessions
+    3. **Review captured evidence** for UX issues:
+       - Confusing or unclear states
+       - Missing feedback or loading indicators
+       - Error messages that don't guide recovery
+       - Inconsistent styling or layout
+    4. **Document findings** with screenshots/output and specific recommendations
+
+    ## Applicability
+
+    Determine the application type and available tooling:
+    - If browser tests exist (Playwright, Puppeteer, Cypress), extend them to capture screenshots
+    - If no browser tests exist, write a standalone script for key scenarios
+    - For terminal apps, capture representative sessions using command output or terminal recording
+
+    If the project has no user-facing interface, document that finding and skip the detailed analysis.
+
+    ## Analysis Steps
+
+    1. Identify the application type (web, terminal, hybrid, no UI)
+    2. List the key user scenarios from documentation, tests, or code analysis
+    3. Capture screenshots or output at each stage of each scenario
+    4. Store artifacts in a temporary directory for review during this audit
+    5. Review each artifact for UX issues
+    6. Document findings with evidence and specific recommendations
+
+    ## Output
+
+    For each UX issue identified, provide:
+    - **Location** - Which scenario and step
+    - **Evidence** - Screenshot filename or captured output
+    - **Problem** - What's wrong from the user's perspective
+    - **Impact** - How it affects the user's ability to complete their goal
+    - **Recommendation** - Specific fix
+    - **Verification** - How to verify the fix (e.g., "Screenshot at step 3 should show success message instead of spinner")
+
+    ## Principles
+
+    - [Actionable Errors](../principles/actionable-errors.md) - Error messages should tell users what to do next
+    - [Unsurprising UX](../principles/unsurprising-ux.md) - The interface should be as guessable as possible
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] Identified the application type (web, terminal, hybrid, or no UI)
+    - [ ] Listed key user scenarios
+    - [ ] Captured screenshots or output at each stage of key scenarios
+    - [ ] Reviewed evidence for UX issues
+    - [ ] Documented findings with evidence and recommendations
+    - [ ] Included verification criteria for each issue
+    - [ ] Created ideas for any UX improvements needed
+  `;
+}
 var stockAuditFunctions = {
   "agent-developer-experience": agentDeveloperExperience,
   "component-reuse": componentReuse,
@@ -1396,7 +1499,8 @@ var stockAuditFunctions = {
   "slow-tests": slowTests,
   "stale-ideas": staleIdeas,
   "test-coverage": testCoverage,
-  "ubiquitous-language": ubiquitousLanguage
+  "ubiquitous-language": ubiquitousLanguage,
+  "ux-audit": uxAudit
 };
 function loadStockAudits() {
   return Object.entries(stockAuditFunctions).sort(([a], [b]) => a.localeCompare(b)).map(([name, render]) => {
@@ -1451,11 +1555,11 @@ var NO_COLORS = {
   green: "",
   yellow: ""
 };
-function shouldDisableColors() {
-  if (process.env.NO_COLOR !== undefined) {
+function shouldDisableColors(env = process.env) {
+  if (env.NO_COLOR !== undefined) {
     return true;
   }
-  if (process.env.TERM === "dumb") {
+  if (env.TERM === "dumb") {
     return true;
   }
   if (!process.stdout.isTTY) {
@@ -1571,8 +1675,8 @@ var CREDENTIALS_DIR = ".dust";
 var CREDENTIALS_FILE = "credentials.json";
 var AUTH_TIMEOUT_MS = 120000;
 var DEFAULT_DUSTBUCKET_HOST = "https://dustbucket.com";
-function getDustbucketHost() {
-  return process.env.DUST_BUCKET_HOST || DEFAULT_DUSTBUCKET_HOST;
+function getDustbucketHost(env = process.env) {
+  return env.DUST_BUCKET_HOST || DEFAULT_DUSTBUCKET_HOST;
 }
 function credentialsPath(homeDir) {
   return join4(homeDir, CREDENTIALS_DIR, CREDENTIALS_FILE);
@@ -1583,8 +1687,11 @@ async function loadStoredToken(fileSystem, homeDir) {
     const content = await fileSystem.readFile(path);
     const data = JSON.parse(content);
     return typeof data.token === "string" ? data.token : null;
-  } catch {
-    return null;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
   }
 }
 async function storeToken(fileSystem, homeDir, token) {
@@ -1596,7 +1703,12 @@ async function clearToken(fileSystem, homeDir) {
   const path = credentialsPath(homeDir);
   try {
     await fileSystem.writeFile(path, "{}");
-  } catch {}
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return;
+    }
+    throw error;
+  }
 }
 async function defaultExchangeCode(code) {
   const host = getDustbucketHost();
@@ -1777,6 +1889,134 @@ import { dirname as dirname2 } from "node:path";
 // lib/claude/spawn-claude-code.ts
 import { spawn as nodeSpawn2 } from "node:child_process";
 import { createInterface as nodeCreateInterface } from "node:readline";
+
+// lib/logging/index.ts
+import { join as join6 } from "node:path";
+
+// lib/logging/match.ts
+function parsePatterns(debug) {
+  if (!debug)
+    return [];
+  const expressions = debug.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  return expressions.map((expr) => {
+    const escaped = expr.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+    const pattern = escaped.replace(/\*/g, ".*");
+    return new RegExp(`^${pattern}$`);
+  });
+}
+function matchesAny(name, patterns) {
+  return patterns.some((re) => re.test(name));
+}
+function formatLine(name, messages) {
+  const text = messages.map((a) => typeof a === "string" ? a : JSON.stringify(a)).join(" ");
+  return `${new Date().toISOString()} [${name}] ${text}
+`;
+}
+
+// lib/logging/sink.ts
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+
+class FileSink {
+  logPath;
+  _appendFileSync;
+  _mkdirSync;
+  resolvedPath;
+  ready = false;
+  constructor(logPath, _appendFileSync = appendFileSync, _mkdirSync = mkdirSync) {
+    this.logPath = logPath;
+    this._appendFileSync = _appendFileSync;
+    this._mkdirSync = _mkdirSync;
+  }
+  ensureLogFile() {
+    if (this.ready)
+      return this.resolvedPath;
+    this.ready = true;
+    this.resolvedPath = this.logPath;
+    try {
+      this._mkdirSync(dirname(this.logPath), { recursive: true });
+    } catch {
+      this.resolvedPath = undefined;
+    }
+    return this.resolvedPath;
+  }
+  write(line) {
+    const path = this.ensureLogFile();
+    if (!path)
+      return;
+    try {
+      this._appendFileSync(path, line);
+    } catch {}
+  }
+}
+
+// lib/logging/index.ts
+var DUST_LOG_FILE = "DUST_LOG_FILE";
+function createLoggingService() {
+  let patterns = null;
+  let initialized = false;
+  let activeFileSink = null;
+  const fileSinkCache = new Map;
+  function init() {
+    if (initialized)
+      return;
+    initialized = true;
+    const parsed = parsePatterns(process.env.DEBUG);
+    patterns = parsed.length > 0 ? parsed : null;
+  }
+  function getOrCreateFileSink(path) {
+    let sink = fileSinkCache.get(path);
+    if (!sink) {
+      sink = new FileSink(path);
+      fileSinkCache.set(path, sink);
+    }
+    return sink;
+  }
+  return {
+    enableFileLogs(scope, sinkForTesting) {
+      const existing = process.env[DUST_LOG_FILE];
+      const logDir = process.env.DUST_LOG_DIR ?? join6(process.cwd(), "log");
+      const path = existing ?? join6(logDir, `${scope}.log`);
+      if (!existing) {
+        process.env[DUST_LOG_FILE] = path;
+      }
+      activeFileSink = sinkForTesting ?? new FileSink(path);
+    },
+    createLogger(name, options) {
+      let perLoggerSink;
+      if (options?.file === false) {
+        perLoggerSink = null;
+      } else if (typeof options?.file === "string") {
+        perLoggerSink = getOrCreateFileSink(options.file);
+      }
+      return (...messages) => {
+        init();
+        const line = formatLine(name, messages);
+        if (perLoggerSink !== undefined) {
+          if (perLoggerSink !== null) {
+            perLoggerSink.write(line);
+          }
+        } else if (activeFileSink) {
+          activeFileSink.write(line);
+        }
+        if (patterns && matchesAny(name, patterns)) {
+          process.stdout.write(line);
+        }
+      };
+    },
+    isEnabled(name) {
+      init();
+      return patterns !== null && matchesAny(name, patterns);
+    }
+  };
+}
+var defaultService = createLoggingService();
+var enableFileLogs = defaultService.enableFileLogs.bind(defaultService);
+var createLogger = defaultService.createLogger.bind(defaultService);
+var isEnabled = defaultService.isEnabled.bind(defaultService);
+
+// lib/claude/spawn-claude-code.ts
+var debug = createLogger("dust.claude.spawn-claude-code");
 var defaultDependencies = {
   spawn: nodeSpawn2,
   createInterface: nodeCreateInterface
@@ -1859,7 +2099,9 @@ async function* spawnClaudeCode(prompt, options = {}, dependencies = defaultDepe
         continue;
       try {
         yield JSON.parse(line);
-      } catch {}
+      } catch {
+        debug("Skipping malformed JSON line: %s", line.slice(0, 200));
+      }
     }
     await closePromise;
   } finally {
@@ -2190,131 +2432,6 @@ async function run(prompt, options = {}, dependencies = defaultRunnerDependencie
   await dependencies.streamEvents(events, sink, onRawEvent);
 }
 
-// lib/logging/index.ts
-import { join as join6 } from "node:path";
-
-// lib/logging/match.ts
-function parsePatterns(debug) {
-  if (!debug)
-    return [];
-  const expressions = debug.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
-  return expressions.map((expr) => {
-    const escaped = expr.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
-    const pattern = escaped.replace(/\*/g, ".*");
-    return new RegExp(`^${pattern}$`);
-  });
-}
-function matchesAny(name, patterns) {
-  return patterns.some((re) => re.test(name));
-}
-function formatLine(name, messages) {
-  const text = messages.map((a) => typeof a === "string" ? a : JSON.stringify(a)).join(" ");
-  return `${new Date().toISOString()} [${name}] ${text}
-`;
-}
-
-// lib/logging/sink.ts
-import { appendFileSync, mkdirSync } from "node:fs";
-import { dirname } from "node:path";
-
-class FileSink {
-  logPath;
-  _appendFileSync;
-  _mkdirSync;
-  resolvedPath;
-  ready = false;
-  constructor(logPath, _appendFileSync = appendFileSync, _mkdirSync = mkdirSync) {
-    this.logPath = logPath;
-    this._appendFileSync = _appendFileSync;
-    this._mkdirSync = _mkdirSync;
-  }
-  ensureLogFile() {
-    if (this.ready)
-      return this.resolvedPath;
-    this.ready = true;
-    this.resolvedPath = this.logPath;
-    try {
-      this._mkdirSync(dirname(this.logPath), { recursive: true });
-    } catch {
-      this.resolvedPath = undefined;
-    }
-    return this.resolvedPath;
-  }
-  write(line) {
-    const path = this.ensureLogFile();
-    if (!path)
-      return;
-    try {
-      this._appendFileSync(path, line);
-    } catch {}
-  }
-}
-
-// lib/logging/index.ts
-var DUST_LOG_FILE = "DUST_LOG_FILE";
-function createLoggingService() {
-  let patterns = null;
-  let initialized = false;
-  let activeFileSink = null;
-  const fileSinkCache = new Map;
-  function init() {
-    if (initialized)
-      return;
-    initialized = true;
-    const parsed = parsePatterns(process.env.DEBUG);
-    patterns = parsed.length > 0 ? parsed : null;
-  }
-  function getOrCreateFileSink(path) {
-    let sink = fileSinkCache.get(path);
-    if (!sink) {
-      sink = new FileSink(path);
-      fileSinkCache.set(path, sink);
-    }
-    return sink;
-  }
-  return {
-    enableFileLogs(scope, sinkForTesting) {
-      const existing = process.env[DUST_LOG_FILE];
-      const logDir = process.env.DUST_LOG_DIR ?? join6(process.cwd(), "log");
-      const path = existing ?? join6(logDir, `${scope}.log`);
-      if (!existing) {
-        process.env[DUST_LOG_FILE] = path;
-      }
-      activeFileSink = sinkForTesting ?? new FileSink(path);
-    },
-    createLogger(name, options) {
-      let perLoggerSink;
-      if (options?.file === false) {
-        perLoggerSink = null;
-      } else if (typeof options?.file === "string") {
-        perLoggerSink = getOrCreateFileSink(options.file);
-      }
-      return (...messages) => {
-        init();
-        const line = formatLine(name, messages);
-        if (perLoggerSink !== undefined) {
-          if (perLoggerSink !== null) {
-            perLoggerSink.write(line);
-          }
-        } else if (activeFileSink) {
-          activeFileSink.write(line);
-        }
-        if (patterns && matchesAny(name, patterns)) {
-          process.stdout.write(line);
-        }
-      };
-    },
-    isEnabled(name) {
-      init();
-      return patterns !== null && matchesAny(name, patterns);
-    }
-  };
-}
-var defaultService = createLoggingService();
-var enableFileLogs = defaultService.enableFileLogs.bind(defaultService);
-var createLogger = defaultService.createLogger.bind(defaultService);
-var isEnabled = defaultService.isEnabled.bind(defaultService);
-
 // lib/bucket/repository-git.ts
 import { join as join7 } from "node:path";
 function getRepoPath(repoName, reposDir) {
@@ -2402,11 +2519,15 @@ function titleToFilename(title) {
 }
 
 // lib/cli/commands/focus.ts
-function buildImplementationInstructions(bin, hooksInstalled, taskTitle) {
+function buildImplementationInstructions(bin, hooksInstalled, taskTitle, taskPath, installCommand) {
   const steps = [];
   let step = 1;
   const hasIdeaFile = !taskTitle?.startsWith(EXPEDITE_IDEA_PREFIX);
   steps.push(`Note: Do NOT run \`${bin} agent\`.`, "");
+  if (installCommand) {
+    steps.push(`${step}. Run \`${installCommand}\` to install dependencies`);
+    step++;
+  }
   steps.push(`${step}. Run \`${bin} check\` to verify the project is in a good state`);
   step++;
   steps.push(`${step}. Implement the task`);
@@ -2416,10 +2537,11 @@ function buildImplementationInstructions(bin, hooksInstalled, taskTitle) {
     step++;
   }
   const commitMessageLine = taskTitle ? `   Use this exact commit message: "${taskTitle}". Do not add any prefix.` : '   Use the task title as the commit message. Do not add prefixes like "Complete task:" - use the title directly.';
+  const deleteTaskLine = taskPath ? `   - Deletion of the completed task file (\`${taskPath}\`)` : "   - Deletion of the completed task file";
   const commitItems = [
     "   - All implementation changes",
-    "   - Deletion of the completed task file",
-    "   - Updates to any facts that changed"
+    deleteTaskLine,
+    `   - Updates to any facts that changed (run \`${bin} facts\` if needed)`
   ];
   if (hasIdeaFile) {
     commitItems.push("   - Deletion of the idea file that spawned this task (if remaining scope exists, create new ideas for it)");
@@ -2725,18 +2847,14 @@ Make sure the repository is in a clean state and synced with remote before finis
   onLoopEvent({ type: "loop.tasks_found" });
   const taskContent = await dependencies.fileSystem.readFile(`${dependencies.context.cwd}/${task.path}`);
   const { dustCommand, installCommand = "npm install" } = dependencies.settings;
-  const instructions = buildImplementationInstructions(dustCommand, hooksInstalled, task.title ?? undefined);
-  const prompt = `Run \`${installCommand}\` to install dependencies, then implement the following task.
-
-The following is the contents of the task file \`${task.path}\`:
+  const instructions = buildImplementationInstructions(dustCommand, hooksInstalled, task.title ?? undefined, task.path, installCommand);
+  const prompt = `Implement the task at \`${task.path}\`:
 
 ----------
 ${taskContent}
 ----------
 
-When the task is complete, delete the task file \`${task.path}\`.
-
-## Instructions
+## How to implement the task
 
 ${instructions}`;
   onAgentEvent?.({
@@ -2877,6 +2995,9 @@ function buildEventMessage(parameters) {
     repository: parameters.repository,
     event: parameters.event
   };
+  if (parameters.repoId !== undefined) {
+    msg.repoId = parameters.repoId;
+  }
   if (parameters.agentSessionId) {
     msg.agentSessionId = parameters.agentSessionId;
   }
@@ -2962,6 +3083,7 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
         sequence,
         sessionId,
         repository: repoName,
+        repoId: repoState.repository.id,
         event,
         agentSessionId
       }));
@@ -3965,7 +4087,12 @@ async function shutdown(state, bucketDeps, context) {
     repoState.wakeUp?.();
   }
   const loopPromises = Array.from(state.repositories.values()).map((rs) => rs.loopPromise).filter((p) => p !== null);
-  await Promise.all(loopPromises.map((p) => p.catch(() => {})));
+  const results = await Promise.allSettled(loopPromises);
+  for (const result of results) {
+    if (result.status === "rejected") {
+      context.stderr(`Repository loop failed: ${result.reason}`);
+    }
+  }
   for (const repoState of state.repositories.values()) {
     await removeRepository(repoState.path, bucketDeps.spawn, context);
   }
@@ -5624,6 +5751,7 @@ async function list(dependencies) {
 // lib/codex/spawn-codex.ts
 import { spawn as nodeSpawn5 } from "node:child_process";
 import { createInterface as nodeCreateInterface2 } from "node:readline";
+var debug2 = createLogger("dust.codex.spawn-codex");
 var defaultDependencies2 = {
   spawn: nodeSpawn5,
   createInterface: nodeCreateInterface2
@@ -5673,7 +5801,9 @@ async function* spawnCodex(prompt, options = {}, dependencies = defaultDependenc
         continue;
       try {
         yield JSON.parse(line);
-      } catch {}
+      } catch {
+        debug2("Skipping malformed JSON line: %s", line.slice(0, 200));
+      }
     }
     await closePromise;
   } finally {

package/dist/types.d.ts

@@ -6,5 +6,7 @@
  */
 export type { AgentSessionEvent, EventMessage } from './agent-events';
 export type { Idea, IdeaOpenQuestion, IdeaOption } from './artifacts/ideas';
+export type { TaskGraph, TaskGraphNode } from './artifacts/index';
+export type { Task } from './artifacts/tasks';
 export type { CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, IdeaInProgress, OpenQuestionResponse, ParsedCaptureIdeaTask, WorkflowTaskMatch, WorkflowTaskType, } from './artifacts/workflow-tasks';
 export type { Repository } from './bucket/repository';

package/dist/validation.js

@@ -730,7 +730,11 @@ function createOverlayFileSystem(base, patchFiles, deletedPaths = new Set) {
             entries.add(entry);
           }
         }
-      } catch {}
+      } catch (error) {
+        if (error.code !== "ENOENT") {
+          throw error;
+        }
+      }
       return Array.from(entries);
     },
     isDirectory(path) {
@@ -821,7 +825,11 @@ async function validatePatch(fileSystem, dustPath, patch) {
         const content = await overlayFs.readFile(filePath);
         allRelationships.push(extractPrincipleRelationships(filePath, content));
       }
-    } catch {}
+    } catch (error) {
+      if (error.code !== "ENOENT") {
+        throw error;
+      }
+    }
     violations.push(...validateBidirectionalLinks(allRelationships));
     violations.push(...validateNoCycles(allRelationships));
   }

package/package.json

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