@joshski/dust 0.1.65 → 0.1.67

package/dist/artifacts.js

@@ -302,19 +302,53 @@ async function findAllCaptureIdeaTasks(fileSystem, dustPath) {
 function titleToFilename(title) {
   return `${title.toLowerCase().replace(/\./g, "-").replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "")}.md`;
 }
-var WORKFLOW_TASK_TYPES = [
-  { type: "refine", prefix: "Refine Idea: " },
-  { type: "decompose-idea", prefix: "Decompose Idea: " },
-  { type: "shelve", prefix: "Shelve Idea: " }
+var WORKFLOW_SECTION_HEADINGS = [
+  { type: "refine", heading: "Refines Idea" },
+  { type: "decompose-idea", heading: "Decomposes Idea" },
+  { type: "shelve", heading: "Shelves Idea" }
 ];
+function extractIdeaSlugFromSection(content, sectionHeading) {
+  const lines = content.split(`
+`);
+  let inSection = false;
+  for (const line of lines) {
+    if (line.startsWith("## ")) {
+      inSection = line.trimEnd() === `## ${sectionHeading}`;
+      continue;
+    }
+    if (!inSection)
+      continue;
+    if (line.startsWith("# "))
+      break;
+    const linkMatch = line.match(MARKDOWN_LINK_PATTERN);
+    if (linkMatch) {
+      const target = linkMatch[2];
+      const slugMatch = target.match(/([^/]+)\.md$/);
+      if (slugMatch) {
+        return slugMatch[1];
+      }
+    }
+  }
+  return null;
+}
 async function findWorkflowTaskForIdea(fileSystem, dustPath, ideaSlug) {
-  const ideaTitle = await readIdeaTitle(fileSystem, dustPath, ideaSlug);
-  for (const { type, prefix } of WORKFLOW_TASK_TYPES) {
-    const filename = titleToFilename(`${prefix}${ideaTitle}`);
-    const filePath = `${dustPath}/tasks/${filename}`;
-    if (fileSystem.exists(filePath)) {
-      const taskSlug = filename.replace(/\.md$/, "");
-      return { type, ideaSlug, taskSlug };
+  const ideaPath = `${dustPath}/ideas/${ideaSlug}.md`;
+  if (!fileSystem.exists(ideaPath)) {
+    throw new Error(`Idea not found: "${ideaSlug}" (expected file at ${ideaPath})`);
+  }
+  const tasksPath = `${dustPath}/tasks`;
+  if (!fileSystem.exists(tasksPath)) {
+    return null;
+  }
+  const files = await fileSystem.readdir(tasksPath);
+  for (const file of files.filter((f) => f.endsWith(".md")).sort()) {
+    const content = await fileSystem.readFile(`${tasksPath}/${file}`);
+    for (const { type, heading } of WORKFLOW_SECTION_HEADINGS) {
+      const linkedSlug = extractIdeaSlugFromSection(content, heading);
+      if (linkedSlug === ideaSlug) {
+        const taskSlug = file.replace(/\.md$/, "");
+        return { type, ideaSlug, taskSlug };
+      }
     }
   }
   return null;
@@ -342,18 +376,26 @@ ${sections.join(`
 `)}
 `;
 }
-function renderTask(title, openingSentence, definitionOfDone, options) {
+function renderIdeaSection(ideaSection) {
+  return `## ${ideaSection.heading}
+
+- [${ideaSection.ideaTitle}](../ideas/${ideaSection.ideaSlug}.md)
+`;
+}
+function renderTask(title, openingSentence, definitionOfDone, ideaSection, options) {
   const descriptionParagraph = options?.description !== undefined ? `
 ${options.description}
 ` : "";
   const resolvedSection = options?.resolvedQuestions && options.resolvedQuestions.length > 0 ? `
 ${renderResolvedQuestions(options.resolvedQuestions)}
 ` : "";
+  const ideaSectionContent = `
+${renderIdeaSection(ideaSection)}
+`;
   return `# ${title}
 
 ${openingSentence}
-${descriptionParagraph}${resolvedSection}
-## Blocked By
+${descriptionParagraph}${resolvedSection}${ideaSectionContent}## Blocked By
 
 (none)
 
@@ -363,13 +405,17 @@ ${definitionOfDone.map((item) => `- [ ] ${item}`).join(`
 `)}
 `;
 }
-async function createIdeaTask(fileSystem, dustPath, prefix, ideaSlug, openingSentenceTemplate, definitionOfDone, taskOptions) {
+async function createIdeaTask(fileSystem, dustPath, prefix, ideaSlug, openingSentenceTemplate, definitionOfDone, ideaSectionHeading, taskOptions) {
   const ideaTitle = await readIdeaTitle(fileSystem, dustPath, ideaSlug);
   const taskTitle = `${prefix}${ideaTitle}`;
   const filename = titleToFilename(taskTitle);
   const filePath = `${dustPath}/tasks/${filename}`;
   const openingSentence = openingSentenceTemplate(ideaTitle);
-  const content = renderTask(taskTitle, openingSentence, definitionOfDone, taskOptions);
+  const ideaSection = { heading: ideaSectionHeading, ideaTitle, ideaSlug };
+  const content = renderTask(taskTitle, openingSentence, definitionOfDone, ideaSection, {
+    description: taskOptions?.description,
+    resolvedQuestions: taskOptions?.resolvedQuestions
+  });
   await fileSystem.writeFile(filePath, content);
   return { filePath };
 }
@@ -379,20 +425,20 @@ async function createRefineIdeaTask(fileSystem, dustPath, ideaSlug, description)
     "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 });
+  ], "Refines Idea", { description });
 }
 async function decomposeIdea(fileSystem, dustPath, options) {
   return createIdeaTask(fileSystem, dustPath, "Decompose Idea: ", options.ideaSlug, (ideaTitle) => `Create one or more well-defined tasks from this idea. Prefer smaller, narrowly scoped tasks that each deliver a thin but complete vertical slice of working software -- a path through the system that can be tested end-to-end -- rather than component-oriented tasks (like "add schema" or "build endpoint") that only work once all tasks are done. Split the idea into multiple tasks if it covers more than one logical change. Review \`.dust/principles/\` to link relevant principles and \`.dust/facts/\` for design decisions that should inform the task. See [${ideaTitle}](../ideas/${options.ideaSlug}.md).`, [
     "One or more new tasks are created in .dust/tasks/",
     "Task's Principles section links to relevant principles from .dust/principles/",
     "The original idea is deleted or updated to reflect remaining scope"
-  ], {
+  ], "Decomposes Idea", {
     description: options.description,
     resolvedQuestions: options.openQuestionResponses
   });
 }
 async function createShelveIdeaTask(fileSystem, dustPath, ideaSlug, description) {
-  return createIdeaTask(fileSystem, dustPath, "Shelve Idea: ", ideaSlug, (ideaTitle) => `Archive this idea and remove it from the active backlog. See [${ideaTitle}](../ideas/${ideaSlug}.md).`, ["Idea file is deleted", "Rationale is recorded in the commit message"], { description });
+  return createIdeaTask(fileSystem, dustPath, "Shelve Idea: ", ideaSlug, (ideaTitle) => `Archive this idea and remove it from the active backlog. See [${ideaTitle}](../ideas/${ideaSlug}.md).`, ["Idea file is deleted", "Rationale is recorded in the commit message"], "Shelves Idea", { description });
 }
 async function createCaptureIdeaTask(fileSystem, dustPath, options) {
   const { title, description, buildItNow } = options;

package/dist/audits/stock-audits.d.ts

@@ -4,9 +4,10 @@
  * Users can override any of these by placing a file with the same name
  * in .dust/config/audits/.
  */
-export interface StockAudit {
+interface StockAudit {
     name: string;
     description: string;
     template: string;
 }
 export declare function loadStockAudits(): StockAudit[];
+export {};

package/dist/cli/types.d.ts

@@ -2,7 +2,7 @@
  * Common types for CLI commands
  */
 import type { FileSystem, GlobScanner } from '../filesystem/types';
-export type { FileSystem, GlobScanner, ReadableFileSystem, WriteOptions, } from '../filesystem/types';
+export type { FileSystem, GlobScanner, ReadableFileSystem, } from '../filesystem/types';
 export interface CommandContext {
     cwd: string;
     stdout: (message: string) => void;

package/dist/dust.js

@@ -275,7 +275,25 @@ async function loadSettings(cwd, fileSystem) {
 }
 
 // lib/version.ts
-var DUST_VERSION = "0.1.65";
+var DUST_VERSION = "0.1.67";
+
+// lib/session.ts
+var DUST_UNATTENDED = "DUST_UNATTENDED";
+var DUST_SKIP_AGENT = "DUST_SKIP_AGENT";
+var DUST_REPOSITORY_ID = "DUST_REPOSITORY_ID";
+function isUnattended(env = process.env) {
+  return !!env[DUST_UNATTENDED];
+}
+function buildUnattendedEnv(options) {
+  const env = {
+    [DUST_UNATTENDED]: "1",
+    [DUST_SKIP_AGENT]: "1"
+  };
+  if (options?.repositoryId) {
+    env[DUST_REPOSITORY_ID] = options.repositoryId;
+  }
+  return env;
+}
 
 // lib/cli/dedent.ts
 function dedent(strings, ...values) {
@@ -524,7 +542,7 @@ ${vars.agentInstructions}` : "";
 }
 async function agent(dependencies, env = process.env) {
   const { context, fileSystem, settings } = dependencies;
-  if (env.DUST_SKIP_AGENT === "1") {
+  if (env[DUST_SKIP_AGENT] === "1") {
     context.stdout("You're running in an automated loop - proceeding to implement the assigned task.");
     return { exitCode: 0 };
   }
@@ -2189,13 +2207,7 @@ async function runOneIteration(dependencies, loopDependencies, onLoopEvent, onAg
     logger = log,
     repositoryId
   } = options;
-  const baseEnv = {
-    DUST_UNATTENDED: "1",
-    DUST_SKIP_AGENT: "1"
-  };
-  if (repositoryId) {
-    baseEnv.DUST_REPOSITORY_ID = repositoryId;
-  }
+  const baseEnv = buildUnattendedEnv({ repositoryId });
   log("syncing with remote");
   onLoopEvent({ type: "loop.syncing" });
   const pullResult = await gitPull(context.cwd, spawn);
@@ -2319,6 +2331,10 @@ function parseMaxIterations(commandArguments) {
 async function loopClaude(dependencies, loopDependencies = createDefaultDependencies()) {
   enableFileLogs("loop");
   const { context, settings } = dependencies;
+  if (isUnattended()) {
+    context.stderr("dust loop cannot run inside an unattended session (DUST_UNATTENDED is set)");
+    return { exitCode: 1 };
+  }
   const { postEvent } = loopDependencies;
   const maxIterations = parseMaxIterations(dependencies.arguments);
   const eventsUrl = settings.eventsUrl;
@@ -3502,9 +3518,13 @@ async function resolveToken(authDeps, context) {
     return null;
   }
 }
-async function bucket(dependencies, bucketDeps = createDefaultBucketDependencies()) {
+async function bucketWorker(dependencies, bucketDeps = createDefaultBucketDependencies()) {
   enableFileLogs("bucket");
   const { context, fileSystem } = dependencies;
+  if (isUnattended()) {
+    context.stderr("dust bucket cannot run inside an unattended session (DUST_UNATTENDED is set)");
+    return { exitCode: 1 };
+  }
   const token = await resolveToken(bucketDeps.auth, context);
   if (!token) {
     return { exitCode: 1 };
@@ -3964,6 +3984,11 @@ function validateTitleFilenameMatch(filePath, content) {
 }
 
 // lib/lint/validators/idea-validator.ts
+var WORKFLOW_PREFIX_TO_SECTION = {
+  "Refine Idea: ": "Refines Idea",
+  "Decompose Idea: ": "Decomposes Idea",
+  "Shelve Idea: ": "Shelves Idea"
+};
 function validateIdeaOpenQuestions(filePath, content) {
   const violations = [];
   const lines = content.split(`
@@ -4077,6 +4102,114 @@ function validateIdeaTransitionTitle(filePath, content, ideasPath, fileSystem) {
   }
   return null;
 }
+function extractSectionContent(content, sectionHeading) {
+  const lines = content.split(`
+`);
+  let inSection = false;
+  let sectionContent = "";
+  let startLine = 0;
+  for (let i = 0;i < lines.length; i++) {
+    const line = lines[i];
+    if (line.startsWith("## ")) {
+      if (inSection)
+        break;
+      if (line.trimEnd() === `## ${sectionHeading}`) {
+        inSection = true;
+        startLine = i + 1;
+      }
+      continue;
+    }
+    if (line.startsWith("# ") && inSection)
+      break;
+    if (inSection) {
+      sectionContent += `${line}
+`;
+    }
+  }
+  if (!inSection)
+    return null;
+  return { content: sectionContent, startLine };
+}
+function validateWorkflowTaskBodySection(filePath, content, ideasPath, fileSystem) {
+  const violations = [];
+  const title = extractTitle(content);
+  if (!title)
+    return violations;
+  let matchedPrefix = null;
+  for (const prefix of IDEA_TRANSITION_PREFIXES) {
+    if (title.startsWith(prefix)) {
+      matchedPrefix = prefix;
+      break;
+    }
+  }
+  if (!matchedPrefix)
+    return violations;
+  const expectedHeading = WORKFLOW_PREFIX_TO_SECTION[matchedPrefix];
+  const section = extractSectionContent(content, expectedHeading);
+  if (!section) {
+    violations.push({
+      file: filePath,
+      message: `Workflow task with "${matchedPrefix.trim()}" prefix is missing required "## ${expectedHeading}" section. Add a section with a link to the idea file, e.g.:
+
+## ${expectedHeading}
+
+- [Idea Title](../ideas/idea-slug.md)`
+    });
+    return violations;
+  }
+  const linkRegex = new RegExp(MARKDOWN_LINK_PATTERN.source, "g");
+  const links = [];
+  const sectionLines = section.content.split(`
+`);
+  for (let i = 0;i < sectionLines.length; i++) {
+    const line = sectionLines[i];
+    let match = linkRegex.exec(line);
+    while (match !== null) {
+      links.push({
+        text: match[1],
+        target: match[2],
+        line: section.startLine + i + 1
+      });
+      match = linkRegex.exec(line);
+    }
+  }
+  if (links.length === 0) {
+    violations.push({
+      file: filePath,
+      message: `"## ${expectedHeading}" section contains no link. Add a markdown link to the idea file, e.g.:
+
+- [Idea Title](../ideas/idea-slug.md)`,
+      line: section.startLine
+    });
+    return violations;
+  }
+  const ideaLinks = links.filter((l) => l.target.includes("/ideas/") || l.target.startsWith("../ideas/"));
+  if (ideaLinks.length === 0) {
+    violations.push({
+      file: filePath,
+      message: `"## ${expectedHeading}" section contains no link to an idea file. Links must point to a file in ../ideas/, e.g.:
+
+- [Idea Title](../ideas/idea-slug.md)`,
+      line: section.startLine
+    });
+    return violations;
+  }
+  for (const link of ideaLinks) {
+    const slugMatch = link.target.match(/([^/]+)\.md$/);
+    if (!slugMatch)
+      continue;
+    const ideaSlug = slugMatch[1];
+    const ideaFilePath = `${ideasPath}/${ideaSlug}.md`;
+    if (!fileSystem.exists(ideaFilePath)) {
+      violations.push({
+        file: filePath,
+        message: `Link to idea "${link.text}" points to non-existent file: ${ideaSlug}.md. Either create the idea file at ideas/${ideaSlug}.md or update the link to point to an existing idea.`,
+        line: link.line
+      });
+    }
+  }
+  return violations;
+}
 
 // lib/lint/validators/link-validator.ts
 import { dirname as dirname3, resolve } from "node:path";
@@ -4480,6 +4613,7 @@ async function lintMarkdown(dependencies) {
       if (ideaTransitionViolation) {
         violations.push(ideaTransitionViolation);
       }
+      violations.push(...validateWorkflowTaskBodySection(filePath, content, ideasPath, fileSystem));
     }
   }
   const principlesPath = `${dustPath}/principles`;
@@ -5428,7 +5562,7 @@ async function prePush(dependencies, gitRunner = defaultGitRunner, env = process
   if (agent2.type === "unknown") {
     return { exitCode: 0 };
   }
-  if (env.DUST_UNATTENDED) {
+  if (isUnattended(env)) {
     const uncommittedFiles = await getUncommittedFiles(context.cwd, gitRunner);
     if (uncommittedFiles.length > 0) {
       context.stderr("");
@@ -5498,7 +5632,7 @@ var commandRegistry = {
   check,
   agent,
   audit,
-  bucket,
+  "bucket worker": bucketWorker,
   "bucket asset upload": bucketAssetUpload,
   focus,
   "new task": newTask,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.65",
+  "version": "0.1.67",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {
@@ -63,9 +63,8 @@
     "@biomejs/biome": "^2.3.13",
     "@types/bun": "^1.3.6",
     "@vitest/coverage-v8": "^4.0.18",
+    "istanbul-lib-coverage": "^3.2.2",
+    "istanbul-lib-report": "^3.0.1",
     "vitest": "^4.0.18"
-  },
-  "dependencies": {
-    "@joshski/dust": "^0.1.49"
   }
 }