@joshski/dust 0.1.96 → 0.1.98

package/dist/lint/validators/content-validator.d.ts

@@ -1,8 +1,9 @@
 /**
  * Content validation for .dust markdown files
  */
+import type { ParsedArtifact } from '../../artifacts/parsed-artifact';
 import type { Violation } from './types';
-export declare function validateOpeningSentence(filePath: string, content: string): Violation | null;
-export declare function validateOpeningSentenceLength(filePath: string, content: string): Violation | null;
-export declare function validateImperativeOpeningSentence(filePath: string, content: string): Violation | null;
-export declare function validateTaskHeadings(filePath: string, content: string): Violation[];
+export declare function validateOpeningSentence(artifact: ParsedArtifact): Violation | null;
+export declare function validateOpeningSentenceLength(artifact: ParsedArtifact): Violation | null;
+export declare function validateImperativeOpeningSentence(artifact: ParsedArtifact): Violation | null;
+export declare function validateTaskHeadings(artifact: ParsedArtifact): Violation[];

package/dist/lint/validators/filename-validator.d.ts

@@ -1,6 +1,7 @@
 /**
  * Filename validation for .dust markdown files
  */
+import type { ParsedArtifact } from '../../artifacts/parsed-artifact';
 import type { Violation } from './types';
 export declare function validateFilename(filePath: string): Violation | null;
-export declare function validateTitleFilenameMatch(filePath: string, content: string): Violation | null;
+export declare function validateTitleFilenameMatch(artifact: ParsedArtifact): Violation | null;

package/dist/lint/validators/idea-validator.d.ts

@@ -1,8 +1,9 @@
 /**
  * Idea file validation for .dust markdown files
  */
+import type { ParsedArtifact } from '../../artifacts/parsed-artifact';
 import type { ReadableFileSystem } from '../../filesystem/types';
 import type { Violation } from './types';
-export declare function validateIdeaOpenQuestions(filePath: string, content: string): Violation[];
-export declare function validateIdeaTransitionTitle(filePath: string, content: string, ideasPath: string, fileSystem: ReadableFileSystem): Violation | null;
-export declare function validateWorkflowTaskBodySection(filePath: string, content: string, ideasPath: string, fileSystem: ReadableFileSystem): Violation[];
+export declare function validateIdeaOpenQuestions(artifact: ParsedArtifact): Violation[];
+export declare function validateIdeaTransitionTitle(artifact: ParsedArtifact, ideasPath: string, fileSystem: ReadableFileSystem): Violation | null;
+export declare function validateWorkflowTaskBodySection(artifact: ParsedArtifact, ideasPath: string, fileSystem: ReadableFileSystem): Violation[];

package/dist/lint/validators/link-validator.d.ts

@@ -1,8 +1,9 @@
 /**
  * Link validation for .dust markdown files
  */
+import type { ParsedArtifact } from '../../artifacts/parsed-artifact';
 import type { ReadableFileSystem } from '../../filesystem/types';
 import type { Violation } from './types';
-export declare function validateLinks(filePath: string, content: string, fileSystem: ReadableFileSystem): Violation[];
-export declare function validateSemanticLinks(filePath: string, content: string): Violation[];
-export declare function validatePrincipleHierarchyLinks(filePath: string, content: string): Violation[];
+export declare function validateLinks(artifact: ParsedArtifact, fileSystem: ReadableFileSystem): Violation[];
+export declare function validateSemanticLinks(artifact: ParsedArtifact): Violation[];
+export declare function validatePrincipleHierarchyLinks(artifact: ParsedArtifact): Violation[];

package/dist/lint/validators/principle-hierarchy.d.ts

@@ -1,9 +1,10 @@
 /**
  * Principle hierarchy validation for .dust markdown files
  */
+import type { ParsedArtifact } from '../../artifacts/parsed-artifact';
 import type { PrincipleRelationships, Violation } from './types';
 export type { PrincipleRelationships };
-export declare function validatePrincipleHierarchySections(filePath: string, content: string): Violation[];
-export declare function extractPrincipleRelationships(filePath: string, content: string): PrincipleRelationships;
+export declare function validatePrincipleHierarchySections(artifact: ParsedArtifact): Violation[];
+export declare function extractPrincipleRelationships(artifact: ParsedArtifact): PrincipleRelationships;
 export declare function validateBidirectionalLinks(allPrincipleRelationships: PrincipleRelationships[]): Violation[];
 export declare function validateNoCycles(allPrincipleRelationships: PrincipleRelationships[]): Violation[];

