@joshski/dust 0.1.64 → 0.1.67

package/biome/dust-no-abbreviated-names.grit

@@ -0,0 +1,58 @@
+language js
+
+or {
+  `ctx` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'ctx'. Use 'context' instead.")
+  },
+  `deps` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'deps'. Use 'dependencies' instead.")
+  },
+  `fs` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'fs'. Use 'fileSystem' instead.")
+  },
+  `args` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'args'. Use 'arguments' instead.")
+  },
+  `req` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'req'. Use 'request' instead.")
+  },
+  `res` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'res'. Use 'response' instead.")
+  },
+  `err` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'err'. Use 'error' instead.")
+  },
+  `cb` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'cb'. Use 'callback' instead.")
+  },
+  `fn` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'fn'. Use a descriptive name instead.")
+  },
+  `opts` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'opts'. Use 'options' instead.")
+  },
+  `params` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'params'. Use 'parameters' instead.")
+  },
+  `obj` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'obj'. Use a descriptive name instead.")
+  },
+  `val` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'val'. Use 'value' instead.")
+  },
+  `idx` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'idx'. Use 'index' instead.")
+  },
+  `len` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'len'. Use 'length' instead.")
+  },
+  `tmp` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'tmp'. Use a descriptive name instead.")
+  },
+  `str` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'str'. Use 'string' or a descriptive name instead.")
+  },
+  `num` where {
+    register_diagnostic(span=$match, message="Avoid abbreviated name 'num'. Use 'number' or a descriptive name instead.")
+  }
+}

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,22 +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}
-## Principles
-
-(none)
-
-## Blocked By
+${descriptionParagraph}${resolvedSection}${ideaSectionContent}## Blocked By
 
 (none)
 
@@ -367,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 };
 }
@@ -383,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;
@@ -418,10 +460,6 @@ Research this idea thoroughly, then create one or more narrowly-scoped task file
 
 ${description}
 
-## Principles
-
-(none)
-
 ## Blocked By
 
 (none)
@@ -438,28 +476,22 @@ ${description}
   const taskTitle = `${CAPTURE_IDEA_PREFIX}${title}`;
   const filename = titleToFilename(taskTitle);
   const filePath = `${dustPath}/tasks/${filename}`;
-  const ideaFilename = titleToFilename(title);
-  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. 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/principles/\` and \`.dust/facts/\` for relevant context.
+Research this idea thoroughly, then create one or more idea files in \`.dust/ideas/\`. 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/principles/\` and \`.dust/facts/\` for relevant context.
 
 ## Idea Description
 
 ${description}
 
-## Principles
-
-(none)
-
 ## Blocked By
 
 (none)
 
 ## Definition of Done
 
-- [ ] Idea file exists at ${ideaPath}
-- [ ] Idea file has an H1 title matching "${title}"
+- [ ] One or more idea files are created in \`.dust/ideas/\`
+- [ ] Each idea file has an H1 title matching its content
 - [ ] 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

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/audits.js

@@ -63,11 +63,50 @@ function dedent(strings, ...values) {
 }
 
 // lib/audits/stock-audits.ts
+var ideasHint = "Review existing ideas in `./.dust/ideas/` to understand what has been proposed or considered historically, then create new idea files in `./.dust/ideas/` for any issues you identify, avoiding duplication.";
+function componentReuse() {
+  return dedent`
+    # Component Reuse
+
+    Find repeated patterns and code that could be extracted into reusable components.
+
+    ${ideasHint}
+
+    ## Scope
+
+    Focus on these areas:
+
+    1. **Repeated patterns** - Similar code blocks that appear multiple times
+    2. **Copy-pasted code** - Near-identical logic across different files
+    3. **Parallel structures** - Code that handles similar cases with minor variations
+    4. **Extraction opportunities** - Logic that could be unified without forcing unrelated concepts together
+
+    ## Principles
+
+    - [Reasonably DRY](../principles/reasonably-dry.md)
+    - [Decoupled Code](../principles/decoupled-code.md)
+    - [Maintainable Codebase](../principles/maintainable-codebase.md)
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] Searched for repeated patterns across the codebase
+    - [ ] Identified copy-pasted or near-duplicate code
+    - [ ] Evaluated each case for whether extraction would be beneficial
+    - [ ] Considered whether similar code serves different purposes that may evolve independently
+    - [ ] Proposed ideas only for extractions where duplication is truly about the same concept
+  `;
+}
 function agentDeveloperExperience() {
   return dedent`
     # Agent Developer Experience
 
