@forwardimpact/pathway 0.21.0 → 0.23.0

package/src/commands/level.js

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

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

@@ -16,7 +16,7 @@ import { skillToMarkdown } from "../formatters/skill/markdown.js";
 import { prepareSkillsList } from "../formatters/skill/shared.js";
 import { getConceptEmoji } from "@forwardimpact/map/levels";
 import { formatTable, formatError } from "../lib/cli-output.js";
-import { generateSkillMarkdown } from "@forwardimpact/libpathway/agent";
+import { generateSkillMarkdown } from "@forwardimpact/libskill/agent";
 import { formatAgentSkill } from "../formatters/agent/skill.js";
 import { loadSkillTemplate } from "../lib/template-loader.js";
 
@@ -85,6 +85,15 @@ async function formatAgentDetail(skill, stages, dataDir) {
   console.log(output);
 }
 
+/**
+ * Format skill list item for --list output
+ * @param {Object} skill - Skill entity
+ * @returns {string} Formatted list line
+ */
+function formatListItem(skill) {
+  return `${skill.id}, ${skill.name}, ${skill.capability || "-"}`;
+}
+
 const baseSkillCommand = createEntityCommand({
   entityName: "skill",
   pluralName: "skills",
@@ -98,6 +107,7 @@ const baseSkillCommand = createEntityCommand({
   }),
   formatSummary,
   formatDetail,
+  formatListItem,
   emojiIcon: "📚",
 });
 

package/src/commands/stage.js

@@ -21,6 +21,15 @@ import {
   formatBullet,
 } from "../lib/cli-output.js";
 
+/**
+ * Format stage list item for --list output
+ * @param {Object} stage - Stage entity
+ * @returns {string} Formatted list line
+ */
+function formatListItem(stage) {
+  return `${stage.id}, ${stage.name}`;
+}
+
 /**
  * Format stage summary output
  * @param {Array} stages - Raw stage entities
@@ -43,7 +52,7 @@ function formatSummary(stages, _data) {
 
   console.log(formatTable(["ID", "Name", "Mode", "Tools", "Handoffs"], rows));
   console.log(`\nTotal: ${stages.length} stages`);
-  console.log(`\nRun 'npx pathway stage --list' for IDs`);
+  console.log(`\nRun 'npx pathway stage --list' for IDs and names`);
   console.log(`Run 'npx pathway stage <id>' for details\n`);
 }
 
@@ -115,5 +124,6 @@ export const runStageCommand = createEntityCommand({
   }),
   formatSummary,
   formatDetail,
+  formatListItem,
   emojiIcon: "🔄",
 });

package/src/commands/tool.js

@@ -9,6 +9,7 @@
  *   npx pathway tool <name>       # Detail view for specific tool
  */
 
