@forwardimpact/pathway 0.20.0 → 0.22.0

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

@@ -10,7 +10,7 @@
 
 import Mustache from "mustache";
 
-import { BEHAVIOUR_MATURITY_ORDER } from "@forwardimpact/schema/levels";
+import { BEHAVIOUR_MATURITY_ORDER } from "@forwardimpact/map/levels";
 import { trimValue, trimFields } from "../shared.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,

package/src/formatters/job/markdown.js

@@ -9,7 +9,7 @@ import {
 } from "../shared.js";
 import { formatLevel } from "../../lib/render.js";
 import { formatJobDescription } from "./description.js";
-import { SKILL_LEVEL_ORDER } from "@forwardimpact/schema/levels";
+import { SKILL_PROFICIENCY_ORDER } from "@forwardimpact/map/levels";
 import { toolkitToMarkdown } from "../toolkit/markdown.js";
 
 /**
@@ -23,7 +23,7 @@ export function jobToMarkdown(view, entities = {}, jobTemplate) {
   const lines = [
     `# ${view.title}`,
     "",
-    `${view.disciplineName} × ${view.gradeId} × ${view.trackName}`,
+    `${view.disciplineName} × ${view.levelId} × ${view.trackName}`,
     "",
   ];
 
@@ -46,8 +46,8 @@ export function jobToMarkdown(view, entities = {}, jobTemplate) {
   // Skill Matrix - sorted by level descending
   lines.push("## Skill Matrix", "");
   const sortedSkills = [...view.skillMatrix].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;
     }
@@ -55,7 +55,7 @@ export function jobToMarkdown(view, entities = {}, jobTemplate) {
   });
   const skillRows = sortedSkills.map((s) => [
     s.skillName,
-    formatLevel(s.level),
+    formatLevel(s.proficiency),
   ]);
   lines.push(tableToMarkdown(["Skill", "Level"], skillRows));
   lines.push("");
@@ -86,7 +86,7 @@ export function jobToMarkdown(view, entities = {}, jobTemplate) {
   }
 
   // Job Description (copyable markdown)
-  if (entities.discipline && entities.grade && jobTemplate) {
+  if (entities.discipline && entities.level && jobTemplate) {
     lines.push("---", "");
     lines.push("## Job Description", "");
     lines.push("```markdown");
@@ -101,7 +101,7 @@ export function jobToMarkdown(view, entities = {}, jobTemplate) {
             derivedResponsibilities: view.derivedResponsibilities,
           },
           discipline: entities.discipline,
-          grade: entities.grade,
+          level: entities.level,
           track: entities.track,
         },
         jobTemplate,

package/src/formatters/json-ld.js

@@ -51,13 +51,13 @@ export function skillToJsonLd(skill, { capabilities = [] } = {}) {
     capability: skill.capability,
     ...(capability && { capabilityName: capability.name }),
     ...(skill.isHumanOnly && { isHumanOnly: true }),
-    levelDescriptions: Object.entries(skill.levelDescriptions || {}).map(
-      ([level, description]) => ({
-        "@type": "SkillLevelDescription",
-        level: `${VOCAB_BASE}${level}`,
-        description,
-      }),
-    ),
+    proficiencyDescriptions: Object.entries(
+      skill.proficiencyDescriptions || {},
+    ).map(([level, description]) => ({
+      "@type": "SkillProficiencyDescription",
+      level: `${VOCAB_BASE}${level}`,
+      description,
+    })),
   };
 }
 
@@ -147,29 +147,29 @@ export function trackToJsonLd(track) {
 }
 
 /**
- * Generate JSON-LD for a grade entity
- * @param {Object} grade - Raw grade entity
+ * Generate JSON-LD for a level entity
+ * @param {Object} level - Raw level entity
  * @returns {Object}
  */
