@joshski/dust 0.1.60 → 0.1.62

package/dist/artifacts/facts.d.ts

@@ -0,0 +1,10 @@
+import type { ReadableFileSystem } from '../cli/types';
+export interface Fact {
+    slug: string;
+    title: string;
+    content: string;
+}
+/**
+ * Parses a fact markdown file into a structured Fact object.
+ */
+export declare function parseFact(fileSystem: ReadableFileSystem, dustPath: string, slug: string): Promise<Fact>;

package/dist/artifacts/index.d.ts

@@ -0,0 +1,49 @@
+import type { FileSystem, ReadableFileSystem } from '../cli/types';
+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 { CAPTURE_IDEA_PREFIX, type CreateIdeaTransitionTaskResult, type DecomposeIdeaOptions, findAllCaptureIdeaTasks, type IdeaInProgress, type OpenQuestionResponse, type ParsedCaptureIdeaTask, type WorkflowTaskMatch } from './workflow-tasks';
+export type { CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, Fact, Idea, IdeaOpenQuestion, IdeaOption, OpenQuestionResponse, ParsedCaptureIdeaTask, Principle, Task, WorkflowTaskMatch, };
+export { CAPTURE_IDEA_PREFIX, findAllCaptureIdeaTasks, parseOpenQuestions };
+export type { IdeaInProgress };
+export interface ArtifactsRepository {
+    parseIdea(options: {
+        slug: string;
+    }): Promise<Idea>;
+    listIdeas(): Promise<string[]>;
+    parsePrinciple(options: {
+        slug: string;
+    }): Promise<Principle>;
+    listPrinciples(): Promise<string[]>;
+    parseFact(options: {
+        slug: string;
+    }): Promise<Fact>;
+    listFacts(): Promise<string[]>;
+    parseTask(options: {
+        slug: string;
+    }): Promise<Task>;
+    listTasks(): Promise<string[]>;
+    createRefineIdeaTask(options: {
+        ideaSlug: string;
+        description?: string;
+    }): Promise<CreateIdeaTransitionTaskResult>;
+    createDecomposeIdeaTask(options: DecomposeIdeaOptions): Promise<CreateIdeaTransitionTaskResult>;
+    createShelveIdeaTask(options: {
+        ideaSlug: string;
+        description?: string;
+    }): Promise<CreateIdeaTransitionTaskResult>;
+    createCaptureIdeaTask(options: {
+        title: string;
+        description: string;
+        buildItNow?: boolean;
+    }): Promise<CreateIdeaTransitionTaskResult>;
+    findWorkflowTaskForIdea(options: {
+        ideaSlug: string;
+    }): Promise<WorkflowTaskMatch | null>;
+    parseCaptureIdeaTask(options: {
+        taskSlug: string;
+    }): Promise<ParsedCaptureIdeaTask | null>;
+}
+export declare function buildArtifactsRepository(fileSystem: FileSystem, dustPath: string): ArtifactsRepository;
+export declare function buildReadOnlyArtifactsRepository(fileSystem: ReadableFileSystem, dustPath: string): Pick<ArtifactsRepository, 'parseIdea' | 'listIdeas' | 'parsePrinciple' | 'listPrinciples' | 'parseFact' | 'listFacts' | 'parseTask' | 'listTasks' | 'findWorkflowTaskForIdea' | 'parseCaptureIdeaTask'>;

package/dist/artifacts/principles.d.ts

@@ -0,0 +1,12 @@
+import type { ReadableFileSystem } from '../cli/types';
+export interface Principle {
+    slug: string;
+    title: string;
+    content: string;
+    parentPrinciple: string | null;
+    subPrinciples: string[];
+}
+/**
+ * Parses a principle markdown file into a structured Principle object.
+ */
+export declare function parsePrinciple(fileSystem: ReadableFileSystem, dustPath: string, slug: string): Promise<Principle>;

package/dist/artifacts/tasks.d.ts

@@ -0,0 +1,13 @@
+import type { ReadableFileSystem } from '../cli/types';
+export interface Task {
+    slug: string;
+    title: string;
+    content: string;
+    principles: string[];
+    blockedBy: string[];
+    definitionOfDone: string[];
+}
+/**
+ * Parses a task markdown file into a structured Task object.
+ */
+export declare function parseTask(fileSystem: ReadableFileSystem, dustPath: string, slug: string): Promise<Task>;

package/dist/artifacts.js

@@ -273,6 +273,32 @@ async function parseTask(fileSystem, dustPath, slug) {
 // lib/artifacts/workflow-tasks.ts
 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`;
 }
@@ -594,6 +620,8 @@ function buildReadOnlyArtifactsRepository(fileSystem, dustPath) {
 }
 export {
   parseOpenQuestions,
+  findAllCaptureIdeaTasks,
   buildReadOnlyArtifactsRepository,
-  buildArtifactsRepository
+  buildArtifactsRepository,
+  CAPTURE_IDEA_PREFIX
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.60",
+  "version": "0.1.62",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {
@@ -20,7 +20,7 @@
     },
     "./artifacts": {
       "import": "./dist/artifacts.js",
-      "types": "./dist/artifacts.d.ts"
+      "types": "./dist/artifacts/index.d.ts"
     },
     "./istanbul/minimal-reporter": "./lib/istanbul/minimal-reporter.cjs"
   },