@forwardimpact/pathway 0.12.0 → 0.14.0

package/src/pages/interview.js

@@ -81,8 +81,8 @@ export function renderInterviewDetail(params) {
     return;
   }
 
-  // State for current interview type (default to first: Screening)
-  let currentType = "short";
+  // State for current interview type (default to first: Mission Fit)
+  let currentType = "mission";
 
   const page = div(
     { className: "interview-detail-page" },
@@ -194,23 +194,32 @@ function createInterviewSummary(interview) {
       { className: "interview-summary-header" },
       h2({}, `${typeInfo.icon} ${typeInfo.name}`),
       p({ className: "text-muted" }, typeInfo.description),
+      typeInfo.panel
+        ? p({ className: "text-muted" }, `Panel: ${typeInfo.panel}`)
+        : null,
     ),
     div(
       { className: "interview-summary-stats" },
       createBadge(`${interview.questions.length} questions`, "default"),
       createBadge(`~${interview.expectedDurationMinutes} minutes`, "secondary"),
-      interview.coverage.skills.length > 0
+      interview.coverage.skills?.length > 0
         ? createBadge(
             `${interview.coverage.skills.length} skills covered`,
             "primary",
           )
         : null,
-      interview.coverage.behaviours.length > 0
+      interview.coverage.behaviours?.length > 0
         ? createBadge(
             `${interview.coverage.behaviours.length} behaviours covered`,
             "primary",
           )
         : null,
+      interview.coverage.capabilities?.length > 0
+        ? createBadge(
+            `${interview.coverage.capabilities.length} capabilities covered`,
+            "primary",
+          )
+        : null,
     ),
   );
 }
@@ -226,6 +235,9 @@ function createQuestionsDisplay(interview, framework) {
   const behaviourQuestions = interview.questions.filter(
     (q) => q.targetType === "behaviour",
   );
+  const capabilityQuestions = interview.questions.filter(
+    (q) => q.targetType === "capability",
+  );
 
   const sections = [];
 
@@ -241,12 +253,21 @@ function createQuestionsDisplay(interview, framework) {
   if (behaviourQuestions.length > 0) {
     sections.push(
       createDetailSection({
-        title: `${getConceptEmoji(framework, "behaviour")} Behaviour Questions (${behaviourQuestions.length})`,
+        title: `${getConceptEmoji(framework, "behaviour")} Stakeholder Simulation (${behaviourQuestions.length})`,
         content: createQuestionsList(behaviourQuestions),
       }),
     );
   }
 
+  if (capabilityQuestions.length > 0) {
+    sections.push(
+      createDetailSection({
+        title: `${getConceptEmoji(framework, "capability") || "🧩"} Decomposition Questions (${capabilityQuestions.length})`,
+        content: createQuestionsList(capabilityQuestions),
+      }),
+    );
+  }
+
   if (sections.length === 0) {
     return div(
       { className: "card" },
@@ -262,6 +283,7 @@ function createQuestionsDisplay(interview, framework) {
 
 /**
  * Create questions list
+ * @param {Array} questions - Questions to display
  */
 function createQuestionsList(questions) {
   return div(
@@ -272,10 +294,41 @@ function createQuestionsList(questions) {
 
 /**
  * Create question card
+ * @param {Object} questionEntry - Question entry
+ * @param {number} number - Question number
  */
 function createQuestionCard(questionEntry, number) {
   const { question, targetName, targetLevel } = questionEntry;
 
+  const contextSection = question.context
+    ? div(
+        { className: "question-context" },
+        h4({}, "Context:"),
+        p({}, question.context),
+      )
+    : null;
+
+  const decompositionPromptsList =
+    question.decompositionPrompts && question.decompositionPrompts.length > 0
+      ? div(
+          { className: "question-prompts" },
+          h4({}, "Guide candidate thinking:"),
+          ul(
+            {},
+            ...question.decompositionPrompts.map((prompt) => li({}, prompt)),
+          ),
+        )
+      : null;
+
+  const simulationPromptsList =
+    question.simulationPrompts && question.simulationPrompts.length > 0
+      ? div(
+          { className: "question-prompts" },
+          h4({}, "Steer the simulation:"),
+          ul({}, ...question.simulationPrompts.map((prompt) => li({}, prompt))),
+        )
+      : null;
+
   const followUpsList =
     question.followUps && question.followUps.length > 0
       ? div(
@@ -309,6 +362,9 @@ function createQuestionCard(questionEntry, number) {
       ),
     ),
     div({ className: "question-text" }, question.text),
+    contextSection,
+    decompositionPromptsList,
+    simulationPromptsList,
     followUpsList,
     lookingForList,
   );

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}}