@joshski/dust 0.1.64 → 0.1.65

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

@@ -353,10 +353,6 @@ ${renderResolvedQuestions(options.resolvedQuestions)}
 
 ${openingSentence}
 ${descriptionParagraph}${resolvedSection}
-## Principles
-
-(none)
-
 ## Blocked By
 
 (none)
@@ -418,10 +414,6 @@ Research this idea thoroughly, then create one or more narrowly-scoped task file
 
 ${description}
 
-## Principles
-
-(none)
-
 ## Blocked By
 
 (none)
@@ -438,28 +430,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.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/dust.js

@@ -275,7 +275,7 @@ async function loadSettings(cwd, fileSystem) {
 }
 
 // lib/version.ts
-var DUST_VERSION = "0.1.64";
+var DUST_VERSION = "0.1.65";
 
 // lib/cli/dedent.ts
 function dedent(strings, ...values) {
@@ -590,11 +590,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 +666,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 +703,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 +738,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 +772,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 +805,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 +840,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 +877,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 +911,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 +943,7 @@ function testCoverage() {
 }
 var stockAuditFunctions = {
   "agent-developer-experience": agentDeveloperExperience,
+  "component-reuse": componentReuse,
   "dead-code": deadCode,
   "facts-verification": factsVerification,
   "ideas-from-commits": ideasFromCommits,
@@ -3740,11 +3796,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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.64",
+  "version": "0.1.65",
   "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",