@wichayutdew/pi-workflows 3.4.0 → 3.5.0

package/dist/index.js

@@ -3195,6 +3195,9 @@ function wrapPlain(value, width, theme, color = "text") {
   });
   return wrapped.length > 0 ? wrapped : [theme.fg(color, " ")];
 }
+function summaryLines(theme, value, width) {
+  return [theme.fg("muted", "summary"), ...wrapPlain(value, width, theme)];
+}
 function boundedArtifact(value) {
   return value.length <= MAX_DETAIL_ARTIFACT_CHARS ? { value, truncated: false } : {
     value: value.slice(0, MAX_DETAIL_ARTIFACT_CHARS),
@@ -3210,7 +3213,8 @@ function renderResult(theme, attempt, width) {
     "",
     theme.bold(theme.fg("accent", "Submitted result")),
     ...keyValueLines(theme, "outcome", result.outcome, width, "success"),
-    ...keyValueLines(theme, "summary", `${result.summary}${result.summaryTruncated ? " … [trace truncated]" : ""}`, width),
+    ...summaryLines(theme, `${result.summary}${result.summaryTruncated ? `
+… [trace truncated]` : ""}`, width),
     ...result.workspaceCwd ? keyValueLines(theme, "workspace", result.workspaceCwd, width) : [],
     ...artifact ? [
       theme.fg("muted", "artifact"),
@@ -3364,7 +3368,7 @@ function renderStepDetail(theme, snapshot, selectedIndex, cache, width) {
     ] : [],
     ...history ? [
       ...keyValueLines(theme, "outcome", history.outcome, width, "success"),
-      ...keyValueLines(theme, "summary", history.summary, width)
+      ...summaryLines(theme, history.summary, width)
     ] : [],
     ...currentReason ? keyValueLines(theme, "reason", currentReason, width, "warning") : [],
     ...entry.isCurrent && snapshot.run.gateFeedback ? keyValueLines(theme, "feedback", snapshot.run.gateFeedback, width, "warning") : [],
@@ -6122,6 +6126,8 @@ function buildStepTask(options) {
     ...contract.workspaceLines,
     "",
     "Put a self-contained compact handoff in `summary`; this is the only step context passed to the next fresh child.",
+    "Format all human-facing output—including summaries, gate artifacts, Markdown plans, reports, comments, and replies—for scanning: short headings, then one distinct fact, action, or metadata value per bullet or paragraph. Never pack unrelated values into one line or dense prose.",
+    "When a schema needs several related fields, use a bullet list with one `field`: `value` per row; use JSON only for machine-readable data under `## Machine-readable handoff` in a fenced valid `json` block. Keep prose outside that block.",
     ...buildNonSuccessSummaryInstructions(contract.outcomes),
     ...isDelegated ? buildDelegatedCompletionInstructions() : [],
     "Do not call the completion tool alongside other tool calls."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wichayutdew/pi-workflows",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "description": "A declarative, pauseable workflow harness for Pi",
   "license": "MIT",
   "repository": {

package/src/prompt/step-task.ts

@@ -151,6 +151,8 @@ export function buildStepTask(options: BuildStepTaskOptions): string {
     ...contract.workspaceLines,
     '',
     'Put a self-contained compact handoff in `summary`; this is the only step context passed to the next fresh child.',
+    'Format all human-facing output—including summaries, gate artifacts, Markdown plans, reports, comments, and replies—for scanning: short headings, then one distinct fact, action, or metadata value per bullet or paragraph. Never pack unrelated values into one line or dense prose.',
+    'When a schema needs several related fields, use a bullet list with one `field`: `value` per row; use JSON only for machine-readable data under `## Machine-readable handoff` in a fenced valid `json` block. Keep prose outside that block.',
     ...buildNonSuccessSummaryInstructions(contract.outcomes),
     ...(isDelegated ? buildDelegatedCompletionInstructions() : []),
     'Do not call the completion tool alongside other tool calls.',

package/src/workflow-status/render-step-detail.ts

@@ -74,6 +74,14 @@ function wrapPlain(
   return wrapped.length > 0 ? wrapped : [theme.fg(color, ' ')];
 }
 
+function summaryLines(
+  theme: WorkflowStatusTheme,
+  value: string,
+  width: number,
+): Array<string> {
+  return [theme.fg('muted', 'summary'), ...wrapPlain(value, width, theme)];
+}
+
 function boundedArtifact(value: string): {
   readonly value: string;
   readonly truncated: boolean;
@@ -101,10 +109,9 @@ function renderResult(
     '',
     theme.bold(theme.fg('accent', 'Submitted result')),
     ...keyValueLines(theme, 'outcome', result.outcome, width, 'success'),
-    ...keyValueLines(
+    ...summaryLines(
       theme,
-      'summary',
-      `${result.summary}${result.summaryTruncated ? ' … [trace truncated]' : ''}`,
+      `${result.summary}${result.summaryTruncated ? '\n… [trace truncated]' : ''}`,
       width,
     ),
     ...(result.workspaceCwd
@@ -439,7 +446,7 @@ export function renderStepDetail(
     ...(history
       ? [
           ...keyValueLines(theme, 'outcome', history.outcome, width, 'success'),
-          ...keyValueLines(theme, 'summary', history.summary, width),
+          ...summaryLines(theme, history.summary, width),
         ]
       : []),
     ...(currentReason