@forwardimpact/pathway 0.10.0 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Career progression web app and CLI for exploring roles and generating agents",
   "license": "Apache-2.0",
   "repository": {

package/src/formatters/agent/profile.js

@@ -11,6 +11,10 @@
 import Mustache from "mustache";
 
 import { trimValue, trimRequired, trimFields } from "../shared.js";
+import {
+  flattenToLine,
+  preprocessArrayFrontmatter,
+} from "../template-preprocess.js";
 
 /**
  * @typedef {Object} WorkingStyleEntry
@@ -49,8 +53,14 @@ import { trimValue, trimRequired, trimFields } from "../shared.js";
  * @returns {Object} Data object ready for Mustache template
  */
 function prepareAgentProfileData({ frontmatter, bodyData }) {
-  // Trim array fields using shared helpers
-  const handoffs = trimFields(frontmatter.handoffs, { prompt: "required" });
+  // Preprocess handoffs - flatten prompt field for front matter compatibility
+  const preprocessedHandoffs = preprocessArrayFrontmatter(
+    frontmatter.handoffs,
+    ["prompt"],
+  );
+  // Then trim as before
+  const handoffs = trimFields(preprocessedHandoffs, { prompt: "required" });
+
   const constraints = (bodyData.constraints || []).map((c) => trimRequired(c));
   const skillIndex = trimFields(bodyData.skillIndex, {
     name: "required",
@@ -75,9 +85,9 @@ function prepareAgentProfileData({ frontmatter, bodyData }) {
   }));
 
   return {
-    // Frontmatter
+    // Frontmatter - flatten description for single-line front matter
     name: frontmatter.name,
-    description: trimRequired(frontmatter.description),
+    description: flattenToLine(frontmatter.description),
     infer: frontmatter.infer,
     handoffs,
 

package/src/formatters/agent/skill.js

@@ -11,6 +11,7 @@
 import Mustache from "mustache";
 
 import { trimValue, splitLines, trimFields } from "../shared.js";
+import { flattenToLine } from "../template-preprocess.js";
 
 /**
  * Prepare agent skill data for template rendering
@@ -40,17 +41,25 @@ function prepareAgentSkillData({
     ready: "array",
   });
 
+  // Flatten multi-line strings to single line for front matter compatibility
+  const description = flattenToLine(frontmatter.description);
+  const useWhen = flattenToLine(frontmatter.useWhen);
+
+  // Keep line arrays for body rendering
   const descriptionLines = splitLines(frontmatter.description);
-  const useWhenLines = splitLines(frontmatter.useWhen);
+
   const trimmedReference = trimValue(reference) || "";
   const tools = toolReferences || [];
 
   return {
     name: frontmatter.name,
+    // Single-line versions for front matter
+    description,
+    hasDescription: !!description,
+    useWhen,
+    hasUseWhen: !!useWhen,
+    // Line arrays for body content
     descriptionLines,
-    hasDescription: descriptionLines.length > 0,
-    useWhenLines,
-    hasUseWhen: useWhenLines.length > 0,
     title,
     stages: processedStages,
     hasStages: processedStages.length > 0,

package/src/formatters/template-preprocess.js

@@ -0,0 +1,60 @@
+/**
+ * Template Preprocessing Utilities
+ *
+ * Functions to prepare template data for front matter compatibility.
+ * Ensures all front matter values are single-line strings for maximum
+ * compatibility with coding agents that have limited YAML parsing.
+ */
+
+/**
+ * Flatten a multi-line string into a single line
+ * Replaces newlines with spaces and collapses multiple spaces.
+ * @param {string|null|undefined} value - Value to flatten
+ * @returns {string} Single-line string (empty string if no value)
+ */
+export function flattenToLine(value) {
+  if (value == null) return "";
+  return value
+    .replace(/\s*\n\s*/g, " ") // Replace newlines (with surrounding whitespace) with single space
+    .replace(/\s+/g, " ") // Collapse multiple spaces
+    .trim();
+}
+
+/**
+ * Join an array of strings into a single line
+ * @param {string[]|null|undefined} lines - Array of lines to join
+ * @param {string} separator - Separator between lines (default: single space)
+ * @returns {string} Single-line string
+ */
+export function joinLines(lines, separator = " ") {
+  if (!lines || !Array.isArray(lines)) return "";
+  return lines.map((line) => line.trim()).join(separator);
+}
+
+/**
+ * Preprocess an object's string fields for front matter
+ * Flattens specified fields to single-line strings.
+ * @param {Object} obj - Object to preprocess
+ * @param {string[]} fields - Field names to flatten
+ * @returns {Object} New object with flattened fields
+ */
+export function preprocessFrontmatter(obj, fields) {
+  const result = { ...obj };
+  for (const field of fields) {
+    if (result[field] != null) {
+      result[field] = flattenToLine(result[field]);
+    }
+  }
+  return result;
+}
+
+/**
+ * Preprocess an array of objects, flattening specified fields in each
+ * @param {Array<Object>|null|undefined} array - Array to preprocess
+ * @param {string[]} fields - Field names to flatten in each object
+ * @returns {Array<Object>} Array with preprocessed objects
+ */
+export function preprocessArrayFrontmatter(array, fields) {
+  if (!array) return [];
+  return array.map((item) => preprocessFrontmatter(item, fields));
+}

package/templates/skill.template.md

@@ -1,10 +1,6 @@
 ---
 name: {{name}}
-description: |
-  {{#descriptionLines}}{{{.}}} {{/descriptionLines}}
-{{#hasUseWhen}}
-  Use When: {{#useWhenLines}}{{{.}}} {{/useWhenLines}}
-{{/hasUseWhen}}
+description: {{{description}}}{{#hasUseWhen}} Use When: {{{useWhen}}}{{/hasUseWhen}}
 ---
 
 # {{{title}}}