@forwardimpact/pathway 0.9.0 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Career progression web app and CLI for exploring roles and generating agents",
   "license": "Apache-2.0",
   "repository": {
@@ -41,7 +41,7 @@
   },
   "dependencies": {
     "@forwardimpact/schema": "^0.4.0",
-    "@forwardimpact/model": "^0.4.0",
+    "@forwardimpact/model": "^0.5.0",
     "mustache": "^4.2.0",
     "simple-icons": "^16.7.0",
     "yaml": "^2.3.4"

package/src/formatters/agent/profile.js

@@ -18,6 +18,13 @@ import { trimValue, trimRequired, trimFields } from "../shared.js";
  * @property {string} content - Working style content (markdown)
  */
 
+/**
+ * @typedef {Object} BeforeHandoffEntry
+ * @property {{id: string, name: string}} skill - Skill info
+ * @property {{id: string, name: string, emojiIcon: string}} capability - Capability info
+ * @property {string[]} items - Checklist items
+ */
+
 /**
  * Prepare agent profile data for template rendering
  * Normalizes string values by trimming trailing newlines for consistent template output.
@@ -35,7 +42,7 @@ import { trimValue, trimRequired, trimFields } from "../shared.js";
  * @param {Array<{name: string, dirname: string, useWhen: string}>} params.bodyData.skillIndex - Skill index entries
  * @param {string} params.bodyData.roleContext - Role context text
  * @param {WorkingStyleEntry[]} params.bodyData.workingStyles - Working style entries
- * @param {string} [params.bodyData.beforeHandoff] - Before handoff checklist markdown
+ * @param {BeforeHandoffEntry[]} [params.bodyData.beforeHandoff] - Before handoff checklist entries
  * @param {string[]} params.bodyData.constraints - List of constraints
  * @param {Array<{id: string, name: string, description: string}>} [params.bodyData.agentIndex] - List of all available agents
  * @param {boolean} [params.bodyData.hasAgentIndex] - Whether agent index is available
@@ -60,6 +67,13 @@ function prepareAgentProfileData({ frontmatter, bodyData }) {
     content: "required",
   });
 
+  // Process beforeHandoff: trim items in each entry
+  const beforeHandoff = (bodyData.beforeHandoff || []).map((entry) => ({
+    skill: entry.skill,
+    capability: entry.capability,
+    items: (entry.items || []).map((item) => trimRequired(item)),
+  }));
+
   return {
     // Frontmatter
     name: frontmatter.name,
@@ -77,7 +91,8 @@ function prepareAgentProfileData({ frontmatter, bodyData }) {
     roleContext: trimValue(bodyData.roleContext),
     workingStyles,
     hasWorkingStyles: workingStyles.length > 0,
-    beforeHandoff: trimValue(bodyData.beforeHandoff),
+    beforeHandoff,
+    hasBeforeHandoff: beforeHandoff.length > 0,
     constraints,
     hasConstraints: constraints.length > 0,
     agentIndex,
@@ -102,7 +117,7 @@ function prepareAgentProfileData({ frontmatter, bodyData }) {
  * @param {Array<{name: string, dirname: string, useWhen: string}>} profile.bodyData.skillIndex - Skill index entries
  * @param {string} profile.bodyData.roleContext - Role context text
  * @param {WorkingStyleEntry[]} profile.bodyData.workingStyles - Working style entries
- * @param {string} [profile.bodyData.beforeHandoff] - Before handoff checklist markdown (optional)
+ * @param {BeforeHandoffEntry[]} [profile.bodyData.beforeHandoff] - Before handoff checklist entries (optional)
  * @param {string[]} profile.bodyData.constraints - List of constraints
  * @param {string} template - Mustache template string
  * @returns {string} Complete .agent.md file content

package/templates/agent.template.md

@@ -88,17 +88,23 @@ and (3) the compromised approach with acknowledged limitations.
 | `{{id}}` | {{{name}}} | {{{description}}} |
 {{/agentIndex}}
 {{/hasAgentIndex}}
-{{#beforeHandoff}}
+{{#hasBeforeHandoff}}
 
 ## Before Handoff
 
 Before offering a handoff, verify and summarize completion of these items:
 
-{{{beforeHandoff}}}
+{{#beforeHandoff}}
+### {{{capability.emojiIcon}}} {{{skill.name}}}
+
+{{#items}}
+- [ ] {{{.}}}
+{{/items}}
 
+{{/beforeHandoff}}
 When verified, summarize what was accomplished then offer the handoff. If items
 are incomplete, explain what remains.
-{{/beforeHandoff}}
+{{/hasBeforeHandoff}}
 
 ## Return Format
 

package/templates/skill.template.md

@@ -1,20 +1,17 @@
 ---
 name: {{name}}
 description: |
-{{#descriptionLines}}
-  {{{.}}}
-{{/descriptionLines}}
+  {{#descriptionLines}}{{{.}}} {{/descriptionLines}}
 {{#hasUseWhen}}
-  **Use When:** {{#useWhenLines}}{{{.}}}{{/useWhenLines}}
+  Use When: {{#useWhenLines}}{{{.}}} {{/useWhenLines}}
 {{/hasUseWhen}}
 ---
 
 # {{{title}}}
-{{#hasUseWhen}}
 
-**Use This Skill When:**
-{{#useWhenLines}}{{{.}}}{{/useWhenLines}}
-{{/hasUseWhen}}
+{{#descriptionLines}}
+{{{.}}}
+{{/descriptionLines}}
 {{#hasStages}}
 
 ## Stage Guidance