-    Review the codebase to ensure agents have everything they need to operate effectively. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Review the codebase to ensure agents have everything they need to operate effectively.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -100,7 +139,9 @@ function deadCode() {
   return dedent`
     # Dead Code
 
-    Find and remove unused code to improve maintainability and reduce bundle size. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Find and remove unused code to improve maintainability and reduce bundle size.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -135,7 +176,9 @@ function factsVerification() {
   return dedent`
     # Facts Verification
 
-    Review \`.dust/facts/\` to ensure documented facts match current reality. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Review \`.dust/facts/\` to ensure documented facts match current reality.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -168,7 +211,9 @@ function ideasFromCommits() {
   return dedent`
     # Ideas from Commits
 
-    Review recent commit history to identify follow-up improvement ideas. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues or opportunities you identify, avoiding duplication.
+    Review recent commit history to identify follow-up improvement ideas.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -200,7 +245,9 @@ function ideasFromPrinciples() {
   return dedent`
     # Ideas from Principles
 
-    Review \`.dust/principles/\` to generate new improvement ideas. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues or opportunities you identify, avoiding duplication.
+    Review \`.dust/principles/\` to generate new improvement ideas.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -231,7 +278,9 @@ function performanceReview() {
   return dedent`
     # Performance Review
 
-    Review the application for performance issues and optimization opportunities. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Review the application for performance issues and optimization opportunities.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -264,7 +313,9 @@ function securityReview() {
   return dedent`
     # Security Review
 
-    Review the codebase for common security vulnerabilities and misconfigurations. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Review the codebase for common security vulnerabilities and misconfigurations.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -299,7 +350,9 @@ function staleIdeas() {
   return dedent`
     # Stale Ideas
 
-    Review \`.dust/ideas/\` to identify ideas that have become stale or irrelevant. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Review \`.dust/ideas/\` to identify ideas that have become stale or irrelevant.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -331,7 +384,9 @@ function testCoverage() {
   return dedent`
     # Test Coverage
 
-    Identify untested code paths and areas that need additional test coverage. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Identify untested code paths and areas that need additional test coverage.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -361,6 +416,7 @@ function testCoverage() {
 }
 var stockAuditFunctions = {
   "agent-developer-experience": agentDeveloperExperience,
+  "component-reuse": componentReuse,
   "dead-code": deadCode,
   "facts-verification": factsVerification,
   "ideas-from-commits": ideasFromCommits,

package/dist/biome/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Biome path export
+ *
+ * Provides the path to the biome directory containing custom GritQL lint rules.
+ * Downstream users can reference this path in their biome.json plugins array.
+ */
+/**
+ * Absolute path to the biome directory containing custom GritQL lint rules.
+ *
+ * @example
+ * ```typescript
+ * import { biomePath } from "@joshski/dust/biome";
+ * // Returns: "/path/to/node_modules/@joshski/dust/biome"
+ * ```
+ */
+export declare const biomePath: string;

package/dist/biome.js

@@ -0,0 +1,8 @@
+// lib/biome/index.ts
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+var currentDir = dirname(fileURLToPath(import.meta.url));
+var biomePath = join(currentDir, "..", "biome");
+export {
+  biomePath
+};

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.64";
+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 };
   }
@@ -590,11 +608,50 @@ function extractOpeningSentence(content) {
 }
 
 // lib/audits/stock-audits.ts
+var ideasHint = "Review existing ideas in `./.dust/ideas/` to understand what has been proposed or considered historically, then create new idea files in `./.dust/ideas/` for any issues you identify, avoiding duplication.";
+function componentReuse() {
+  return dedent`
+    # Component Reuse
+
+    Find repeated patterns and code that could be extracted into reusable components.
+
+    ${ideasHint}
+
+    ## Scope
+
+    Focus on these areas:
+
+    1. **Repeated patterns** - Similar code blocks that appear multiple times
+    2. **Copy-pasted code** - Near-identical logic across different files
+    3. **Parallel structures** - Code that handles similar cases with minor variations
+    4. **Extraction opportunities** - Logic that could be unified without forcing unrelated concepts together
+
+    ## Principles
+
+    - [Reasonably DRY](../principles/reasonably-dry.md)
+    - [Decoupled Code](../principles/decoupled-code.md)
+    - [Maintainable Codebase](../principles/maintainable-codebase.md)
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] Searched for repeated patterns across the codebase
+    - [ ] Identified copy-pasted or near-duplicate code
+    - [ ] Evaluated each case for whether extraction would be beneficial
+    - [ ] Considered whether similar code serves different purposes that may evolve independently
+    - [ ] Proposed ideas only for extractions where duplication is truly about the same concept
+  `;
+}
 function agentDeveloperExperience() {
   return dedent`
     # Agent Developer Experience
 
-    Review the codebase to ensure agents have everything they need to operate effectively. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Review the codebase to ensure agents have everything they need to operate effectively.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -627,7 +684,9 @@ function deadCode() {
   return dedent`
     # Dead Code
 
-    Find and remove unused code to improve maintainability and reduce bundle size. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Find and remove unused code to improve maintainability and reduce bundle size.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -662,7 +721,9 @@ function factsVerification() {
   return dedent`
     # Facts Verification
 
-    Review \`.dust/facts/\` to ensure documented facts match current reality. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Review \`.dust/facts/\` to ensure documented facts match current reality.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -695,7 +756,9 @@ function ideasFromCommits() {
   return dedent`
     # Ideas from Commits
 
-    Review recent commit history to identify follow-up improvement ideas. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues or opportunities you identify, avoiding duplication.
+    Review recent commit history to identify follow-up improvement ideas.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -727,7 +790,9 @@ function ideasFromPrinciples() {
   return dedent`
     # Ideas from Principles
 
-    Review \`.dust/principles/\` to generate new improvement ideas. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues or opportunities you identify, avoiding duplication.
+    Review \`.dust/principles/\` to generate new improvement ideas.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -758,7 +823,9 @@ function performanceReview() {
   return dedent`
     # Performance Review
 
-    Review the application for performance issues and optimization opportunities. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Review the application for performance issues and optimization opportunities.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -791,7 +858,9 @@ function securityReview() {
   return dedent`
     # Security Review
 
-    Review the codebase for common security vulnerabilities and misconfigurations. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Review the codebase for common security vulnerabilities and misconfigurations.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -826,7 +895,9 @@ function staleIdeas() {
   return dedent`
     # Stale Ideas
 
-    Review \`.dust/ideas/\` to identify ideas that have become stale or irrelevant. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Review \`.dust/ideas/\` to identify ideas that have become stale or irrelevant.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -858,7 +929,9 @@ function testCoverage() {
   return dedent`
     # Test Coverage
 
-    Identify untested code paths and areas that need additional test coverage. Review existing ideas in \`./.ideas/\` and the recent history of \`./.dust/ideas\` to understand what has been proposed or considered historically, then create new idea files in \`./.ideas/\` for any issues you identify, avoiding duplication.
+    Identify untested code paths and areas that need additional test coverage.
+
+    ${ideasHint}
 
     ## Scope
 
@@ -888,6 +961,7 @@ function testCoverage() {
 }
 var stockAuditFunctions = {
   "agent-developer-experience": agentDeveloperExperience,
+  "component-reuse": componentReuse,
   "dead-code": deadCode,
   "facts-verification": factsVerification,
   "ideas-from-commits": ideasFromCommits,
@@ -2133,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);
@@ -2263,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;
@@ -3446,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 };
@@ -3740,11 +3816,7 @@ function runBufferedProcess(spawnFn, command, commandArguments, cwd, shell, time
 import { join as join8 } from "node:path";
 
 // lib/lint/validators/content-validator.ts
-var REQUIRED_HEADINGS = [
-  "## Principles",
-  "## Blocked By",
-  "## Definition of Done"
-];
+var REQUIRED_HEADINGS = ["## Blocked By", "## Definition of Done"];
 var MAX_OPENING_SENTENCE_LENGTH = 150;
 var NON_IMPERATIVE_STARTERS = new Set([
   "the",
@@ -3912,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(`
@@ -4025,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";
@@ -4428,6 +4613,7 @@ async function lintMarkdown(dependencies) {
       if (ideaTransitionViolation) {
         violations.push(ideaTransitionViolation);
       }
+      violations.push(...validateWorkflowTaskBodySection(filePath, content, ideasPath, fileSystem));
     }
   }
   const principlesPath = `${dustPath}/principles`;
@@ -5376,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("");
@@ -5446,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.64",
+  "version": "0.1.67",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {
@@ -29,12 +29,17 @@
     "./filesystem": {
       "types": "./dist/filesystem/types.d.ts"
     },
-    "./istanbul/minimal-reporter": "./lib/istanbul/minimal-reporter.cjs"
+    "./istanbul/minimal-reporter": "./lib/istanbul/minimal-reporter.cjs",
+    "./biome": {
+      "import": "./dist/biome.js",
+      "types": "./dist/biome/index.d.ts"
+    }
   },
   "files": [
     "dist",
     "bin",
-    "lib/istanbul/minimal-reporter.cjs"
+    "lib/istanbul/minimal-reporter.cjs",
+    "biome"
   ],
   "repository": {
     "type": "git",
@@ -58,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"
   }
 }