@joshski/dust 0.1.74 → 0.1.76

package/dist/audits.js

@@ -670,6 +670,114 @@ function globalState() {
     - [ ] Proposed ideas for refactoring global state to explicit dependencies
   `;
 }
+function repositoryContext() {
+  return dedent`
+    # Repository Context
+
+    Compile or update \`.dust/repository.md\` with a high-level overview of the repository's purpose, capabilities, and design philosophy.
+
+    ## Purpose
+
+    The repository context document helps downstream agents quickly understand the project without reading individual files. It describes features, scenarios, and design philosophy rather than implementation details. This enables high-level planning where agents reason about capabilities rather than code structure.
+
+    ## Scope
+
+    Review the current state of the codebase and produce a document covering:
+
+    1. **What the project is** - A one-sentence summary of its purpose
+    2. **What it does** - The key capabilities and features it provides
+    3. **How it fits into workflows** - How users or other systems interact with it
+    4. **Design philosophy** - The guiding principles behind its architecture
+    5. **Key scenarios** - The main use cases or user journeys it supports
+
+    Avoid mentioning specific file paths, class names, or implementation details. Write for someone who needs to make high-level suggestions about the project's direction, not someone about to edit a specific file.
+
+    ## Analysis Steps
+
+    1. Read the existing \`.dust/repository.md\` if it exists
+    2. Review README, package.json, and top-level documentation for project purpose
+    3. Scan the codebase to understand features and capabilities
+    4. Review \`.dust/principles/\` for design philosophy
+    5. Review \`.dust/facts/\` for context on current state
+    6. Update \`.dust/repository.md\` with current findings, preserving any sections that are still accurate
+
+    ## Principles
+
+    (none)
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] \`.dust/repository.md\` exists and is up to date
+    - [ ] Document describes what the project does without referencing specific files
+    - [ ] Key capabilities and features are listed
+    - [ ] Design philosophy or guiding approach is captured
+    - [ ] Document is concise enough to fit comfortably in an agent context window
+    - [ ] A new agent reading only this document could make sensible high-level suggestions
+  `;
+}
+function slowTests() {
+  return dedent`
+    # Slow Tests
+
+    Identify slow-running tests that impact feedback loop speed.
+
+    ${ideasHint}
+
+    ## Scope
+
+    Focus on these areas:
+
+    1. **Test execution times** - Identify tests that exceed a reasonable duration threshold (e.g., 100ms for unit tests, 1s for integration tests)
+    2. **I/O-bound tests** - Tests that perform actual file system, network, or database operations
+    3. **Sleep/delay usage** - Tests using \`setTimeout\`, \`sleep\`, or similar timing functions
+    4. **Missing mocks** - Tests that make real HTTP requests or database calls instead of using stubs
+    5. **Setup overhead** - Expensive \`beforeEach\`/\`beforeAll\` setup that could be optimized or shared
+    6. **Serial test execution** - Tests that could run in parallel but are forced to run serially
+
+    ## Analysis Steps
+
+    1. Run the test suite with timing output: \`npm test -- --reporter=verbose\` or equivalent
+    2. Identify tests taking longer than the threshold (100ms+ for unit, 1s+ for integration)
+    3. Search for \`setTimeout\`, \`sleep\`, \`delay\`, and similar timing patterns in test files
+    4. Look for real I/O: \`fetch\`, \`axios\`, database clients, file system operations without mocks
+    5. Review \`beforeEach\`/\`beforeAll\` blocks for expensive operations
+    6. Check test configuration for parallelization settings
+
+    ## Output
+
+    For each slow test identified, provide:
+    - **Test name** - The describe/it block name
+    - **File path** - Location of the test
+    - **Duration** - How long the test takes (if measurable)
+    - **Cause** - Why the test is slow (I/O, sleep, setup, etc.)
+    - **Suggestion** - Specific optimization (mock the API, use fake timers, share setup, etc.)
+
+    ## Principles
+
+    - [Fast Feedback Loops](../principles/fast-feedback-loops.md) - Tests should run quickly for tight iteration cycles
+    - [Fast Feedback](../principles/fast-feedback.md) - Slow tests discourage frequent validation
+    - [Keep Unit Tests Pure](../principles/keep-unit-tests-pure.md) - Pure tests are faster and more reliable
+    - [Stubs Over Mocks](../principles/stubs-over-mocks.md) - Use stubs to avoid slow real dependencies
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] Ran test suite with timing information
+    - [ ] Listed tests exceeding duration thresholds (100ms unit, 1s integration)
+    - [ ] Identified tests using sleep/setTimeout/delay patterns
+    - [ ] Found tests with unmocked I/O (network, database, file system)
+    - [ ] Reviewed beforeEach/beforeAll for optimization opportunities
+    - [ ] Checked test parallelization configuration
+    - [ ] Proposed ideas for optimizing the slowest tests
+  `;
+}
 function ubiquitousLanguage() {
   return dedent`
     # Ubiquitous Language
@@ -736,7 +844,9 @@ var stockAuditFunctions = {
   "ideas-from-principles": ideasFromPrinciples,
   "performance-review": performanceReview,
   "refactoring-opportunities": refactoringOpportunities,
+  "repository-context": repositoryContext,
   "security-review": securityReview,
+  "slow-tests": slowTests,
   "stale-ideas": staleIdeas,
   "test-coverage": testCoverage,
   "ubiquitous-language": ubiquitousLanguage

package/dist/dust.js

@@ -275,7 +275,7 @@ async function loadSettings(cwd, fileSystem) {
 }
 
 // lib/version.ts
-var DUST_VERSION = "0.1.74";
+var DUST_VERSION = "0.1.76";
 
 // lib/session.ts
 var DUST_UNATTENDED = "DUST_UNATTENDED";
@@ -1217,6 +1217,114 @@ function globalState() {
     - [ ] Proposed ideas for refactoring global state to explicit dependencies
   `;
 }
