@joshski/dust 0.1.58 → 0.1.60

package/dist/types.d.ts

@@ -5,5 +5,5 @@
  * the event protocol, workflow tasks, and idea structures.
  */
 export type { AgentSessionEvent, EventMessage } from './agent-events';
-export type { Idea, IdeaOpenQuestion, IdeaOption } from './ideas';
-export type { CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, IdeaInProgress, OpenQuestionResponse, ParsedCaptureIdeaTask, WorkflowTaskMatch, WorkflowTaskType, } from './workflow-tasks';
+export type { Idea, IdeaOpenQuestion, IdeaOption } from './artifacts/ideas';
+export type { CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, IdeaInProgress, OpenQuestionResponse, ParsedCaptureIdeaTask, WorkflowTaskMatch, WorkflowTaskType, } from './artifacts/workflow-tasks';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.58",
+  "version": "0.1.60",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {
@@ -10,10 +10,6 @@
     "./types": {
       "types": "./dist/types.d.ts"
     },
-    "./workflow-tasks": {
-      "import": "./dist/workflow-tasks.js",
-      "types": "./dist/workflow-tasks.d.ts"
-    },
     "./logging": {
       "import": "./dist/logging.js",
       "types": "./dist/logging/index.d.ts"
@@ -22,9 +18,9 @@
       "import": "./dist/agents.js",
       "types": "./dist/agents/detection.d.ts"
     },
-    "./ideas": {
-      "import": "./dist/ideas.js",
-      "types": "./dist/ideas.d.ts"
+    "./artifacts": {
+      "import": "./dist/artifacts.js",
+      "types": "./dist/artifacts.d.ts"
     },
     "./istanbul/minimal-reporter": "./lib/istanbul/minimal-reporter.cjs"
   },
@@ -46,7 +42,7 @@
   "author": "joshski",
   "license": "MIT",
   "scripts": {
-    "build": "bun build lib/cli/run.ts --target node --outfile dist/dust.js && printf '%s\\n%s' '#!/usr/bin/env node' \"$(cat dist/dust.js)\" > dist/dust.js && bun build lib/workflow-tasks.ts --target node --outfile dist/workflow-tasks.js && bun build lib/logging/index.ts --target node --outfile dist/logging.js && bun build lib/agents/detection.ts --target node --outfile dist/agents.js && bun build lib/ideas.ts --target node --outfile dist/ideas.js && bunx tsc --project tsconfig.build.json",
+    "build": "bun build lib/cli/run.ts --target node --outfile dist/dust.js && printf '%s\\n%s' '#!/usr/bin/env node' \"$(cat dist/dust.js)\" > dist/dust.js && bun build lib/logging/index.ts --target node --outfile dist/logging.js && bun build lib/agents/detection.ts --target node --outfile dist/agents.js && bun build lib/artifacts/index.ts --target node --outfile dist/artifacts.js && bunx tsc --project tsconfig.build.json",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "eval": "bun run ./evals/run.ts"

package/dist/ideas.js

@@ -1,135 +0,0 @@
-// lib/markdown/markdown-utilities.ts
-function extractTitle(content) {
-  const match = content.match(/^#\s+(.+)$/m);
-  return match ? match[1].trim() : null;
-}
-function extractOpeningSentence(content) {
-  const lines = content.split(`
-`);
-  let h1Index = -1;
-  for (let i = 0;i < lines.length; i++) {
-    if (lines[i].match(/^#\s+.+$/)) {
-      h1Index = i;
-      break;
-    }
-  }
-  if (h1Index === -1) {
-    return null;
-  }
-  let paragraphStart = -1;
-  for (let i = h1Index + 1;i < lines.length; i++) {
-    const line = lines[i].trim();
-    if (line !== "") {
-      paragraphStart = i;
-      break;
-    }
-  }
-  if (paragraphStart === -1) {
-    return null;
-  }
-  const firstLine = lines[paragraphStart];
-  const trimmedFirstLine = firstLine.trim();
-  if (trimmedFirstLine.startsWith("#") || trimmedFirstLine.startsWith("-") || trimmedFirstLine.startsWith("*") || trimmedFirstLine.startsWith("+") || trimmedFirstLine.match(/^\d+\./) || trimmedFirstLine.startsWith("```") || trimmedFirstLine.startsWith(">")) {
-    return null;
-  }
-  let paragraph = "";
-  for (let i = paragraphStart;i < lines.length; i++) {
-    const line = lines[i].trim();
-    if (line === "")
-      break;
-    if (line.startsWith("#") || line.startsWith("```") || line.startsWith(">")) {
-      break;
-    }
-    paragraph += (paragraph ? " " : "") + line;
-  }
-  const sentenceMatch = paragraph.match(/^(.+?[.?!])(?:\s|$)/);
-  if (!sentenceMatch) {
-    return null;
-  }
-  return sentenceMatch[1];
-}
-
-// lib/ideas.ts
-function parseOpenQuestions(content) {
-  const lines = content.split(`
-`);
-  const questions = [];
-  let inOpenQuestions = false;
-  let currentQuestion = null;
-  let currentOption = null;
-  let descriptionLines = [];
-  function flushOption() {
-    if (currentOption) {
-      currentOption.description = descriptionLines.join(`
-`).trim();
-      descriptionLines = [];
-      currentOption = null;
-    }
-  }
-  function flushQuestion() {
-    flushOption();
-    if (currentQuestion) {
-      questions.push(currentQuestion);
-      currentQuestion = null;
-    }
-  }
-  for (const line of lines) {
-    if (line.startsWith("## ")) {
-      if (inOpenQuestions) {
-        flushQuestion();
-      }
-      inOpenQuestions = line.trimEnd() === "## Open Questions";
-      continue;
-    }
-    if (!inOpenQuestions)
-      continue;
-    if (line.startsWith("### ")) {
-      flushQuestion();
-      currentQuestion = {
-        question: line.slice(4).trim(),
-        options: []
-      };
-      continue;
-    }
-    if (line.startsWith("#### ")) {
-      flushOption();
-      currentOption = {
-        name: line.slice(5).trim(),
-        description: ""
-      };
-      if (currentQuestion) {
-        currentQuestion.options.push(currentOption);
-      }
-      continue;
-    }
-    if (currentOption) {
-      descriptionLines.push(line);
-    }
-  }
-  flushQuestion();
-  return questions;
-}
-async function parseIdea(fileSystem, dustPath, slug) {
-  const ideaPath = `${dustPath}/ideas/${slug}.md`;
-  if (!fileSystem.exists(ideaPath)) {
-    throw new Error(`Idea not found: "${slug}" (expected file at ${ideaPath})`);
-  }
-  const content = await fileSystem.readFile(ideaPath);
-  const title = extractTitle(content);
-  if (!title) {
-    throw new Error(`Idea file has no title: ${ideaPath}`);
-  }
-  const openingSentence = extractOpeningSentence(content);
-  const openQuestions = parseOpenQuestions(content);
-  return {
-    slug,
-    title,
-    openingSentence,
-    content,
-    openQuestions
-  };
-}
-export {
-  parseOpenQuestions,
-  parseIdea
-};

package/dist/workflow-tasks.js

@@ -1,244 +0,0 @@
-// lib/workflow-tasks.ts
-var IDEA_TRANSITION_PREFIXES = [
-  "Refine Idea: ",
-  "Decompose Idea: ",
-  "Shelve Idea: "
-];
-var CAPTURE_IDEA_PREFIX = "Add Idea: ";
-var BUILD_IDEA_PREFIX = "Build Idea: ";
-async function findAllCaptureIdeaTasks(fileSystem, dustPath) {
-  const tasksPath = `${dustPath}/tasks`;
-  if (!fileSystem.exists(tasksPath))
-    return [];
-  const files = await fileSystem.readdir(tasksPath);
-  const results = [];
-  for (const file of files.filter((f) => f.endsWith(".md")).sort()) {
-    const content = await fileSystem.readFile(`${tasksPath}/${file}`);
-    const titleMatch = content.match(/^#\s+(.+)$/m);
-    if (!titleMatch)
-      continue;
-    const title = titleMatch[1].trim();
-    if (title.startsWith(CAPTURE_IDEA_PREFIX)) {
-      results.push({
-        taskSlug: file.replace(/\.md$/, ""),
-        ideaTitle: title.slice(CAPTURE_IDEA_PREFIX.length)
-      });
-    } else if (title.startsWith(BUILD_IDEA_PREFIX)) {
-      results.push({
-        taskSlug: file.replace(/\.md$/, ""),
-        ideaTitle: title.slice(BUILD_IDEA_PREFIX.length)
-      });
-    }
-  }
-  return results;
-}
-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: " }
-];
-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 };
-    }
-  }
-  return null;
-}
-async function readIdeaTitle(fileSystem, dustPath, ideaSlug) {
-  const ideaPath = `${dustPath}/ideas/${ideaSlug}.md`;
-  if (!fileSystem.exists(ideaPath)) {
-    throw new Error(`Idea not found: "${ideaSlug}" (expected file at ${ideaPath})`);
-  }
-  const ideaContent = await fileSystem.readFile(ideaPath);
-  const ideaTitleMatch = ideaContent.match(/^#\s+(.+)$/m);
-  if (!ideaTitleMatch) {
-    throw new Error(`Idea file has no title: ${ideaPath}`);
-  }
-  return ideaTitleMatch[1].trim();
-}
-function renderResolvedQuestions(responses) {
-  const sections = responses.map((r) => `### ${r.question}
-
-**Decision:** ${r.chosenOption}`);
-  return `## Resolved Questions
-
-${sections.join(`
-
-`)}
-`;
-}
-function renderTask(title, openingSentence, definitionOfDone, options) {
-  const descriptionParagraph = options?.description !== undefined ? `
-${options.description}
-` : "";
-  const resolvedSection = options?.resolvedQuestions && options.resolvedQuestions.length > 0 ? `
-${renderResolvedQuestions(options.resolvedQuestions)}
-` : "";
-  return `# ${title}
-
-${openingSentence}
-${descriptionParagraph}${resolvedSection}
-## Goals
-
-(none)
-
-## Blocked By
-
-(none)
-
-## Definition of Done
-
-${definitionOfDone.map((item) => `- [ ] ${item}`).join(`
-`)}
-`;
-}
-async function createIdeaTask(fileSystem, dustPath, prefix, ideaSlug, openingSentenceTemplate, definitionOfDone, 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);
-  await fileSystem.writeFile(filePath, content);
-  return { filePath };
-}
-async function createRefineIdeaTask(fileSystem, dustPath, ideaSlug, description) {
-  return createIdeaTask(fileSystem, dustPath, "Refine Idea: ", ideaSlug, (ideaTitle) => `Thoroughly research this idea and refine it into a well-defined proposal. Read the idea file, explore the codebase for relevant context, and identify any ambiguity. Where aspects are unclear or could go multiple ways, add open questions to the idea file. Review \`.dust/goals/\` for alignment and \`.dust/facts/\` for relevant design decisions. See [${ideaTitle}](../ideas/${ideaSlug}.md). 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.`, [
-    "Idea is thoroughly researched with relevant codebase context",
-    "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 });
-}
-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/goals/\` to link relevant goals 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 Goals section links to relevant goals from .dust/goals/",
-    "The original idea is deleted or updated to reflect remaining scope"
-  ], {
-    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 });
-}
-async function createCaptureIdeaTask(fileSystem, dustPath, options) {
-  const { title, description, buildItNow } = options;
-  if (!title || !title.trim()) {
-    throw new Error("title is required and must not be whitespace-only");
-  }
-  if (!description || !description.trim()) {
-    throw new Error("description is required and must not be whitespace-only");
-  }
-  if (buildItNow) {
-    const taskTitle2 = `${BUILD_IDEA_PREFIX}${title}`;
-    const filename2 = titleToFilename(taskTitle2);
-    const filePath2 = `${dustPath}/tasks/${filename2}`;
-    const content2 = `# ${taskTitle2}
-
-Research this idea thoroughly, then create one or more narrowly-scoped task files in \`.dust/tasks/\`. Review \`.dust/goals/\` and \`.dust/facts/\` for relevant context. Each task should deliver a thin but complete vertical slice of working software.
-
-## Idea Description
-
-${description}
-
-## Goals
-
-(none)
-
-## Blocked By
-
-(none)
-
-## Definition of Done
-
-- [ ] One or more new tasks are created in \`.dust/tasks/\`
-- [ ] Tasks link to relevant goals from \`.dust/goals/\`
-- [ ] Tasks are narrowly scoped vertical slices
-`;
-    await fileSystem.writeFile(filePath2, content2);
-    return { filePath: filePath2 };
-  }
-  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/goals/\` and \`.dust/facts/\` for relevant context.
-
-## Idea Description
-
-${description}
-
-## Goals
-
-(none)
-
-## Blocked By
-
-(none)
-
-## Definition of Done
-
-- [ ] Idea file exists at ${ideaPath}
-- [ ] Idea file has an H1 title matching "${title}"
-- [ ] 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 };
-}
-async function parseCaptureIdeaTask(fileSystem, dustPath, taskSlug) {
-  const filePath = `${dustPath}/tasks/${taskSlug}.md`;
-  if (!fileSystem.exists(filePath)) {
-    return null;
-  }
-  const content = await fileSystem.readFile(filePath);
-  const titleMatch = content.match(/^#\s+(.+)$/m);
-  if (!titleMatch) {
-    return null;
-  }
-  const title = titleMatch[1].trim();
-  let ideaTitle;
-  let buildItNow;
-  if (title.startsWith(BUILD_IDEA_PREFIX)) {
-    ideaTitle = title.slice(BUILD_IDEA_PREFIX.length);
-    buildItNow = true;
-  } else if (title.startsWith(CAPTURE_IDEA_PREFIX)) {
-    ideaTitle = title.slice(CAPTURE_IDEA_PREFIX.length);
-    buildItNow = false;
-  } else {
-    return null;
-  }
-  const descriptionMatch = content.match(/^## Idea Description\n\n([\s\S]*?)\n\n## /m);
-  if (!descriptionMatch) {
-    return null;
-  }
-  const ideaDescription = descriptionMatch[1];
-  return { ideaTitle, ideaDescription, buildItNow };
-}
-export {
-  titleToFilename,
-  parseCaptureIdeaTask,
-  findWorkflowTaskForIdea,
-  findAllCaptureIdeaTasks,
-  decomposeIdea,
-  createShelveIdeaTask,
-  createRefineIdeaTask,
-  createCaptureIdeaTask,
-  IDEA_TRANSITION_PREFIXES,
-  CAPTURE_IDEA_PREFIX,
-  BUILD_IDEA_PREFIX
-};