@joshski/dust 0.1.76 → 0.1.77

package/dist/agent-events.d.ts

@@ -30,6 +30,7 @@ export interface EventMessage {
     timestamp: string;
     sessionId: string;
     repository: string;
+    repoId?: number;
     agentSessionId?: string;
     event: AgentSessionEvent;
 }

package/dist/audits.js

@@ -831,6 +831,75 @@ function ubiquitousLanguage() {
     - [ ] Proposed ideas for standardizing inconsistent terminology
   `;
 }
+function uxAudit() {
+  return dedent`
+    # UX Audit
+
+    Review the end user experience by capturing visual or interactive evidence at key scenarios.
+
+    ${ideasHint}
+
+    ## Scope
+
+    1. **Identify key scenarios** - What are the main user journeys? (e.g., signup, login, checkout, onboarding, core workflows)
+    2. **Capture evidence** - For each scenario:
+       - Web apps: Take screenshots at each step using browser automation (Playwright, Puppeteer, Cypress, or similar)
+       - Terminal apps: Capture command output and interactive sessions
+    3. **Review captured evidence** for UX issues:
+       - Confusing or unclear states
+       - Missing feedback or loading indicators
+       - Error messages that don't guide recovery
+       - Inconsistent styling or layout
+    4. **Document findings** with screenshots/output and specific recommendations
+
+    ## Applicability
+
+    Determine the application type and available tooling:
+    - If browser tests exist (Playwright, Puppeteer, Cypress), extend them to capture screenshots
+    - If no browser tests exist, write a standalone script for key scenarios
+    - For terminal apps, capture representative sessions using command output or terminal recording
+
+    If the project has no user-facing interface, document that finding and skip the detailed analysis.
+
+    ## Analysis Steps
+
+    1. Identify the application type (web, terminal, hybrid, no UI)
+    2. List the key user scenarios from documentation, tests, or code analysis
+    3. Capture screenshots or output at each stage of each scenario
+    4. Store artifacts in a temporary directory for review during this audit
+    5. Review each artifact for UX issues
+    6. Document findings with evidence and specific recommendations
+
+    ## Output
+
+    For each UX issue identified, provide:
+    - **Location** - Which scenario and step
+    - **Evidence** - Screenshot filename or captured output
+    - **Problem** - What's wrong from the user's perspective
+    - **Impact** - How it affects the user's ability to complete their goal
+    - **Recommendation** - Specific fix
+    - **Verification** - How to verify the fix (e.g., "Screenshot at step 3 should show success message instead of spinner")
+
+    ## Principles
+
+    - [Actionable Errors](../principles/actionable-errors.md) - Error messages should tell users what to do next
+    - [Unsurprising UX](../principles/unsurprising-ux.md) - The interface should be as guessable as possible
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] Identified the application type (web, terminal, hybrid, or no UI)
+    - [ ] Listed key user scenarios
+    - [ ] Captured screenshots or output at each stage of key scenarios
+    - [ ] Reviewed evidence for UX issues
+    - [ ] Documented findings with evidence and recommendations
+    - [ ] Included verification criteria for each issue
+    - [ ] Created ideas for any UX improvements needed
+  `;
+}
 var stockAuditFunctions = {
   "agent-developer-experience": agentDeveloperExperience,
   "component-reuse": componentReuse,
@@ -849,7 +918,8 @@ var stockAuditFunctions = {
   "slow-tests": slowTests,
   "stale-ideas": staleIdeas,
   "test-coverage": testCoverage,
-  "ubiquitous-language": ubiquitousLanguage
+  "ubiquitous-language": ubiquitousLanguage,
+  "ux-audit": uxAudit
 };
 function loadStockAudits() {
   return Object.entries(stockAuditFunctions).sort(([a], [b]) => a.localeCompare(b)).map(([name, render]) => {

package/dist/bucket/repository-loop.d.ts

@@ -30,6 +30,7 @@ export declare function buildEventMessage(parameters: {
     sequence: number;
     sessionId: string;
     repository: string;
+    repoId?: number;
     event: AgentSessionEvent;
     agentSessionId?: string;
 }): EventMessage;

package/dist/dust.js

@@ -275,7 +275,7 @@ async function loadSettings(cwd, fileSystem) {
 }
 
 // lib/version.ts
-var DUST_VERSION = "0.1.76";
+var DUST_VERSION = "0.1.77";
 
 // lib/session.ts
 var DUST_UNATTENDED = "DUST_UNATTENDED";
@@ -1378,6 +1378,75 @@ function ubiquitousLanguage() {
     - [ ] Proposed ideas for standardizing inconsistent terminology
   `;
 }