-export function gradeToJsonLd(grade) {
+export function levelToJsonLd(level) {
   return {
-    ...baseJsonLd("Grade", grade.id),
-    identifier: grade.id,
-    name: grade.displayName || grade.name,
-    ...(grade.ordinalRank && { ordinalRank: grade.ordinalRank }),
-    ...(grade.typicalExperienceRange && {
-      typicalExperienceRange: grade.typicalExperienceRange,
+    ...baseJsonLd("Level", level.id),
+    identifier: level.id,
+    name: level.displayName || level.name,
+    ...(level.ordinalRank && { ordinalRank: level.ordinalRank }),
+    ...(level.typicalExperienceRange && {
+      typicalExperienceRange: level.typicalExperienceRange,
     }),
-    ...(grade.baseSkillLevels && {
-      baseSkillLevels: {
-        "@type": "BaseSkillLevels",
-        primary: `${VOCAB_BASE}${grade.baseSkillLevels.primary}`,
-        secondary: `${VOCAB_BASE}${grade.baseSkillLevels.secondary}`,
-        broad: `${VOCAB_BASE}${grade.baseSkillLevels.broad}`,
+    ...(level.baseSkillProficiencies && {
+      baseSkillProficiencies: {
+        "@type": "BaseSkillProficiencies",
+        primary: `${VOCAB_BASE}${level.baseSkillProficiencies.primary}`,
+        secondary: `${VOCAB_BASE}${level.baseSkillProficiencies.secondary}`,
+        broad: `${VOCAB_BASE}${level.baseSkillProficiencies.broad}`,
       },
     }),
-    ...(grade.baseBehaviourMaturity && {
-      baseBehaviourMaturity: `${VOCAB_BASE}${grade.baseBehaviourMaturity}`,
+    ...(level.baseBehaviourMaturity && {
+      baseBehaviourMaturity: `${VOCAB_BASE}${level.baseBehaviourMaturity}`,
     }),
   };
 }

package/src/formatters/{grade → level}/dom.js

@@ -1,5 +1,5 @@
 /**
- * Grade formatting for DOM output
+ * Level formatting for DOM output
  */
 
 import {
@@ -19,33 +19,33 @@ import {
 import { createBackLink } from "../../components/nav.js";
 import { createLevelDots } from "../../components/detail.js";
 import {
-  SKILL_LEVEL_ORDER,
+  SKILL_PROFICIENCY_ORDER,
   BEHAVIOUR_MATURITY_ORDER,
   getConceptEmoji,
-} from "@forwardimpact/schema/levels";
+} from "@forwardimpact/map/levels";
 import { createJobBuilderButton } from "../../components/action-buttons.js";
-import { prepareGradeDetail } from "./shared.js";
-import { createJsonLdScript, gradeToJsonLd } from "../json-ld.js";
+import { prepareLevelDetail } from "./shared.js";
+import { createJsonLdScript, levelToJsonLd } from "../json-ld.js";
 
 /**
- * Format grade detail as DOM elements
- * @param {Object} grade - Raw grade entity
+ * Format level detail as DOM elements
+ * @param {Object} level - Raw level entity
  * @param {Object} options - Formatting options
  * @param {Object} [options.framework] - Framework config for emojis
  * @param {boolean} [options.showBackLink=true] - Whether to show back navigation link
  * @returns {HTMLElement}
  */
-export function gradeToDOM(grade, { framework, showBackLink = true } = {}) {
-  const view = prepareGradeDetail(grade);
-  const emoji = framework ? getConceptEmoji(framework, "grade") : "📊";
+export function levelToDOM(level, { framework, showBackLink = true } = {}) {
+  const view = prepareLevelDetail(level);
+  const emoji = framework ? getConceptEmoji(framework, "level") : "📊";
   return div(
-    { className: "detail-page grade-detail" },
+    { className: "detail-page level-detail" },
     // JSON-LD structured data
-    createJsonLdScript(gradeToJsonLd(grade)),
+    createJsonLdScript(levelToJsonLd(level)),
     // Header
     div(
       { className: "page-header" },
-      showBackLink ? createBackLink("/grade", "← Back to Grades") : null,
+      showBackLink ? createBackLink("/level", "← Back to Levels") : null,
       heading1({ className: "page-title" }, `${emoji} `, view.displayName),
       div(
         { className: "page-meta" },
@@ -61,8 +61,8 @@ export function gradeToDOM(grade, { framework, showBackLink = true } = {}) {
         ? div(
             { className: "page-actions" },
             createJobBuilderButton({
-              paramName: "grade",
-              paramValue: grade.id,
+              paramName: "level",
+              paramValue: level.id,
             }),
           )
         : null,
@@ -111,15 +111,15 @@ export function gradeToDOM(grade, { framework, showBackLink = true } = {}) {
         )
       : null,
 
-    // Base Skill Levels and Base Behaviour Maturity in two columns
+    // Base Skill Proficiencies and Base Behaviour Maturity in two columns
     div(
       { className: "detail-section" },
       div(
         { className: "content-columns" },
-        // Base Skill Levels column
+        // Base Skill Proficiencies column
         div(
           { className: "column" },
-          heading2({ className: "section-title" }, "Base Skill Levels"),
+          heading2({ className: "section-title" }, "Base Skill Proficiencies"),
           table(
             { className: "level-table" },
             thead({}, tr({}, th({}, "Type"), th({}, "Level"))),
@@ -130,10 +130,12 @@ export function gradeToDOM(grade, { framework, showBackLink = true } = {}) {
                 td({}, span({ className: "badge badge-primary" }, "Primary")),
                 td(
                   {},
-                  view.baseSkillLevels?.primary
+                  view.baseSkillProficiencies?.primary
                     ? createLevelDots(
-                        SKILL_LEVEL_ORDER.indexOf(view.baseSkillLevels.primary),
-                        SKILL_LEVEL_ORDER.length,
+                        SKILL_PROFICIENCY_ORDER.indexOf(
+                          view.baseSkillProficiencies.primary,
+                        ),
+                        SKILL_PROFICIENCY_ORDER.length,
                       )
                     : span({ className: "text-muted" }, "—"),
                 ),
@@ -146,12 +148,12 @@ export function gradeToDOM(grade, { framework, showBackLink = true } = {}) {
                 ),
                 td(
                   {},
-                  view.baseSkillLevels?.secondary
+                  view.baseSkillProficiencies?.secondary
                     ? createLevelDots(
-                        SKILL_LEVEL_ORDER.indexOf(
-                          view.baseSkillLevels.secondary,
+                        SKILL_PROFICIENCY_ORDER.indexOf(
+                          view.baseSkillProficiencies.secondary,
                         ),
-                        SKILL_LEVEL_ORDER.length,
+                        SKILL_PROFICIENCY_ORDER.length,
                       )
                     : span({ className: "text-muted" }, "—"),
                 ),
@@ -161,10 +163,12 @@ export function gradeToDOM(grade, { framework, showBackLink = true } = {}) {
                 td({}, span({ className: "badge badge-broad" }, "Broad")),
                 td(
                   {},
-                  view.baseSkillLevels?.broad
+                  view.baseSkillProficiencies?.broad
                     ? createLevelDots(
-                        SKILL_LEVEL_ORDER.indexOf(view.baseSkillLevels.broad),
-                        SKILL_LEVEL_ORDER.length,
+                        SKILL_PROFICIENCY_ORDER.indexOf(
+                          view.baseSkillProficiencies.broad,
+                        ),
+                        SKILL_PROFICIENCY_ORDER.length,
                       )
                     : span({ className: "text-muted" }, "—"),
                 ),