@joshski/dust 0.1.92 → 0.1.93

package/dist/artifacts/index.d.ts

@@ -40,6 +40,7 @@ export interface ArtifactsRepository {
     createRefineIdeaTask(options: {
         ideaSlug: string;
         description?: string;
+        openQuestionResponses?: OpenQuestionResponse[];
         dustCommand?: string;
     }): Promise<CreateIdeaTransitionTaskResult>;
     createDecomposeIdeaTask(options: DecomposeIdeaOptions & {

package/dist/artifacts/workflow-tasks.d.ts

@@ -45,7 +45,7 @@ export interface DecomposeIdeaOptions {
     description?: string;
     openQuestionResponses?: OpenQuestionResponse[];
 }
-export declare function createRefineIdeaTask(fileSystem: FileSystem, dustPath: string, ideaSlug: string, description?: string, dustCommand?: string): Promise<CreateIdeaTransitionTaskResult>;
+export declare function createRefineIdeaTask(fileSystem: FileSystem, dustPath: string, ideaSlug: string, description?: string, openQuestionResponses?: OpenQuestionResponse[], dustCommand?: string): Promise<CreateIdeaTransitionTaskResult>;
 export declare function decomposeIdea(fileSystem: FileSystem, dustPath: string, options: DecomposeIdeaOptions, dustCommand?: string): Promise<CreateIdeaTransitionTaskResult>;
 export declare function createShelveIdeaTask(fileSystem: FileSystem, dustPath: string, ideaSlug: string, description?: string, _dustCommand?: string): Promise<CreateIdeaTransitionTaskResult>;
 export declare function createIdeaTask(fileSystem: FileSystem, dustPath: string, options: {

package/dist/artifacts.js

@@ -460,14 +460,17 @@ async function createIdeaTransitionTask(fileSystem, dustPath, workflowType, pref
   await fileSystem.writeFile(filePath, content);
   return { filePath };
 }
-async function createRefineIdeaTask(fileSystem, dustPath, ideaSlug, description, dustCommand) {
+async function createRefineIdeaTask(fileSystem, dustPath, ideaSlug, description, openQuestionResponses, dustCommand) {
   const cmd = dustCommand ?? "dust";
   return createIdeaTransitionTask(fileSystem, dustPath, "refine-idea", "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. Run \`${cmd} principles\` for alignment and \`${cmd} 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"
-  ], "Refines Idea", { description });
+  ], "Refines Idea", {
+    description,
+    resolvedQuestions: openQuestionResponses
+  });
 }
 async function decomposeIdea(fileSystem, dustPath, options, dustCommand) {
   const cmd = dustCommand ?? "dust";
@@ -632,7 +635,7 @@ function buildArtifactsRepository(fileSystem, dustPath) {
       return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).sort();
     },
     async createRefineIdeaTask(options) {
-      return createRefineIdeaTask(fileSystem, dustPath, options.ideaSlug, options.description, options.dustCommand);
+      return createRefineIdeaTask(fileSystem, dustPath, options.ideaSlug, options.description, options.openQuestionResponses, options.dustCommand);
     },
     async createDecomposeIdeaTask(options) {
       return decomposeIdea(fileSystem, dustPath, options, options.dustCommand);

package/dist/dust.js

@@ -500,7 +500,7 @@ async function loadSettings(cwd, fileSystem) {
 }
 
 // lib/version.ts
-var DUST_VERSION = "0.1.92";
+var DUST_VERSION = "0.1.93";
 
 // lib/session.ts
 var DUST_UNATTENDED = "DUST_UNATTENDED";
@@ -2563,6 +2563,25 @@ function selectAgentCapabilities(input) {
   }
   return agents;
 }
+async function fetchCodexModelsFromApi(apiKey) {
+  try {
+    const response = await fetch("https://api.openai.com/v1/models", {
+      headers: { Authorization: `Bearer ${apiKey}` }
+    });
+    if (!response.ok) {
+      log2(`OpenAI models API returned ${response.status}`);
+      return [];
+    }
+    const body = await response.json();
+    if (!body.data || !Array.isArray(body.data)) {
+      return [];
+    }
+    return body.data.map((m) => m.id).filter((id) => id.includes("codex")).sort();
+  } catch (error) {
+    log2(`OpenAI models API fetch failed: ${error instanceof Error ? error.message : String(error)}`);
+    return [];
+  }
+}
 async function discoverAgentCapabilities(dependencies) {
   const [claudeVersionProbe, codexVersionProbe] = await Promise.all([
     probeCommand(dependencies.spawn, "claude", ["--version"]),
@@ -2570,10 +2589,18 @@ async function discoverAgentCapabilities(dependencies) {
   ]);
   let codexModelsProbe = null;
   if (codexVersionProbe.success) {
-    codexModelsProbe = await probeCommand(dependencies.spawn, "codex", [
-      "models",
-      "--json"
-    ]);
+    const getEnv = dependencies.getEnv ?? ((name) => process.env[name]);
+    const apiKey = getEnv("OPENAI_API_KEY");
+    if (apiKey) {
+      const fetcher = dependencies.fetchCodexModelsFromApi ?? fetchCodexModelsFromApi;
+      const models = await fetcher(apiKey);
+      if (models.length > 0) {
+        codexModelsProbe = {
+          success: true,
+          stdout: JSON.stringify(models)
+        };
+      }
+    }
   }
   return {
     type: "agent-capabilities",
@@ -7840,7 +7867,12 @@ function renderHierarchy(nodes, output, prefix = "") {
   }
 }
 async function list(dependencies) {
-  const { arguments: commandArguments, context, fileSystem } = dependencies;
+  const {
+    arguments: commandArguments,
+    context,
+    fileSystem,
+    settings
+  } = dependencies;
   const dustPath = `${context.cwd}/.dust`;
   const colors = getColors();
   if (!fileSystem.exists(dustPath)) {
@@ -7855,6 +7887,7 @@ async function list(dependencies) {
     return { exitCode: 1 };
   }
   const specificTypeRequested = commandArguments.length > 0;
+  const showTaskCreationHint = specificTypeRequested && typesToList.length === 1 && typesToList[0] === "tasks";
   const workflowTasks = typesToList.includes("ideas") && fileSystem.exists(dustPath) ? await findAllWorkflowTasks(fileSystem, dustPath) : null;
   for (const type of typesToList) {
     const dirPath = `${dustPath}/${type}`;
@@ -7939,6 +7972,11 @@ async function list(dependencies) {
       });
     }
   }
+  if (showTaskCreationHint) {
+    context.stdout("➕ Add a New Task");
+    context.stdout("");
+    context.stdout(`Run \`${settings.dustCommand} new task\``);
+  }
   return { exitCode: 0 };
 }
 
@@ -8141,7 +8179,7 @@ function newTaskInstructions(vars) {
   steps.push("   - The goal is a task description with minimal ambiguity at implementation time");
   steps.push("4. Create a new markdown file in `.dust/tasks/` with a descriptive kebab-case name (e.g., `add-user-authentication.md`)");
   steps.push("5. Add a title as the first line using an H1 heading (e.g., `# Add user authentication`)");
-  steps.push('6. Write a comprehensive description starting with an imperative opening sentence (e.g., "Add caching to the API layer." not "This task adds caching."). Include technical details and references to relevant files.');
+  steps.push('6. Write a comprehensive description starting with an imperative opening sentence (e.g., "Add caching to the API layer." not "This task adds caching."). The opening sentence must be 150 characters or fewer. Include technical details and references to relevant files.');
   steps.push("7. Add a `## Principles` section with links to relevant principles this task supports (e.g., `- [Principle Name](../principles/principle-name.md)`)");
   steps.push("8. Add a `## Blocked By` section listing any tasks that must complete first, or `(none)` if there are no blockers");
   steps.push("9. Add a `## Definition of Done` section with a checklist of completion criteria using `- [ ]` for each item");

package/package.json

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