@joshski/dust 0.1.44 → 0.1.46

package/dist/agent-events.d.ts

@@ -39,8 +39,4 @@ export interface EventMessage {
  * is forwarded as a claude-event.
  */
 export declare function rawEventToAgentEvent(rawEvent: Record<string, unknown>): AgentSessionEvent;
-/**
- * Format an AgentSessionEvent for console output.
- * Returns null for events that should not be displayed.
- */
 export declare function formatAgentEvent(event: AgentSessionEvent): string | null;

package/dist/cli/types.d.ts

@@ -22,6 +22,7 @@ export interface FileSystem {
     readdir: (path: string) => Promise<string[]>;
     chmod: (path: string, mode: number) => Promise<void>;
     isDirectory: (path: string) => boolean;
+    getFileCreationTime: (path: string) => number;
 }
 export interface GlobScanner {
     scan: (dir: string) => AsyncIterable<string>;

package/dist/dust.js

@@ -18,129 +18,128 @@ var KNOWN_CHECK_KEYS = new Set([
   "hints",
   "timeoutMilliseconds"
 ]);
-function validateSettingsJson(content) {
+function validateCheckEntry(check, checkPath) {
   const violations = [];
-  let parsed;
-  try {
-    parsed = JSON.parse(content);
-  } catch (error) {
-    violations.push({
-      message: `Invalid JSON: ${error.message}`
-    });
+  if (typeof check === "string") {
     return violations;
   }
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    violations.push({
-      message: "settings.json must be a JSON object"
-    });
+  if (typeof check !== "object" || check === null || Array.isArray(check)) {
+    violations.push({ message: `${checkPath} must be a string or object` });
     return violations;
   }
-  const settings = parsed;
-  for (const key of Object.keys(settings)) {
-    if (!KNOWN_SETTINGS_KEYS.has(key)) {
+  const checkObj = check;
+  for (const key of Object.keys(checkObj)) {
+    if (!KNOWN_CHECK_KEYS.has(key)) {
       violations.push({
-        message: `Unknown key "${key}" in settings.json. Known keys: ${[...KNOWN_SETTINGS_KEYS].sort().join(", ")}`
+        message: `Unknown key "${key}" in ${checkPath}. Known keys: ${[...KNOWN_CHECK_KEYS].sort().join(", ")}`
       });
     }
   }
-  if ("checks" in settings) {
-    if (!Array.isArray(settings.checks)) {
+  if (!("name" in checkObj)) {
+    violations.push({
+      message: `${checkPath} is missing required field "name"`
+    });
+  } else if (typeof checkObj.name !== "string") {
+    violations.push({ message: `${checkPath}.name must be a string` });
+  }
+  if (!("command" in checkObj)) {
+    violations.push({
+      message: `${checkPath} is missing required field "command"`
+    });
+  } else if (typeof checkObj.command !== "string") {
+    violations.push({ message: `${checkPath}.command must be a string` });
+  }
+  if ("hints" in checkObj) {
+    if (!Array.isArray(checkObj.hints)) {
       violations.push({
-        message: '"checks" must be an array'
+        message: `${checkPath}.hints must be an array of strings`
       });
     } else {
-      for (let i = 0;i < settings.checks.length; i++) {
-        const check = settings.checks[i];
-        const checkPath = `checks[${i}]`;
-        if (typeof check === "string") {
-          continue;
-        }
-        if (typeof check !== "object" || check === null || Array.isArray(check)) {
-          violations.push({
-            message: `${checkPath} must be a string or object`
-          });
-          continue;
-        }
-        const checkObj = check;
-        for (const key of Object.keys(checkObj)) {
-          if (!KNOWN_CHECK_KEYS.has(key)) {
-            violations.push({
-              message: `Unknown key "${key}" in ${checkPath}. Known keys: ${[...KNOWN_CHECK_KEYS].sort().join(", ")}`
-            });
-          }
-        }
-        if (!("name" in checkObj)) {
-          violations.push({
-            message: `${checkPath} is missing required field "name"`
-          });
-        } else if (typeof checkObj.name !== "string") {
-          violations.push({
-            message: `${checkPath}.name must be a string`
-          });
-        }
-        if (!("command" in checkObj)) {
-          violations.push({
-            message: `${checkPath} is missing required field "command"`
-          });
-        } else if (typeof checkObj.command !== "string") {
+      for (let j = 0;j < checkObj.hints.length; j++) {
+        if (typeof checkObj.hints[j] !== "string") {
           violations.push({
-            message: `${checkPath}.command must be a string`
+            message: `${checkPath}.hints[${j}] must be a string`
           });
         }
-        if ("hints" in checkObj) {
-          if (!Array.isArray(checkObj.hints)) {
-            violations.push({
-              message: `${checkPath}.hints must be an array of strings`
-            });
-          } else {
-            for (let j = 0;j < checkObj.hints.length; j++) {
-              if (typeof checkObj.hints[j] !== "string") {
-                violations.push({
-                  message: `${checkPath}.hints[${j}] must be a string`
-                });
-              }
-            }
-          }
-        }
-        if ("timeoutMilliseconds" in checkObj) {
-          if (typeof checkObj.timeoutMilliseconds !== "number" || checkObj.timeoutMilliseconds <= 0) {
-            violations.push({
-              message: `${checkPath}.timeoutMilliseconds must be a positive number`
-            });
-          }
-        }
       }
     }
   }
-  if ("extraDirectories" in settings) {
-    if (!Array.isArray(settings.extraDirectories)) {
+  if ("timeoutMilliseconds" in checkObj) {
+    if (typeof checkObj.timeoutMilliseconds !== "number" || checkObj.timeoutMilliseconds <= 0) {
       violations.push({
-        message: '"extraDirectories" must be an array of strings'
+        message: `${checkPath}.timeoutMilliseconds must be a positive number`
       });
-    } else {
-      for (let i = 0;i < settings.extraDirectories.length; i++) {
-        if (typeof settings.extraDirectories[i] !== "string") {
-          violations.push({
-            message: `extraDirectories[${i}] must be a string`
-          });
-        }
-      }
     }
   }
-  if ("dustCommand" in settings && typeof settings.dustCommand !== "string") {
-    violations.push({
-      message: '"dustCommand" must be a string'
-    });
+  return violations;
+}
+function validateChecksConfig(settings) {
+  if (!("checks" in settings)) {
+    return [];
   }
-  if ("installCommand" in settings && typeof settings.installCommand !== "string") {
+  if (!Array.isArray(settings.checks)) {
+    return [{ message: '"checks" must be an array' }];
+  }
+  const violations = [];
+  for (let i = 0;i < settings.checks.length; i++) {
+    violations.push(...validateCheckEntry(settings.checks[i], `checks[${i}]`));
+  }
+  return violations;
+}
+function validateExtraDirectories(settings) {
+  if (!("extraDirectories" in settings)) {
+    return [];
+  }
+  if (!Array.isArray(settings.extraDirectories)) {
+    return [{ message: '"extraDirectories" must be an array of strings' }];
+  }
+  const violations = [];
+  for (let i = 0;i < settings.extraDirectories.length; i++) {
+    if (typeof settings.extraDirectories[i] !== "string") {
+      violations.push({ message: `extraDirectories[${i}] must be a string` });
+    }
+  }
+  return violations;
+}
+function validateDustEventsUrl(settings) {
+  if ("eventsUrl" in settings && typeof settings.eventsUrl !== "string") {
+    return [{ message: '"eventsUrl" must be a string' }];
+  }
+  return [];
+}
+function validateSettingsJson(content) {
+  const violations = [];
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch (error) {
     violations.push({
-      message: '"installCommand" must be a string'
+      message: `Invalid JSON: ${error.message}`
     });
+    return violations;
   }
-  if ("eventsUrl" in settings && typeof settings.eventsUrl !== "string") {
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
     violations.push({
-      message: '"eventsUrl" must be a string'
+      message: "settings.json must be a JSON object"
     });
+    return violations;
+  }
+  const settings = parsed;
+  for (const key of Object.keys(settings)) {
+    if (!KNOWN_SETTINGS_KEYS.has(key)) {
+      violations.push({
+        message: `Unknown key "${key}" in settings.json. Known keys: ${[...KNOWN_SETTINGS_KEYS].sort().join(", ")}`
+      });
+    }
+  }
+  violations.push(...validateChecksConfig(settings));
+  violations.push(...validateExtraDirectories(settings));
+  violations.push(...validateDustEventsUrl(settings));
+  if ("dustCommand" in settings && typeof settings.dustCommand !== "string") {
+    violations.push({ message: '"dustCommand" must be a string' });
+  }
+  if ("installCommand" in settings && typeof settings.installCommand !== "string") {
+    violations.push({ message: '"installCommand" must be a string' });
   }
   return violations;
 }
@@ -578,6 +577,10 @@ function agentDeveloperExperience() {
     4. **Debugging tools** - Can agents diagnose issues without trial and error?
     5. **Structured logging** - Is system behavior observable through logs?
 
+    ## Goals
+
+    (none)
+
     ## Blocked By
 
     (none)
@@ -607,6 +610,10 @@ function deadCode() {
     4. **Unused dependencies** - Packages in package.json not used in code
     5. **Commented-out code** - Old code left in comments
 
+    ## Goals
+
+    (none)
+
     ## Blocked By
 
     (none)
@@ -637,6 +644,10 @@ function factsVerification() {
     3. **Staleness** - Have facts become outdated due to recent changes?
     4. **Relevance** - Are all facts still useful for understanding the project?
 
+    ## Goals
+
+    (none)
+
     ## Blocked By
 
     (none)
@@ -666,6 +677,10 @@ function ideasFromCommits() {
     3. **Pattern opportunities** - Can recent changes be generalized?
     4. **Test gaps** - Do recent changes have adequate test coverage?
 
+    ## Goals
+
+    (none)
+
     ## Blocked By
 
     (none)
@@ -694,6 +709,10 @@ function ideasFromGoals() {
     3. **New opportunities** - What work would better achieve each goal?
     4. **Goal alignment** - Are current tasks aligned with stated goals?
 
+    ## Goals
+
+    (none)
+
     ## Blocked By
 
     (none)
@@ -722,6 +741,10 @@ function performanceReview() {
     4. **Build performance** - How fast is the build process?
     5. **Test speed** - Are tests running efficiently?
 
+    ## Goals
+
+    (none)
+
     ## Blocked By
 
     (none)
@@ -751,6 +774,10 @@ function securityReview() {
     4. **Sensitive data exposure** - Logging sensitive data, insecure storage
     5. **Dependency vulnerabilities** - Known CVEs in dependencies
 
+    ## Goals
+
+    (none)
+
     ## Blocked By
 
     (none)
@@ -781,6 +808,10 @@ function staleIdeas() {
     3. **Actionability** - Can the idea be converted to a task?
     4. **Duplication** - Are there overlapping or redundant ideas?
 
+    ## Goals
+
+    (none)
+
     ## Blocked By
 
     (none)
@@ -810,6 +841,10 @@ function testCoverage() {
     4. **User-facing features** - UI components, form validation
     5. **Recent changes** - Code modified in the last few commits
 
+    ## Goals
+
+    (none)
+
     ## Blocked By
 
     (none)
@@ -973,7 +1008,7 @@ import { accessSync, statSync } from "node:fs";
 import { chmod, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { createServer as httpCreateServer } from "node:http";
 import { homedir } from "node:os";
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 
 // lib/bucket/auth.ts
 import { join as join4 } from "node:path";
@@ -1046,7 +1081,29 @@ async function authenticate(authDeps) {
         if (code) {
           cleanup();
           exchange(code).then(resolve, reject);
-          return new Response("<html><body><p>Authentication successful! You can close this tab.</p></body></html>", { headers: { "Content-Type": "text/html" } });
+          return new Response(`<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Authorized</title>
+  <style>
+    body { font-family: system-ui, sans-serif; display: flex; justify-content: center; align-items: center; min-height: 100vh; margin: 0; background: #0a0a0a; color: #fafafa; }
+    .card { text-align: center; padding: 2rem; border: 1px solid #333; border-radius: 8px; max-width: 400px; }
+    h1 { font-size: 1.25rem; margin-bottom: 1rem; }
+    p { color: #999; }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <svg width="64" height="64" viewBox="0 0 512 512" fill="#fafafa" xmlns="http://www.w3.org/2000/svg" style="margin-bottom: 1rem;">
+      <path d="M392.566 159.4c-.649-79.601-31.851-134.481-80.25-141.944l-1.443-10.127a8.52 8.52 0 0 0-3.339-5.619 8.52 8.52 0 0 0-6.327-1.622l-92.99 13.287c-4.671.666-7.916 4.995-7.25 9.666l1.605 11.229c-.709.179-1.417.307-2.075.692-52.122 30.126-68.688 71.677-77.346 122.859-34.293 13.773-55.008 33.157-55.008 55.316 0 11.997 6.242 23.149 17.24 33.072-.12.922 42.712 207.763 42.712 207.763.06.273.128.555.213.828 10.64 33.678 63.146 57.203 127.693 57.203 66.963 0 118.308-23.107 127.906-58.031 0 0 42.832-206.841 42.712-207.763 10.998-9.922 17.24-21.074 17.24-33.072.001-21.34-19.264-40.083-51.293-53.737m-276.281 51.072a2180 2180 0 0 1-4.022 33.712c-17.326-9.606-27.043-20.545-27.043-31.048 0-11.989 12.723-24.541 34.933-35.044-1.374 10.452-2.612 21.219-3.868 32.38m88.849-158.254.658 4.637a8.52 8.52 0 0 0 3.339 5.619 8.5 8.5 0 0 0 5.123 1.708c.401 0 .811-.026 1.213-.085l92.99-13.287c4.671-.666 7.916-4.995 7.25-9.666l-.837-5.858c35.497 9.077 58.509 53.642 60.482 117.634-32.021-10.477-73.214-16.634-119.35-16.634-43.797 0-83.051 5.593-114.312 15.123 8.205-41.8 23.439-74.573 63.444-99.191m50.867 220.691c-52.891 0-97.217-8.735-127.505-21.1 1.819-13.645 3.339-26.778 4.756-39.425 1.648-14.704 3.228-28.555 5.149-41.653 29.724-10.341 70.208-17.368 117.6-17.368 100.641 0 170.781 31.5 170.781 59.773s-70.14 59.773-170.781 59.773"/>
+    </svg>
+    <h1>Your agent is connected!</h1>
+    <p>You can close this tab.</p>
+  </div>
+</body>
+</html>`, { headers: { "Content-Type": "text/html" } });
         }
         return new Response("Missing code", { status: 400 });
       }
@@ -1120,26 +1177,7 @@ function getLogLines(buffer) {
 }
 
 // lib/bucket/repository.ts
-import { dirname as dirname2, join as join6 } from "node:path";
-
-// lib/agent-events.ts
-function rawEventToAgentEvent(rawEvent) {
-  if (typeof rawEvent.type === "string" && rawEvent.type === "stream_event") {
-    return { type: "agent-session-activity" };
-  }
-  return { type: "claude-event", rawEvent };
-}
-function formatAgentEvent(event) {
-  switch (event.type) {
-    case "agent-session-started":
-      return `\uD83E\uDD16 Starting Claude: ${event.title}`;
-    case "agent-session-ended":
-      return event.success ? "\uD83E\uDD16 Claude session ended (success)" : `\uD83E\uDD16 Claude session ended (error: ${event.error})`;
-    case "agent-session-activity":
-    case "claude-event":
-      return null;
-  }
-}
+import { dirname as dirname2, join as join7 } from "node:path";
 
 // lib/claude/spawn-claude-code.ts
 import { spawn as nodeSpawn } from "node:child_process";
@@ -1540,11 +1578,81 @@ async function run(prompt, options = {}, dependencies = defaultRunnerDependencie
   await dependencies.streamEvents(events, sink, onRawEvent);
 }
 
+// lib/bucket/repository-git.ts
+import { join as join5 } from "node:path";
+function getRepoPath(repoName, reposDir) {
+  const safeName = repoName.replace(/[^a-zA-Z0-9-_/]/g, "-");
+  return join5(reposDir, safeName);
+}
+async function cloneRepository(repository, targetPath, spawn, context) {
+  return new Promise((resolve) => {
+    const proc = spawn("git", ["clone", repository.gitUrl, targetPath], {
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let stderr = "";
+    proc.stderr?.on("data", (data) => {
+      stderr += data.toString();
+    });
+    proc.on("close", (code) => {
+      if (code === 0) {
+        resolve(true);
+      } else {
+        context.stderr(`Failed to clone ${repository.name}: ${stderr.trim()}`);
+        resolve(false);
+      }
+    });
+    proc.on("error", (error) => {
+      context.stderr(`Failed to clone ${repository.name}: ${error.message}`);
+      resolve(false);
+    });
+  });
+}
+async function removeRepository(path, spawn, context) {
+  return new Promise((resolve) => {
+    const proc = spawn("rm", ["-rf", path], {
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    proc.on("close", (code) => {
+      resolve(code === 0);
+    });
+    proc.on("error", (error) => {
+      context.stderr(`Failed to remove ${path}: ${error.message}`);
+      resolve(false);
+    });
+  });
+}
+
+// lib/agent-events.ts
+function rawEventToAgentEvent(rawEvent) {
+  if (typeof rawEvent.type === "string" && rawEvent.type === "stream_event") {
+    return { type: "agent-session-activity" };
+  }
+  return { type: "claude-event", rawEvent };
+}
+function agentDisplayName(agentType) {
+  if (agentType === "codex")
+    return "Codex";
+  return "Claude";
+}
+function formatAgentEvent(event) {
+  switch (event.type) {
+    case "agent-session-started": {
+      const name = agentDisplayName(event.agentType);
+      return `\uD83E\uDD16 Starting ${name}: ${event.title}`;
+    }
+    case "agent-session-ended":
+      return event.success ? "\uD83E\uDD16 Agent session ended (success)" : `\uD83E\uDD16 Agent session ended (error: ${event.error})`;
+    case "agent-session-activity":
+    case "claude-event":
+      return null;
+  }
+}
+
 // lib/cli/commands/loop.ts
 import { spawn as nodeSpawn2 } from "node:child_process";
 import { readFileSync } from "node:fs";
 import os from "node:os";
-import { dirname, join as join5 } from "node:path";
+import { dirname, join as join6 } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // lib/workflow-tasks.ts
@@ -1634,7 +1742,11 @@ async function findUnblockedTasks(cwd, fileSystem) {
     return { tasks: [] };
   }
   const files = await fileSystem.readdir(tasksPath);
-  const mdFiles = files.filter((f) => f.endsWith(".md")).sort();
+  const mdFiles = files.filter((f) => f.endsWith(".md")).sort((a, b) => {
+    const aTime = fileSystem.getFileCreationTime(`${tasksPath}/${a}`);
+    const bTime = fileSystem.getFileCreationTime(`${tasksPath}/${b}`);
+    return aTime - bTime;
+  });
   if (mdFiles.length === 0) {
     return { tasks: [] };
   }
@@ -1688,8 +1800,8 @@ async function next(dependencies) {
 var __dirname2 = dirname(fileURLToPath(import.meta.url));
 function getDustVersion() {
   const candidates = [
-    join5(__dirname2, "../../../package.json"),
-    join5(__dirname2, "../package.json")
+    join6(__dirname2, "../../../package.json"),
+    join6(__dirname2, "../package.json")
   ];
   for (const candidate of candidates) {
     try {
@@ -1712,8 +1824,10 @@ function formatLoopEvent(event) {
   switch (event.type) {
     case "loop.warning":
       return "⚠️  WARNING: This command skips all permission checks. Only use in a sandbox environment!";
-    case "loop.started":
-      return `\uD83D\uDD04 Starting dust loop claude (max ${event.maxIterations} iterations)...`;
+    case "loop.started": {
+      const agent2 = event.agentType ?? "claude";
+      return `\uD83D\uDD04 Starting dust loop ${agent2} (max ${event.maxIterations} iterations)...`;
+    }
     case "loop.syncing":
       return "\uD83C\uDF0D Syncing with remote";
     case "loop.sync_skipped":
@@ -1799,6 +1913,7 @@ async function findAvailableTasks(dependencies) {
 async function runOneIteration(dependencies, loopDependencies, onLoopEvent, onAgentEvent, options = {}) {
   const { context } = dependencies;
   const { spawn, run: run2 } = loopDependencies;
+  const agentName = loopDependencies.agentType === "codex" ? "Codex" : "Claude";
   const { onRawEvent } = options;
   onLoopEvent({ type: "loop.syncing" });
   const pullResult = await gitPull(context.cwd, spawn);
@@ -1823,7 +1938,7 @@ Make sure the repository is in a clean state and synced with remote before finis
       type: "agent-session-started",
       title: "Resolving git conflict",
       prompt: prompt2,
-      agentType: "claude",
+      agentType: loopDependencies.agentType ?? "claude",
       purpose: "git-conflict",
       ...getEnvironmentContext(context.cwd)
     });
@@ -1840,7 +1955,7 @@ Make sure the repository is in a clean state and synced with remote before finis
       return "resolved_pull_conflict";
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      context.stderr(`Claude failed to resolve git pull conflict: ${errorMessage}`);
+      context.stderr(`${agentName} failed to resolve git pull conflict: ${errorMessage}`);
       onAgentEvent?.({
         type: "agent-session-ended",
         success: false,
@@ -1876,7 +1991,7 @@ ${instructions}`;
     type: "agent-session-started",
     title: task.title ?? task.path,
     prompt,
-    agentType: "claude",
+    agentType: loopDependencies.agentType ?? "claude",
     purpose: "task",
     ...getEnvironmentContext(context.cwd)
   });
@@ -1893,7 +2008,7 @@ ${instructions}`;
     return "ran_claude";
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
-    context.stderr(`Claude exited with error: ${errorMessage}`);
+    context.stderr(`${agentName} exited with error: ${errorMessage}`);
     onAgentEvent?.({
       type: "agent-session-ended",
       success: false,
@@ -1937,7 +2052,11 @@ async function loopClaude(dependencies, loopDependencies = createDefaultDependen
     sendWireEvent(event);
   };
   onLoopEvent({ type: "loop.warning" });
-  onLoopEvent({ type: "loop.started", maxIterations });
+  onLoopEvent({
+    type: "loop.started",
+    maxIterations,
+    agentType: loopDependencies.agentType
+  });
   context.stdout("   Press Ctrl+C to stop");
   context.stdout("");
   let completedIterations = 0;
@@ -1965,68 +2084,8 @@ async function loopClaude(dependencies, loopDependencies = createDefaultDependen
   return { exitCode: 0 };
 }
 
-// lib/bucket/repository.ts
-var SLEEP_INTERVAL_MS2 = 30000;
-function parseRepository(data) {
-  if (typeof data === "string") {
-    return { name: data, gitUrl: data };
-  }
-  if (typeof data === "object" && data !== null && "name" in data && "gitUrl" in data) {
-    const repositoryData = data;
-    if (typeof repositoryData.name === "string" && typeof repositoryData.gitUrl === "string") {
-      const repo = {
-        name: repositoryData.name,
-        gitUrl: repositoryData.gitUrl
-      };
-      if (typeof repositoryData.url === "string") {
-        repo.url = repositoryData.url;
-      }
-      return repo;
-    }
-  }
-  return null;
-}
-function getRepoPath(repoName, reposDir) {
-  const safeName = repoName.replace(/[^a-zA-Z0-9-_/]/g, "-");
-  return join6(reposDir, safeName);
-}
-async function cloneRepository(repository, targetPath, spawn, context) {
-  return new Promise((resolve) => {
-    const proc = spawn("git", ["clone", repository.gitUrl, targetPath], {
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    let stderr = "";
-    proc.stderr?.on("data", (data) => {
-      stderr += data.toString();
-    });
-    proc.on("close", (code) => {
-      if (code === 0) {
-        resolve(true);
-      } else {
-        context.stderr(`Failed to clone ${repository.name}: ${stderr.trim()}`);
-        resolve(false);
-      }
-    });
-    proc.on("error", (error) => {
-      context.stderr(`Failed to clone ${repository.name}: ${error.message}`);
-      resolve(false);
-    });
-  });
-}
-async function removeRepository(path, spawn, context) {
-  return new Promise((resolve) => {
-    const proc = spawn("rm", ["-rf", path], {
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    proc.on("close", (code) => {
-      resolve(code === 0);
-    });
-    proc.on("error", (error) => {
-      context.stderr(`Failed to remove ${path}: ${error.message}`);
-      resolve(false);
-    });
-  });
-}
+// lib/bucket/repository-loop.ts
+var FALLBACK_TIMEOUT_MS = 300000;
 function createNoOpGlobScanner() {
   return {
     scan: async function* () {}
@@ -2120,11 +2179,42 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
       }
     });
     if (result === "no_tasks") {
-      await sleep(SLEEP_INTERVAL_MS2);
+      await new Promise((resolve) => {
+        repoState.wakeUp = () => {
+          repoState.wakeUp = undefined;
+          resolve();
+        };
+        sleep(FALLBACK_TIMEOUT_MS).then(() => {
+          if (repoState.wakeUp) {
+            repoState.wakeUp = undefined;
+            resolve();
+          }
+        });
+      });
     }
   }
   appendLogLine(repoState.logBuffer, createLogLine(`Stopped loop for ${repoName}`, "stdout"));
 }
+// lib/bucket/repository.ts
+function parseRepository(data) {
+  if (typeof data === "string") {
+    return { name: data, gitUrl: data };
+  }
+  if (typeof data === "object" && data !== null && "name" in data && "gitUrl" in data) {
+    const repositoryData = data;
+    if (typeof repositoryData.name === "string" && typeof repositoryData.gitUrl === "string") {
+      const repo = {
+        name: repositoryData.name,
+        gitUrl: repositoryData.gitUrl
+      };
+      if (typeof repositoryData.url === "string") {
+        repo.url = repositoryData.url;
+      }
+      return repo;
+    }
+  }
+  return null;
+}
 async function addRepository(repository, manager, repoDeps, context) {
   if (manager.repositories.has(repository.name)) {
     return;
@@ -2169,6 +2259,7 @@ async function removeRepositoryFromManager(repoName, manager, repoDeps, context)
     return;
   }
   repoState.stopRequested = true;
+  repoState.wakeUp?.();
   if (repoState.loopPromise) {
     await Promise.race([repoState.loopPromise, repoDeps.sleep(5000)]);
   }
@@ -2714,6 +2805,7 @@ function createDefaultBucketDependencies() {
         return false;
       }
     },
+    getFileCreationTime: (path) => statSync(path).birthtimeMs,
     readFile: (path) => readFile(path, "utf8"),
     writeFile: (path, content) => writeFile(path, content, "utf8"),
     mkdir: (path, options) => mkdir(path, options).then(() => {}),
@@ -2730,7 +2822,7 @@ function createDefaultBucketDependencies() {
     writeStdout: defaultWriteStdout,
     isTTY: process.stdout.isTTY ?? false,
     sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
-    getReposDir: () => process.env.DUST_REPOS_DIR || join7(homedir(), ".dust", "repos"),
+    getReposDir: () => process.env.DUST_REPOS_DIR || join8(homedir(), ".dust", "repos"),
     auth: {
       createServer: defaultCreateServer,
       openBrowser: defaultOpenBrowser,
@@ -2876,6 +2968,10 @@ function connectWebSocket(token, state, bucketDependencies, context, fileSystem,
     state.emit(disconnectEvent);
     logMessage(state, context, useTUI, formatBucketEvent(disconnectEvent));
     state.ws = null;
+    if (event.code === 4000) {
+      logMessage(state, context, useTUI, "Another connection replaced this one. Not reconnecting.");
+      return;
+    }
     if (!state.shuttingDown) {
       logMessage(state, context, useTUI, `Reconnecting in ${state.reconnectDelay / 1000} seconds...`);
       state.reconnectTimer = setTimeout(() => {
@@ -2896,9 +2992,23 @@ function connectWebSocket(token, state, bucketDependencies, context, fileSystem,
         syncUIWithRepoList(state, repos);
         const repoDeps = toRepositoryDependencies(bucketDependencies, fileSystem);
         const repoContext = createTUIContext(state, context, useTUI);
-        handleRepositoryList(repos, state, repoDeps, repoContext).then(() => syncTUI(state)).catch((error) => {
+        handleRepositoryList(repos, state, repoDeps, repoContext).then(() => {
+          syncTUI(state);
+          for (const repoData of repos) {
+            if (typeof repoData === "object" && repoData !== null && "name" in repoData && "hasTask" in repoData && repoData.hasTask) {
+              const repoState = state.repositories.get(repoData.name);
+              repoState?.wakeUp?.();
+            }
+          }
+        }).catch((error) => {
           logMessage(state, context, useTUI, `Failed to handle repository list: ${error.message}`, "stderr");
         });
+      } else if (message.type === "task-available") {
+        const repoName = message.repository;
+        if (typeof repoName === "string") {
+          const repoState = state.repositories.get(repoName);
+          repoState?.wakeUp?.();
+        }
       }
     } catch {
       logMessage(state, context, useTUI, `Failed to parse WebSocket message: ${event.data}`, "stderr");
@@ -2920,6 +3030,7 @@ async function shutdown(state, bucketDeps, context) {
   }
   for (const repoState of state.repositories.values()) {
     repoState.stopRequested = true;
+    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(() => {})));
@@ -3099,7 +3210,7 @@ function runBufferedProcess(spawnFn, command, commandArguments, cwd, shell, time
 }
 
 // lib/cli/commands/lint-markdown.ts
-import { dirname as dirname3, join as join8, resolve } from "node:path";
+import { dirname as dirname3, join as join9, resolve } from "node:path";
 var REQUIRED_HEADINGS = ["## Goals", "## Blocked By", "## Definition of Done"];
 var REQUIRED_GOAL_HEADINGS = ["## Parent Goal", "## Sub-Goals"];
 var SLUG_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*\.md$/;
@@ -3636,7 +3747,7 @@ async function lintMarkdown(dependencies) {
   const violations = [];
   context.stdout("Validating directory structure...");
   violations.push(...await validateDirectoryStructure(dustPath, fileSystem, dependencies.settings.extraDirectories));
-  const settingsPath = join8(dustPath, "config", "settings.json");
+  const settingsPath = join9(dustPath, "config", "settings.json");
   if (fileSystem.exists(settingsPath)) {
     context.stdout("Validating settings.json...");
     try {
@@ -4225,6 +4336,125 @@ async function list(dependencies) {
   return { exitCode: 0 };
 }
 
+// lib/codex/spawn-codex.ts
+import { spawn as nodeSpawn4 } from "node:child_process";
+import { createInterface as nodeCreateInterface2 } from "node:readline";
+var defaultDependencies2 = {
+  spawn: nodeSpawn4,
+  createInterface: nodeCreateInterface2
+};
+async function* spawnCodex(prompt, options = {}, dependencies = defaultDependencies2) {
+  const { cwd, env } = options;
+  const codexArguments = ["exec", prompt, "--json", "--yolo"];
+  if (cwd) {
+    codexArguments.push("--cd", cwd);
+  }
+  const proc = dependencies.spawn("codex", codexArguments, {
+    stdio: ["ignore", "pipe", "pipe"],
+    env: { ...process.env, ...env }
+  });
+  if (!proc.stdout) {
+    throw new Error("Failed to get stdout from codex process");
+  }
+  const rl = dependencies.createInterface({ input: proc.stdout });
+  for await (const line of rl) {
+    if (!line.trim())
+      continue;
+    try {
+      yield JSON.parse(line);
+    } catch {}
+  }
+  let stderrOutput = "";
+  proc.stderr?.on("data", (data) => {
+    stderrOutput += data.toString();
+  });
+  await new Promise((resolve2, reject) => {
+    proc.on("close", (code) => {
+      if (code === 0 || code === null)
+        resolve2();
+      else {
+        const errMsg = stderrOutput.trim() ? `codex exited with code ${code}: ${stderrOutput.trim()}` : `codex exited with code ${code}`;
+        reject(new Error(errMsg));
+      }
+    });
+    proc.on("error", reject);
+  });
+}
+
+// lib/codex/event-parser.ts
+function* parseCodexRawEvent(raw) {
+  if (raw.type !== "item.completed")
+    return;
+  const item = raw.item;
+  if (!item)
+    return;
+  if (item.type === "agent_message" && typeof item.text === "string") {
+    yield { type: "text_delta", text: `${item.text}
+` };
+  } else if (item.type === "command_execution" && typeof item.command === "string") {
+    yield {
+      type: "tool_use",
+      id: typeof item.id === "string" ? item.id : "",
+      name: "command_execution",
+      input: { command: item.command }
+    };
+    if (typeof item.aggregated_output === "string") {
+      yield {
+        type: "tool_result",
+        toolUseId: typeof item.id === "string" ? item.id : "",
+        content: item.aggregated_output || `(exit code: ${item.exit_code ?? "unknown"})`
+      };
+    }
+  }
+}
+
+// lib/codex/streamer.ts
+async function streamCodexEvents(events, sink, onRawEvent) {
+  let hadTextOutput = false;
+  for await (const raw of events) {
+    onRawEvent?.(raw);
+    for (const event of parseCodexRawEvent(raw)) {
+      processEvent(event, sink, { hadTextOutput });
+      if (event.type === "text_delta") {
+        hadTextOutput = true;
+      } else if (event.type === "tool_use") {
+        hadTextOutput = false;
+      }
+    }
+  }
+}
+
+// lib/codex/run.ts
+var defaultRunnerDependencies2 = {
+  spawnCodex,
+  createStdoutSink,
+  streamCodexEvents
+};
+async function run2(prompt, options = {}, dependencies = defaultRunnerDependencies2) {
+  const isRunOptions = (opt) => ("spawnOptions" in opt) || ("onRawEvent" in opt);
+  const spawnOptions = isRunOptions(options) ? options.spawnOptions ?? {} : options;
+  const onRawEvent = isRunOptions(options) ? options.onRawEvent : undefined;
+  const events = dependencies.spawnCodex(prompt, spawnOptions);
+  const sink = dependencies.createStdoutSink();
+  await dependencies.streamCodexEvents(events, sink, onRawEvent);
+}
+
+// lib/cli/commands/loop-codex.ts
+function createCodexDependencies(overrides = {}) {
+  return {
+    ...createDefaultDependencies(),
+    run: run2,
+    ...overrides,
+    agentType: "codex"
+  };
+}
+async function loopCodex(dependencies, loopDependencies = createCodexDependencies()) {
+  return loopClaude(dependencies, {
+    ...loopDependencies,
+    agentType: "codex"
+  });
+}
+
 // lib/cli/commands/new-goal.ts
 function newGoalInstructions(vars) {
   const intro = vars.isClaudeCodeWeb ? "Follow these steps. Use a todo list to track your progress." : "Follow these steps:";
@@ -4555,6 +4785,7 @@ var commandRegistry = {
   "implement task": implementTask,
   "pick task": pickTask,
   "loop claude": loopClaude,
+  "loop codex": loopCodex,
   "pre push": prePush,
   help
 };
@@ -4621,6 +4852,7 @@ function createFileSystem(primitives) {
     mkdir: async (path, options) => {
       await primitives.mkdir(path, options);
     },
+    getFileCreationTime: (path) => primitives.statSync(path).birthtimeMs,
     readdir: (path) => primitives.readdir(path),
     chmod: (path, mode) => primitives.chmod(path, mode)
   };

package/package.json

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