+function uxAudit() {
+  return dedent`
+    # UX Audit
+
+    Review the end user experience by capturing visual or interactive evidence at key scenarios.
+
+    ${ideasHint}
+
+    ## Scope
+
+    1. **Identify key scenarios** - What are the main user journeys? (e.g., signup, login, checkout, onboarding, core workflows)
+    2. **Capture evidence** - For each scenario:
+       - Web apps: Take screenshots at each step using browser automation (Playwright, Puppeteer, Cypress, or similar)
+       - Terminal apps: Capture command output and interactive sessions
+    3. **Review captured evidence** for UX issues:
+       - Confusing or unclear states
+       - Missing feedback or loading indicators
+       - Error messages that don't guide recovery
+       - Inconsistent styling or layout
+    4. **Document findings** with screenshots/output and specific recommendations
+
+    ## Applicability
+
+    Determine the application type and available tooling:
+    - If browser tests exist (Playwright, Puppeteer, Cypress), extend them to capture screenshots
+    - If no browser tests exist, write a standalone script for key scenarios
+    - For terminal apps, capture representative sessions using command output or terminal recording
+
+    If the project has no user-facing interface, document that finding and skip the detailed analysis.
+
+    ## Analysis Steps
+
+    1. Identify the application type (web, terminal, hybrid, no UI)
+    2. List the key user scenarios from documentation, tests, or code analysis
+    3. Capture screenshots or output at each stage of each scenario
+    4. Store artifacts in a temporary directory for review during this audit
+    5. Review each artifact for UX issues
+    6. Document findings with evidence and specific recommendations
+
+    ## Output
+
+    For each UX issue identified, provide:
+    - **Location** - Which scenario and step
+    - **Evidence** - Screenshot filename or captured output
+    - **Problem** - What's wrong from the user's perspective
+    - **Impact** - How it affects the user's ability to complete their goal
+    - **Recommendation** - Specific fix
+    - **Verification** - How to verify the fix (e.g., "Screenshot at step 3 should show success message instead of spinner")
+
+    ## Principles
+
+    - [Actionable Errors](../principles/actionable-errors.md) - Error messages should tell users what to do next
+    - [Unsurprising UX](../principles/unsurprising-ux.md) - The interface should be as guessable as possible
+
+    ## Blocked By
+
+    (none)
+
+    ## Definition of Done
+
+    - [ ] Identified the application type (web, terminal, hybrid, or no UI)
+    - [ ] Listed key user scenarios
+    - [ ] Captured screenshots or output at each stage of key scenarios
+    - [ ] Reviewed evidence for UX issues
+    - [ ] Documented findings with evidence and recommendations
+    - [ ] Included verification criteria for each issue
+    - [ ] Created ideas for any UX improvements needed
+  `;
+}
 var stockAuditFunctions = {
   "agent-developer-experience": agentDeveloperExperience,
   "component-reuse": componentReuse,
@@ -1396,7 +1465,8 @@ var stockAuditFunctions = {
   "slow-tests": slowTests,
   "stale-ideas": staleIdeas,
   "test-coverage": testCoverage,
-  "ubiquitous-language": ubiquitousLanguage
+  "ubiquitous-language": ubiquitousLanguage,
+  "ux-audit": uxAudit
 };
 function loadStockAudits() {
   return Object.entries(stockAuditFunctions).sort(([a], [b]) => a.localeCompare(b)).map(([name, render]) => {
@@ -2877,6 +2947,9 @@ function buildEventMessage(parameters) {
     repository: parameters.repository,
     event: parameters.event
   };
+  if (parameters.repoId !== undefined) {
+    msg.repoId = parameters.repoId;
+  }
   if (parameters.agentSessionId) {
     msg.agentSessionId = parameters.agentSessionId;
   }
@@ -2962,6 +3035,7 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
         sequence,
         sessionId,
         repository: repoName,
+        repoId: repoState.repository.id,
         event,
         agentSessionId
       }));

package/package.json

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