@forwardimpact/pathway 0.21.0 → 0.22.0

package/src/components/builder.js

@@ -1,5 +1,5 @@
 /**
- * Builder component for discipline/grade/track selection pages
+ * Builder component for discipline/level/track selection pages
  */
 
 import {
@@ -32,7 +32,7 @@ import { createReactive } from "../lib/reactive.js";
 /**
  * @typedef {Object} BuilderSelection
  * @property {Object} discipline - Selected discipline
- * @property {Object} grade - Selected grade
+ * @property {Object} level - Selected level
  * @property {Object} track - Selected track
  */
 
@@ -78,10 +78,10 @@ export function createBuilder({
   const selection = createReactive({
     discipline: urlParams.get("discipline") || "",
     track: urlParams.get("track") || "",
-    grade: urlParams.get("grade") || "",
+    level: urlParams.get("level") || "",
   });
 
-  const sortedGrades = [...data.grades].sort((a, b) => a.level - b.level);
+  const sortedLevels = [...data.levels].sort((a, b) => a.level - b.level);
 
   // Create elements that need references
   const previewContainer = div(
@@ -155,9 +155,9 @@ export function createBuilder({
   }
 
   // Subscribe to selection changes - all updates happen here
-  selection.subscribe(({ discipline, track, grade }) => {
-    // Track is now optional - only discipline and grade are required
-    if (!discipline || !grade) {
+  selection.subscribe(({ discipline, track, level }) => {
+    // Track is now optional - only discipline and level are required
+    if (!discipline || !level) {
       previewContainer.innerHTML = "";
       previewContainer.appendChild(
         p({ className: "text-muted" }, emptyPreviewText),
@@ -168,9 +168,9 @@ export function createBuilder({
 
     const disciplineObj = data.disciplines.find((d) => d.id === discipline);
     const trackObj = track ? data.tracks.find((t) => t.id === track) : null;
-    const gradeObj = data.grades.find((g) => g.id === grade);
+    const levelObj = data.levels.find((g) => g.id === level);
 
-    if (!disciplineObj || !gradeObj) {
+    if (!disciplineObj || !levelObj) {
       previewContainer.innerHTML = "";
       previewContainer.appendChild(
         p({ className: "text-muted" }, "Invalid selection. Please try again."),
@@ -182,7 +182,7 @@ export function createBuilder({
     const selectionObj = {
       discipline: disciplineObj,
       track: trackObj,
-      grade: gradeObj,
+      level: levelObj,
     };
     const preview = previewPresenter(selectionObj, data);
 
@@ -193,8 +193,8 @@ export function createBuilder({
 
   // Wire up button
   actionButton.addEventListener("click", () => {
-    const { discipline, track, grade } = selection.get();
-    window.location.hash = detailPath({ discipline, track, grade });
+    const { discipline, track, level } = selection.get();
+    window.location.hash = detailPath({ discipline, track, level });
   });
 
   // Build the page
@@ -234,17 +234,17 @@ export function createBuilder({
             getDisplayName: (d) => d.specialization || d.name,
           }),
         ),
-        // Grade selector (second)
+        // Level selector (second)
         div(
           { className: "form-group" },
-          label({ className: "form-label" }, labels.grade || "Grade"),
+          label({ className: "form-label" }, labels.level || "Level"),
           createSelectWithValue({
-            id: "grade-select",
-            items: sortedGrades,
-            initialValue: selection.get().grade,
-            placeholder: "Select a grade...",
+            id: "level-select",
+            items: sortedLevels,
+            initialValue: selection.get().level,
+            placeholder: "Select a level...",
             onChange: (value) => {
-              selection.update((prev) => ({ ...prev, grade: value }));
+              selection.update((prev) => ({ ...prev, level: value }));
             },
             getDisplayName: (g) => g.id,
           }),
@@ -284,7 +284,7 @@ export function createBuilder({
 
   // Trigger initial update if preselected
   const initial = selection.get();
-  if (initial.discipline || initial.track || initial.grade) {
+  if (initial.discipline || initial.track || initial.level) {
     setTimeout(() => selection.set(selection.get()), 0);
   }
 
@@ -370,12 +370,12 @@ export function createProgressPreview(preview, selection) {
     );
   }
 
-  const { discipline, grade, track } = selection;
+  const { discipline, level, track } = selection;
 
   // Build badges array - track is optional
   const badges = [
     createBadge(discipline.specialization, "discipline"),
-    createBadge(grade.id, "grade"),
+    createBadge(level.id, "level"),
   ];
   if (track) {
     badges.push(createBadge(track.name, "track"));
@@ -394,19 +394,19 @@ export function createProgressPreview(preview, selection) {
       div({ className: "preview-label" }, "Progression Paths Available"),
       div(
         { className: "preview-paths" },
-        preview.nextGrade
+        preview.nextLevel
           ? div(
               { className: "path-item" },
               span({ className: "path-icon" }, "📈"),
               span(
                 {},
-                `Next Grade: ${preview.nextGrade.id} - ${preview.nextGrade.name}`,
+                `Next Level: ${preview.nextLevel.id} - ${preview.nextLevel.name}`,
               ),
             )
           : div(
               { className: "path-item text-muted" },
               span({ className: "path-icon" }, "🏆"),
-              span({}, "You're at the highest grade!"),
+              span({}, "You're at the highest level!"),
             ),
         preview.validTracks.length > 0
           ? div(

package/src/components/comparison-radar.js

@@ -9,7 +9,7 @@
 import { ComparisonRadarChart } from "../lib/radar.js";
 import { div, h3 } from "../lib/render.js";
 import {
-  getSkillLevelIndex,
+  getSkillProficiencyIndex,
   getBehaviourMaturityIndex,
   formatLevel,
 } from "../lib/render.js";
@@ -97,7 +97,7 @@ export function createComparisonSkillRadar(
 
       currentData.push({
         label: skillName,
-        value: currentSkill ? getSkillLevelIndex(currentSkill.level) : 0,
+        value: currentSkill ? getSkillProficiencyIndex(currentSkill.level) : 0,
         maxValue: 5,
         description: currentSkill
           ? `${formatLevel(currentSkill.type)} - ${formatLevel(currentSkill.level)}`
@@ -106,7 +106,7 @@ export function createComparisonSkillRadar(
 
       targetData.push({
         label: skillName,
-        value: targetSkill ? getSkillLevelIndex(targetSkill.level) : 0,
+        value: targetSkill ? getSkillProficiencyIndex(targetSkill.level) : 0,
         maxValue: 5,
         description: targetSkill
           ? `${formatLevel(targetSkill.type)} - ${formatLevel(targetSkill.level)}`

package/src/components/detail.js

@@ -21,7 +21,7 @@ import { createBackLink } from "./nav.js";
 import { createTag } from "./card.js";
 import { formatLevel } from "../lib/render.js";
 import {
-  SKILL_LEVEL_ORDER,
+  SKILL_PROFICIENCY_ORDER,
   BEHAVIOUR_MATURITY_ORDER,
 } from "@forwardimpact/map/levels";
 
@@ -80,7 +80,7 @@ export function createDetailSection({ title, content }) {
  */
 export function createLevelTable(descriptions, type = "skill") {
   const levels =
-    type === "skill" ? SKILL_LEVEL_ORDER : BEHAVIOUR_MATURITY_ORDER;
+    type === "skill" ? SKILL_PROFICIENCY_ORDER : BEHAVIOUR_MATURITY_ORDER;
 
   const levelLabels = Object.fromEntries(
     levels.map((level, index) => [level, String(index + 1)]),

package/src/components/grid.js

@@ -59,7 +59,7 @@ export function createFixedGrid(columns, children, options = {}) {
 }
 
 /**
- * Create a grid for form selectors (discipline/grade/track dropdowns)
+ * Create a grid for form selectors (discipline/level/track dropdowns)
  * Uses auto-grid-sm (200px min)
  * @param {HTMLElement[]} children - Form control elements
  * @returns {HTMLElement}

package/src/components/radar-chart.js

@@ -8,7 +8,7 @@
 import { RadarChart } from "../lib/radar.js";
 import { div, h3 } from "../lib/render.js";
 import {
-  getSkillLevelIndex,
+  getSkillProficiencyIndex,
   getBehaviourMaturityIndex,
   formatLevel,
 } from "../lib/render.js";
@@ -33,9 +33,9 @@ export function createSkillRadar(skillMatrix, options = {}) {
 
     const data = skillMatrix.map((skill) => ({
       label: skill.skillName,
-      value: getSkillLevelIndex(skill.level),
+      value: getSkillProficiencyIndex(skill.proficiency),
       maxValue: 5,
-      description: `${formatLevel(skill.type)} skill - ${formatLevel(skill.level)}`,
+      description: `${formatLevel(skill.type)} skill - ${formatLevel(skill.proficiency)}`,
     }));
 
     const chart = new RadarChart({

package/src/components/skill-matrix.js

@@ -15,10 +15,10 @@ import {
   td,
   a,
 } from "../lib/render.js";
-import { getSkillLevelIndex } from "../lib/render.js";
+import { getSkillProficiencyIndex } from "../lib/render.js";
 import { createLevelCell } from "./detail.js";
 import { createBadge } from "./card.js";
-import { SKILL_LEVEL_ORDER } from "@forwardimpact/map/levels";
+import { SKILL_PROFICIENCY_ORDER } from "@forwardimpact/map/levels";
 import { truncate } from "../formatters/shared.js";
 
 /**
@@ -28,8 +28,8 @@ import { truncate } from "../formatters/shared.js";
  */
 function sortByLevelDescending(skills) {
   return [...skills].sort((a, b) => {
-    const levelA = SKILL_LEVEL_ORDER.indexOf(a.level);
-    const levelB = SKILL_LEVEL_ORDER.indexOf(b.level);
+    const levelA = SKILL_PROFICIENCY_ORDER.indexOf(a.level);
+    const levelB = SKILL_PROFICIENCY_ORDER.indexOf(b.level);
     if (levelB !== levelA) {
       return levelB - levelA;
     }
@@ -50,7 +50,7 @@ export function createSkillMatrix(skillMatrix) {
   const sortedSkills = sortByLevelDescending(skillMatrix);
 
   const rows = sortedSkills.map((skill) => {
-    const levelIndex = getSkillLevelIndex(skill.level);
+    const levelIndex = getSkillProficiencyIndex(skill.proficiency);
 
     return tr(
       { className: skill.isHumanOnly ? "human-only-row" : "" },
@@ -69,10 +69,10 @@ export function createSkillMatrix(skillMatrix) {
           : null,
       ),
       td({}, createBadge(skill.capability, skill.capability)),
-      createLevelCell(levelIndex, 5, skill.level),
+      createLevelCell(levelIndex, 5, skill.proficiency),
       td(
         { className: "skill-description" },
-        truncate(skill.levelDescription, 80),
+        truncate(skill.proficiencyDescription, 80),
       ),
     );
   });

package/src/css/pages/landing.css

@@ -63,20 +63,20 @@
     margin: 0;
   }
 
-  /* Grades timeline */
-  .grades-timeline {
+  /* Levels timeline */
+  .levels-timeline {
     display: flex;
     flex-direction: column;
     gap: var(--space-md);
   }
 
-  .grade-timeline-item {
+  .level-timeline-item {
     display: flex;
     gap: var(--space-lg);
     align-items: flex-start;
   }
 
-  .grade-level-marker {
+  .level-level-marker {
     width: 50px;
     height: 50px;
     border-radius: 50%;
@@ -90,7 +90,7 @@
     flex-shrink: 0;
   }
 
-  .grade-timeline-content {
+  .level-timeline-content {
     flex: 1;
   }
 }

package/src/formatters/index.js

@@ -55,10 +55,10 @@ export {
   disciplineToMicrodata,
 } from "./discipline/microdata.js";
 
-// Grade formatters
-export { gradeListToMarkdown, gradeToMarkdown } from "./grade/markdown.js";
-export { gradeToDOM } from "./grade/dom.js";
-export { gradeListToMicrodata, gradeToMicrodata } from "./grade/microdata.js";
+// Level formatters
+export { levelListToMarkdown, levelToMarkdown } from "./level/markdown.js";
+export { levelToDOM } from "./level/dom.js";
+export { levelListToMicrodata, levelToMicrodata } from "./level/microdata.js";
 
 // Track formatters
 export { trackListToMarkdown, trackToMarkdown } from "./track/markdown.js";
@@ -75,7 +75,7 @@ export {
   behaviourToJsonLd,
   disciplineToJsonLd,
   trackToJsonLd,
-  gradeToJsonLd,
+  levelToJsonLd,
   driverToJsonLd,
   stageToJsonLd,
 } from "./json-ld.js";

package/src/formatters/interview/shared.js

@@ -108,7 +108,7 @@ function groupQuestionsIntoSections(questions) {
  * @property {string} interviewType - 'mission', 'decomposition', or 'stakeholder'
  * @property {string} disciplineId
  * @property {string} disciplineName
- * @property {string} gradeId
+ * @property {string} levelId
  * @property {string} trackId
  * @property {string} trackName
  * @property {Array} sections
@@ -121,7 +121,7 @@ function groupQuestionsIntoSections(questions) {
  * Prepare interview questions for a job
  * @param {Object} params
  * @param {Object} params.discipline
- * @param {Object} params.grade
+ * @param {Object} params.level
  * @param {Object} params.track
  * @param {Array} params.skills
  * @param {Array} params.behaviours
@@ -131,18 +131,18 @@ function groupQuestionsIntoSections(questions) {
  */
 export function prepareInterviewDetail({
   discipline,
-  grade,
+  level,
   track,
   skills,
   behaviours,
   questions,
   interviewType = "mission",
 }) {
-  if (!discipline || !grade) return null;
+  if (!discipline || !level) return null;
 
   const job = getOrCreateJob({
     discipline,
-    grade,
+    level,
     track,
     skills,
     behaviours,
@@ -208,7 +208,7 @@ export function prepareInterviewDetail({
     interviewType,
     disciplineId: discipline.id,
     disciplineName: discipline.specialization || discipline.name,
-    gradeId: grade.id,
+    levelId: level.id,
     trackId: track?.id || null,
     trackName: track?.name || null,
     sections: allSections,
@@ -231,21 +231,21 @@ export function prepareInterviewDetail({
  * Prepare interview builder preview for form validation
  * @param {Object} params
  * @param {Object|null} params.discipline
- * @param {Object|null} params.grade
+ * @param {Object|null} params.level
  * @param {Object|null} params.track
  * @param {number} params.behaviourCount - Total behaviours in the system
- * @param {Array} [params.grades] - All grades for validation
+ * @param {Array} [params.levels] - All levels for validation
  * @returns {InterviewBuilderPreview}
  */
 export function prepareInterviewBuilderPreview({
   discipline,
-  grade,
+  level,
   track,
   behaviourCount,
-  grades,
+  levels,
 }) {
   // Track is optional (null = generalist)
-  if (!discipline || !grade) {
+  if (!discipline || !level) {
     return {
       isValid: false,
       title: null,
@@ -257,9 +257,9 @@ export function prepareInterviewBuilderPreview({
 
   const validCombination = isValidJobCombination({
     discipline,
-    grade,
+    level,
     track,
-    grades,
+    levels,
   });
 
   if (!validCombination) {
@@ -275,7 +275,7 @@ export function prepareInterviewBuilderPreview({
     };
   }
 
-  const title = generateJobTitle(discipline, grade, track);
+  const title = generateJobTitle(discipline, level, track);
   const totalSkills = getDisciplineSkillIds(discipline).length;
 
   return {
@@ -292,7 +292,7 @@ export function prepareInterviewBuilderPreview({
  * @property {string} title
  * @property {string} disciplineId
  * @property {string} disciplineName
- * @property {string} gradeId
+ * @property {string} levelId
  * @property {string} trackId
  * @property {string} trackName
  * @property {Object.<string, Object>} interviews - Keyed by type
@@ -302,7 +302,7 @@ export function prepareInterviewBuilderPreview({
  * Prepare all interview types for a job (for toggle UI)
  * @param {Object} params
  * @param {Object} params.discipline
- * @param {Object} params.grade
+ * @param {Object} params.level
  * @param {Object} params.track
  * @param {Array} params.skills
  * @param {Array} params.behaviours
@@ -311,18 +311,18 @@ export function prepareInterviewBuilderPreview({
  */
 export function prepareAllInterviews({
   discipline,
-  grade,
+  level,
   track,
   skills,
   behaviours,
   questions,
 }) {
   // Track is optional (null = generalist)
-  if (!discipline || !grade) return null;
+  if (!discipline || !level) return null;
 
   const job = getOrCreateJob({
     discipline,
-    grade,
+    level,
     track,
     skills,
     behaviours,
@@ -350,7 +350,7 @@ export function prepareAllInterviews({
     title: job.title,
     disciplineId: discipline.id,
     disciplineName: discipline.specialization || discipline.name,
-    gradeId: grade.id,
+    levelId: level.id,
     trackId: track?.id || null,
     trackName: track?.name || null,
     interviews: {

package/src/formatters/job/description.js

@@ -18,11 +18,11 @@ import { trimValue, trimFields } from "../shared.js";
  * @param {Object} params
  * @param {Object} params.job - The job definition
  * @param {Object} params.discipline - The discipline
- * @param {Object} params.grade - The grade
+ * @param {Object} params.level - The level
  * @param {Object} [params.track] - The track (optional)
  * @returns {Object} Data object ready for Mustache template
  */
-function prepareJobDescriptionData({ job, discipline, grade, track }) {
+function prepareJobDescriptionData({ job, discipline, level, track }) {
   // Build role summary from discipline - use manager version if applicable
   const isManagement = discipline.isManagement === true;
   let roleSummary =
@@ -81,22 +81,22 @@ function prepareJobDescriptionData({ job, discipline, grade, track }) {
     return indexB - indexA;
   });
 
-  // Build capability skill sections at the highest skill level
+  // Build capability skill sections at the highest skill proficiency
   let capabilitySkills = [];
   const derivedResponsibilities = job.derivedResponsibilities || [];
   if (derivedResponsibilities.length > 0) {
-    // derivedResponsibilities is sorted: highest level first, then by ordinalRank
-    const highestLevel = derivedResponsibilities[0].level;
+    // derivedResponsibilities is sorted: highest proficiency first, then by ordinalRank
+    const highestProficiency = derivedResponsibilities[0].proficiency;
 
-    // Filter responsibilities to only the highest level
+    // Filter responsibilities to only the highest proficiency
     const topResponsibilities = derivedResponsibilities.filter(
-      (r) => r.level === highestLevel,
+      (r) => r.proficiency === highestProficiency,
     );
 
     // Group skill matrix entries by capability at the highest level
     const skillsByCapability = {};
     for (const skill of job.skillMatrix) {
-      if (skill.level !== highestLevel) continue;
+      if (skill.proficiency !== highestProficiency) continue;
       if (!skillsByCapability[skill.capability]) {
         skillsByCapability[skill.capability] = [];
       }
@@ -115,7 +115,7 @@ function prepareJobDescriptionData({ job, discipline, grade, track }) {
           responsibilityDescription: r.responsibility,
           skills: skills.map((s) => ({
             skillName: s.skillName,
-            levelDescription: s.levelDescription || "",
+            proficiencyDescription: s.proficiencyDescription || "",
           })),
         };
       });
@@ -123,9 +123,9 @@ function prepareJobDescriptionData({ job, discipline, grade, track }) {
 
   // Build qualification summary with placeholder replacement
   const qualificationSummary =
-    (grade.qualificationSummary || "").replace(
+    (level.qualificationSummary || "").replace(
       /\{typicalExperienceRange\}/g,
-      grade.typicalExperienceRange || "",
+      level.typicalExperienceRange || "",
     ) || null;
 
   const behaviours = trimFields(sortedBehaviours, {
@@ -137,8 +137,8 @@ function prepareJobDescriptionData({ job, discipline, grade, track }) {
 
   return {
     title: job.title,
-    gradeId: grade.id,
-    typicalExperienceRange: grade.typicalExperienceRange,
+    levelId: level.id,
+    typicalExperienceRange: level.typicalExperienceRange,
     trackName: track?.name || null,
     hasTrack: !!track,
     roleSummary: trimValue(roleSummary),
@@ -151,7 +151,7 @@ function prepareJobDescriptionData({ job, discipline, grade, track }) {
     capabilitySkills: capabilitySkills.map((cap) => ({
       ...cap,
       responsibilityDescription: trimValue(cap.responsibilityDescription),
-      skills: trimFields(cap.skills, { levelDescription: "optional" }),
+      skills: trimFields(cap.skills, { proficiencyDescription: "optional" }),
     })),
     hasCapabilitySkills: capabilitySkills.length > 0,
     qualificationSummary: trimmedQualificationSummary,
@@ -164,15 +164,15 @@ function prepareJobDescriptionData({ job, discipline, grade, track }) {
  * @param {Object} params
  * @param {Object} params.job - The job definition
  * @param {Object} params.discipline - The discipline
- * @param {Object} params.grade - The grade
+ * @param {Object} params.level - The level
  * @param {Object} [params.track] - The track (optional)
  * @param {string} template - Mustache template string
  * @returns {string} Markdown formatted job description
  */
 export function formatJobDescription(
-  { job, discipline, grade, track },
+  { job, discipline, level, track },
   template,
 ) {
-  const data = prepareJobDescriptionData({ job, discipline, grade, track });
+  const data = prepareJobDescriptionData({ job, discipline, level, track });
   return Mustache.render(template, data);
 }

package/src/formatters/job/dom.js

@@ -28,7 +28,7 @@ import { createToolkitTable } from "../toolkit/dom.js";
  * @param {boolean} [options.showJobDescriptionHtml=false] - Whether to show HTML job description (for print)
  * @param {boolean} [options.showJobDescriptionMarkdown=true] - Whether to show copyable markdown section
  * @param {Object} [options.discipline] - Discipline entity for job description
- * @param {Object} [options.grade] - Grade entity for job description
+ * @param {Object} [options.level] - Level entity for job description
  * @param {Object} [options.track] - Track entity for job description
  * @param {string} [options.jobTemplate] - Mustache template for job description
  * @returns {HTMLElement}
@@ -40,12 +40,12 @@ export function jobToDOM(view, options = {}) {
     showJobDescriptionHtml = false,
     showJobDescriptionMarkdown = true,
     discipline,
-    grade,
+    level,
     track,
     jobTemplate,
   } = options;
 
-  const hasEntities = discipline && grade && jobTemplate;
+  const hasEntities = discipline && level && jobTemplate;
 
   return div(
     { className: "job-detail-page" },
@@ -61,7 +61,7 @@ export function jobToDOM(view, options = {}) {
         "Generated from: ",
         a({ href: `#/discipline/${view.disciplineId}` }, view.disciplineName),
         " × ",
-        a({ href: `#/grade/${view.gradeId}` }, view.gradeId),
+        a({ href: `#/level/${view.levelId}` }, view.levelId),
         " × ",
         a({ href: `#/track/${view.trackId}` }, view.trackName),
       ),
@@ -99,7 +99,7 @@ export function jobToDOM(view, options = {}) {
             derivedResponsibilities: view.derivedResponsibilities,
           },
           discipline,
-          grade,
+          level,
           track,
           template: jobTemplate,
         })
@@ -156,7 +156,7 @@ export function jobToDOM(view, options = {}) {
             derivedResponsibilities: view.derivedResponsibilities,
           },
           discipline,
-          grade,
+          level,
           track,
           template: jobTemplate,
         })
@@ -211,7 +211,7 @@ function getScoreColor(score) {
  * @param {Object} params
  * @param {Object} params.job - The job definition
  * @param {Object} params.discipline - The discipline
- * @param {Object} params.grade - The grade
+ * @param {Object} params.level - The level
  * @param {Object} params.track - The track
  * @param {string} params.template - Mustache template for job description
  * @returns {HTMLElement} The job description section element
@@ -219,7 +219,7 @@ function getScoreColor(score) {
 export function createJobDescriptionSection({
   job,
   discipline,
-  grade,
+  level,
   track,
   template,
 }) {
@@ -227,7 +227,7 @@ export function createJobDescriptionSection({
     {
       job,
       discipline,
-      grade,
+      level,
       track,
     },
     template,
@@ -253,7 +253,7 @@ export function createJobDescriptionSection({
  * @param {Object} params
  * @param {Object} params.job - The job definition
  * @param {Object} params.discipline - The discipline
- * @param {Object} params.grade - The grade
+ * @param {Object} params.level - The level
  * @param {Object} params.track - The track
  * @param {string} params.template - Mustache template for job description
  * @returns {HTMLElement} The job description HTML element (print-only)
@@ -261,7 +261,7 @@ export function createJobDescriptionSection({
 export function createJobDescriptionHtml({
   job,
   discipline,
-  grade,
+  level,
   track,
   template,
 }) {
@@ -269,7 +269,7 @@ export function createJobDescriptionHtml({
     {
       job,
       discipline,
-      grade,
+      level,
       track,
     },
     template,