@joshski/dust 0.1.102 → 0.1.103

package/dist/lint/validators/audit-validator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Audit file validation for .dust/config/audits/ markdown files.
+ *
+ * Custom audits must follow the same structure as stock audits:
+ * - Opening description after H1 title
+ * - ## Scope section
+ * - ## Blocked By section
+ * - ## Definition of Done section
+ */
+import type { ParsedArtifact } from '../../artifacts/parsed-artifact';
+import type { Violation } from './types';
+/**
+ * Validates that an audit file contains all required section headings.
+ */
+export declare function validateAuditHeadings(artifact: ParsedArtifact): Violation[];

package/dist/loop/iteration.d.ts

@@ -39,6 +39,8 @@ export interface IterationOptions {
     proxyPort?: number;
     /** Branch name when working on a non-default branch */
     branch?: string;
+    /** Trace ID for correlating events across processes */
+    traceId?: string;
 }
 export declare function findAvailableTasks(dependencies: CommandDependencies): Promise<{
     tasks: UnblockedTask[];

package/dist/patch.js

@@ -225,6 +225,22 @@ function createOverlayFileSystem(base, patchFiles, deletedPaths = new Set) {
   };
 }
 
+// lib/lint/validators/audit-validator.ts
+var REQUIRED_AUDIT_HEADINGS = ["Scope", "Blocked By", "Definition of Done"];
+function validateAuditHeadings(artifact) {
+  const violations = [];
+  const sectionHeadings = new Set(artifact.sections.map((s) => s.heading));
+  for (const heading of REQUIRED_AUDIT_HEADINGS) {
+    if (!sectionHeadings.has(heading)) {
+      violations.push({
+        file: artifact.filePath,
+        message: `Missing required heading: "## ${heading}"`
+      });
+    }
+  }
+  return violations;
+}
+
 // lib/lint/validators/content-validator.ts
 var REQUIRED_TASK_HEADINGS = ["Blocked By", "Definition of Done"];
 var MAX_OPENING_SENTENCE_LENGTH = 150;
@@ -519,6 +535,12 @@ function validateWorkflowTaskBodySection(artifact, ideasPath, fileSystem) {
   }
   if (!matchedPrefix)
     return violations;
