@forwardimpact/pathway 0.20.0 → 0.22.0

package/src/commands/progress.js

@@ -4,15 +4,15 @@
  * Shows career progression analysis in the terminal.
  *
  * Usage:
- *   npx pathway progress <discipline> <grade>                            # Progress for trackless job
- *   npx pathway progress <discipline> <grade> --track=<track>            # Progress with track
- *   npx pathway progress <discipline> <from_grade> --compare=<to_grade>  # Compare grades
+ *   npx pathway progress <discipline> <level>                            # Progress for trackless job
+ *   npx pathway progress <discipline> <level> --track=<track>            # Progress with track
+ *   npx pathway progress <discipline> <from_level> --compare=<to_level>  # Compare levels
  */
 
 import { createCompositeCommand } from "./command-factory.js";
 import {
   prepareProgressDetail,
-  getDefaultTargetGrade,
+  getDefaultTargetLevel,
 } from "../formatters/progress/shared.js";
 import { progressToMarkdown } from "../formatters/progress/markdown.js";
 
@@ -26,53 +26,53 @@ function formatProgress(view) {
 
 export const runProgressCommand = createCompositeCommand({
   commandName: "progress",
-  requiredArgs: ["discipline_id", "grade_id"],
+  requiredArgs: ["discipline_id", "level_id"],
   findEntities: (data, args, options) => {
     const discipline = data.disciplines.find((d) => d.id === args[0]);
-    const grade = data.grades.find((g) => g.id === args[1]);
+    const level = data.levels.find((g) => g.id === args[1]);
     const track = options.track
       ? data.tracks.find((t) => t.id === options.track)
       : null;
 
-    let targetGrade;
+    let targetLevel;
     if (options.compare) {
-      targetGrade = data.grades.find((g) => g.id === options.compare);
-      if (!targetGrade) {
-        console.error(`Target grade not found: ${options.compare}`);
+      targetLevel = data.levels.find((g) => g.id === options.compare);
+      if (!targetLevel) {
+        console.error(`Target level not found: ${options.compare}`);
         process.exit(1);
       }
     } else {
-      targetGrade = getDefaultTargetGrade(grade, data.grades);
-      if (!targetGrade) {
-        console.error("No next grade available for progression.");
+      targetLevel = getDefaultTargetLevel(level, data.levels);
+      if (!targetLevel) {
+        console.error("No next level available for progression.");
         process.exit(1);
       }
     }
 
-    return { discipline, grade, track, targetGrade };
+    return { discipline, level, track, targetLevel };
   },
   validateEntities: (entities, _data, options) => {
     if (!entities.discipline) {
       return `Discipline not found`;
     }
-    if (!entities.grade) {
-      return `Grade not found`;
+    if (!entities.level) {
+      return `Level not found`;
     }
     if (options.track && !entities.track) {
       return `Track not found: ${options.track}`;
     }
-    if (!entities.targetGrade) {
-      return `Target grade not found`;
+    if (!entities.targetLevel) {
+      return `Target level not found`;
     }
     return null;
   },
   presenter: (entities, data) =>
     prepareProgressDetail({
       fromDiscipline: entities.discipline,
-      fromGrade: entities.grade,
+      fromLevel: entities.level,
       fromTrack: entities.track,
       toDiscipline: entities.discipline,
-      toGrade: entities.targetGrade,
+      toLevel: entities.targetLevel,
       toTrack: entities.track,
       skills: data.skills,
       behaviours: data.behaviours,

package/src/commands/questions.js

@@ -49,7 +49,7 @@ function showQuestionsSummary(data) {
   console.log(`\n❓ Questions\n`);
 
   // Skill questions by level
-  const skillLevels = [
+  const skillProficiencies = [
     "awareness",
     "foundational",
     "working",
@@ -57,10 +57,10 @@ function showQuestionsSummary(data) {
     "expert",
   ];
   const roleTypes = ["professionalQuestions", "managementQuestions"];
-  const skillRows = skillLevels.map((level) => {
+  const skillRows = skillProficiencies.map((level) => {
     let count = 0;
     for (const skill of skills) {
-      const sq = questions.skillLevels?.[skill.id];
+      const sq = questions.skillProficiencies?.[skill.id];
       if (sq) {
         for (const roleType of roleTypes) {
           count += (sq[roleType]?.[level] || []).length;

package/src/commands/skill.js

@@ -14,7 +14,7 @@
 import { createEntityCommand } from "./command-factory.js";
 import { skillToMarkdown } from "../formatters/skill/markdown.js";
 import { prepareSkillsList } from "../formatters/skill/shared.js";
-import { getConceptEmoji } from "@forwardimpact/schema/levels";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
 import { formatTable, formatError } from "../lib/cli-output.js";
 import { generateSkillMarkdown } from "@forwardimpact/libpathway/agent";
 import { formatAgentSkill } from "../formatters/agent/skill.js";

package/src/commands/track.js

@@ -14,7 +14,7 @@ import { createEntityCommand } from "./command-factory.js";
 import { trackToMarkdown } from "../formatters/track/markdown.js";
 import { sortTracksByName } from "../formatters/track/shared.js";
 import { formatTable } from "../lib/cli-output.js";
-import { getConceptEmoji } from "@forwardimpact/schema/levels";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
 
 /**
  * Format track summary output

package/src/commands/update.js

@@ -3,20 +3,21 @@
  *
  * Re-downloads the distribution bundle from the published site URL
  * and updates the local ~/.fit/pathway/ installation.
+ * Updates the global @forwardimpact/pathway package if the version changed.
  */
 
 import { cp, mkdir, rm, readFile, writeFile, access } from "fs/promises";
 import { join } from "path";
 import { homedir } from "os";
 import { execFileSync, execSync } from "child_process";
-import { loadFrameworkConfig } from "@forwardimpact/schema/loader";
+import { loadFrameworkConfig } from "@forwardimpact/map/loader";
 
 const INSTALL_DIR = join(homedir(), ".fit", "pathway");
 
 /**
  * Run the update command.
  * Reads siteUrl from the installed framework.yaml, re-downloads the bundle,
- * extracts data, and runs npm install to update dependencies.
+ * extracts data, and updates the global pathway package if the version changed.
  *
  * @param {Object} params - Command parameters
  * @param {string} params.dataDir - Path to data directory (may be the installed one)
@@ -82,7 +83,7 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
     ]);
     console.log("   ✓ Extracted");
 
-    // 3. Compare versions
+    // 3. Compare versions from bundle's package.json (version manifest)
     const newPkgPath = join(extractDir, "package.json");
     const oldPkgPath = join(INSTALL_DIR, "package.json");
     const newPkg = JSON.parse(await readFile(newPkgPath, "utf8"));
@@ -104,21 +105,18 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
     await cp(join(extractDir, "data"), installDataDir, { recursive: true });
     console.log("   ✓ Data updated");
 
-    // 5. Update package.json if version changed
+    // 5. Update version manifest
+    await writeFile(oldPkgPath, JSON.stringify(newPkg, null, 2) + "\n");
+
+    // 6. Update global pathway package if version changed
     if (oldVersion !== newVersion) {
       console.log(`   Updating pathway ${oldVersion} → ${newVersion}...`);
-      await writeFile(oldPkgPath, JSON.stringify(newPkg, null, 2) + "\n");
-      console.log("   ✓ package.json updated");
+      execSync(`npm install -g @forwardimpact/pathway@${newVersion}`, {
+        stdio: "ignore",
+      });
+      console.log("   ✓ Global package updated");
     }
 
-    // 6. Run npm install
-    console.log("   Installing dependencies...");
-    execSync("npm install --production --ignore-scripts --no-audit --no-fund", {
-      cwd: INSTALL_DIR,
-      stdio: "ignore",
-    });
-    console.log("   ✓ Dependencies installed");
-
     // 7. Report
     console.log(`
 ✅ Update complete!

package/src/components/action-buttons.js

@@ -30,7 +30,7 @@ export function createNavButton({ label, href, variant = "primary" }) {
 /**
  * Create a button to navigate to job builder with a parameter
  * @param {Object} options - Configuration options
- * @param {string} options.paramName - Parameter name (discipline, grade, track)
+ * @param {string} options.paramName - Parameter name (discipline, level, track)
  * @param {string} options.paramValue - Parameter value (the ID)
  * @param {string} [options.label] - Optional custom label
  * @returns {HTMLElement}
@@ -38,7 +38,7 @@ export function createNavButton({ label, href, variant = "primary" }) {
 export function createJobBuilderButton({ paramName, paramValue, label }) {
   const defaultLabels = {
     discipline: "Build Job with this Discipline →",
-    grade: "Build Job at this Grade →",
+    level: "Build Job at this Level →",
     track: "Build Job with this Track →",
   };
 
@@ -52,7 +52,7 @@ export function createJobBuilderButton({ paramName, paramValue, label }) {
 /**
  * Create a button to navigate to interview prep with a parameter
  * @param {Object} options - Configuration options
- * @param {string} options.paramName - Parameter name (discipline, grade, track)
+ * @param {string} options.paramName - Parameter name (discipline, level, track)
  * @param {string} options.paramValue - Parameter value (the ID)
  * @param {string} [options.label] - Optional custom label
  * @returns {HTMLElement}

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/checklist.js

@@ -6,7 +6,7 @@
  */
 
 import { div, span, details, summary } from "../lib/render.js";
-import { getCapabilityEmoji } from "@forwardimpact/schema/levels";
+import { getCapabilityEmoji } from "@forwardimpact/map/levels";
 
 /**
  * Create checklist display grouped by capability

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,9 +21,9 @@ 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/schema/levels";
+} from "@forwardimpact/map/levels";
 
 /**
  * Create a detail page header
@@ -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/schema/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/behaviour/dom.js

@@ -21,7 +21,7 @@ import { createLevelCell } from "../../components/detail.js";
 import {
   BEHAVIOUR_MATURITY_ORDER,
   getConceptEmoji,
-} from "@forwardimpact/schema/levels";
+} from "@forwardimpact/map/levels";
 import { prepareBehaviourDetail } from "./shared.js";
 import { createJsonLdScript, behaviourToJsonLd } from "../json-ld.js";
 

package/src/formatters/discipline/dom.js

@@ -18,7 +18,7 @@ import {
   createJobBuilderButton,
   createInterviewPrepButton,
 } from "../../components/action-buttons.js";
-import { getConceptEmoji } from "@forwardimpact/schema/levels";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
 import { prepareDisciplineDetail } from "./shared.js";
 import { createJsonLdScript, disciplineToJsonLd } from "../json-ld.js";
 import { createBadge } from "../../components/card.js";

package/src/formatters/driver/dom.js

@@ -5,7 +5,7 @@
 import { div, heading1, heading2, p, a, span } from "../../lib/render.js";
 import { createBackLink } from "../../components/nav.js";
 import { prepareDriverDetail } from "./shared.js";
-import { getConceptEmoji } from "@forwardimpact/schema/levels";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
 import { createJsonLdScript, driverToJsonLd } from "../json-ld.js";
 
 /**

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/dom.js

@@ -5,7 +5,7 @@
 import { div, heading1, heading2, p, span } from "../../lib/render.js";
 import { createBackLink } from "../../components/nav.js";
 import { createLevelDots } from "../../components/detail.js";
-import { getConceptEmoji } from "@forwardimpact/schema/levels";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
 
 /**
  * Format interview detail as DOM elements

package/src/formatters/interview/markdown.js

@@ -3,7 +3,7 @@
  */
 
 import { formatLevel } from "../../lib/render.js";
-import { getConceptEmoji } from "@forwardimpact/schema/levels";
+import { getConceptEmoji } from "@forwardimpact/map/levels";
 
 /**
  * Format interview detail as markdown