@joshski/dust 0.1.95 → 0.1.97

package/dist/artifacts/ideas.d.ts

@@ -14,6 +14,11 @@ export interface Idea {
     content: string;
     openQuestions: IdeaOpenQuestion[];
 }
+export interface ParsedIdeaContent {
+    title: string | null;
+    body: string;
+    openQuestions: IdeaOpenQuestion[];
+}
 /**
  * Parses the ## Open Questions section from idea markdown content.
  * Extracts each ### question heading and its #### option children.
@@ -23,3 +28,15 @@ export declare function parseOpenQuestions(content: string): IdeaOpenQuestion[];
  * Parses an idea markdown file into a structured Idea object.
  */
 export declare function parseIdea(fileSystem: ReadableFileSystem, dustPath: string, slug: string): Promise<Idea>;
+/**
+ * Parses idea markdown into a structured object that can be bound to a UI
+ * and serialized back to markdown.
+ */
+export declare function parseIdeaContent(markdown: string): ParsedIdeaContent;
+/**
+ * Serializes a ParsedIdeaContent back to markdown.
+ * Open Questions are appended as the last section.
+ */
+export declare function ideaContentToMarkdown(content: ParsedIdeaContent, options?: {
+    includeOpenQuestions?: boolean;
+}): string;

package/dist/artifacts/index.d.ts

@@ -1,10 +1,11 @@
 import type { FileSystem, ReadableFileSystem } from '../filesystem/types';
 import { type Fact } from './facts';
-import { type Idea, type IdeaOpenQuestion, type IdeaOption, parseOpenQuestions } from './ideas';
+import { type Idea, type IdeaOpenQuestion, type IdeaOption, type ParsedIdeaContent, ideaContentToMarkdown, parseIdeaContent, parseOpenQuestions } from './ideas';
+import { extractTitle } from '../markdown/markdown-utilities';
 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, parseResolvedQuestions, type WorkflowTaskMatch, type WorkflowTaskType } from './workflow-tasks';
-export type { AllWorkflowTasks, CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, Fact, Idea, IdeaOpenQuestion, IdeaOption, OpenQuestionResponse, ParsedCaptureIdeaTask, Principle, Task, WorkflowTaskMatch, WorkflowTaskType, };
+export type { AllWorkflowTasks, CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, Fact, Idea, IdeaOpenQuestion, IdeaOption, OpenQuestionResponse, ParsedCaptureIdeaTask, ParsedIdeaContent, Principle, Task, WorkflowTaskMatch, WorkflowTaskType, };
 export interface TaskGraphNode {
     task: Task;
     workflowType: WorkflowTaskType | null;
@@ -16,7 +17,7 @@ export interface TaskGraph {
         to: string;
     }>;
 }
-export { CAPTURE_IDEA_PREFIX, findAllWorkflowTasks, parseOpenQuestions, parseResolvedQuestions, };
+export { CAPTURE_IDEA_PREFIX, extractTitle, findAllWorkflowTasks, ideaContentToMarkdown, parseIdeaContent, parseOpenQuestions, parseResolvedQuestions, };
 export type { IdeaInProgress };
 export type ArtifactType = 'ideas' | 'tasks' | 'principles' | 'facts';
 export interface ReadOnlyArtifactsRepository {

package/dist/artifacts.js

@@ -4,50 +4,68 @@ function extractTitle(content) {
   return match ? match[1].trim() : null;
 }
 var MARKDOWN_LINK_PATTERN = /\[([^\]]+)\]\(([^)]+)\)/;