+import { truncate } from "../formatters/shared.js";
 import { prepareToolsList } from "../formatters/tool/shared.js";
 import {
   formatTable,
@@ -27,10 +28,10 @@ export async function runToolCommand({ data, args, options }) {
   const [name] = args;
   const { tools, totalCount } = prepareToolsList(data.skills);
 
-  // --list: Output clean newline-separated tool names for piping
+  // --list: Output descriptive comma-separated tool lines for piping
   if (options.list) {
     for (const tool of tools) {
-      console.log(tool.name);
+      console.log(`${tool.name}, ${truncate(tool.description, 60)}`);
     }
     return;
   }
@@ -87,7 +88,7 @@ function formatSummary(tools, totalCount) {
   if (sorted.length > 15) {
     console.log(`(showing top 15 by usage)`);
   }
-  console.log(`\nRun 'npx pathway tool --list' for all tool names`);
+  console.log(`\nRun 'npx pathway tool --list' for all tool names and descriptions`);
   console.log(`Run 'npx pathway tool <name>' for details\n`);
 }
 

package/src/commands/track.js

@@ -16,6 +16,15 @@ import { sortTracksByName } from "../formatters/track/shared.js";
 import { formatTable } from "../lib/cli-output.js";
 import { getConceptEmoji } from "@forwardimpact/map/levels";
 
+/**
+ * Format track list item for --list output
+ * @param {Object} track - Track entity
+ * @returns {string} Formatted list line
+ */
+function formatListItem(track) {
+  return `${track.id}, ${track.name}`;
+}
+
 /**
  * Format track summary output
  * @param {Array} tracks - Raw track entities
@@ -34,7 +43,7 @@ function formatSummary(tracks, data) {
 
   console.log(formatTable(["ID", "Name", "Modifiers"], rows));
   console.log(`\nTotal: ${tracks.length} tracks`);
-  console.log(`\nRun 'npx pathway track --list' for IDs`);
+  console.log(`\nRun 'npx pathway track --list' for IDs and names`);
   console.log(`Run 'npx pathway track <id>' for details\n`);
 }
 
@@ -63,5 +72,6 @@ export const runTrackCommand = createEntityCommand({
   sortItems: sortTracksByName,
   formatSummary,
   formatDetail,
+  formatListItem,
   emojiIcon: "🛤️",
 });

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

@@ -1,108 +1,12 @@
 /**
  * Reusable card component
+ *
+ * Re-exports from @forwardimpact/libui/components/card.
  */
 
-import { div, h3, p, span } from "../lib/render.js";
-
-/**
- * Create a card component
- * @param {Object} options
- * @param {string} options.title - Card title
- * @param {string} [options.description] - Card description
- * @param {string} [options.href] - Link destination (makes card clickable)
- * @param {HTMLElement[]} [options.badges] - Badges to display
- * @param {HTMLElement[]} [options.meta] - Meta information
- * @param {HTMLElement} [options.content] - Additional content
- * @param {HTMLElement} [options.icon] - Icon element to display
- * @param {string} [options.className] - Additional CSS class
- * @returns {HTMLElement}
- */
-export function createCard({
-  title,
-  description,
-  href,
-  badges = [],
-  meta = [],
-  content,
-  icon,
-  className = "",
-}) {
-  const isClickable = !!href;
-
-  const titleContent = icon
-    ? div(
-        { className: "card-title-with-icon" },
-        icon,
-        h3({ className: "card-title" }, title),
-      )
-    : h3({ className: "card-title" }, title);
-
-  const cardHeader = div(
-    { className: "card-header" },
-    titleContent,
-    badges.length > 0 ? div({ className: "card-badges" }, ...badges) : null,
-  );
-
-  const card = div(
-    {
-      className:
-        `card ${isClickable ? "card-clickable" : ""} ${className}`.trim(),
-    },
-    cardHeader,
-    description ? p({ className: "card-description" }, description) : null,
-    content || null,
-    meta.length > 0 ? div({ className: "card-meta" }, ...meta) : null,
-  );
-
-  if (isClickable) {
-    card.addEventListener("click", () => {
-      window.location.hash = href;
-    });
-  }
-
-  return card;
-}
-
-/**
- * Create a stat card for the landing page
- * @param {Object} options
- * @param {number|string} options.value - The stat value
- * @param {string} options.label - The stat label
- * @param {string} [options.href] - Optional link
- * @returns {HTMLElement}
- */
-export function createStatCard({ value, label, href }) {
-  const card = div(
-    { className: "stat-card" },
-    div({ className: "stat-value" }, String(value)),
-    div({ className: "stat-label" }, label),
-  );
-
-  if (href) {
-    card.style.cursor = "pointer";
-    card.addEventListener("click", () => {
-      window.location.hash = href;
-    });
-  }
-
-  return card;
-}
-
-/**
- * Create a badge element
- * @param {string} text - Badge text
- * @param {string} [type] - Badge type (default, primary, secondary, broad, technical, ai, etc.)
- * @returns {HTMLElement}
- */
-export function createBadge(text, type = "default") {
-  return span({ className: `badge badge-${type}` }, text);
-}
-
-/**
- * Create a tag element
- * @param {string} text
- * @returns {HTMLElement}
- */
-export function createTag(text) {
-  return span({ className: "info-tag" }, text);
-}
+export {
+  createCard,
+  createStatCard,
+  createBadge,
+  createTag,
+} from "@forwardimpact/libui/components/card";

package/src/components/comparison-radar.js

@@ -9,11 +9,11 @@
 import { ComparisonRadarChart } from "../lib/radar.js";
 import { div, h3 } from "../lib/render.js";
 import {
-  getSkillLevelIndex,
+  getSkillProficiencyIndex,
   getBehaviourMaturityIndex,
   formatLevel,
 } from "../lib/render.js";
-import { compareByCapability } from "@forwardimpact/libpathway/policies";
+import { compareByCapability } from "@forwardimpact/libskill/policies";
 
 /**
  * Create a comparison skill radar chart
@@ -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)}`