+  if (matchedPrefix === "Expedite Idea: ") {
+    const hasIdeaDescriptionSection = artifact.sections.some((s) => s.heading === "Idea Description" && s.level === 2);
+    if (hasIdeaDescriptionSection) {
+      return violations;
+    }
+  }
   const expectedHeading = WORKFLOW_PREFIX_TO_SECTION[matchedPrefix];
   const section = artifact.sections.find((s) => s.heading === expectedHeading && s.level === 2);
   if (!section) {
@@ -816,6 +838,7 @@ async function parseArtifacts(fileSystem, dustPath) {
     tasks: []
   };
   const rootFiles = [];
+  const customAudits = [];
   const violations = [];
   let rootEntries;
   try {
@@ -874,11 +897,40 @@ async function parseArtifacts(fileSystem, dustPath) {
       byType[dir].push(artifact);
     }
   }
+  const auditsPath = `${dustPath}/config/audits`;
+  let auditEntries;
+  try {
+    auditEntries = await fileSystem.readdir(auditsPath);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      auditEntries = [];
+    } else {
+      throw error;
+    }
+  }
+  for (const entry of auditEntries) {
+    if (!entry.endsWith(".md"))
+      continue;
+    const filePath = `${auditsPath}/${entry}`;
+    let content;
+    try {
+      content = await fileSystem.readFile(filePath);
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        continue;
+      }
+      throw error;
+    }
+    const artifact = parseArtifact(filePath, content);
+    artifacts.set(filePath, artifact);
+    customAudits.push(artifact);
+  }
   return {
     context: {
       artifacts,
       byType,
       rootFiles,
+      customAudits,
       dustPath,
       fileSystem
     },
@@ -887,7 +939,7 @@ async function parseArtifacts(fileSystem, dustPath) {
 }
 function validateArtifacts(context) {
   const violations = [];
-  const { byType, rootFiles, dustPath, fileSystem } = context;
+  const { byType, rootFiles, customAudits, dustPath, fileSystem } = context;
   const ideasPath = `${dustPath}/ideas`;
   for (const artifact of rootFiles) {
     violations.push(...validateLinks(artifact, fileSystem));
@@ -931,6 +983,18 @@ function validateArtifacts(context) {
   }
   violations.push(...validateBidirectionalLinks(allPrincipleRelationships));
   violations.push(...validateNoCycles(allPrincipleRelationships));
+  for (const artifact of customAudits) {
+    const filenameViolation = validateFilename(artifact.filePath);
+    if (filenameViolation)
+      violations.push(filenameViolation);
+    const openingSentenceViolation = validateOpeningSentence(artifact);
+    if (openingSentenceViolation)
+      violations.push(openingSentenceViolation);
+    const lengthViolation = validateOpeningSentenceLength(artifact);
+    if (lengthViolation)
+      violations.push(lengthViolation);
+    violations.push(...validateAuditHeadings(artifact));
+  }
   return violations;
 }
 

package/dist/session.d.ts

@@ -3,9 +3,11 @@ export declare const DUST_UNATTENDED = "DUST_UNATTENDED";
 export declare const DUST_SKIP_AGENT = "DUST_SKIP_AGENT";
 export declare const DUST_REPOSITORY_ID = "DUST_REPOSITORY_ID";
 export declare const DUST_PROXY_PORT = "DUST_PROXY_PORT";
+export declare const DUST_TRACE_ID = "DUST_TRACE_ID";
 export declare function isUnattended(session: SessionConfig): boolean;
 export declare function buildUnattendedEnv(options: {
     repositoryId?: string;
     proxyPort?: number;
+    traceId?: string;
     session: SessionConfig;
 }): Record<string, string>;

package/dist/validation/validation-pipeline.d.ts

@@ -19,6 +19,7 @@ interface ValidationContext {
         tasks: ParsedArtifact[];
     };
     rootFiles: ParsedArtifact[];
+    customAudits: ParsedArtifact[];
     dustPath: string;
     fileSystem: ReadableFileSystem;
 }

package/dist/validation.js

@@ -222,6 +222,22 @@ var ARTIFACT_TYPES = [
   "tasks"
 ];
 
+// lib/lint/validators/audit-validator.ts
+var REQUIRED_AUDIT_HEADINGS = ["Scope", "Blocked By", "Definition of Done"];
+function validateAuditHeadings(artifact) {
+  const violations = [];
+  const sectionHeadings = new Set(artifact.sections.map((s) => s.heading));
+  for (const heading of REQUIRED_AUDIT_HEADINGS) {
+    if (!sectionHeadings.has(heading)) {
+      violations.push({
+        file: artifact.filePath,
+        message: `Missing required heading: "## ${heading}"`
+      });
+    }
+  }
+  return violations;
+}
+
 // lib/lint/validators/content-validator.ts
 var REQUIRED_TASK_HEADINGS = ["Blocked By", "Definition of Done"];
 var MAX_OPENING_SENTENCE_LENGTH = 150;
@@ -516,6 +532,12 @@ function validateWorkflowTaskBodySection(artifact, ideasPath, fileSystem) {
   }
   if (!matchedPrefix)
     return violations;
+  if (matchedPrefix === "Expedite Idea: ") {
+    const hasIdeaDescriptionSection = artifact.sections.some((s) => s.heading === "Idea Description" && s.level === 2);
+    if (hasIdeaDescriptionSection) {
+      return violations;
+    }
+  }
   const expectedHeading = WORKFLOW_PREFIX_TO_SECTION[matchedPrefix];
   const section = artifact.sections.find((s) => s.heading === expectedHeading && s.level === 2);
   if (!section) {
@@ -813,6 +835,7 @@ async function parseArtifacts(fileSystem, dustPath) {
     tasks: []
   };
   const rootFiles = [];
+  const customAudits = [];
   const violations = [];
   let rootEntries;
   try {
@@ -871,11 +894,40 @@ async function parseArtifacts(fileSystem, dustPath) {
       byType[dir].push(artifact);
     }
   }
+  const auditsPath = `${dustPath}/config/audits`;
+  let auditEntries;
+  try {
+    auditEntries = await fileSystem.readdir(auditsPath);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      auditEntries = [];
+    } else {
+      throw error;
+    }
+  }
+  for (const entry of auditEntries) {
+    if (!entry.endsWith(".md"))
+      continue;
+    const filePath = `${auditsPath}/${entry}`;
+    let content;
+    try {
+      content = await fileSystem.readFile(filePath);
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        continue;
+      }
+      throw error;
+    }
+    const artifact = parseArtifact(filePath, content);
+    artifacts.set(filePath, artifact);
+    customAudits.push(artifact);
+  }
   return {
     context: {
       artifacts,
       byType,
       rootFiles,
+      customAudits,
       dustPath,
       fileSystem
     },
@@ -884,7 +936,7 @@ async function parseArtifacts(fileSystem, dustPath) {
 }
 function validateArtifacts(context) {
   const violations = [];
-  const { byType, rootFiles, dustPath, fileSystem } = context;
+  const { byType, rootFiles, customAudits, dustPath, fileSystem } = context;
   const ideasPath = `${dustPath}/ideas`;
   for (const artifact of rootFiles) {
     violations.push(...validateLinks(artifact, fileSystem));
@@ -928,6 +980,18 @@ function validateArtifacts(context) {
   }
   violations.push(...validateBidirectionalLinks(allPrincipleRelationships));
   violations.push(...validateNoCycles(allPrincipleRelationships));
+  for (const artifact of customAudits) {
+    const filenameViolation = validateFilename(artifact.filePath);
+    if (filenameViolation)
+      violations.push(filenameViolation);
+    const openingSentenceViolation = validateOpeningSentence(artifact);
+    if (openingSentenceViolation)
+      violations.push(openingSentenceViolation);
+    const lengthViolation = validateOpeningSentenceLength(artifact);
+    if (lengthViolation)
+      violations.push(lengthViolation);
+    violations.push(...validateAuditHeadings(artifact));
+  }
   return violations;
 }
 

package/lib/docker/default.Dockerfile

@@ -0,0 +1,8 @@
+FROM oven/bun:1
+RUN apt-get update && apt-get install -y git nodejs npm curl && rm -rf /var/lib/apt/lists/*
+RUN npm install -g @anthropic-ai/claude-code @openai/codex
+# Install system libraries required by Playwright browsers (Chromium, Firefox, WebKit)
+RUN npx -y playwright install-deps
+RUN useradd -m -s /bin/bash user
+USER user
+WORKDIR /workspace

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.102",
+  "version": "0.1.103",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {
@@ -55,6 +55,7 @@
     "dist",
     "bin",
     "lib/istanbul/minimal-reporter.cjs",
+    "lib/docker/default.Dockerfile",
     "biome",
     ".dust/principles"
   ],