@forwardimpact/pathway 0.21.0 → 0.22.0

package/src/slide-main.js

@@ -18,7 +18,7 @@ import { renderSkillSlide } from "./slides/skill.js";
 import { renderBehaviourSlide } from "./slides/behaviour.js";
 import { renderDriverSlide } from "./slides/driver.js";
 import { renderDisciplineSlide } from "./slides/discipline.js";
-import { renderGradeSlide } from "./slides/grade.js";
+import { renderLevelSlide } from "./slides/level.js";
 import { renderTrackSlide } from "./slides/track.js";
 import { renderJobSlide } from "./slides/job.js";
 import { renderInterviewSlide } from "./slides/interview.js";
@@ -140,9 +140,9 @@ function setupRoutes() {
     });
   });
 
-  // Grades
-  router.on("/grade/:id", (params) => {
-    renderGradeSlide({ render: renderSlide, data: getState().data, params });
+  // Levels
+  router.on("/level/:id", (params) => {
+    renderLevelSlide({ render: renderSlide, data: getState().data, params });
   });
 
   // Tracks
@@ -150,12 +150,12 @@ function setupRoutes() {
     renderTrackSlide({ render: renderSlide, data: getState().data, params });
   });
 
-  // Jobs - new format: discipline/grade/track (track optional)
-  router.on("/job/:discipline/:grade/:track", (params) => {
+  // Jobs - new format: discipline/level/track (track optional)
+  router.on("/job/:discipline/:level/:track", (params) => {
     renderJobSlide({ render: renderSlide, data: getState().data, params });
   });
 
-  router.on("/job/:discipline/:grade", (params) => {
+  router.on("/job/:discipline/:level", (params) => {
     renderJobSlide({
       render: renderSlide,
       data: getState().data,
@@ -163,8 +163,8 @@ function setupRoutes() {
     });
   });
 
-  // Interviews - new format: discipline/grade/track (track optional)
-  router.on("/interview/:discipline/:grade/:track", (params) => {
+  // Interviews - new format: discipline/level/track (track optional)
+  router.on("/interview/:discipline/:level/:track", (params) => {
     renderInterviewSlide({
       render: renderSlide,
       data: getState().data,
@@ -172,7 +172,7 @@ function setupRoutes() {
     });
   });
 
-  router.on("/interview/:discipline/:grade", (params) => {
+  router.on("/interview/:discipline/:level", (params) => {
     renderInterviewSlide({
       render: renderSlide,
       data: getState().data,
@@ -180,12 +180,12 @@ function setupRoutes() {
     });
   });
 
-  // Progress - new format: discipline/grade/track (track optional)
-  router.on("/progress/:discipline/:grade/:track", (params) => {
+  // Progress - new format: discipline/level/track (track optional)
+  router.on("/progress/:discipline/:level/:track", (params) => {
     renderProgressSlide({ render: renderSlide, data: getState().data, params });
   });
 
-  router.on("/progress/:discipline/:grade", (params) => {
+  router.on("/progress/:discipline/:level", (params) => {
     renderProgressSlide({
       render: renderSlide,
       data: getState().data,
@@ -211,15 +211,15 @@ function buildSlideOrder(data) {
     data.disciplines.forEach((d) => order.push(`/discipline/${d.id}`));
   }
 
-  // Grades (moved before Tracks)
-  if (data.grades && data.grades.length > 0) {
+  // Levels (moved before Tracks)
+  if (data.levels && data.levels.length > 0) {
     boundaries.push(order.length);
-    order.push("/chapter/grade");
-    order.push("/overview/grade");
-    data.grades.forEach((g) => order.push(`/grade/${g.id}`));
+    order.push("/chapter/level");
+    order.push("/overview/level");
+    data.levels.forEach((g) => order.push(`/level/${g.id}`));
   }
 
-  // Tracks (moved after Grades)
+  // Tracks (moved after Levels)
   if (data.tracks && data.tracks.length > 0) {
     boundaries.push(order.length);
     order.push("/chapter/track");
@@ -254,7 +254,7 @@ function buildSlideOrder(data) {
   // Jobs
   const jobs = generateAllJobs({
     disciplines: data.disciplines,
-    grades: data.grades,
+    levels: data.levels,
     tracks: data.tracks,
     skills: data.skills,
     behaviours: data.behaviours,
@@ -267,8 +267,8 @@ function buildSlideOrder(data) {
     jobs.forEach((job) =>
       order.push(
         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}`,
       ),
     );
   }

package/src/slides/chapter.js

@@ -38,10 +38,10 @@ export function renderChapterSlide({ render, data, params }) {
       emojiIcon: framework.entityDefinitions.discipline.emojiIcon,
       description: framework.entityDefinitions.discipline.description,
     },
-    grade: {
-      title: framework.entityDefinitions.grade.title,
-      emojiIcon: framework.entityDefinitions.grade.emojiIcon,
-      description: framework.entityDefinitions.grade.description,
+    level: {
+      title: framework.entityDefinitions.level.title,
+      emojiIcon: framework.entityDefinitions.level.emojiIcon,
+      description: framework.entityDefinitions.level.description,
     },
     track: {
       title: framework.entityDefinitions.track.title,

package/src/slides/index.js

@@ -55,25 +55,25 @@ export function renderSlideIndex({ render, data }) {
       ),
     ),
 
-    // Grades
+    // Levels
     div(
       { className: "slide-section" },
       a(
-        { href: "#/overview/grade" },
+        { href: "#/overview/level" },
         heading2(
           { className: "slide-section-title" },
-          `${getConceptEmoji(data.framework, "grade")} `,
-          span({ className: "gradient-text" }, "Grades"),
+          `${getConceptEmoji(data.framework, "level")} `,
+          span({ className: "gradient-text" }, "Levels"),
         ),
       ),
       ul(
         { className: "related-list" },
-        ...data.grades.map((grade) =>
+        ...data.levels.map((level) =>
           li(
             {},
             a(
-              { href: `#/grade/${grade.id}` },
-              `${grade.id} - ${grade.professionalTitle}`,
+              { href: `#/level/${level.id}` },
+              `${level.id} - ${level.professionalTitle}`,
             ),
           ),
         ),
@@ -174,7 +174,7 @@ export function renderSlideIndex({ render, data }) {
         { className: "related-list" },
         ...generateAllJobs({
           disciplines: data.disciplines,
-          grades: data.grades,
+          levels: data.levels,
           tracks: data.tracks,
           skills: data.skills,
           behaviours: data.behaviours,
@@ -185,8 +185,8 @@ export function renderSlideIndex({ render, 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,
             ),

package/src/slides/interview.js

@@ -20,7 +20,7 @@ import { interviewToDOM } from "../formatters/index.js";
  */
 export function renderInterviewSlide({ render, data, params }) {
   const discipline = data.disciplines.find((d) => d.id === params.discipline);
-  const grade = data.grades.find((g) => g.id === params.grade);
+  const level = data.levels.find((g) => g.id === params.level);
   const track = data.tracks.find((t) => t.id === params.track);
 
   // Get interview type from URL query or default to full
@@ -29,7 +29,7 @@ export function renderInterviewSlide({ render, data, params }) {
 
   const view = prepareInterviewDetail({
     discipline,
-    grade,
+    level,
     track,
     skills: data.skills,
     behaviours: data.behaviours,

package/src/slides/job.js

@@ -17,12 +17,12 @@ import { jobToDOM } from "../formatters/index.js";
  */
 export function renderJobSlide({ render, data, params }) {
   const discipline = data.disciplines.find((d) => d.id === params.discipline);
-  const grade = data.grades.find((g) => g.id === params.grade);
+  const level = data.levels.find((g) => g.id === params.level);
   const track = data.tracks.find((t) => t.id === params.track);
 
   const view = prepareJobDetail({
     discipline,
-    grade,
+    level,
     track,
     skills: data.skills,
     behaviours: data.behaviours,
@@ -49,7 +49,7 @@ export function renderJobSlide({ render, data, params }) {
       showJobDescriptionHtml: true,
       showJobDescriptionMarkdown: false,
       discipline,
-      grade,
+      level,
       track,
     }),
   );

package/src/slides/level.js

@@ -0,0 +1,32 @@
+/**
+ * Level Slide View
+ *
+ * Printer-friendly view of a level.
+ */
+
+import { div, h1, p } from "../lib/render.js";
+import { levelToDOM } from "../formatters/index.js";
+
+/**
+ * Render level slide
+ * @param {Object} params
+ * @param {Function} params.render
+ * @param {Object} params.data
+ * @param {Object} params.params
+ */
+export function renderLevelSlide({ render, data, params }) {
+  const level = data.levels.find((g) => g.id === params.id);
+
+  if (!level) {
+    render(
+      div(
+        { className: "slide-error" },
+        h1({}, "Level Not Found"),
+        p({}, `No level found with ID: ${params.id}`),
+      ),
+    );
+    return;
+  }
+
+  render(levelToDOM(level, { framework: data.framework, showBackLink: false }));
+}

package/src/slides/overview.js

@@ -12,7 +12,7 @@ import {
   skillToCardConfig,
   behaviourToCardConfig,
   driverToCardConfig,
-  gradeToCardConfig,
+  levelToCardConfig,
   trackToCardConfig,
   jobToCardConfig,
 } from "../lib/card-mappers.js";
@@ -20,7 +20,7 @@ import { prepareDisciplinesList } from "../formatters/discipline/shared.js";
 import { prepareSkillsList } from "../formatters/skill/shared.js";
 import { prepareBehavioursList } from "../formatters/behaviour/shared.js";
 import { prepareDriversList } from "../formatters/driver/shared.js";
-import { prepareGradesList } from "../formatters/grade/shared.js";
+import { prepareLevelsList } from "../formatters/level/shared.js";
 import { prepareTracksList } from "../formatters/track/shared.js";
 import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
 
@@ -92,12 +92,12 @@ export function renderOverviewSlide({ render, data, params }) {
       mapper: disciplineToCardConfig,
       isGrouped: true,
     },
-    grade: {
-      title: framework.entityDefinitions.grade.title,
-      emojiIcon: framework.entityDefinitions.grade.emojiIcon,
-      description: framework.entityDefinitions.grade.description,
-      entities: prepareGradesList(data.grades).items,
-      mapper: gradeToCardConfig,
+    level: {
+      title: framework.entityDefinitions.level.title,
+      emojiIcon: framework.entityDefinitions.level.emojiIcon,
+      description: framework.entityDefinitions.level.description,
+      entities: prepareLevelsList(data.levels).items,
+      mapper: levelToCardConfig,
     },
     track: {
       title: framework.entityDefinitions.track.title,
@@ -112,7 +112,7 @@ export function renderOverviewSlide({ render, data, params }) {
       description: framework.entityDefinitions.job.description,
       entities: generateAllJobs({
         disciplines: data.disciplines,
-        grades: data.grades,
+        levels: data.levels,
         tracks: data.tracks,
         skills: data.skills,
         behaviours: data.behaviours,

package/src/slides/progress.js

@@ -7,7 +7,7 @@
 import { div, h1, p } from "../lib/render.js";
 import {
   prepareProgressDetail,
-  getDefaultTargetGrade,
+  getDefaultTargetLevel,
 } from "../formatters/progress/shared.js";
 import { progressToDOM } from "../formatters/index.js";
 
@@ -20,12 +20,12 @@ import { progressToDOM } from "../formatters/index.js";
  */
 export function renderProgressSlide({ render, data, params }) {
   const discipline = data.disciplines.find((d) => d.id === params.discipline);
-  const grade = data.grades.find((g) => g.id === params.grade);
+  const level = data.levels.find((g) => g.id === params.level);
   const track = params.track
     ? data.tracks.find((t) => t.id === params.track)
     : null;
 
-  if (!discipline || !grade) {
+  if (!discipline || !level) {
     render(
       div(
         { className: "slide-error" },
@@ -36,23 +36,23 @@ export function renderProgressSlide({ render, data, params }) {
     return;
   }
 
-  // Get compare grade from URL query or default to next grade
+  // Get compare level from URL query or default to next level
   const urlParams = new URLSearchParams(window.location.search);
-  const compareGradeId = urlParams.get("compare");
+  const compareLevelId = urlParams.get("compare");
 
-  let targetGrade;
-  if (compareGradeId) {
-    targetGrade = data.grades.find((g) => g.id === compareGradeId);
+  let targetLevel;
+  if (compareLevelId) {
+    targetLevel = data.levels.find((g) => g.id === compareLevelId);
   } else {
-    targetGrade = getDefaultTargetGrade(grade, data.grades);
+    targetLevel = getDefaultTargetLevel(level, data.levels);
   }
 
-  if (!targetGrade) {
+  if (!targetLevel) {
     render(
       div(
         { className: "slide-error" },
         h1({}, "No Progression Available"),
-        p({}, "No next grade available for this role."),
+        p({}, "No next level available for this role."),
       ),
     );
     return;
@@ -60,10 +60,10 @@ export function renderProgressSlide({ render, data, params }) {
 
   const view = prepareProgressDetail({
     fromDiscipline: discipline,
-    fromGrade: grade,
+    fromLevel: level,
     fromTrack: track,
     toDiscipline: discipline,
-    toGrade: targetGrade,
+    toLevel: targetLevel,
     toTrack: track,
     skills: data.skills,
     behaviours: data.behaviours,

package/src/types.js

@@ -19,7 +19,7 @@
  * @property {boolean} [humanOnly] - Whether this skill requires human presence
  * @property {'primary'|'secondary'|'tertiary'} type - Skill type in this role
  * @property {string} level - Level ID (e.g., "advanced", "expert")
- * @property {string} levelDescription - Human-readable level description
+ * @property {string} proficiencyDescription - Human-readable level description
  */
 
 // ============================================================================

package/templates/job.template.md

@@ -1,6 +1,6 @@
 # {{{title}}}
 
-- **Level:** {{{gradeId}}}
+- **Level:** {{{levelId}}}
 - **Experience:** {{{typicalExperienceRange}}}
 {{#hasTrack}}- **Track:** {{{trackName}}}
 {{/hasTrack}}
@@ -34,7 +34,7 @@
 {{{responsibilityDescription}}}:
 
 {{#skills}}
-- **{{{skillName}}}:** {{{levelDescription}}}
+- **{{{skillName}}}:** {{{proficiencyDescription}}}
 {{/skills}}
 {{/capabilitySkills}}
 {{/hasCapabilitySkills}}

package/src/commands/grade.js

@@ -1,60 +0,0 @@
-/**
- * Grade CLI Command
- *
- * Handles grade summary, listing, and detail display in the terminal.
- *
- * Usage:
- *   npx pathway grade              # Summary with stats
- *   npx pathway grade --list       # IDs only (for piping)
- *   npx pathway grade <id>         # Detail view
- *   npx pathway grade --validate   # Validation checks
- */
-
-import { createEntityCommand } from "./command-factory.js";
-import { gradeToMarkdown } from "../formatters/grade/markdown.js";
-import { formatTable } from "../lib/cli-output.js";
-import { getConceptEmoji } from "@forwardimpact/map/levels";
-import { capitalize } from "../formatters/shared.js";
-
-/**
- * Format grade summary output
- * @param {Array} grades - Raw grade entities
- * @param {Object} data - Full data context
- */
-function formatSummary(grades, data) {
-  const { framework } = data;
-  const emoji = framework ? getConceptEmoji(framework, "grade") : "📊";
-
-  console.log(`\n${emoji} Grades\n`);
-
-  const rows = grades.map((g) => [
-    g.id,
-    g.displayName || g.id,
-    g.typicalExperienceRange || "-",
-    capitalize(g.baseSkillLevels?.primary || "-"),
-  ]);
-
-  console.log(formatTable(["ID", "Name", "Experience", "Primary Level"], rows));
-  console.log(`\nTotal: ${grades.length} grades`);
-  console.log(`\nRun 'npx pathway grade --list' for IDs`);
-  console.log(`Run 'npx pathway grade <id>' for details\n`);
-}
-
-/**
- * Format grade detail output
- * @param {Object} grade - Raw grade entity
- * @param {Object} framework - Framework config
- */
-function formatDetail(grade, framework) {
-  console.log(gradeToMarkdown(grade, framework));
-}
-
-export const runGradeCommand = createEntityCommand({
-  entityName: "grade",
-  pluralName: "grades",
-  findEntity: (data, id) => data.grades.find((g) => g.id === id),
-  presentDetail: (entity) => entity,
-  formatSummary,
-  formatDetail,
-  emojiIcon: "📊",
-});

package/src/formatters/grade/shared.js

@@ -1,86 +0,0 @@
-/**
- * Grade presentation helpers
- *
- * Shared utilities for formatting grade data across DOM and markdown outputs.
- */
-
-/**
- * Get grade display name (shows both professional and management titles)
- * @param {Object} grade
- * @returns {string}
- */
-export function getGradeDisplayName(grade) {
-  if (grade.professionalTitle && grade.managementTitle) {
-    if (grade.professionalTitle === grade.managementTitle) {
-      return grade.professionalTitle;
-    }
-    return `${grade.professionalTitle} / ${grade.managementTitle}`;
-  }
-  return grade.professionalTitle || grade.managementTitle || grade.id;
-}
-
-/**
- * @typedef {Object} GradeListItem
- * @property {string} id
- * @property {string} displayName
- * @property {number} ordinalRank
- * @property {string|null} typicalExperienceRange
- * @property {Object} baseSkillLevels
- * @property {string|null} impactScope
- */
-
-/**
- * Transform grades for list view
- * @param {Array} grades - Raw grade entities
- * @returns {{ items: GradeListItem[] }}
- */
-export function prepareGradesList(grades) {
-  const sortedGrades = [...grades].sort(
-    (a, b) => a.ordinalRank - b.ordinalRank,
-  );
-
-  const items = sortedGrades.map((grade) => ({
-    id: grade.id,
-    displayName: getGradeDisplayName(grade),
-    ordinalRank: grade.ordinalRank,
-    typicalExperienceRange: grade.typicalExperienceRange || null,
-    baseSkillLevels: grade.baseSkillLevels || {},
-    impactScope: grade.expectations?.impactScope || null,
-  }));
-
-  return { items };
-}
-
-/**
- * @typedef {Object} GradeDetailView
- * @property {string} id
- * @property {string} displayName
- * @property {string} professionalTitle
- * @property {string} managementTitle
- * @property {number} ordinalRank
- * @property {string|null} typicalExperienceRange
- * @property {Object} baseSkillLevels
- * @property {Object} baseBehaviourMaturity
- * @property {Object} expectations
- */
-
-/**
- * Transform grade for detail view
- * @param {Object} grade - Raw grade entity
- * @returns {GradeDetailView|null}
- */
-export function prepareGradeDetail(grade) {
-  if (!grade) return null;
-
-  return {
-    id: grade.id,
-    displayName: getGradeDisplayName(grade),
-    professionalTitle: grade.professionalTitle || null,
-    managementTitle: grade.managementTitle || null,
-    ordinalRank: grade.ordinalRank,
-    typicalExperienceRange: grade.typicalExperienceRange || null,
-    baseSkillLevels: grade.baseSkillLevels || {},
-    baseBehaviourMaturity: grade.baseBehaviourMaturity || {},
-    expectations: grade.expectations || {},
-  };
-}

package/src/pages/grade.js

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