@joshski/dust 0.1.54 → 0.1.56

package/dist/agents/detection.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Agent detection module
+ *
+ * Provides type-safe detection of which agent environment is running
+ * based on environment variables.
+ */
+export type Agent = {
+    type: 'claude-code-web';
+    name: 'Claude Code Web';
+} | {
+    type: 'claude-code';
+    name: 'Claude Code';
+} | {
+    type: 'codex';
+    name: 'Codex';
+} | {
+    type: 'unknown';
+    name: 'Agent';
+};
+export type AgentType = Agent['type'];
+/**
+ * Detects which agent environment is running based on environment variables.
+ *
+ * Detection priority:
+ * 1. CLAUDECODE + CLAUDE_CODE_REMOTE → Claude Code Web
+ * 2. CLAUDECODE alone → Claude Code
+ * 3. CODEX_HOME or CODEX_CI → Codex
+ * 4. Fallback → unknown Agent
+ */
+export declare function detectAgent(env?: NodeJS.ProcessEnv): Agent;

package/dist/agents.js

@@ -0,0 +1,16 @@
+// lib/agents/detection.ts
+function detectAgent(env = process.env) {
+  if (env.CLAUDECODE) {
+    if (env.CLAUDE_CODE_REMOTE) {
+      return { type: "claude-code-web", name: "Claude Code Web" };
+    }
+    return { type: "claude-code", name: "Claude Code" };
+  }
+  if (env.CODEX_HOME || env.CODEX_CI) {
+    return { type: "codex", name: "Codex" };
+  }
+  return { type: "unknown", name: "Agent" };
+}
+export {
+  detectAgent
+};

package/dist/cli/types.d.ts

@@ -4,6 +4,7 @@
 export interface CommandContext {
     cwd: string;
     stdout: (message: string) => void;
+    stdoutInline?: (message: string) => void;
     stderr: (message: string) => void;
 }
 export interface CommandResult {

package/dist/dust.js

@@ -269,7 +269,7 @@ function detectAgent(env = process.env) {
     }
     return { type: "claude-code", name: "Claude Code" };
   }