-function extractOpeningSentence(content) {
-  const lines = content.split(`
-`);
-  let h1Index = -1;
+function findH1Index(lines) {
   for (let i = 0;i < lines.length; i++) {
     if (lines[i].match(/^#\s+.+$/)) {
-      h1Index = i;
-      break;
+      return i;
     }
   }
-  if (h1Index === -1) {
-    return null;
+  return -1;
+}
+function findFirstNonBlankLineAfter(lines, startIndex) {
+  for (let i = startIndex + 1;i < lines.length; i++) {
+    if (lines[i].trim() !== "") {
+      return i;
+    }
+  }
+  return -1;
+}
+var LIST_ITEM_PREFIXES = ["-", "*", "+"];
+var STRUCTURAL_PREFIXES = ["#", "```", ">"];
+function isStructuralElement(line) {
+  if (STRUCTURAL_PREFIXES.some((prefix) => line.startsWith(prefix))) {
+    return true;
+  }
+  if (LIST_ITEM_PREFIXES.some((prefix) => line.startsWith(prefix))) {
+    return true;
   }
-  let paragraphStart = -1;
-  for (let i = h1Index + 1;i < lines.length; i++) {
+  return /^\d+\./.test(line);
+}
+function isBlockBreak(line) {
+  return STRUCTURAL_PREFIXES.some((prefix) => line.startsWith(prefix));
+}
+function collectParagraph(lines, startIndex) {
+  const parts = [];
+  for (let i = startIndex;i < lines.length; i++) {
     const line = lines[i].trim();
-    if (line !== "") {
-      paragraphStart = i;
+    if (line === "" || isBlockBreak(line)) {
       break;
     }
+    parts.push(line);
   }
-  if (paragraphStart === -1) {
+  return parts.join(" ");
+}
+function extractFirstSentence(paragraph) {
+  const match = paragraph.match(/^(.+?[.?!])(?:\s|$)/);
+  return match ? match[1] : null;
+}
+function extractOpeningSentence(content) {
+  const lines = content.split(`
+`);
+  const h1Index = findH1Index(lines);
+  if (h1Index === -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(">")) {
+  const paragraphStart = findFirstNonBlankLineAfter(lines, h1Index);
+  if (paragraphStart === -1) {
     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) {
+  const trimmedFirstLine = lines[paragraphStart].trim();
+  if (isStructuralElement(trimmedFirstLine)) {
     return null;
   }
-  return sentenceMatch[1];
+  const paragraph = collectParagraph(lines, paragraphStart);
+  return extractFirstSentence(paragraph);
 }
 
 // lib/artifacts/facts.ts
@@ -162,6 +180,83 @@ async function parseIdea(fileSystem, dustPath, slug) {
     openQuestions
   };
 }
+function stripOpenQuestionsSection(content) {
+  const lines = content.split(`
+`);
+  const result = [];
+  let inOpenQuestions = false;
+  let inCodeFence = false;
+  for (const line of lines) {
+    if (line.startsWith("```")) {
+      inCodeFence = !inCodeFence;
+      if (!inOpenQuestions)
+        result.push(line);
+      continue;
+    }
+    if (inCodeFence) {
+      if (!inOpenQuestions)
+        result.push(line);
+      continue;
+    }
+    if (line.startsWith("## ")) {
+      inOpenQuestions = line.trimEnd() === "## Open Questions";
+      if (!inOpenQuestions)
+        result.push(line);
+      continue;
+    }
+    if (!inOpenQuestions) {
+      result.push(line);
+    }
+  }
+  while (result.length > 0 && result[result.length - 1].trim() === "") {
+    result.pop();
+  }
+  return result.join(`
+`) + `
+`;
+}
+function stripTitle(content) {
+  const match = content.match(/^#\s+.+\n+/);
+  if (!match)
+    return content;
+  return content.slice(match[0].length);
+}
+function parseIdeaContent(markdown) {
+  const title = extractTitle(markdown);
+  const openQuestions = parseOpenQuestions(markdown);
+  const body = stripTitle(stripOpenQuestionsSection(markdown));
+  return { title, body, openQuestions };
+}
+function ideaContentToMarkdown(content, options) {
+  const includeOQ = options?.includeOpenQuestions ?? true;
+  const parts = [];
+  if (content.title) {
+    parts.push(`# ${content.title}`);
+    parts.push("");
+  }
+  if (content.body) {
+    parts.push(content.body.trimEnd());
+    parts.push("");
+  }
+  if (includeOQ && content.openQuestions.length > 0) {
+    parts.push("## Open Questions");
+    parts.push("");
+    for (const q of content.openQuestions) {
+      parts.push(`### ${q.question}`);
+      parts.push("");
+      for (const o of q.options) {
+        parts.push(`#### ${o.name}`);
+        parts.push("");
+        if (o.description) {
+          parts.push(o.description);
+          parts.push("");
+        }
+      }
+    }
+  }
+  return parts.join(`
+`);
+}
 
 // lib/artifacts/principles.ts
 function extractLinksFromSection(content, sectionHeading) {
@@ -765,7 +860,10 @@ function buildReadOnlyArtifactsRepository(fileSystem, dustPath) {
 export {
   parseResolvedQuestions,
   parseOpenQuestions,
+  parseIdeaContent,
+  ideaContentToMarkdown,
   findAllWorkflowTasks,
+  extractTitle,
   buildReadOnlyArtifactsRepository,
   buildArtifactsRepository,
   CAPTURE_IDEA_PREFIX

package/dist/audits/index.d.ts

@@ -26,6 +26,7 @@ export interface AuditsRepository {
     }): Promise<Audit>;
     createAuditTask(options: {
         name: string;
+        comment?: string;
     }): Promise<CreateAuditTaskResult>;
 }
 /**
@@ -34,8 +35,8 @@ export interface AuditsRepository {
  */
 export declare function transformAuditContent(content: string): string;
 /**
- * Injects an Ad-hoc Scope section after the opening description, before ## Scope.
- * The ad-hoc details are passed through without validation.
+ * Injects a Comments section after the opening description, before ## Scope.
+ * The comment is passed through without validation.
  */
-export declare function injectAdHocScope(content: string, adHocDetails: string): string;
+export declare function injectComment(content: string, comment: string): string;
 export declare function buildAuditsRepository(fileSystem: FileSystem, dustPath: string): AuditsRepository;