@joshski/dust 0.1.100 → 0.1.101

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

@@ -3,7 +3,6 @@
  */
 import type { ParsedArtifact } from '../../artifacts/parsed-artifact';
 import type { PrincipleRelationships, Violation } from './types';
-export type { PrincipleRelationships };
 export declare function validatePrincipleHierarchySections(artifact: ParsedArtifact): Violation[];
 export declare function extractPrincipleRelationships(artifact: ParsedArtifact): PrincipleRelationships;
 export declare function validateBidirectionalLinks(allPrincipleRelationships: PrincipleRelationships[]): Violation[];

package/dist/patch/index.d.ts

@@ -26,10 +26,18 @@ export interface ArtifactPatchInput {
     principles?: Record<string, PrincipleInput | null>;
     tasks?: Record<string, TaskInput | null>;
 }
+export type ArtifactType = 'fact' | 'idea' | 'principle' | 'task';
+export interface ArtifactPreview {
+    type: ArtifactType;
+    slug: string;
+    action: 'create' | 'update' | 'delete';
+    content: string | null;
+}
 export interface BuildArtifactPatchResult {
     valid: boolean;
     violations: Violation[];
     patch: ArtifactPatch;
+    previews: ArtifactPreview[];
 }
 interface ValidatePatchOptions {
     cwd?: string;

package/dist/patch.js

@@ -1521,6 +1521,57 @@ function normalizeTargetPath(target, sourceDir) {
   }
   return null;
 }
+function parseArtifactPath(path) {
+  const match = path.match(/^(facts|ideas|principles|tasks)\/([^/]+)\.md$/);
+  if (!match)
+    return null;
+  const dirToType = {
+    facts: "fact",
+    ideas: "idea",
+    principles: "principle",
+    tasks: "task"
+  };
+  return {
+    type: dirToType[match[1]],
+    slug: match[2]
+  };
+}
+async function buildPreviews(fileSystem, dustPath, files) {
+  const previews = [];
+  for (const [path, content] of Object.entries(files)) {
+    const parsed = parseArtifactPath(path);
+    if (!parsed)
+      continue;
+    if (content === null) {
+      previews.push({
+        type: parsed.type,
+        slug: parsed.slug,
+        action: "delete",
+        content: null
+      });
+    } else {
+      const exists = await fileExists(fileSystem, `${dustPath}/${path}`);
+      previews.push({
+        type: parsed.type,
+        slug: parsed.slug,
+        action: exists ? "update" : "create",
+        content
+      });
+    }
+  }
+  return previews;
+}
+async function fileExists(fileSystem, path) {
+  try {
+    await fileSystem.readFile(path);
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
 function processFacts(facts, accumulator) {
   for (const [slug, factInput] of Object.entries(facts)) {
     if (factInput === null) {
@@ -1630,10 +1681,12 @@ async function buildArtifactPatch(fileSystem, dustPath, input, options = {}) {
   }
   const patch = { files: accumulator.files };
   const validationResult = await validatePatch(fileSystem, dustPath, patch, options);
+  const previews = await buildPreviews(fileSystem, dustPath, accumulator.files);
   return {
     valid: validationResult.valid && hierarchyViolations.length === 0,
     violations: [...hierarchyViolations, ...validationResult.violations],
-    patch
+    patch,
+    previews
   };
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.100",
+  "version": "0.1.101",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {
@@ -45,13 +45,18 @@
     "./patch": {
       "import": "./dist/patch.js",
       "types": "./dist/patch/index.d.ts"
+    },
+    "./core-principles": {
+      "import": "./dist/core-principles.js",
+      "types": "./dist/core-principles.d.ts"
     }
   },
   "files": [
     "dist",
     "bin",
     "lib/istanbul/minimal-reporter.cjs",
-    "biome"
+    "biome",
+    ".dust/principles"
   ],
   "repository": {
     "type": "git",