@forwardimpact/pathway 0.20.0 → 0.22.0

package/src/pages/agent-builder.js

@@ -26,7 +26,7 @@ import {
   deriveStageAgent,
   generateSkillMarkdown,
   deriveAgentSkills,
-  deriveReferenceGrade,
+  deriveReferenceLevel,
   deriveToolkit,
   buildAgentIndex,
 } from "@forwardimpact/libpathway";
@@ -256,8 +256,8 @@ export async function renderAgentBuilder() {
       return;
     }
 
-    // Get reference grade for derivation
-    const grade = deriveReferenceGrade(data.grades);
+    // Get reference level for derivation
+    const level = deriveReferenceLevel(data.levels);
 
     // Build agent index for all valid combinations
     const agentIndex = buildAgentIndex({
@@ -274,7 +274,7 @@ export async function renderAgentBuilder() {
       humanTrack,
       agentDiscipline,
       agentTrack,
-      grade,
+      level,
       stages,
       skills: data.skills,
       behaviours: data.behaviours,
@@ -451,7 +451,7 @@ function createAllStagesPreview(context) {
     humanTrack,
     agentDiscipline,
     agentTrack,
-    grade,
+    level,
     stages,
     skills,
     behaviours,
@@ -468,7 +468,7 @@ function createAllStagesPreview(context) {
       discipline: humanDiscipline,
       track: humanTrack,
       stage,
-      grade,
+      level,
       skills,
       behaviours,
       agentBehaviours,
@@ -481,7 +481,7 @@ function createAllStagesPreview(context) {
       discipline: humanDiscipline,
       track: humanTrack,
       stage,
-      grade,
+      level,
       skills,
       behaviours,
       agentBehaviours,
@@ -498,7 +498,7 @@ function createAllStagesPreview(context) {
   const derivedSkills = deriveAgentSkills({
     discipline: humanDiscipline,
     track: humanTrack,
-    grade,
+    level,
     skills,
   });
 
@@ -594,7 +594,7 @@ function createSingleStagePreview(context, stage) {
     humanTrack,
     agentDiscipline,
     agentTrack,
-    grade,
+    level,
     skills,
     behaviours,
     agentBehaviours,
@@ -609,7 +609,7 @@ function createSingleStagePreview(context, stage) {
     discipline: humanDiscipline,
     track: humanTrack,
     stage,
-    grade,
+    level,
     skills,
     behaviours,
     agentBehaviours,
@@ -623,7 +623,7 @@ function createSingleStagePreview(context, stage) {
   const derivedSkills = deriveAgentSkills({
     discipline: humanDiscipline,
     track: humanTrack,
-    grade,
+    level,
     skills,
   });
 

package/src/pages/assessment-results.js

@@ -45,14 +45,14 @@ export function renderAssessmentResults() {
   };
 
   // Find matching jobs with realistic scoring
-  const { matches, matchesByTier, estimatedGrade } = findRealisticMatches({
+  const { matches, matchesByTier, estimatedLevel } = findRealisticMatches({
     selfAssessment,
     disciplines: data.disciplines,
-    grades: data.grades,
+    levels: data.levels,
     tracks: data.tracks,
     skills: data.skills,
     behaviours: data.behaviours,
-    filterByGrade: false, // Show all grades but group by tier
+    filterByLevel: false, // Show all levels but group by tier
     topN: 20,
   });
 
@@ -73,7 +73,7 @@ export function renderAssessmentResults() {
     ),
 
     // Summary stats
-    createSummaryStats(assessmentState, data, estimatedGrade),
+    createSummaryStats(assessmentState, data, estimatedLevel),
 
     // Top matches grouped by tier
     createMatchesSection(matches, matchesByTier, selfAssessment, data),
@@ -139,28 +139,28 @@ function renderNoAssessment() {
  * Create summary statistics section
  * @param {Object} assessmentState - Current assessment state
  * @param {Object} data - App data
- * @param {{grade: Object, confidence: number}} estimatedGrade - Estimated best-fit grade
+ * @param {{level: Object, confidence: number}} estimatedLevel - Estimated best-fit level
  * @returns {HTMLElement}
  */
-function createSummaryStats(assessmentState, data, estimatedGrade) {
+function createSummaryStats(assessmentState, data, estimatedLevel) {
   const skillCount = Object.keys(assessmentState.skills).length;
   const behaviourCount = Object.keys(assessmentState.behaviours).length;
 
   // Calculate average levels
-  const avgSkillLevel = calculateAverageLevel(
+  const avgSkillProficiency = calculateAverageLevel(
     Object.values(assessmentState.skills),
     ["awareness", "foundational", "working", "practitioner", "expert"],
   );
 
-  // Get grade name based on track (default to professional)
-  const gradeName =
-    estimatedGrade.grade.professionalTitle ||
-    estimatedGrade.grade.name ||
-    estimatedGrade.grade.id;
+  // Get level name based on track (default to professional)
+  const levelName =
+    estimatedLevel.level.professionalTitle ||
+    estimatedLevel.level.name ||
+    estimatedLevel.level.id;
   const confidenceLabel =
-    estimatedGrade.confidence >= 0.7
+    estimatedLevel.confidence >= 0.7
       ? "High"
-      : estimatedGrade.confidence >= 0.4
+      : estimatedLevel.confidence >= 0.4
         ? "Medium"
         : "Low";
 
@@ -179,8 +179,12 @@ function createSummaryStats(assessmentState, data, estimatedGrade) {
         `of ${data.behaviours.length} Behaviours`,
         "🧠",
       ),
-      createStatBox(formatLevel(avgSkillLevel), "Avg Skill Level", "💡"),
-      createStatBox(gradeName, `Estimated Level (${confidenceLabel})`, "🎯"),
+      createStatBox(
+        formatLevel(avgSkillProficiency),
+        "Avg Skill Proficiency",
+        "💡",
+      ),
+      createStatBox(levelName, `Estimated Level (${confidenceLabel})`, "🎯"),
     ),
   );
 }
@@ -380,8 +384,8 @@ function createMatchCard(match, _index, _selfAssessment, _data) {
           a(
             {
               href: job.track
-                ? `#/job/${job.discipline.id}/${job.grade.id}/${job.track.id}`
-                : `#/job/${job.discipline.id}/${job.grade.id}`,
+                ? `#/job/${job.discipline.id}/${job.level.id}/${job.track.id}`
+                : `#/job/${job.discipline.id}/${job.level.id}`,
             },
             job.title,
           ),
@@ -389,7 +393,7 @@ function createMatchCard(match, _index, _selfAssessment, _data) {
         div(
           { className: "match-badges" },
           createBadge(job.discipline.name, "default"),
-          createBadge(job.grade.name, "secondary"),
+          createBadge(job.level.name, "secondary"),
           job.track && createBadge(job.track.name, "broad"),
         ),
       ),
@@ -440,8 +444,8 @@ function createMatchCard(match, _index, _selfAssessment, _data) {
       a(
         {
           href: job.track
-            ? `#/job/${job.discipline.id}/${job.grade.id}/${job.track.id}`
-            : `#/job/${job.discipline.id}/${job.grade.id}`,
+            ? `#/job/${job.discipline.id}/${job.level.id}/${job.track.id}`
+            : `#/job/${job.discipline.id}/${job.level.id}`,
           className: "btn btn-secondary btn-sm",
         },
         "View Job Details",
@@ -449,8 +453,8 @@ function createMatchCard(match, _index, _selfAssessment, _data) {
       a(
         {
           href: job.track
-            ? `#/interview/${job.discipline.id}/${job.grade.id}/${job.track.id}`
-            : `#/interview/${job.discipline.id}/${job.grade.id}`,
+            ? `#/interview/${job.discipline.id}/${job.level.id}/${job.track.id}`
+            : `#/interview/${job.discipline.id}/${job.level.id}`,
           className: "btn btn-secondary btn-sm",
         },
         "Interview Prep",

package/src/pages/behaviour.js

@@ -9,7 +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";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
 
 /**
  * Render behaviours list page

package/src/pages/discipline.js

@@ -10,7 +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";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
 
 /**
  * Format discipline group name for display

package/src/pages/driver.js

@@ -9,7 +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";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
 
 /**
  * Render drivers list page

package/src/pages/interview-builder.js

@@ -17,7 +17,7 @@ export function renderInterviewPrep() {
     createBuilder({
       title: "Interview Prep",
       description:
-        "Select a discipline, track, and grade to generate tailored interview questions " +
+        "Select a discipline, track, and level to generate tailored interview questions " +
         "based on the role's skill requirements and expected behaviours.",
       formTitle: "Select Role",
       emptyPreviewText: "Select all three components to preview the interview.",
@@ -26,21 +26,21 @@ export function renderInterviewPrep() {
         prepareInterviewBuilderPreview({
           ...selection,
           behaviourCount: data.behaviours.length,
-          grades: data.grades,
+          levels: data.levels,
         }),
       detailPath: (sel) =>
         sel.track
-          ? `/interview/${sel.discipline}/${sel.grade}/${sel.track}`
-          : `/interview/${sel.discipline}/${sel.grade}`,
+          ? `/interview/${sel.discipline}/${sel.level}/${sel.track}`
+          : `/interview/${sel.discipline}/${sel.level}`,
       renderPreview: createStandardPreview,
       helpItems: [
         {
           label: "Role Selection",
-          text: "Choose a discipline, track, and grade to define the target role for the interview.",
+          text: "Choose a discipline, track, and level to define the target role for the interview.",
         },
         {
           label: "Skill Questions",
-          text: "Questions are generated based on the required skill levels for the role.",
+          text: "Questions are generated based on the required skill proficiencies for the role.",
         },
         {
           label: "Behaviour Questions",

package/src/pages/interview.js

@@ -21,7 +21,7 @@ import { createBadge } from "../components/card.js";
 import { createBackLink } from "../components/nav.js";
 import { createDetailSection } from "../components/detail.js";
 import { renderError } from "../components/error-page.js";
-import { getConceptEmoji } from "@forwardimpact/schema/levels";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
 import {
   prepareAllInterviews,
   INTERVIEW_TYPES,
@@ -32,18 +32,18 @@ import {
  * @param {Object} params - Route params
  */
 export function renderInterviewDetail(params) {
-  const { discipline: disciplineId, grade: gradeId, track: trackId } = params;
+  const { discipline: disciplineId, level: levelId, track: trackId } = params;
   const { data } = getState();
 
   // Find the components
   const discipline = data.disciplines.find((d) => d.id === disciplineId);
-  const grade = data.grades.find((g) => g.id === gradeId);
+  const level = data.levels.find((g) => g.id === levelId);
   const track = trackId ? data.tracks.find((t) => t.id === trackId) : null;
 
-  if (!discipline || !grade) {
+  if (!discipline || !level) {
     renderError({
       title: "Interview Not Found",
-      message: "Invalid combination. Discipline or grade not found.",
+      message: "Invalid combination. Discipline or level not found.",
       backPath: "/interview-prep",
       backText: "← Back to Interview Prep",
     });
@@ -64,7 +64,7 @@ export function renderInterviewDetail(params) {
   // Use formatter shared module to get all interview types
   const interviewsView = prepareAllInterviews({
     discipline,
-    grade,
+    level,
     track,
     skills: data.skills,
     behaviours: data.behaviours,
@@ -74,7 +74,7 @@ export function renderInterviewDetail(params) {
   if (!interviewsView) {
     renderError({
       title: "Invalid Combination",
-      message: "This discipline, track, and grade combination is not valid.",
+      message: "This discipline, track, and level combination is not valid.",
       backPath: "/interview-prep",
       backText: "← Back to Interview Prep",
     });
@@ -100,8 +100,8 @@ export function renderInterviewDetail(params) {
         ),
         " × ",
         a(
-          { href: `#/grade/${interviewsView.gradeId}` },
-          interviewsView.gradeId,
+          { href: `#/level/${interviewsView.levelId}` },
+          interviewsView.levelId,
         ),
         " × ",
         a(

package/src/pages/job-builder.js

@@ -17,7 +17,7 @@ export function renderJobBuilder() {
     createBuilder({
       title: "Job Builder",
       description:
-        "Combine a discipline, track, and grade to generate a complete job definition " +
+        "Combine a discipline, track, and level to generate a complete job definition " +
         "with skill matrix and behaviour profile.",
       formTitle: "Select Components",
       emptyPreviewText:
@@ -27,12 +27,12 @@ export function renderJobBuilder() {
         prepareJobBuilderPreview({
           ...selection,
           behaviourCount: data.behaviours.length,
-          grades: data.grades,
+          levels: data.levels,
         }),
       detailPath: (sel) =>
         sel.track
-          ? `/job/${sel.discipline}/${sel.grade}/${sel.track}`
-          : `/job/${sel.discipline}/${sel.grade}`,
+          ? `/job/${sel.discipline}/${sel.level}/${sel.track}`
+          : `/job/${sel.discipline}/${sel.level}`,
       renderPreview: createStandardPreview,
       helpItems: [
         {
@@ -40,8 +40,8 @@ export function renderJobBuilder() {
           text: "Defines the T-shaped skill profile with primary, secondary, and broad skills.",
         },
         {
-          label: "Grade",
-          text: "Sets base skill levels and behaviour maturity expectations for career level.",
+          label: "Level",
+          text: "Sets base skill proficiencies and behaviour maturity expectations for career level.",
         },
         {
           label: "Track",

package/src/pages/job.js

@@ -28,18 +28,18 @@ async function getJobTemplate() {
  * @param {Object} params - Route params
  */
 export async function renderJobDetail(params) {
-  const { discipline: disciplineId, grade: gradeId, track: trackId } = params;
+  const { discipline: disciplineId, level: levelId, track: trackId } = params;
   const { data } = getState();
 
   // Find the components
   const discipline = data.disciplines.find((d) => d.id === disciplineId);
-  const grade = data.grades.find((g) => g.id === gradeId);
+  const level = data.levels.find((g) => g.id === levelId);
   const track = trackId ? data.tracks.find((t) => t.id === trackId) : null;
 
-  if (!discipline || !grade) {
+  if (!discipline || !level) {
     renderError({
       title: "Job Not Found",
-      message: "Invalid job combination. Discipline or grade not found.",
+      message: "Invalid job combination. Discipline or level not found.",
       backPath: "/job-builder",
       backText: "← Back to Job Builder",
     });
@@ -60,7 +60,7 @@ export async function renderJobDetail(params) {
   // Use formatter shared module to get job detail view
   const jobView = prepareJobDetail({
     discipline,
-    grade,
+    level,
     track,
     skills: data.skills,
     behaviours: data.behaviours,
@@ -72,7 +72,7 @@ export async function renderJobDetail(params) {
   if (!jobView) {
     renderError({
       title: "Invalid Combination",
-      message: "This discipline, track, and grade combination is not valid.",
+      message: "This discipline, track, and level combination is not valid.",
       backPath: "/job-builder",
       backText: "← Back to Job Builder",
     });
@@ -89,6 +89,6 @@ export async function renderJobDetail(params) {
 
   // Load template and format
   const jobTemplate = await getJobTemplate();
-  const page = jobToDOM(jobView, { discipline, grade, track, jobTemplate });
+  const page = jobToDOM(jobView, { discipline, level, track, jobTemplate });
   render(page);
 }

package/src/pages/landing.js

@@ -8,7 +8,7 @@ import { createStatCard } from "../components/card.js";
 import {
   groupSkillsByCapability,
   getConceptEmoji,
-} from "@forwardimpact/schema/levels";
+} from "@forwardimpact/map/levels";
 import { getStageEmoji } from "../formatters/stage/shared.js";
 import { aggregateTools } from "../formatters/tool/shared.js";
 import { createCommandPrompt } from "../components/command-prompt.js";
@@ -105,9 +105,9 @@ export function renderLanding() {
         href: "/discipline",
       }),
       createStatCard({
-        value: data.grades.length,
-        label: "Grades",
-        href: "/grade",
+        value: data.levels.length,
+        label: "Levels",
+        href: "/level",
       }),
       createStatCard({
         value: data.tracks.length,
@@ -169,9 +169,9 @@ export function renderLanding() {
           "/discipline",
         ),
         createQuickLinkCard(
-          `${getConceptEmoji(framework, "grade")} ${framework.entityDefinitions.grade.title}`,
-          `${data.grades.length} ${framework.entityDefinitions.grade.title.toLowerCase()} — ${framework.entityDefinitions.grade.description.trim().split("\n")[0]}`,
-          "/grade",
+          `${getConceptEmoji(framework, "level")} ${framework.entityDefinitions.level.title}`,
+          `${data.levels.length} ${framework.entityDefinitions.level.title.toLowerCase()} — ${framework.entityDefinitions.level.description.trim().split("\n")[0]}`,
+          "/level",
         ),
         createQuickLinkCard(
           `${getConceptEmoji(framework, "track")} ${framework.entityDefinitions.track.title}`,
@@ -220,7 +220,7 @@ export function renderLanding() {
           h2({}, "🔨 Build a Job Definition"),
           p(
             {},
-            "Combine a discipline, track, and grade to generate a complete job definition " +
+            "Combine a discipline, track, and level to generate a complete job definition " +
               "with skill matrices and behaviour profiles.",
           ),
           div(
@@ -256,7 +256,7 @@ export function renderLanding() {
           h2({}, "📈 Plan Your Career"),
           p(
             {},
-            "Visualize your progression to the next grade and compare expectations " +
+            "Visualize your progression to the next level and compare expectations " +
               "across different tracks to plan your career development.",
           ),
           div(

package/src/pages/level.js

@@ -0,0 +1,122 @@
+/**
+ * Levels pages
+ */
+
+import { render, div, h1, h3, p, formatLevel } from "../lib/render.js";
+import { getState } from "../lib/state.js";
+import { createBadge } from "../components/card.js";
+import { renderNotFound } from "../components/error-page.js";
+import { prepareLevelsList } from "../formatters/level/shared.js";
+import { levelToDOM } from "../formatters/level/dom.js";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
+
+/**
+ * Render levels list page
+ */
+export function renderLevelsList() {
+  const { data } = getState();
+  const { framework } = data;
+  const levelEmoji = getConceptEmoji(framework, "level");
+
+  // Transform data for list view
+  const { items } = prepareLevelsList(data.levels);
+
+  const page = div(
+    { className: "levels-page" },
+    // Header
+    div(
+      { className: "page-header" },
+      h1(
+        { className: "page-title" },
+        `${levelEmoji} ${framework.entityDefinitions.level.title}`,
+      ),
+      p(
+        { className: "page-description" },
+        framework.entityDefinitions.level.description.trim(),
+      ),
+    ),
+
+    // Levels timeline
+    div(
+      { className: "levels-timeline" },
+      ...items.map((level) => createLevelTimelineItem(level)),
+    ),
+  );
+
+  render(page);
+}
+
+/**
+ * Create a level timeline item
+ * @param {Object} level
+ * @returns {HTMLElement}
+ */
+function createLevelTimelineItem(level) {
+  const item = div(
+    { className: "level-timeline-item" },
+    div({ className: "level-level-marker" }, String(level.ordinalRank)),
+    div(
+      { className: "level-timeline-content card card-clickable" },
+      div(
+        { className: "card-header" },
+        h3({ className: "card-title" }, level.displayName),
+        createBadge(level.id, "default"),
+      ),
+      level.typicalExperienceRange
+        ? p(
+            { className: "text-muted", style: "margin: 0.25rem 0" },
+            `${level.typicalExperienceRange} experience`,
+          )
+        : null,
+      div(
+        { className: "card-meta", style: "margin-top: 0.5rem" },
+        createBadge(
+          `Primary: ${formatLevel(level.baseSkillProficiencies?.primary)}`,
+          "primary",
+        ),
+        createBadge(
+          `Secondary: ${formatLevel(level.baseSkillProficiencies?.secondary)}`,
+          "secondary",
+        ),
+        createBadge(
+          `Broad: ${formatLevel(level.baseSkillProficiencies?.broad)}`,
+          "broad",
+        ),
+      ),
+      level.scope
+        ? p(
+            { className: "card-description", style: "margin-top: 0.75rem" },
+            `Scope: ${level.scope}`,
+          )
+        : null,
+    ),
+  );
+
+  item.querySelector(".card").addEventListener("click", () => {
+    window.location.hash = `/level/${level.id}`;
+  });
+
+  return item;
+}
+
+/**
+ * Render level detail page
+ * @param {Object} params - Route params
+ */
+export function renderLevelDetail(params) {
+  const { data } = getState();
+  const level = data.levels.find((g) => g.id === params.id);
+
+  if (!level) {
+    renderNotFound({
+      entityType: "Level",
+      entityId: params.id,
+      backPath: "/level",
+      backText: "← Back to Levels",
+    });
+    return;
+  }
+
+  // Use DOM formatter - it handles transformation internally
+  render(levelToDOM(level, { framework: data.framework }));
+}

package/src/pages/progress-builder.js

@@ -18,7 +18,7 @@ export function renderCareerProgress() {
       title: "Career Progress",
       description:
         "Select your current role to visualize career progression. See what skills and behaviours " +
-        "change as you advance to the next grade, or compare expectations across different tracks.",
+        "change as you advance to the next level, or compare expectations across different tracks.",
       formTitle: "Select Your Current Role",
       emptyPreviewText:
         "Select all three components to preview progression paths.",
@@ -26,25 +26,25 @@ export function renderCareerProgress() {
       previewPresenter: (selection) =>
         prepareCareerProgressPreview({
           ...selection,
-          grades: data.grades,
+          levels: data.levels,
           tracks: data.tracks,
         }),
       detailPath: (sel) =>
         sel.track
-          ? `/progress/${sel.discipline}/${sel.grade}/${sel.track}`
-          : `/progress/${sel.discipline}/${sel.grade}`,
+          ? `/progress/${sel.discipline}/${sel.level}/${sel.track}`
+          : `/progress/${sel.discipline}/${sel.level}`,
       renderPreview: createProgressPreview,
       labels: {
-        grade: "Current Grade",
+        level: "Current Level",
       },
       helpItems: [
         {
-          label: "📈 Grade Progression",
-          text: "See exactly which skills and behaviours need to grow to advance to the next grade level.",
+          label: "📈 Level Progression",
+          text: "See exactly which skills and behaviours need to grow to advance to the next level rank.",
         },
         {
           label: "🔀 Track Comparison",
-          text: "Compare how expectations differ across tracks at the same grade - useful for exploring lateral moves.",
+          text: "Compare how expectations differ across tracks at the same level - useful for exploring lateral moves.",
         },
         {
           label: "🎯 Development Focus",