+function repositoryContext() {
+  return dedent`
+    # Repository Context
+
+    Compile or update \`.dust/repository.md\` with a high-level overview of the repository's purpose, capabilities, and design philosophy.
+
+    ## Purpose
+
+    The repository context document helps downstream agents quickly understand the project without reading individual files. It describes features, scenarios, and design philosophy rather than implementation details. This enables high-level planning where agents reason about capabilities rather than code structure.
+
+    ## Scope
+
+    Review the current state of the codebase and produce a document covering:
+
+    1. **What the project is** - A one-sentence summary of its purpose
+    2. **What it does** - The key capabilities and features it provides
+    3. **How it fits into workflows** - How users or other systems interact with it
+    4. **Design philosophy** - The guiding principles behind its architecture
+    5. **Key scenarios** - The main use cases or user journeys it supports
+
+    Avoid mentioning specific file paths, class names, or implementation details. Write for someone who needs to make high-level suggestions about the project's direction, not someone about to edit a specific file.
+
+    ## Analysis Steps
+
+    1. Read the existing \`.dust/repository.md\` if it exists
+    2. Review README, package.json, and top-level documentation for project purpose
+    3. Scan the codebase to understand features and capabilities
+    4. Review \`.dust/principles/\` for design philosophy
+    5. Review \`.dust/facts/\` for context on current state
+    6. Update \`.dust/repository.md\` with current findings, preserving any sections that are still accurate
+
+    ## Principles
+
+    (none)
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] \`.dust/repository.md\` exists and is up to date
+    - [ ] Document describes what the project does without referencing specific files
+    - [ ] Key capabilities and features are listed
+    - [ ] Design philosophy or guiding approach is captured
+    - [ ] Document is concise enough to fit comfortably in an agent context window
+    - [ ] A new agent reading only this document could make sensible high-level suggestions
+  `;
+}
+function slowTests() {
+  return dedent`
+    # Slow Tests
+
+    Identify slow-running tests that impact feedback loop speed.
+
+    ${ideasHint}
+
+    ## Scope
+
+    Focus on these areas:
+
+    1. **Test execution times** - Identify tests that exceed a reasonable duration threshold (e.g., 100ms for unit tests, 1s for integration tests)
+    2. **I/O-bound tests** - Tests that perform actual file system, network, or database operations
+    3. **Sleep/delay usage** - Tests using \`setTimeout\`, \`sleep\`, or similar timing functions
+    4. **Missing mocks** - Tests that make real HTTP requests or database calls instead of using stubs
+    5. **Setup overhead** - Expensive \`beforeEach\`/\`beforeAll\` setup that could be optimized or shared
+    6. **Serial test execution** - Tests that could run in parallel but are forced to run serially
+
+    ## Analysis Steps
+
+    1. Run the test suite with timing output: \`npm test -- --reporter=verbose\` or equivalent
+    2. Identify tests taking longer than the threshold (100ms+ for unit, 1s+ for integration)
+    3. Search for \`setTimeout\`, \`sleep\`, \`delay\`, and similar timing patterns in test files
+    4. Look for real I/O: \`fetch\`, \`axios\`, database clients, file system operations without mocks
+    5. Review \`beforeEach\`/\`beforeAll\` blocks for expensive operations
+    6. Check test configuration for parallelization settings
+
+    ## Output
+
+    For each slow test identified, provide:
+    - **Test name** - The describe/it block name
+    - **File path** - Location of the test
+    - **Duration** - How long the test takes (if measurable)
+    - **Cause** - Why the test is slow (I/O, sleep, setup, etc.)
+    - **Suggestion** - Specific optimization (mock the API, use fake timers, share setup, etc.)
+
+    ## Principles
+
+    - [Fast Feedback Loops](../principles/fast-feedback-loops.md) - Tests should run quickly for tight iteration cycles
+    - [Fast Feedback](../principles/fast-feedback.md) - Slow tests discourage frequent validation
+    - [Keep Unit Tests Pure](../principles/keep-unit-tests-pure.md) - Pure tests are faster and more reliable
+    - [Stubs Over Mocks](../principles/stubs-over-mocks.md) - Use stubs to avoid slow real dependencies
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] Ran test suite with timing information
+    - [ ] Listed tests exceeding duration thresholds (100ms unit, 1s integration)
+    - [ ] Identified tests using sleep/setTimeout/delay patterns
+    - [ ] Found tests with unmocked I/O (network, database, file system)
+    - [ ] Reviewed beforeEach/beforeAll for optimization opportunities
+    - [ ] Checked test parallelization configuration
+    - [ ] Proposed ideas for optimizing the slowest tests
+  `;
+}
 function ubiquitousLanguage() {
   return dedent`
     # Ubiquitous Language
@@ -1283,7 +1391,9 @@ var stockAuditFunctions = {
   "ideas-from-principles": ideasFromPrinciples,
   "performance-review": performanceReview,
   "refactoring-opportunities": refactoringOpportunities,
+  "repository-context": repositoryContext,
   "security-review": securityReview,
+  "slow-tests": slowTests,
   "stale-ideas": staleIdeas,
   "test-coverage": testCoverage,
   "ubiquitous-language": ubiquitousLanguage
@@ -2214,7 +2324,8 @@ function getRepoPath(repoName, reposDir) {
 async function cloneRepository(repository, targetPath, spawn, context) {
   return new Promise((resolve) => {
     const proc = spawn("git", ["clone", repository.gitUrl, targetPath], {
-      stdio: ["ignore", "pipe", "pipe"]
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, GIT_TERMINAL_PROMPT: "0" }
     });
     let stderr = "";
     proc.stderr?.on("data", (data) => {
@@ -2438,26 +2549,26 @@ function getEnvironmentContext(cwd) {
 function formatLoopEvent(event) {
   switch (event.type) {
     case "loop.warning":
-      return "⚠️  WARNING: This command skips all permission checks. Only use in a sandbox environment!";
+      return "WARNING: This command skips all permission checks. Only use in a sandbox environment!";
     case "loop.started": {
       const agent2 = event.agentType ?? "claude";
-      return `\uD83D\uDD04 Starting dust loop ${agent2} (max ${event.maxIterations} iterations)...`;
+      return `Starting dust loop ${agent2} (max ${event.maxIterations} iterations)...`;
     }
     case "loop.syncing":
-      return "\uD83C\uDF0D Syncing with remote";
+      return "Syncing with remote";
     case "loop.sync_skipped":
       return `Note: git pull skipped (${event.reason})`;
     case "loop.checking_tasks":
       return null;
     case "loop.no_tasks":
-      return "\uD83D\uDE34 No tasks available. Sleeping...";
+      return "No tasks available. Sleeping...";
     case "loop.tasks_found":
-      return `✨ Found a task. Going to work!
+      return `Found a task. Going to work!
 `;
     case "loop.iteration_complete":
-      return `\uD83D\uDCCB Completed iteration ${event.iteration}/${event.maxIterations}`;
+      return `Completed iteration ${event.iteration}/${event.maxIterations}`;
     case "loop.ended":
-      return `\uD83C\uDFC1 Reached max iterations (${event.maxIterations}). Exiting.`;
+      return `Reached max iterations (${event.maxIterations}). Exiting.`;
   }
 }
 function createPostEvent(fetchFn) {
@@ -2515,7 +2626,8 @@ async function gitPull(cwd, spawn) {
   return new Promise((resolve) => {
     const proc = spawn("git", ["pull"], {
       cwd,
-      stdio: ["ignore", "pipe", "pipe"]
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, GIT_TERMINAL_PROMPT: "0" }
     });
     let stderr = "";
     proc.stderr?.on("data", (data) => {
@@ -3065,6 +3177,15 @@ function parseServerMessage(data) {
 }
 
 // lib/bucket/terminal-ui.ts
+var CHARS = {
+  dot: "*",
+  sparkle: "",
+  ellipsis: "...",
+  hline: "-",
+  arrows_lr: "<->",
+  arrows_ud: "up/dn",
+  scroll_down: "v"
+};
 var ANSI = {
   HIDE_CURSOR: "\x1B[?25l",
   SHOW_CURSOR: "\x1B[?25h",
@@ -3119,8 +3240,8 @@ function truncateLine(text, maxWidth) {
   for (let match = ansiRegex.exec(text);match !== null; match = ansiRegex.exec(text)) {
     const textBefore = text.slice(lastIndex, match.index);
     for (const char of textBefore) {
-      if (visibleCount >= maxWidth - 1) {
-        result += "…";
+      if (visibleCount >= maxWidth - CHARS.ellipsis.length) {
+        result += CHARS.ellipsis;
         return result + ANSI.RESET;
       }
       result += char;
@@ -3131,8 +3252,8 @@ function truncateLine(text, maxWidth) {
   }
   const remaining = text.slice(lastIndex);
   for (const char of remaining) {
-    if (visibleCount >= maxWidth - 1) {
-      result += "…";
+    if (visibleCount >= maxWidth - CHARS.ellipsis.length) {
+      result += CHARS.ellipsis;
       return result + ANSI.RESET;
     }
     result += char;
@@ -3232,7 +3353,7 @@ function getTabRowCount(state) {
     return 1;
   const tabWidths = [5];
   for (const name of state.repositories) {
-    tabWidths.push(name.length + 4);
+    tabWidths.push(name.length + 2 + CHARS.dot.length + 1);
   }
   let rows = 1;
   let currentRowWidth = 0;
@@ -3302,8 +3423,8 @@ function renderTabs(state) {
     const color = getRepoColor(name, i);
     const agentStatus = state.agentStatuses.get(name) ?? "idle";
     const dotColor = agentStatus === "busy" ? ANSI.FG_GREEN : ANSI.DIM;
-    const dot = `${dotColor}●${ANSI.RESET}`;
-    const width = name.length + 4;
+    const dot = `${dotColor}${CHARS.dot}${ANSI.RESET}`;
+    const width = name.length + 2 + CHARS.dot.length + 1;
     if (i === state.selectedIndex) {
       tabs.push({
         text: ` ${dot}${color} ${ANSI.INVERSE}${name}${ANSI.RESET} `,
@@ -3328,10 +3449,10 @@ function renderTabs(state) {
   return rows.map((row) => row.map((t) => t.text).join("|"));
 }
 function renderHelpLine() {
-  return `${ANSI.DIM}[←→] select  [↑↓] scroll  [PgUp/PgDn] page  [g/G] top/bottom  [o] open  [q] quit${ANSI.RESET}`;
+  return `${ANSI.DIM}[${CHARS.arrows_lr}] select  [${CHARS.arrows_ud}] scroll  [PgUp/PgDn] page  [g/G] top/bottom  [o] open  [q] quit${ANSI.RESET}`;
 }
 function renderSeparator(width) {
-  return "─".repeat(width);
+  return CHARS.hline.repeat(Math.max(0, width));
 }
 function formatLogLine(line, prefixAlign, maxWidth) {
   let prefix = "";
@@ -3363,7 +3484,7 @@ function formatLogLine(line, prefixAlign, maxWidth) {
 function renderFrame(state) {
   const lines = [];
   const hostLabel = state.connectedHost ? ` ${ANSI.DIM}[connected to ${state.connectedHost}]${ANSI.RESET}` : "";
-  lines.push(`${ANSI.BOLD}✨ dust bucket${ANSI.RESET}${hostLabel}`);
+  lines.push(`${ANSI.BOLD}${CHARS.sparkle}dust bucket${ANSI.RESET}${hostLabel}`);
   const tabRows = renderTabs(state);
   for (const tabRow of tabRows) {
     lines.push(tabRow);
@@ -3386,7 +3507,7 @@ function renderFrame(state) {
     lines.push("");
   }
   if (state.scrollOffset > 0) {
-    const indicator = `${ANSI.DIM}↓ ${state.scrollOffset} more${ANSI.RESET}`;
+    const indicator = `${ANSI.DIM}${CHARS.scroll_down} ${state.scrollOffset} more${ANSI.RESET}`;
     lines[lines.length - 1] = indicator;
   }
   const output = [];
@@ -3534,8 +3655,8 @@ function defaultSetupResize(onResize) {
 }
 function defaultGetTerminalSize() {
   return {
-    width: process.stdout.columns ?? 80,
-    height: process.stdout.rows ?? 24
+    width: process.stdout.columns || 80,
+    height: process.stdout.rows || 24
   };
 }
 function defaultWriteStdout(data) {

package/package.json

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