package/dist/loop/events.d.ts

@@ -47,6 +47,23 @@ export interface LoopDockerErrorEvent {
     type: 'loop.docker_error';
     error: string;
 }
-export type LoopEvent = LoopWarningEvent | LoopStartedEvent | LoopSyncingEvent | LoopSyncSkippedEvent | LoopCheckingTasksEvent | LoopNoTasksEvent | LoopTasksFoundEvent | LoopIterationCompleteEvent | LoopEndedEvent | LoopDockerDetectedEvent | LoopDockerBuildingEvent | LoopDockerBuiltEvent | LoopDockerErrorEvent;
+export interface LoopInstallingEvent {
+    type: 'loop.installing';
+}
+export interface LoopInstallFailedEvent {
+    type: 'loop.install_failed';
+    output: string;
+}
+export interface LoopRunningChecksEvent {
+    type: 'loop.running_checks';
+}
+export interface LoopChecksPassedEvent {
+    type: 'loop.checks_passed';
+}
+export interface LoopChecksFailedEvent {
+    type: 'loop.checks_failed';
+    output: string;
+}
+export type LoopEvent = LoopWarningEvent | LoopStartedEvent | LoopSyncingEvent | LoopSyncSkippedEvent | LoopCheckingTasksEvent | LoopNoTasksEvent | LoopTasksFoundEvent | LoopIterationCompleteEvent | LoopEndedEvent | LoopDockerDetectedEvent | LoopDockerBuildingEvent | LoopDockerBuiltEvent | LoopDockerErrorEvent | LoopInstallingEvent | LoopInstallFailedEvent | LoopRunningChecksEvent | LoopChecksPassedEvent | LoopChecksFailedEvent;
 export type LoopEmitFn = (event: LoopEvent) => void;
 export declare function formatLoopEvent(event: LoopEvent): string | null;

package/dist/loop/git-pull.d.ts

@@ -1,9 +1,9 @@
 import type { spawn as nodeSpawn } from 'node:child_process';
