@forwardimpact/pathway 0.13.0 → 0.14.0

package/src/pages/behaviour.js

@@ -9,6 +9,7 @@ import { renderNotFound } from "../components/error-page.js";
 import { prepareBehavioursList } from "../formatters/behaviour/shared.js";
 import { behaviourToDOM } from "../formatters/behaviour/dom.js";
 import { behaviourToCardConfig } from "../lib/card-mappers.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Render behaviours list page
@@ -16,6 +17,7 @@ import { behaviourToCardConfig } from "../lib/card-mappers.js";
 export function renderBehavioursList() {
   const { data } = getState();
   const { framework } = data;
+  const behaviourEmoji = getConceptEmoji(framework, "behaviour");
 
   // Transform data for list view
   const { items } = prepareBehavioursList(data.behaviours);
@@ -27,7 +29,7 @@ export function renderBehavioursList() {
       { className: "page-header" },
       h1(
         { className: "page-title" },
-        framework.entityDefinitions.behaviour.title,
+        `${behaviourEmoji} ${framework.entityDefinitions.behaviour.title}`,
       ),
       p(
         { className: "page-description" },

package/src/pages/discipline.js

@@ -10,6 +10,7 @@ import { renderNotFound } from "../components/error-page.js";
 import { prepareDisciplinesList } from "../formatters/discipline/shared.js";
 import { disciplineToDOM } from "../formatters/discipline/dom.js";
 import { disciplineToCardConfig } from "../lib/card-mappers.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Format discipline group name for display
@@ -42,6 +43,7 @@ function renderDisciplineGroupHeader(groupName, count) {
 export function renderDisciplinesList() {
   const { data } = getState();
   const { framework } = data;
+  const disciplineEmoji = getConceptEmoji(framework, "discipline");
 
   // Transform data for list view (grouped by professional/management)
   const { groups } = prepareDisciplinesList(data.disciplines);
@@ -53,7 +55,7 @@ export function renderDisciplinesList() {
       { className: "page-header" },
       h1(
         { className: "page-title" },
-        framework.entityDefinitions.discipline.title,
+        `${disciplineEmoji} ${framework.entityDefinitions.discipline.title}`,
       ),
       p(
         { className: "page-description" },

package/src/pages/driver.js

@@ -9,6 +9,7 @@ import { renderNotFound } from "../components/error-page.js";
 import { prepareDriversList } from "../formatters/driver/shared.js";
 import { driverToDOM } from "../formatters/driver/dom.js";
 import { driverToCardConfig } from "../lib/card-mappers.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Render drivers list page
@@ -16,6 +17,7 @@ import { driverToCardConfig } from "../lib/card-mappers.js";
 export function renderDriversList() {
   const { data } = getState();
   const { framework } = data;
+  const driverEmoji = getConceptEmoji(framework, "driver");
 
   // Transform data for list view
   const { items } = prepareDriversList(data.drivers);
@@ -25,7 +27,10 @@ export function renderDriversList() {
     // Header
     div(
       { className: "page-header" },
-      h1({ className: "page-title" }, framework.entityDefinitions.driver.title),
+      h1(
+        { className: "page-title" },
+        `${driverEmoji} ${framework.entityDefinitions.driver.title}`,
+      ),
       p(
         { className: "page-description" },
         framework.entityDefinitions.driver.description.trim(),

package/src/pages/grade.js

@@ -8,6 +8,7 @@ import { createBadge } from "../components/card.js";
 import { renderNotFound } from "../components/error-page.js";
 import { prepareGradesList } from "../formatters/grade/shared.js";
 import { gradeToDOM } from "../formatters/grade/dom.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Render grades list page
@@ -15,6 +16,7 @@ import { gradeToDOM } from "../formatters/grade/dom.js";
 export function renderGradesList() {
   const { data } = getState();
   const { framework } = data;
+  const gradeEmoji = getConceptEmoji(framework, "grade");
 
   // Transform data for list view
   const { items } = prepareGradesList(data.grades);
@@ -24,7 +26,10 @@ export function renderGradesList() {
     // Header
     div(
       { className: "page-header" },
-      h1({ className: "page-title" }, framework.entityDefinitions.grade.title),
+      h1(
+        { className: "page-title" },
+        `${gradeEmoji} ${framework.entityDefinitions.grade.title}`,
+      ),
       p(
         { className: "page-description" },
         framework.entityDefinitions.grade.description.trim(),

package/src/pages/job.js

@@ -66,6 +66,7 @@ export async function renderJobDetail(params) {
     behaviours: data.behaviours,
     drivers: data.drivers,
     capabilities: data.capabilities,
+    stages: data.stages,
   });
 
   if (!jobView) {

package/src/pages/landing.js

@@ -11,6 +11,7 @@ import {
 } from "@forwardimpact/schema/levels";
 import { getStageEmoji } from "../formatters/stage/shared.js";
 import { aggregateTools } from "../formatters/tool/shared.js";
+import { createCommandPrompt } from "../components/command-prompt.js";
 
 /**
  * Create lifecycle flow visualization for landing page
@@ -63,6 +64,12 @@ export function renderLanding() {
         span({ className: "brand-tag brand-tag-hero" }, framework.tag),
       ),
       p({}, framework.description.trim()),
+      // Install command prompt (only if distribution URL is configured)
+      framework.distribution?.siteUrl
+        ? createCommandPrompt(
+            `curl -fsSL ${framework.distribution.siteUrl}/install.sh | bash`,
+          )
+        : null,
       // Job builder CTA
       div(
         { className: "page-actions", style: "justify-content: center" },

package/src/pages/skill.js

@@ -10,7 +10,10 @@ import { renderNotFound } from "../components/error-page.js";
 import { prepareSkillsList } from "../formatters/skill/shared.js";
 import { skillToDOM } from "../formatters/skill/dom.js";
 import { skillToCardConfig } from "../lib/card-mappers.js";
-import { getCapabilityEmoji } from "@forwardimpact/schema/levels";
+import {
+  getCapabilityEmoji,
+  getConceptEmoji,
+} from "@forwardimpact/schema/levels";
 
 /**
  * Render skills list page
@@ -18,6 +21,7 @@ import { getCapabilityEmoji } from "@forwardimpact/schema/levels";
 export function renderSkillsList() {
   const { data } = getState();
   const { framework } = data;
+  const skillEmoji = getConceptEmoji(framework, "skill");
 
   // Transform data for list view
   const { groups, groupOrder } = prepareSkillsList(
@@ -30,7 +34,10 @@ export function renderSkillsList() {
     // Header
     div(
       { className: "page-header" },
-      h1({ className: "page-title" }, framework.entityDefinitions.skill.title),
+      h1(
+        { className: "page-title" },
+        `${skillEmoji} ${framework.entityDefinitions.skill.title}`,
+      ),
       p(
         { className: "page-description" },
         framework.entityDefinitions.skill.description.trim(),

package/src/pages/track.js

@@ -9,6 +9,7 @@ import { renderNotFound } from "../components/error-page.js";
 import { prepareTracksList } from "../formatters/track/shared.js";
 import { trackToDOM } from "../formatters/track/dom.js";
 import { trackToCardConfig } from "../lib/card-mappers.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Render tracks list page
@@ -16,6 +17,7 @@ import { trackToCardConfig } from "../lib/card-mappers.js";
 export function renderTracksList() {
   const { data } = getState();
   const { framework } = data;
+  const trackEmoji = getConceptEmoji(framework, "track");
 
   // Transform data for list view
   const { items } = prepareTracksList(data.tracks);
@@ -25,7 +27,10 @@ export function renderTracksList() {
     // Header
     div(
       { className: "page-header" },
-      h1({ className: "page-title" }, framework.entityDefinitions.track.title),
+      h1(
+        { className: "page-title" },
+        `${trackEmoji} ${framework.entityDefinitions.track.title}`,
+      ),
       p(
         { className: "page-description" },
         framework.entityDefinitions.track.description.trim(),

package/src/slides/job.js

@@ -28,6 +28,7 @@ export function renderJobSlide({ render, data, params }) {
     behaviours: data.behaviours,
     drivers: data.drivers,
     capabilities: data.capabilities,
+    stages: data.stages,
   });
 
   if (!view) {

package/templates/agent.template.md

@@ -57,11 +57,18 @@ project-specific guidance, required tools, and technology standards. Pre-trainin
 knowledge alone is insufficient—skills contain organizational standards that
 override general knowledge.
 
-Skills represent mandatory organizational patterns. When a skill specifies tools
-in its "Required Tools" section, you MUST use them. If a blocking constraint
-prevents use, document in your output: (1) which skill requirement you cannot
-meet, (2) the specific constraint preventing compliance, and (3) the alternative
-approach with acknowledged trade-offs.
+Each skill file contains XML-tagged sections for precise navigation:
+
+- **`<{{stageId}}_stage_checklist>`** — Your stage-specific checklist. Follow
+  the Read-Then-Do and Do-Then-Confirm items for the {{stageName}} stage.
+- **`<required_tools>`** — Mandatory tools for this skill. You MUST use these
+  organizational standards that override general knowledge or personal
+  preferences.
+{{#isOnboard}}
+- **`<onboarding_steps>`** — Step-by-step environment setup instructions.
+  Follow these to install prerequisites and configure the development
+  environment. Focus on setup only — do not begin feature implementation.
+{{/isOnboard}}
 
 | Skill | Location | Use When |
 | ----- | -------- | -------- |
@@ -88,23 +95,23 @@ and (3) the compromised approach with acknowledged limitations.
 | `{{id}}` | {{{name}}} | {{{description}}} |
 {{/agentIndex}}
 {{/hasAgentIndex}}
-{{#hasBeforeHandoff}}
+{{#hasConfirmChecklist}}
 
-## Before Handoff
+## Do-Then-Confirm Checklist
 
 Before offering a handoff, verify and summarize completion of these items:
 
-{{#beforeHandoff}}
+{{#confirmChecklist}}
 ### {{{capability.emojiIcon}}} {{{skill.name}}}
 
 {{#items}}
 - [ ] {{{.}}}
 {{/items}}
 
-{{/beforeHandoff}}
+{{/confirmChecklist}}
 When verified, summarize what was accomplished then offer the handoff. If items
 are incomplete, explain what remains.
-{{/hasBeforeHandoff}}
+{{/hasConfirmChecklist}}
 
 ## Return Format
 

package/templates/install.template.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# {{{frameworkTitle}}} — Local Install
+# Generated by @forwardimpact/pathway v{{{version}}}
+#
+# Installs to ~/.fit/pathway/
+#
+# Usage:
+#   curl -fsSL {{{siteUrl}}}/install.sh | bash
+#
+set -euo pipefail
+
+SITE_URL="{{{siteUrl}}}"
+INSTALL_DIR="${HOME}/.fit/pathway"
+
+command -v node >/dev/null 2>&1 || { echo "Error: Node.js 18+ is required. https://nodejs.org"; exit 1; }
+command -v npm  >/dev/null 2>&1 || { echo "Error: npm is required."; exit 1; }
+
+echo "Installing to ${INSTALL_DIR}..."
+mkdir -p "${INSTALL_DIR}"
+
+TMPFILE=$(mktemp)
+trap 'rm -f "$TMPFILE"' EXIT
+curl -fsSL "${SITE_URL}/bundle.tar.gz" -o "$TMPFILE"
+tar -xzf "$TMPFILE" -C "${INSTALL_DIR}" --strip-components=1
+
+(cd "${INSTALL_DIR}" && npm install --production --ignore-scripts --no-audit --no-fund --silent)
+
+echo ""
+echo "Done. Usage:"
+echo "  cd ${INSTALL_DIR}"
+echo "  npx fit-pathway skill --list"
+echo "  npx fit-pathway job --list"
+echo "  npx fit-pathway agent --list"

package/templates/skill.template.md

@@ -13,23 +13,29 @@ description: {{{description}}}{{#hasUseWhen}} Use When: {{{useWhen}}}{{/hasUseWh
 ## Stage Guidance
 {{#stages}}
 
+<{{stageId}}_stage_checklist>
+
 ### {{stageName}} Stage
 
 **Focus:** {{{focus}}}
 
-**Activities:**
-{{#activities}}
-- {{{.}}}
-{{/activities}}
+**Read-Then-Do Checklist:**
+{{#readChecklist}}
+- [ ] {{{.}}}
+{{/readChecklist}}
 
-**Ready for {{nextStageName}} when:**
-{{#ready}}
+**Do-Then-Confirm Checklist:**
+{{#confirmChecklist}}
 - [ ] {{{.}}}
-{{/ready}}
+{{/confirmChecklist}}
+
+</{{stageId}}_stage_checklist>
 {{/stages}}
 {{/hasStages}}
 {{#hasToolReferences}}
 
+<required_tools>
+
 ## Required Tools
 
 **MANDATORY:** You MUST use these tools when applying this skill. These are
@@ -45,6 +51,8 @@ trade-offs.
 {{#toolReferences}}
 | {{#url}}[{{{name}}}]({{{url}}}){{/url}}{{^url}}{{{name}}}{{/url}} | {{{useWhen}}} |
 {{/toolReferences}}
+
+</required_tools>
 {{/hasToolReferences}}
 {{#hasReference}}