@joshski/dust 0.1.68 → 0.1.70

package/dist/artifacts/index.d.ts

@@ -3,9 +3,9 @@ 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 { CAPTURE_IDEA_PREFIX, type CreateIdeaTransitionTaskResult, type DecomposeIdeaOptions, findAllCaptureIdeaTasks, type IdeaInProgress, type OpenQuestionResponse, type ParsedCaptureIdeaTask, type WorkflowTaskMatch } from './workflow-tasks';
-export type { CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, Fact, Idea, IdeaOpenQuestion, IdeaOption, OpenQuestionResponse, ParsedCaptureIdeaTask, Principle, Task, WorkflowTaskMatch, };
-export { CAPTURE_IDEA_PREFIX, findAllCaptureIdeaTasks, parseOpenQuestions };
+import { type AllWorkflowTasks, CAPTURE_IDEA_PREFIX, type CreateIdeaTransitionTaskResult, type DecomposeIdeaOptions, findAllCaptureIdeaTasks, 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, };
+export { CAPTURE_IDEA_PREFIX, findAllCaptureIdeaTasks, findAllWorkflowTasks, parseOpenQuestions, };
 export type { IdeaInProgress };
 export interface ArtifactsRepository {
     parseIdea(options: {

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

@@ -1,7 +1,7 @@
 import type { FileSystem, ReadableFileSystem } from '../filesystem/types';
 export declare const IDEA_TRANSITION_PREFIXES: string[];
 export declare const CAPTURE_IDEA_PREFIX = "Add Idea: ";
-export declare const BUILD_IDEA_PREFIX = "Build Idea: ";
+export declare const BUILD_IDEA_PREFIX = "Decompose Idea: ";
 export interface IdeaInProgress {
     taskSlug: string;
     ideaTitle: string;
@@ -28,6 +28,11 @@ export interface WorkflowTaskMatch {
     ideaSlug: string;
     taskSlug: string;
 }
+export interface AllWorkflowTasks {
+    captureIdeaTasks: IdeaInProgress[];
+    workflowTasksByIdeaSlug: Map<string, WorkflowTaskMatch>;
+}
+export declare function findAllWorkflowTasks(fileSystem: ReadableFileSystem, dustPath: string): Promise<AllWorkflowTasks>;
 export declare function findWorkflowTaskForIdea(fileSystem: ReadableFileSystem, dustPath: string, ideaSlug: string): Promise<WorkflowTaskMatch | null>;
 export interface CreateIdeaTransitionTaskResult {
     filePath: string;

package/dist/artifacts.js

@@ -272,7 +272,7 @@ async function parseTask(fileSystem, dustPath, slug) {
 
 // lib/artifacts/workflow-tasks.ts
 var CAPTURE_IDEA_PREFIX = "Add Idea: ";
-var BUILD_IDEA_PREFIX = "Build Idea: ";
+var BUILD_IDEA_PREFIX = "Decompose Idea: ";
 async function findAllCaptureIdeaTasks(fileSystem, dustPath) {
   const tasksPath = `${dustPath}/tasks`;
   if (!fileSystem.exists(tasksPath))
@@ -290,7 +290,7 @@ async function findAllCaptureIdeaTasks(fileSystem, dustPath) {
         taskSlug: file.replace(/\.md$/, ""),
         ideaTitle: title.slice(CAPTURE_IDEA_PREFIX.length)
       });
-    } else if (title.startsWith(BUILD_IDEA_PREFIX)) {
+    } else if (title.startsWith(BUILD_IDEA_PREFIX) && !content.includes("## Decomposes Idea")) {
       results.push({
         taskSlug: file.replace(/\.md$/, ""),
         ideaTitle: title.slice(BUILD_IDEA_PREFIX.length)
@@ -331,6 +331,45 @@ function extractIdeaSlugFromSection(content, sectionHeading) {
   }
   return null;
 }
+async function findAllWorkflowTasks(fileSystem, dustPath) {
+  const tasksPath = `${dustPath}/tasks`;
+  const captureIdeaTasks = [];
+  const workflowTasksByIdeaSlug = new Map;
+  if (!fileSystem.exists(tasksPath)) {
+    return { captureIdeaTasks, workflowTasksByIdeaSlug };
+  }
+  const files = await fileSystem.readdir(tasksPath);
+  for (const file of files.filter((f) => f.endsWith(".md")).sort()) {
+    const content = await fileSystem.readFile(`${tasksPath}/${file}`);
+    const titleMatch = content.match(/^#\s+(.+)$/m);
+    if (!titleMatch)
+      continue;
+    const title = titleMatch[1].trim();
+    const taskSlug = file.replace(/\.md$/, "");
+    if (title.startsWith(CAPTURE_IDEA_PREFIX)) {
+      captureIdeaTasks.push({
+        taskSlug,
+        ideaTitle: title.slice(CAPTURE_IDEA_PREFIX.length)
+      });
+    } else if (title.startsWith(BUILD_IDEA_PREFIX) && !content.includes("## Decomposes Idea")) {
+      captureIdeaTasks.push({
+        taskSlug,
+        ideaTitle: title.slice(BUILD_IDEA_PREFIX.length)
+      });
+    }
+    for (const { type, heading } of WORKFLOW_SECTION_HEADINGS) {
+      const linkedSlug = extractIdeaSlugFromSection(content, heading);
+      if (linkedSlug) {
+        workflowTasksByIdeaSlug.set(linkedSlug, {
+          type,
+          ideaSlug: linkedSlug,
+          taskSlug
+        });
+      }
+    }
+  }
+  return { captureIdeaTasks, workflowTasksByIdeaSlug };
+}
 async function findWorkflowTaskForIdea(fileSystem, dustPath, ideaSlug) {
   const ideaPath = `${dustPath}/ideas/${ideaSlug}.md`;
   if (!fileSystem.exists(ideaPath)) {
@@ -652,6 +691,7 @@ function buildReadOnlyArtifactsRepository(fileSystem, dustPath) {
 }
 export {
   parseOpenQuestions,
+  findAllWorkflowTasks,
   findAllCaptureIdeaTasks,
   buildReadOnlyArtifactsRepository,
   buildArtifactsRepository,

package/dist/audits.js

@@ -614,6 +614,62 @@ function errorHandling() {
     - [ ] Proposed ideas for any error handling improvements identified
   `;
 }
+function globalState() {
+  return dedent`
+    # Global State
+
+    Find global state and singletons that introduce hidden coupling and hurt testability.
+
+    ${ideasHint}
+
+    ## Scope
+
+    Focus on these patterns:
+
+    1. **Module-level mutable variables** - Variables declared outside functions that can be modified
+    2. **Singleton patterns** - Classes or objects that enforce a single instance (getInstance, static instance fields)
+    3. **Global registries** - Maps, arrays, or sets that accumulate state across module loads
+    4. **Implicit dependencies** - Functions that read from or write to module-level state instead of using parameters
+    5. **Shared configuration objects** - Mutable config objects imported and modified by multiple modules
+    6. **Lazy initialization with caching** - Values computed once and stored at module level
+
+    ## Analysis Steps
+
+    1. Search for \`let\` and \`var\` declarations at module level (outside functions/classes)
+    2. Look for singleton patterns: \`getInstance\`, \`static instance\`, \`export const instance\`
+    3. Find module-level \`Map\`, \`Set\`, \`Array\`, or \`Object\` that gets modified
+    4. Identify functions that reference module-level variables not passed as parameters
+    5. Check for \`process.env\` access scattered throughout the codebase instead of centralized
+
+    ## Output
+
+    For each global state instance identified, provide:
+    - **Location** - File path and line number
+    - **Pattern** - Which category (mutable variable, singleton, registry, etc.)
+    - **Impact** - How this affects testability or coupling (e.g., "Tests must reset this state", "Cannot run tests in parallel")
+    - **Suggestion** - How to refactor (e.g., "Pass as dependency", "Use factory function", "Move to function scope")
+
+    ## Principles
+
+    - [Dependency Injection](../principles/dependency-injection.md) - Dependencies should be passed in, not accessed globally
+    - [Decoupled Code](../principles/decoupled-code.md) - Code should be organized into independent units
+    - [Test Isolation](../principles/test-isolation.md) - Tests should not affect each other
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] Searched for module-level mutable variables (let/var outside functions)
+    - [ ] Identified singleton patterns and getInstance methods
+    - [ ] Found global registries (Maps, Sets, Arrays modified at module level)
+    - [ ] Located functions with implicit dependencies on module-level state
+    - [ ] Checked for scattered process.env access
+    - [ ] Documented impact of each global state instance on testing
+    - [ ] Proposed ideas for refactoring global state to explicit dependencies
+  `;
+}
 function ubiquitousLanguage() {
   return dedent`
     # Ubiquitous Language
@@ -675,6 +731,7 @@ var stockAuditFunctions = {
   "dead-code": deadCode,
   "error-handling": errorHandling,
   "facts-verification": factsVerification,
+  "global-state": globalState,
   "ideas-from-commits": ideasFromCommits,
   "ideas-from-principles": ideasFromPrinciples,
   "performance-review": performanceReview,

package/dist/bucket/repository.d.ts

@@ -14,8 +14,8 @@ export { runRepositoryLoop } from './repository-loop';
 export interface Repository {
     name: string;
     gitUrl: string;
-    url?: string;
-    id?: string;
+    url: string;
+    id: number;
 }
 export interface RepositoryState {
     repository: Repository;

package/dist/dust.js

@@ -275,7 +275,7 @@ async function loadSettings(cwd, fileSystem) {
 }
 
 // lib/version.ts
-var DUST_VERSION = "0.1.68";
+var DUST_VERSION = "0.1.70";
 
 // lib/session.ts
 var DUST_UNATTENDED = "DUST_UNATTENDED";
@@ -537,6 +537,8 @@ ${vars.agentInstructions}` : "";
     6. **Unclear** → \`${vars.bin} help\`
        If none of the above clearly apply, run this to see all available commands.
 
+    Note: "tasks" here refers to dust task files in \`.dust/tasks/\`, not internal task tracking tools.
+
     Do NOT proceed without running one of these commands.${instructions}
   `;
 }
@@ -1159,6 +1161,62 @@ function errorHandling() {
     - [ ] Proposed ideas for any error handling improvements identified
   `;
 }
+function globalState() {
+  return dedent`
+    # Global State
+
+    Find global state and singletons that introduce hidden coupling and hurt testability.
+
+    ${ideasHint}
+
+    ## Scope
+
+    Focus on these patterns:
+
+    1. **Module-level mutable variables** - Variables declared outside functions that can be modified
+    2. **Singleton patterns** - Classes or objects that enforce a single instance (getInstance, static instance fields)
+    3. **Global registries** - Maps, arrays, or sets that accumulate state across module loads
+    4. **Implicit dependencies** - Functions that read from or write to module-level state instead of using parameters
+    5. **Shared configuration objects** - Mutable config objects imported and modified by multiple modules
+    6. **Lazy initialization with caching** - Values computed once and stored at module level
+
+    ## Analysis Steps
+
+    1. Search for \`let\` and \`var\` declarations at module level (outside functions/classes)
+    2. Look for singleton patterns: \`getInstance\`, \`static instance\`, \`export const instance\`
+    3. Find module-level \`Map\`, \`Set\`, \`Array\`, or \`Object\` that gets modified
+    4. Identify functions that reference module-level variables not passed as parameters
+    5. Check for \`process.env\` access scattered throughout the codebase instead of centralized
+
+    ## Output
+
+    For each global state instance identified, provide:
+    - **Location** - File path and line number
+    - **Pattern** - Which category (mutable variable, singleton, registry, etc.)
+    - **Impact** - How this affects testability or coupling (e.g., "Tests must reset this state", "Cannot run tests in parallel")
+    - **Suggestion** - How to refactor (e.g., "Pass as dependency", "Use factory function", "Move to function scope")
+
+    ## Principles
+
+    - [Dependency Injection](../principles/dependency-injection.md) - Dependencies should be passed in, not accessed globally
+    - [Decoupled Code](../principles/decoupled-code.md) - Code should be organized into independent units
+    - [Test Isolation](../principles/test-isolation.md) - Tests should not affect each other
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] Searched for module-level mutable variables (let/var outside functions)
+    - [ ] Identified singleton patterns and getInstance methods
+    - [ ] Found global registries (Maps, Sets, Arrays modified at module level)
+    - [ ] Located functions with implicit dependencies on module-level state
+    - [ ] Checked for scattered process.env access
+    - [ ] Documented impact of each global state instance on testing
+    - [ ] Proposed ideas for refactoring global state to explicit dependencies
+  `;
+}
 function ubiquitousLanguage() {
   return dedent`
     # Ubiquitous Language
@@ -1220,6 +1278,7 @@ var stockAuditFunctions = {
   "dead-code": deadCode,
   "error-handling": errorHandling,
   "facts-verification": factsVerification,
+  "global-state": globalState,
   "ideas-from-commits": ideasFromCommits,
   "ideas-from-principles": ideasFromPrinciples,
   "performance-review": performanceReview,
@@ -2226,7 +2285,7 @@ var IDEA_TRANSITION_PREFIXES = [
   "Decompose Idea: ",
   "Shelve Idea: "
 ];
-var BUILD_IDEA_PREFIX = "Build Idea: ";
+var BUILD_IDEA_PREFIX = "Decompose Idea: ";
 function titleToFilename(title) {
   return `${title.toLowerCase().replace(/\./g, "-").replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "")}.md`;
 }
@@ -2811,7 +2870,7 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
       result = await runOneIteration(commandDeps, loopDeps, onLoopEvent, onAgentEvent, {
         hooksInstalled,
         signal: abortController.signal,
-        repositoryId: repoState.repository.id,
+        repositoryId: repoState.repository.id.toString(),
         onRawEvent: (rawEvent) => {
           onAgentEvent(rawEventToAgentEvent(rawEvent));
         }
@@ -2870,23 +2929,15 @@ function startRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
   });
 }
 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 = {
+    if (typeof repositoryData.name === "string" && typeof repositoryData.gitUrl === "string" && typeof repositoryData.url === "string" && typeof repositoryData.id === "number") {
+      return {
         name: repositoryData.name,
-        gitUrl: repositoryData.gitUrl
+        gitUrl: repositoryData.gitUrl,
+        url: repositoryData.url,
+        id: repositoryData.id
       };
-      if (typeof repositoryData.url === "string") {
-        repo.url = repositoryData.url;
-      }
-      if (typeof repositoryData.id === "string") {
-        repo.id = repositoryData.id;
-      }
-      return repo;
     }
   }
   return null;
@@ -2991,20 +3042,16 @@ function parseServerMessage(data) {
       if (typeof repo.name !== "string" || typeof repo.gitUrl !== "string") {
         return null;
       }
-      const item = {
-        name: repo.name,
-        gitUrl: repo.gitUrl
-      };
-      if (typeof repo.url === "string") {
-        item.url = repo.url;
-      }
-      if (typeof repo.id === "string") {
-        item.id = repo.id;
-      }
-      if (typeof repo.hasTask === "boolean") {
-        item.hasTask = repo.hasTask;
+      if (typeof repo.id !== "number" || typeof repo.url !== "string" || typeof repo.hasTask !== "boolean") {
+        return null;
       }
-      repositories.push(item);
+      repositories.push({
+        id: repo.id,
+        name: repo.name,
+        gitUrl: repo.gitUrl,
+        url: repo.url,
+        hasTask: repo.hasTask
+      });
     }
     return { type: "repository-list", repositories };
   }
@@ -3741,16 +3788,10 @@ function connectWebSocket(token, state, bucketDependencies, context, fileSystem,
         for (const r of repos) {
           const attrs = [];
           attrs.push(`name=${r.name}`);
-          if (r.id !== undefined) {
-            attrs.push(`id=${r.id}`);
-          }
+          attrs.push(`id=${r.id}`);
           attrs.push(`gitUrl=${r.gitUrl}`);
-          if (r.url !== undefined) {
-            attrs.push(`url=${r.url}`);
-          }
-          if (r.hasTask !== undefined) {
-            attrs.push(`hasTask=${r.hasTask}`);
-          }
+          attrs.push(`url=${r.url}`);
+          attrs.push(`hasTask=${r.hasTask}`);
           logMessage(state, context, useTUI, `  - ${attrs.join(", ")}`);
         }
       }
@@ -3997,14 +4038,15 @@ function createDefaultUploadDependencies() {
       const file = Bun.file(path);
       return file.exists();
     },
-    uploadFile: async (url, token, fileBytes, contentType) => {
+    uploadFile: async (url, token, fileBytes, contentType, fileName) => {
+      const formData = new FormData;
+      formData.append("file", new Blob([fileBytes.buffer], { type: contentType }), fileName);
       const response = await fetch(url, {
         method: "POST",
         headers: {
-          Authorization: `Bearer ${token}`,
-          "Content-Type": contentType
+          Authorization: `Bearer ${token}`
         },
-        body: new Blob([fileBytes])
+        body: formData
       });
       if (!response.ok) {
         const text = await response.text();
@@ -4089,9 +4131,10 @@ async function bucketAssetUpload(dependencies, uploadDeps = createDefaultUploadD
   }
   const fileBytes = await uploadDeps.readFileBytes(filePath);
   const contentType = getContentType(filePath);
+  const fileName = filePath.split("/").pop();
   const uploadUrl = `${getDustbucketHost()}/api/assets?repositoryId=${encodeURIComponent(repositoryId)}`;
   try {
-    const result = await uploadDeps.uploadFile(uploadUrl, token, fileBytes, contentType);
+    const result = await uploadDeps.uploadFile(uploadUrl, token, fileBytes, contentType, fileName);
     context.stdout(result.url);
     return { exitCode: 0 };
   } catch (error) {
@@ -5036,7 +5079,7 @@ async function runSingleCheck(check, cwd, runner) {
     output: result.output,
     hints: check.hints,
     durationMs,
-    timedOut: result.timedOut,
+    timedOut: result.timedOut ?? false,
     timeoutSeconds: timeoutMs / 1000
   };
 }
@@ -5075,7 +5118,8 @@ async function runValidationCheck(dependencies) {
     output: outputLines.join(`
 `),
     isBuiltIn: true,
-    durationMs
+    durationMs,
+    timedOut: false
   };
 }
 function displayResults(results, context) {
@@ -5085,7 +5129,7 @@ function displayResults(results, context) {
     if (result.timedOut) {
       context.stdout(`✗ ${result.name} [timed out after ${result.timeoutSeconds}s]`);
     } else {
-      const timing = result.durationMs !== undefined && result.durationMs >= 1000 ? ` [${(result.durationMs / 1000).toFixed(1)}s]` : "";
+      const timing = result.durationMs >= 1000 ? ` [${(result.durationMs / 1000).toFixed(1)}s]` : "";
       if (result.exitCode === 0) {
         context.stdout(`✓ ${result.name}${timing}`);
       } else {

package/package.json

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