-type GitPullResult = {
+type PullResult = {
     success: true;
 } | {
     success: false;
     message: string;
 };
-export declare function gitPull(cwd: string, spawn: typeof nodeSpawn): Promise<GitPullResult>;
+export declare function gitPull(cwd: string, spawn: typeof nodeSpawn): Promise<PullResult>;
 export {};

package/dist/loop/iteration.d.ts

@@ -3,6 +3,7 @@ import { run as claudeRun } from '../claude/run';
 import type { DockerSpawnConfig } from '../claude/types';
 import type { DockerDependencies } from '../docker/docker-agent';
 import { type SessionConfig } from '../env-config';
+import { type ShellRunner } from '../cli/process-runner';
 import type { CommandDependencies } from '../cli/types';
 import { type InvalidTask, type UnblockedTask } from '../cli/commands/next';
 import type { LoopEmitFn } from './events';
@@ -17,9 +18,11 @@ export interface LoopDependencies {
     fetch?: typeof fetch;
     /** Optional overrides for Docker dependency functions (for testing) */
     dockerDeps?: Partial<DockerDependencies>;
+    /** Shell runner for executing pre-flight commands (install, check) */
+    shellRunner?: ShellRunner;
 }
 export declare function createDefaultDependencies(): LoopDependencies;
-type IterationResult = 'no_tasks' | 'ran_claude' | 'claude_error' | 'resolved_pull_conflict';
+type IterationResult = 'no_tasks' | 'ran_claude' | 'claude_error' | 'resolved_pull_conflict' | 'ran_check_fix';
 type LogFn = (message: string) => void;
 export interface IterationOptions {
     onRawEvent?: (rawEvent: Record<string, unknown>) => void;

package/dist/patch/fact.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Fact serialization and patch building functions.
+ */
+export interface FactInput {
+    title: string;
+    body: string;
+}
+/**
+ * Serializes a FactInput object to markdown format.
+ */
+export declare function serializeFact(input: FactInput): string;
+/**
+ * Builds file entries for a fact artifact patch.
+ */
+export declare function buildFactFiles(input: FactInput, slug: string): Record<string, string>;

package/dist/patch/idea.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Idea serialization and patch building functions.
+ */
+export interface IdeaOpenQuestion {
+    question: string;
+    options: Array<{
+        name: string;
+        description: string;
+    }>;
+}
+export interface IdeaInput {
+    title: string;
+    body?: string;
+    openQuestions?: IdeaOpenQuestion[];
+}
+/**
+ * Serializes an IdeaInput object to markdown format.
+ */
+export declare function serializeIdea(input: IdeaInput): string;
+/**
+ * Builds file entries for an idea artifact patch.
+ */
+export declare function buildIdeaFiles(input: IdeaInput, slug: string): Record<string, string>;

package/dist/patch/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Artifact patch building API.
+ *
+ * Provides functions for building multi-file artifact patches from
+ * structured objects with automatic validation.
+ */
+import type { ReadableFileSystem } from '../filesystem/types';
+import type { Violation } from '../lint/validators/types';
+import { type ArtifactPatch } from '../validation/index';
+import { type FactInput } from './fact';
+import { type IdeaInput } from './idea';
+import { type PrincipleInput } from './principle';
+import { type TaskInput } from './task';
+export { serializeFact } from './fact';
+export type { FactInput } from './fact';
+export { serializeIdea } from './idea';
+export type { IdeaInput, IdeaOpenQuestion } from './idea';
+export { serializePrinciple } from './principle';
+export type { PrincipleInput } from './principle';
+export { serializeTask } from './task';
+export type { TaskInput, StandardTaskInput, WorkflowTaskInput } from './task';
+export type { ArtifactPatch, Violation };
+export interface ArtifactPatchInput {
+    facts?: Record<string, FactInput | null>;
+    ideas?: Record<string, IdeaInput | null>;
+    principles?: Record<string, PrincipleInput | null>;
+    tasks?: Record<string, TaskInput | null>;
+}
+export interface BuildArtifactPatchResult {
+    valid: boolean;
+    violations: Violation[];
+    patch: ArtifactPatch;
+}
+interface ValidatePatchOptions {
+    cwd?: string;
+}
+/**
+ * Builds an artifact patch from structured input objects.
+ *
+ * @param fileSystem - The existing filesystem
+ * @param dustPath - Absolute path to the .dust directory
+ * @param input - Structured artifact input objects
+ * @param options - Optional configuration (e.g., cwd for relative violation paths)
+ * @returns Result with validation status and the patch
+ *
+ * @example
+ * const result = await buildArtifactPatch(fileSystem, '.dust', {
+ *   facts: {
+ *     'new-fact': { title: 'New Fact', body: 'Description here.' },
+ *     'old-fact': null,  // delete
+ *   },
+ * })
+ */
+export declare function buildArtifactPatch(fileSystem: ReadableFileSystem, dustPath: string, input: ArtifactPatchInput, options?: ValidatePatchOptions): Promise<BuildArtifactPatchResult>;

package/dist/patch/principle.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Principle serialization and patch building functions.
+ */
+export interface PrincipleInput {
+    title: string;
+    body?: string;
+    parentPrinciple?: string | null;
+    subPrinciples?: string[];
+}
+/**
+ * Serializes a PrincipleInput object to markdown format.
+ */
+export declare function serializePrinciple(input: PrincipleInput): string;
+/**
+ * Builds file entries for a principle artifact patch.
+ */
+export declare function buildPrincipleFiles(input: PrincipleInput, slug: string): Record<string, string>;

package/dist/patch/task.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Task serialization and patch building functions.
+ */
+export interface StandardTaskInput {
+    type?: undefined;
+    title: string;
+    body?: string;
+    blockedBy?: string[];
+    principles?: string[];
+    definitionOfDone: string[];
+}
+export interface WorkflowTaskInput {
+    type: 'capture-idea' | 'refine-idea' | 'decompose-idea' | 'shelve-idea';
+    ideaSlug: string;
+    definitionOfDone?: string[];
+}
+export type TaskInput = StandardTaskInput | WorkflowTaskInput;
+/**
+ * Serializes a TaskInput object to markdown format.
+ */
+export declare function serializeTask(input: TaskInput): string;
+/**
+ * Builds file entries for a task artifact patch.
+ */
+export declare function buildTaskFiles(input: TaskInput, slug: string): Record<string, string>;