ahead-pi 0.8.2 → 0.8.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ahead-pi",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "AHEAD workflow enforcement and context for Pi",
   "keywords": [
     "ahead",

package/src/guidance.ts

@@ -533,8 +533,10 @@ export function buildArtifactTemplate(
 }
 
 /**
- * Insert inspiration-only example lines into each field as HTML comments.
- * Validation strips comments, so an untouched field still counts as empty.
+ * Insert inspiration-only example lines into each field as plain text with
+ * an "ex. - " prefix. Validation strips these lines for the emptiness
+ * check and rejects any saved form that still contains them, so no example
+ * line can ever persist in a recorded artifact.
  */
 export function insertFieldExamples(template: string, perField: string[][]): string {
   let updated = template;
@@ -548,16 +550,27 @@ export function insertFieldExamples(template: string, perField: string[][]): str
     }
     updated = updated.replace(
       marker,
-      [
-        marker,
-        "<!-- Examples — inspiration only, not requirements. Delete them and write your own answer. -->",
-        ...examples.map((example) => `<!-- ~ ${example} ~ -->`),
-      ].join("\n"),
+      [marker, ...examples.map((example) => `ex. - ${example}`)].join("\n"),
     );
   }
   return updated;
 }
 
+const EXAMPLE_LINE_PATTERN = /^\s*ex\.\s*-\s?/;
+
+function stripExampleLines(text: string): { cleaned: string; hadExamples: boolean } {
+  const kept: string[] = [];
+  let hadExamples = false;
+  for (const line of text.split("\n")) {
+    if (EXAMPLE_LINE_PATTERN.test(line)) {
+      hadExamples = true;
+      continue;
+    }
+    kept.push(line);
+  }
+  return { cleaned: kept.join("\n").trim(), hadExamples };
+}
+
 export function validateArtifactForm(content: string, prompts: string[]): string[] {
   const errors: string[] = [];
   for (const [index, prompt] of prompts.entries()) {
@@ -575,11 +588,18 @@ export function validateArtifactForm(content: string, prompts: string[]): string
       .slice(beginIndex + begin.length, endIndex)
       .replace(/<!--[\s\S]*?-->/g, "")
       .trim();
-    if (!response) {
-      errors.push(prompt);
+    const { cleaned, hadExamples } = stripExampleLines(response);
+    if (!cleaned) {
+      errors.push(
+        hadExamples ? `${prompt} (replace the “ex. -” example lines with your own answer)` : prompt,
+      );
+      continue;
+    }
+    if (hadExamples) {
+      errors.push(`${prompt} (remove the leftover “ex. -” example lines)`);
       continue;
     }
-    if (/^(?:n\/?a|not applicable)\s*[.!]?$/i.test(response)) {
+    if (/^(?:n\/?a|not applicable)\s*[.!]?$/i.test(cleaned)) {
       errors.push(`${prompt} (explain why it is not applicable)`);
     }
   }

package/src/index.ts

@@ -1617,15 +1617,27 @@ async function recordHumanArtifact(
   const prompts = promptsForArtifact(state.workflow_id, state.phase.id, artifact.kind);
   let template = await humanArtifactTemplate(store, state, run, artifact.kind, artifact.title);
   if (ctx.hasUI && artifact.kind !== "review-disposition" && prompts.length > 0) {
-    if (ctx.model) {
-      ctx.ui.notify("Drafting two example prompts per field (inspiration only)…", "info");
+    // Visible progress while drafting: the loader row and footer status show
+    // until the call resolves, so the wait never looks like a hang.
+    const showProgress = ctx.model !== undefined;
+    if (showProgress) {
+      ctx.ui.setWorkingMessage("Drafting example prompts (inspiration only)…");
+      ctx.ui.setStatus("ahead-examples", "Drafting example prompts…");
+    }
+    let draft;
+    try {
+      draft = await draftFieldExamples(ctx, {
+        workflowTitle: engine.getWorkflow(state.workflow_id).title,
+        phaseTitle: state.phase.title,
+        runTitle: run.title,
+        fields: prompts,
+      });
+    } finally {
+      if (showProgress) {
+        ctx.ui.setWorkingMessage();
+        ctx.ui.setStatus("ahead-examples", undefined);
+      }
     }
-    const draft = await draftFieldExamples(ctx, {
-      workflowTitle: engine.getWorkflow(state.workflow_id).title,
-      phaseTitle: state.phase.title,
-      runTitle: run.title,
-      fields: prompts,
-    });
     if (draft.examples) {
       template = insertFieldExamples(template, draft.examples);
     } else if (draft.skipped === "no-auth") {