@forwardimpact/pathway 0.20.0 → 0.22.0

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/slides.html

@@ -9,10 +9,10 @@
       {
         "imports": {
           "mustache": "https://esm.sh/mustache@4.2.0",
-          "@forwardimpact/schema": "/schema/lib/index.js",
-          "@forwardimpact/schema/levels": "/schema/lib/levels.js",
-          "@forwardimpact/schema/loader": "/schema/lib/loader.js",
-          "@forwardimpact/schema/validation": "/schema/lib/validation.js",
+          "@forwardimpact/map": "/map/lib/index.js",
+          "@forwardimpact/map/levels": "/map/lib/levels.js",
+          "@forwardimpact/map/loader": "/map/lib/loader.js",
+          "@forwardimpact/map/validation": "/map/lib/validation.js",
           "@forwardimpact/libpathway": "/model/lib/index.js",
           "@forwardimpact/libpathway/derivation": "/model/lib/derivation.js",
           "@forwardimpact/libpathway/modifiers": "/model/lib/modifiers.js",

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/install.template.sh

@@ -2,7 +2,8 @@
 # {{{frameworkTitle}}} — Local Install
 # Generated by @forwardimpact/pathway v{{{version}}}
 #
-# Installs to ~/.fit/pathway/
+# Installs fit-pathway globally via npm and downloads organization data
+# to ~/.fit/pathway/data/.
 #
 # Usage:
 #   curl -fsSL {{{siteUrl}}}/install.sh | bash
@@ -15,7 +16,12 @@ INSTALL_DIR="${HOME}/.fit/pathway"
 command -v node >/dev/null 2>&1 || { echo "Error: Node.js 18+ is required. https://nodejs.org"; exit 1; }
 command -v npm  >/dev/null 2>&1 || { echo "Error: npm is required."; exit 1; }
 
-echo "Installing to ${INSTALL_DIR}..."
+# Install fit-pathway globally (provides the fit-pathway binary on PATH)
+echo "Installing @forwardimpact/pathway globally..."
+npm install -g @forwardimpact/pathway@{{{version}}}
+
+# Download organization data to ~/.fit/pathway/data/
+echo "Downloading organization data to ${INSTALL_DIR}/data/..."
 mkdir -p "${INSTALL_DIR}"
 
 TMPFILE=$(mktemp)
@@ -23,11 +29,8 @@ trap 'rm -f "$TMPFILE"' EXIT
 curl -fsSL "${SITE_URL}/bundle.tar.gz" -o "$TMPFILE"
 tar -xzf "$TMPFILE" -C "${INSTALL_DIR}" --strip-components=1
 
-(cd "${INSTALL_DIR}" && npm install --production --ignore-scripts --no-audit --no-fund --silent)
-
 echo ""
 echo "Done. Usage:"
-echo "  cd ${INSTALL_DIR}"
-echo "  npx fit-pathway skill --list"
-echo "  npx fit-pathway job --list"
-echo "  npx fit-pathway agent --list"
+echo "  fit-pathway skill --list"
+echo "  fit-pathway job --list"
+echo "  fit-pathway agent --list"

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/schema/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/schema/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 }));
-}

package/src/slides/grade.js

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