-  if (env.CODEX_HOME) {
+  if (env.CODEX_HOME || env.CODEX_CI) {
     return { type: "codex", name: "Codex" };
   }
   return { type: "unknown", name: "Agent" };
@@ -1925,8 +1925,7 @@ function formatLoopEvent(event) {
     case "loop.checking_tasks":
       return null;
     case "loop.no_tasks":
-      return `\uD83D\uDE34 No tasks available. Sleeping...
-`;
+      return "\uD83D\uDE34 No tasks available. Sleeping...";
     case "loop.tasks_found":
       return `✨ Found a task. Going to work!
 `;
@@ -1973,7 +1972,18 @@ function createWireEventSender(eventsUrl, sessionId, postEvent, onError, getAgen
 }
 var log = createLogger("dust.cli.commands.loop");
 var SLEEP_INTERVAL_MS = 30000;
+var SLEEP_STEP_MS = 1000;
 var DEFAULT_MAX_ITERATIONS = 10;
+async function sleepWithProgress(sleep, totalMs, writeInline, writeLine) {
+  let remainingMs = totalMs;
+  while (remainingMs > 0) {
+    const stepMs = Math.min(SLEEP_STEP_MS, remainingMs);
+    await sleep(stepMs);
+    writeInline(".");
+    remainingMs -= stepMs;
+  }
+  writeLine("");
+}
 async function gitPull(cwd, spawn) {
   return new Promise((resolve) => {
     const proc = spawn("git", ["pull"], {
@@ -2172,7 +2182,8 @@ async function loopClaude(dependencies, loopDependencies = createDefaultDependen
     const result = await runOneIteration(dependencies, loopDependencies, onLoopEvent, onAgentEvent, iterationOptions);
     if (result === "no_tasks") {
       log("sleeping, no tasks");
-      await loopDependencies.sleep(SLEEP_INTERVAL_MS);
+      const writeInline = context.stdoutInline ?? context.stdout;
+      await sleepWithProgress(loopDependencies.sleep, SLEEP_INTERVAL_MS, writeInline, context.stdout);
     } else {
       completedIterations++;
       log(`iteration ${completedIterations}/${maxIterations} complete, result=${result}`);
@@ -3706,17 +3717,15 @@ function validateIdeaOpenQuestions(filePath, content) {
   const violations = [];
   const lines = content.split(`
 `);
+  const topLevelStructureMessage = "Open Questions must use `### Question?` headings and `#### Option` headings at the top level. Put supporting markdown (including lists and code blocks) under an option heading. Run `dust new idea` to see the expected format.";
   let inOpenQuestions = false;
   let currentQuestionLine = null;
+  let inOption = false;
   let inCodeBlock = false;
   for (let i = 0;i < lines.length; i++) {
     const line = lines[i];
-    if (line.startsWith("```")) {
-      inCodeBlock = !inCodeBlock;
-      continue;
-    }
-    if (inCodeBlock)
-      continue;
+    const trimmedLine = line.trimEnd();
+    const nonWhitespaceLine = line.trim();
     if (line.startsWith("## ")) {
       if (inOpenQuestions && currentQuestionLine !== null) {
         violations.push({
@@ -3735,19 +3744,27 @@ function validateIdeaOpenQuestions(filePath, content) {
       }
       inOpenQuestions = line === "## Open Questions";
       currentQuestionLine = null;
+      inOption = false;
+      inCodeBlock = false;
       continue;
     }
     if (!inOpenQuestions)
       continue;
-    if (/^[-*] /.test(line.trimStart())) {
-      violations.push({
-        file: filePath,
-        message: "Open Questions must use ### headings for questions and #### headings for options, not bullet points. Run `dust new idea` to see the expected format.",
-        line: i + 1
-      });
+    if (line.startsWith("```")) {
+      if (!inOption && !inCodeBlock) {
+        violations.push({
+          file: filePath,
+          message: topLevelStructureMessage,
+          line: i + 1
+        });
+      }
+      inCodeBlock = !inCodeBlock;
       continue;
     }
+    if (inCodeBlock)
+      continue;
     if (line.startsWith("### ")) {
+      inOption = false;
       if (currentQuestionLine !== null) {
         violations.push({
           file: filePath,
@@ -3755,7 +3772,7 @@ function validateIdeaOpenQuestions(filePath, content) {
           line: currentQuestionLine
         });
       }
-      if (!line.trimEnd().endsWith("?")) {
+      if (!trimmedLine.endsWith("?")) {
         violations.push({
           file: filePath,
           message: 'Questions must end with "?" (e.g., "### Should we take our own payments?")',
@@ -3769,6 +3786,15 @@ function validateIdeaOpenQuestions(filePath, content) {
     }
     if (line.startsWith("#### ")) {
       currentQuestionLine = null;
+      inOption = true;
+      continue;
+    }
+    if (nonWhitespaceLine && !inOption) {
+      violations.push({
+        file: filePath,
+        message: topLevelStructureMessage,
+        line: i + 1
+      });
     }
   }
   if (inOpenQuestions && currentQuestionLine !== null) {
@@ -5125,6 +5151,7 @@ async function wireEntry(fsPrimitives, processPrimitives, consolePrimitives) {
     context: {
       cwd: processPrimitives.cwd(),
       stdout: consolePrimitives.log,
+      stdoutInline: consolePrimitives.write,
       stderr: consolePrimitives.error
     },
     fileSystem,
@@ -5140,4 +5167,10 @@ await wireEntry({ existsSync, statSync: statSync2, readFile: readFile2, writeFil
   exit: (code) => {
     process.exitCode = code;
   }
-}, { log: console.log, error: console.error });
+}, {
+  log: console.log,
+  write: (message) => {
+    process.stdout.write(message);
+  },
+  error: console.error
+});

package/dist/workflow-tasks.js

@@ -111,9 +111,10 @@ async function createIdeaTask(fileSystem, dustPath, prefix, ideaSlug, openingSen
   return { filePath };
 }
 async function createRefineIdeaTask(fileSystem, dustPath, ideaSlug, description) {
-  return createIdeaTask(fileSystem, dustPath, "Refine Idea: ", ideaSlug, (ideaTitle) => `Thoroughly research this idea and refine it into a well-defined proposal. Read the idea file, explore the codebase for relevant context, and identify any ambiguity. Where aspects are unclear or could go multiple ways, add open questions to the idea file. Review \`.dust/goals/\` for alignment and \`.dust/facts/\` for relevant design decisions. See [${ideaTitle}](../ideas/${ideaSlug}.md).`, [
+  return createIdeaTask(fileSystem, dustPath, "Refine Idea: ", ideaSlug, (ideaTitle) => `Thoroughly research this idea and refine it into a well-defined proposal. Read the idea file, explore the codebase for relevant context, and identify any ambiguity. Where aspects are unclear or could go multiple ways, add open questions to the idea file. Review \`.dust/goals/\` for alignment and \`.dust/facts/\` for relevant design decisions. See [${ideaTitle}](../ideas/${ideaSlug}.md). If you add open questions, use \`## Open Questions\` with \`### Question?\` headings and one or more \`#### Option\` headings beneath each question, and only add questions that are meaningful decisions worth asking.`, [
     "Idea is thoroughly researched with relevant codebase context",
     "Open questions are added for any ambiguous or underspecified aspects",
+    "Open questions follow the required heading format and focus on high-value decisions",
     "Idea file is updated with findings"
   ], { description });
 }
@@ -174,7 +175,7 @@ ${description}
   const ideaPath = `.dust/ideas/${ideaFilename}`;
   const content = `# ${taskTitle}
 
-Research this idea thoroughly, then create an idea file at \`${ideaPath}\`. Read the codebase for relevant context, flesh out the description, and identify any ambiguity. Where aspects are unclear or could go multiple ways, add open questions to the idea file. Review \`.dust/goals/\` and \`.dust/facts/\` for relevant context.
+Research this idea thoroughly, then create an idea file at \`${ideaPath}\`. Read the codebase for relevant context, flesh out the description, and identify any ambiguity. Where aspects are unclear or could go multiple ways, add open questions to the idea file. If you add open questions, use \`## Open Questions\` with \`### Question?\` headings and one or more \`#### Option\` headings beneath each question, and only add questions that are meaningful decisions worth asking. Review \`.dust/goals/\` and \`.dust/facts/\` for relevant context.
 
 ## Idea Description
 
@@ -194,6 +195,7 @@ ${description}
 - [ ] Idea file has an H1 title matching "${title}"
 - [ ] Idea includes relevant context from codebase exploration
 - [ ] Open questions are added for any ambiguous or underspecified aspects
+- [ ] Open questions follow the required heading format and focus on high-value decisions
 `;
   await fileSystem.writeFile(filePath, content);
   return { filePath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.54",
+  "version": "0.1.56",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {
@@ -18,6 +18,10 @@
       "import": "./dist/logging.js",
       "types": "./dist/logging/index.d.ts"
     },
+    "./agents": {
+      "import": "./dist/agents.js",
+      "types": "./dist/agents/detection.d.ts"
+    },
     "./istanbul/minimal-reporter": "./lib/istanbul/minimal-reporter.cjs"
   },
   "files": [
@@ -38,7 +42,7 @@
   "author": "joshski",
   "license": "MIT",
   "scripts": {
-    "build": "bun build lib/cli/run.ts --target node --outfile dist/dust.js && printf '%s\\n%s' '#!/usr/bin/env node' \"$(cat dist/dust.js)\" > dist/dust.js && bun build lib/workflow-tasks.ts --target node --outfile dist/workflow-tasks.js && bun build lib/logging/index.ts --target node --outfile dist/logging.js && bunx tsc --project tsconfig.build.json",
+    "build": "bun build lib/cli/run.ts --target node --outfile dist/dust.js && printf '%s\\n%s' '#!/usr/bin/env node' \"$(cat dist/dust.js)\" > dist/dust.js && bun build lib/workflow-tasks.ts --target node --outfile dist/workflow-tasks.js && bun build lib/logging/index.ts --target node --outfile dist/logging.js && bun build lib/agents/detection.ts --target node --outfile dist/agents.js && bunx tsc --project tsconfig.build.json",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "eval": "bun run ./evals/run.ts"