@joshski/dust 0.1.45 → 0.1.47

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

@@ -577,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)
@@ -606,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)
@@ -636,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)
@@ -665,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)
@@ -693,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)
@@ -721,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)
@@ -750,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)
@@ -780,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)
@@ -809,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)
@@ -1593,12 +1629,19 @@ function rawEventToAgentEvent(rawEvent) {
   }
   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":
-      return `\uD83E\uDD16 Starting Claude: ${event.title}`;
+    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 Claude session ended (success)" : `\uD83E\uDD16 Claude session ended (error: ${event.error})`;
+      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;
@@ -1699,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: [] };
   }
@@ -1777,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":
@@ -1864,7 +1913,8 @@ async function findAvailableTasks(dependencies) {
 async function runOneIteration(dependencies, loopDependencies, onLoopEvent, onAgentEvent, options = {}) {
   const { context } = dependencies;
   const { spawn, run: run2 } = loopDependencies;
-  const { onRawEvent } = options;
+  const agentName = loopDependencies.agentType === "codex" ? "Codex" : "Claude";
+  const { onRawEvent, hooksInstalled = false } = options;
   onLoopEvent({ type: "loop.syncing" });
   const pullResult = await gitPull(context.cwd, spawn);
   if (!pullResult.success) {
@@ -1888,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)
     });
@@ -1905,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,
@@ -1923,7 +1973,7 @@ 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, true, task.title ?? undefined);
+  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}\`:
@@ -1941,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)
   });
@@ -1958,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,
@@ -2001,12 +2051,17 @@ async function loopClaude(dependencies, loopDependencies = createDefaultDependen
     }
     sendWireEvent(event);
   };
+  const hooksInstalled = await manageGitHooks(dependencies);
   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;
-  const iterationOptions = {};
+  const iterationOptions = { hooksInstalled };
   if (eventsUrl) {
     iterationOptions.onRawEvent = (rawEvent) => {
       onAgentEvent(rawEventToAgentEvent(rawEvent));
@@ -2117,9 +2172,11 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
       sendEvent(msg);
     }
   };
+  const hooksInstalled = await manageGitHooks(commandDeps);
   while (!repoState.stopRequested) {
     agentSessionId = crypto.randomUUID();
     const result = await runOneIteration(commandDeps, loopDeps, onLoopEvent, onAgentEvent, {
+      hooksInstalled,
       onRawEvent: (rawEvent) => {
         onAgentEvent(rawEventToAgentEvent(rawEvent));
       }
@@ -2751,6 +2808,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(() => {}),
@@ -4281,6 +4339,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:";
@@ -4611,6 +4788,7 @@ var commandRegistry = {
   "implement task": implementTask,
   "pick task": pickTask,
   "loop claude": loopClaude,
+  "loop codex": loopCodex,
   "pre push": prePush,
   help
 };
@@ -4677,6 +4855,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.45",
+  "version": "0.1.47",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {