@joshski/dust 0.1.93 → 0.1.95

package/dist/artifacts/index.d.ts

@@ -3,7 +3,7 @@ import { type Fact } from './facts';
 import { type Idea, type IdeaOpenQuestion, type IdeaOption, parseOpenQuestions } from './ideas';
 import { type Principle } from './principles';
 import { type Task } from './tasks';
-import { type AllWorkflowTasks, CAPTURE_IDEA_PREFIX, type CreateIdeaTransitionTaskResult, type DecomposeIdeaOptions, findAllWorkflowTasks, type IdeaInProgress, type OpenQuestionResponse, type ParsedCaptureIdeaTask, type WorkflowTaskMatch, type WorkflowTaskType } from './workflow-tasks';
+import { type AllWorkflowTasks, CAPTURE_IDEA_PREFIX, type CreateIdeaTransitionTaskResult, type DecomposeIdeaOptions, findAllWorkflowTasks, type IdeaInProgress, type OpenQuestionResponse, type ParsedCaptureIdeaTask, parseResolvedQuestions, type WorkflowTaskMatch, type WorkflowTaskType } from './workflow-tasks';
 export type { AllWorkflowTasks, CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, Fact, Idea, IdeaOpenQuestion, IdeaOption, OpenQuestionResponse, ParsedCaptureIdeaTask, Principle, Task, WorkflowTaskMatch, WorkflowTaskType, };
 export interface TaskGraphNode {
     task: Task;
@@ -16,10 +16,10 @@ export interface TaskGraph {
         to: string;
     }>;
 }
-export { CAPTURE_IDEA_PREFIX, findAllWorkflowTasks, parseOpenQuestions };
+export { CAPTURE_IDEA_PREFIX, findAllWorkflowTasks, parseOpenQuestions, parseResolvedQuestions, };
 export type { IdeaInProgress };
 export type ArtifactType = 'ideas' | 'tasks' | 'principles' | 'facts';
-export interface ArtifactsRepository {
+export interface ReadOnlyArtifactsRepository {
     artifactPath(type: ArtifactType, slug: string): string;
     parseIdea(options: {
         slug: string;
@@ -37,6 +37,15 @@ export interface ArtifactsRepository {
         slug: string;
     }): Promise<Task>;
     listTasks(): Promise<string[]>;
+    findWorkflowTaskForIdea(options: {
+        ideaSlug: string;
+    }): Promise<WorkflowTaskMatch | null>;
+    parseCaptureIdeaTask(options: {
+        taskSlug: string;
+    }): Promise<ParsedCaptureIdeaTask | null>;
+    buildTaskGraph(): Promise<TaskGraph>;
+}
+export interface ArtifactsRepository extends ReadOnlyArtifactsRepository {
     createRefineIdeaTask(options: {
         ideaSlug: string;
         description?: string;
@@ -51,19 +60,17 @@ export interface ArtifactsRepository {
         description?: string;
         dustCommand?: string;
     }): Promise<CreateIdeaTransitionTaskResult>;
+    createExpediteIdeaTask(options: {
+        ideaSlug: string;
+        description?: string;
+        dustCommand?: string;
+    }): Promise<CreateIdeaTransitionTaskResult>;
     createIdeaTask(options: {
         title: string;
         description: string;
         expedite?: boolean;
         dustCommand?: string;
     }): Promise<CreateIdeaTransitionTaskResult>;
-    findWorkflowTaskForIdea(options: {
-        ideaSlug: string;
-    }): Promise<WorkflowTaskMatch | null>;
-    parseCaptureIdeaTask(options: {
-        taskSlug: string;
-    }): Promise<ParsedCaptureIdeaTask | null>;
-    buildTaskGraph(): Promise<TaskGraph>;
 }
 export declare function buildArtifactsRepository(fileSystem: FileSystem, dustPath: string): ArtifactsRepository;
-export declare function buildReadOnlyArtifactsRepository(fileSystem: ReadableFileSystem, dustPath: string): Pick<ArtifactsRepository, 'artifactPath' | 'parseIdea' | 'listIdeas' | 'parsePrinciple' | 'listPrinciples' | 'parseFact' | 'listFacts' | 'parseTask' | 'listTasks' | 'findWorkflowTaskForIdea' | 'parseCaptureIdeaTask' | 'buildTaskGraph'>;
+export declare function buildReadOnlyArtifactsRepository(fileSystem: ReadableFileSystem, dustPath: string): ReadOnlyArtifactsRepository;

package/dist/artifacts/workflow-tasks.d.ts

@@ -21,11 +21,12 @@ export interface ParsedCaptureIdeaTask {
  * 6. Add .md extension
  */
 export declare function titleToFilename(title: string): string;
-export type WorkflowTaskType = 'refine-idea' | 'decompose-idea' | 'shelve-idea';
+export type WorkflowTaskType = 'refine-idea' | 'decompose-idea' | 'shelve-idea' | 'expedite-idea';
 export interface WorkflowTaskMatch {
     type: WorkflowTaskType;
     ideaSlug: string;
     taskSlug: string;
+    resolvedQuestions: OpenQuestionResponse[];
 }
 export interface AllWorkflowTasks {
     captureIdeaTasks: IdeaInProgress[];
@@ -45,9 +46,11 @@ export interface DecomposeIdeaOptions {
     description?: string;
     openQuestionResponses?: OpenQuestionResponse[];
 }
+export declare function parseResolvedQuestions(content: string): OpenQuestionResponse[];
 export declare function createRefineIdeaTask(fileSystem: FileSystem, dustPath: string, ideaSlug: string, description?: string, openQuestionResponses?: OpenQuestionResponse[], dustCommand?: string): Promise<CreateIdeaTransitionTaskResult>;
 export declare function decomposeIdea(fileSystem: FileSystem, dustPath: string, options: DecomposeIdeaOptions, dustCommand?: string): Promise<CreateIdeaTransitionTaskResult>;
 export declare function createShelveIdeaTask(fileSystem: FileSystem, dustPath: string, ideaSlug: string, description?: string, _dustCommand?: string): Promise<CreateIdeaTransitionTaskResult>;
+export declare function createExpediteIdeaTask(fileSystem: FileSystem, dustPath: string, ideaSlug: string, description?: string, dustCommand?: string): Promise<CreateIdeaTransitionTaskResult>;
 export declare function createIdeaTask(fileSystem: FileSystem, dustPath: string, options: {
     title: string;
     description: string;

package/dist/artifacts.js

@@ -92,7 +92,21 @@ function parseOpenQuestions(content) {
       currentQuestion = null;
     }
   }
+  let inCodeFence = false;
   for (const line of lines) {
+    if (line.startsWith("```")) {
+      inCodeFence = !inCodeFence;
+      if (currentOption) {
+        descriptionLines.push(line);
+      }
+      continue;
+    }
+    if (inCodeFence) {
+      if (currentOption) {
+        descriptionLines.push(line);
+      }
+      continue;
+    }
     if (line.startsWith("## ")) {
       if (inOpenQuestions) {
         flushQuestion();
@@ -240,9 +254,9 @@ function extractDefinitionOfDone(content) {
       continue;
     if (line.startsWith("# "))
       break;
-    const checklistMatch = line.match(/^-\s+\[[x\s]\]\s+(.+)$/i);
-    if (checklistMatch) {
-      items.push(checklistMatch[1].trim());
+    const listMatch = line.match(/^-\s+(.+)$/);
+    if (listMatch) {
+      items.push(listMatch[1].trim());
     }
   }
   return items;
@@ -293,13 +307,21 @@ async function readWorkflowHint(fileSystem, dustPath, workflowType) {
 var WORKFLOW_SECTION_HEADINGS = [
   { type: "refine-idea", heading: "Refines Idea" },
   { type: "decompose-idea", heading: "Decomposes Idea" },
-  { type: "shelve-idea", heading: "Shelves Idea" }
+  { type: "shelve-idea", heading: "Shelves Idea" },
+  { type: "expedite-idea", heading: "Expedites Idea" }
 ];
 function extractIdeaSlugFromSection(content, sectionHeading) {
   const lines = content.split(`
 `);
   let inSection = false;
+  let inCodeFence = false;
   for (const line of lines) {
+    if (line.startsWith("```")) {
+      inCodeFence = !inCodeFence;
+      continue;
+    }
+    if (inCodeFence)
+      continue;
     if (line.startsWith("## ")) {
       inSection = line.trimEnd() === `## ${sectionHeading}`;
       continue;
@@ -327,7 +349,7 @@ async function findAllWorkflowTasks(fileSystem, dustPath) {
     return { captureIdeaTasks, workflowTasksByIdeaSlug };
   }
   const files = await fileSystem.readdir(tasksPath);
-  for (const file of files.filter((f) => f.endsWith(".md")).sort()) {
+  for (const file of files.filter((f) => f.endsWith(".md")).toSorted()) {
     const content = await fileSystem.readFile(`${tasksPath}/${file}`);
     const titleMatch = content.match(/^#\s+(.+)$/m);
     if (!titleMatch)
@@ -351,7 +373,8 @@ async function findAllWorkflowTasks(fileSystem, dustPath) {
         workflowTasksByIdeaSlug.set(linkedSlug, {
           type,
           ideaSlug: linkedSlug,
-          taskSlug
+          taskSlug,
+          resolvedQuestions: parseResolvedQuestions(content)
         });
       }
     }
@@ -368,13 +391,18 @@ async function findWorkflowTaskForIdea(fileSystem, dustPath, ideaSlug) {
     return null;
   }
   const files = await fileSystem.readdir(tasksPath);
-  for (const file of files.filter((f) => f.endsWith(".md")).sort()) {
+  for (const file of files.filter((f) => f.endsWith(".md")).toSorted()) {
     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 {
+          type,
+          ideaSlug,
+          taskSlug,
+          resolvedQuestions: parseResolvedQuestions(content)
+        };
       }
     }
   }
@@ -403,6 +431,46 @@ ${sections.join(`
 `)}
 `;
 }
+function parseResolvedQuestions(content) {
+  const lines = content.split(`
+`);
+  const results = [];
+  let inSection = false;
+  let currentQuestion = null;
+  let inCodeFence = false;
+  for (const line of lines) {
+    if (line.startsWith("```")) {
+      inCodeFence = !inCodeFence;
+      continue;
+    }
+    if (inCodeFence)
+      continue;
+    if (line.startsWith("## ")) {
+      inSection = line.trimEnd() === "## Resolved Questions";
+      currentQuestion = null;
+      continue;
+    }
+    if (!inSection)
+      continue;
+    if (line.startsWith("# "))
+      break;
+    if (line.startsWith("### ")) {
+      currentQuestion = line.slice(4).trimEnd();
+      continue;
+    }
+    if (currentQuestion !== null) {
+      const decisionMatch = line.match(/^\*\*Decision:\*\*\s*(.+)$/);
+      if (decisionMatch) {
+        results.push({
+          question: currentQuestion,
+          chosenOption: decisionMatch[1].trimEnd()
+        });
+        currentQuestion = null;
+      }
+    }
+  }
+  return results;
+}
 function renderIdeaSection(ideaSection) {
   return `## ${ideaSection.heading}
 
@@ -440,7 +508,7 @@ ${repositoryHintsSection}
 
 ## Definition of Done
 
-${definitionOfDone.map((item) => `- [ ] ${item}`).join(`
+${definitionOfDone.map((item) => `- ${item}`).join(`
 `)}
 `;
 }
@@ -486,6 +554,14 @@ async function decomposeIdea(fileSystem, dustPath, options, dustCommand) {
 async function createShelveIdeaTask(fileSystem, dustPath, ideaSlug, description, _dustCommand) {
   return createIdeaTransitionTask(fileSystem, dustPath, "shelve-idea", "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 createExpediteIdeaTask(fileSystem, dustPath, ideaSlug, description, dustCommand) {
+  const cmd = dustCommand ?? "dust";
+  return createIdeaTransitionTask(fileSystem, dustPath, "expedite-idea", "Expedite Idea: ", ideaSlug, (ideaTitle) => `Research this idea briefly. If confident the implementation is straightforward (clear scope, minimal risk, no open questions), implement directly and commit. Otherwise, create one or more narrowly-scoped task files in \`.dust/tasks/\`. Run \`${cmd} principles\` and \`${cmd} facts\` for relevant context. See [${ideaTitle}](../ideas/${ideaSlug}.md).`, [
+    "Idea is implemented directly OR one or more new tasks are created in `.dust/tasks/`",
+    "If tasks were created, they link to relevant principles from `.dust/principles/`",
+    "Changes are committed with a clear commit message"
+  ], "Expedites Idea", { description });
+}
 async function createIdeaTask(fileSystem, dustPath, options) {
   const { title, description, expedite, dustCommand } = options;
   const cmd = dustCommand ?? "dust";
@@ -517,9 +593,9 @@ ${repositoryHintsSection2}
 
 ## Definition of Done
 
-- [ ] Idea is implemented directly OR one or more new tasks are created in \`.dust/tasks/\`
-- [ ] If tasks were created, they link to relevant principles from \`.dust/principles/\`
-- [ ] Changes are committed with a clear commit message
+- Idea is implemented directly OR one or more new tasks are created in \`.dust/tasks/\`
+- If tasks were created, they link to relevant principles from \`.dust/principles/\`
+- Changes are committed with a clear commit message
 `;
     await fileSystem.writeFile(filePath2, content2);
     return { filePath: filePath2 };
@@ -545,11 +621,11 @@ ${repositoryHintsSection}
 
 ## Definition of Done
 
-- [ ] 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
+- 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
 `;
   await fileSystem.writeFile(filePath, content);
   return { filePath };
@@ -585,7 +661,7 @@ async function parseCaptureIdeaTask(fileSystem, dustPath, taskSlug) {
 }
 
 // lib/artifacts/index.ts
-function buildArtifactsRepository(fileSystem, dustPath) {
+function buildReadOperations(fileSystem, dustPath) {
   return {
     artifactPath(type, slug) {
       return `${dustPath}/${type}/${slug}.md`;
@@ -599,7 +675,7 @@ function buildArtifactsRepository(fileSystem, dustPath) {
         return [];
       }
       const files = await fileSystem.readdir(ideasPath);
-      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).sort();
+      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).toSorted();
     },
     async parsePrinciple(options) {
       return parsePrinciple(fileSystem, dustPath, options.slug);
@@ -610,7 +686,7 @@ function buildArtifactsRepository(fileSystem, dustPath) {
         return [];
       }
       const files = await fileSystem.readdir(principlesPath);
-      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).sort();
+      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).toSorted();
     },
     async parseFact(options) {
       return parseFact(fileSystem, dustPath, options.slug);
@@ -621,7 +697,7 @@ function buildArtifactsRepository(fileSystem, dustPath) {
         return [];
       }
       const files = await fileSystem.readdir(factsPath);
-      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).sort();
+      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).toSorted();
     },
     async parseTask(options) {
       return parseTask(fileSystem, dustPath, options.slug);
@@ -632,19 +708,7 @@ function buildArtifactsRepository(fileSystem, dustPath) {
         return [];
       }
       const files = await fileSystem.readdir(tasksPath);
-      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).sort();
-    },
-    async createRefineIdeaTask(options) {
-      return createRefineIdeaTask(fileSystem, dustPath, options.ideaSlug, options.description, options.openQuestionResponses, options.dustCommand);
-    },
-    async createDecomposeIdeaTask(options) {
-      return decomposeIdea(fileSystem, dustPath, options, options.dustCommand);
-    },
-    async createShelveIdeaTask(options) {
-      return createShelveIdeaTask(fileSystem, dustPath, options.ideaSlug, options.description, options.dustCommand);
-    },
-    async createIdeaTask(options) {
-      return createIdeaTask(fileSystem, dustPath, options);
+      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).toSorted();
     },
     async findWorkflowTaskForIdea(options) {
       return findWorkflowTaskForIdea(fileSystem, dustPath, options.ideaSlug);
@@ -675,85 +739,31 @@ function buildArtifactsRepository(fileSystem, dustPath) {
     }
   };
 }
-function buildReadOnlyArtifactsRepository(fileSystem, dustPath) {
+function buildArtifactsRepository(fileSystem, dustPath) {
   return {
-    artifactPath(type, slug) {
-      return `${dustPath}/${type}/${slug}.md`;
-    },
-    async parseIdea(options) {
-      return parseIdea(fileSystem, dustPath, options.slug);
-    },
-    async listIdeas() {
-      const ideasPath = `${dustPath}/ideas`;
-      if (!fileSystem.exists(ideasPath)) {
-        return [];
-      }
-      const files = await fileSystem.readdir(ideasPath);
-      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).sort();
-    },
-    async parsePrinciple(options) {
-      return parsePrinciple(fileSystem, dustPath, options.slug);
-    },
-    async listPrinciples() {
-      const principlesPath = `${dustPath}/principles`;
-      if (!fileSystem.exists(principlesPath)) {
-        return [];
-      }
-      const files = await fileSystem.readdir(principlesPath);
-      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).sort();
-    },
-    async parseFact(options) {
-      return parseFact(fileSystem, dustPath, options.slug);
-    },
-    async listFacts() {
-      const factsPath = `${dustPath}/facts`;
-      if (!fileSystem.exists(factsPath)) {
-        return [];
-      }
-      const files = await fileSystem.readdir(factsPath);
-      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).sort();
-    },
-    async parseTask(options) {
-      return parseTask(fileSystem, dustPath, options.slug);
+    ...buildReadOperations(fileSystem, dustPath),
+    async createRefineIdeaTask(options) {
+      return createRefineIdeaTask(fileSystem, dustPath, options.ideaSlug, options.description, options.openQuestionResponses, options.dustCommand);
     },
-    async listTasks() {
-      const tasksPath = `${dustPath}/tasks`;
-      if (!fileSystem.exists(tasksPath)) {
-        return [];
-      }
-      const files = await fileSystem.readdir(tasksPath);
-      return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, "")).sort();
+    async createDecomposeIdeaTask(options) {
+      return decomposeIdea(fileSystem, dustPath, options, options.dustCommand);
     },
-    async findWorkflowTaskForIdea(options) {
-      return findWorkflowTaskForIdea(fileSystem, dustPath, options.ideaSlug);
+    async createShelveIdeaTask(options) {
+      return createShelveIdeaTask(fileSystem, dustPath, options.ideaSlug, options.description, options.dustCommand);
     },
-    async parseCaptureIdeaTask(options) {
-      return parseCaptureIdeaTask(fileSystem, dustPath, options.taskSlug);
+    async createExpediteIdeaTask(options) {
+      return createExpediteIdeaTask(fileSystem, dustPath, options.ideaSlug, options.description, options.dustCommand);
     },
-    async buildTaskGraph() {
-      const taskSlugs = await this.listTasks();
-      const allWorkflowTasks = await findAllWorkflowTasks(fileSystem, dustPath);
-      const workflowTypeByTaskSlug = new Map;
-      for (const match of allWorkflowTasks.workflowTasksByIdeaSlug.values()) {
-        workflowTypeByTaskSlug.set(match.taskSlug, match.type);
-      }
-      const nodes = [];
-      const edges = [];
-      for (const slug of taskSlugs) {
-        const task = await this.parseTask({ slug });
-        nodes.push({
-          task,
-          workflowType: workflowTypeByTaskSlug.get(slug) ?? null
-        });
-        for (const blockerSlug of task.blockedBy) {
-          edges.push({ from: blockerSlug, to: slug });
-        }
-      }
-      return { nodes, edges };
+    async createIdeaTask(options) {
+      return createIdeaTask(fileSystem, dustPath, options);
     }
   };
 }
+function buildReadOnlyArtifactsRepository(fileSystem, dustPath) {
+  return buildReadOperations(fileSystem, dustPath);
+}
 export {
+  parseResolvedQuestions,
   parseOpenQuestions,
   findAllWorkflowTasks,
   buildReadOnlyArtifactsRepository,

package/dist/audits/checks-audit.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Checks Audit - Pure functions for detecting tech stacks and suggesting checks.
+ *
+ * This module provides the functional core for the checks-audit stock audit.
+ * It detects the project's technology ecosystem, identifies configured checks,
+ * parses CI configuration files, and suggests missing check categories.
+ */
+import type { DustSettings } from '../cli/types';
+export type Ecosystem = 'javascript' | 'python' | 'go' | 'rust' | 'ruby' | 'php' | 'elixir';
+export interface TechStackDetection {
+    ecosystem: Ecosystem;
+    indicators: string[];
+    packageManager?: string;
+}
+export interface CheckOption {
+    name: string;
+    command: string;
+    description?: string;
+}
+export interface CheckSuggestion {
+    category: string;
+    ecosystem: Ecosystem;
+    reason: string;
+    suggestedCheck: CheckOption;
+    alternatives: CheckOption[];
+    detectedIndicators: string[];
+}
+export interface CIFileContent {
+    path: string;
+    content: string;
+}
+/**
+ * Detects tech stacks based on project files.
+ */
+export declare function detectTechStack(projectFiles: string[]): TechStackDetection[];
+/**
+ * Extracts check categories from existing dust settings.
+ */
+export declare function detectConfiguredChecks(settings: DustSettings): Set<string>;
+/**
+ * Parses CI configuration files to detect what checks run in CI.
+ */
+export declare function detectCIChecks(ciFiles: CIFileContent[]): Set<string>;
+/**
+ * Suggests missing checks based on detected tech stack and configured checks.
+ */
+export declare function suggestChecks(techStack: TechStackDetection[], projectFiles: string[], configuredChecks: Set<string>, ciChecks: Set<string>): CheckSuggestion[];
+/**
+ * Renders a check suggestion as an idea file content.
+ */
+export declare function renderCheckIdea(suggestion: CheckSuggestion, packageManager?: string): string;
+/**
+ * Returns the checks-audit stock audit template.
+ */
+export declare function checksAuditTemplate(): string;