@forwardimpact/pathway 0.22.0 → 0.23.1

package/bin/fit-pathway.js

@@ -117,7 +117,9 @@ Generate job definitions from discipline × level × track combinations.
 
 Usage:
   npx fit-pathway job                                  Summary with stats
+  npx fit-pathway job --track=<track>                  Summary filtered by track
   npx fit-pathway job --list                           All valid combinations
+  npx fit-pathway job --list --track=<track>            Combinations for a track
   npx fit-pathway job <discipline> <level>             Detail view (trackless)
   npx fit-pathway job <d> <l> --track=<track>          Detail view (with track)
   npx fit-pathway job <d> <l> --skills                 Plain list of skill IDs
@@ -126,15 +128,17 @@ Usage:
 
 Options:
   --track=TRACK       Track specialization (e.g., platform, forward_deployed)
+                      Also filters --list and summary modes
   --skills            Output plain list of skill IDs (for piping)
   --tools             Output plain list of tool names (for piping)
   --checklist=STAGE   Show checklist for stage handoff (plan, code)
 
 Examples:
-  npx fit-pathway job software_engineering L4
-  npx fit-pathway job software_engineering L4 --track=platform
-  npx fit-pathway job se L3 --track=platform --skills
-  npx fit-pathway job se L3 --track=platform --tools
+  npx fit-pathway job                                  # overview of all jobs
+  npx fit-pathway job --track=forward_deployed         # jobs on a specific track
+  npx fit-pathway job --list --track=forward_deployed  # list for piping
+  npx fit-pathway job software_engineering J060        # trackless job detail
+  npx fit-pathway job software_engineering J060 --track=platform  # with track
 
 ────────────────────────────────────────────────────────────────────────────────
 AGENT COMMAND

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.22.0",
+  "version": "0.23.1",
   "description": "Career progression web app and CLI for exploring roles and generating agent teams",
   "license": "Apache-2.0",
   "repository": {
@@ -41,12 +41,16 @@
   },
   "dependencies": {
     "@forwardimpact/map": "^0.11.0",
-    "@forwardimpact/libpathway": "^3.0.0",
+    "@forwardimpact/libskill": "^3.0.0",
+    "@forwardimpact/libui": "^1.0.0",
     "mustache": "^4.2.0",
     "simple-icons": "^16.7.0",
     "yaml": "^2.3.4"
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/src/commands/agent.js

@@ -42,7 +42,7 @@ import {
   buildAgentIndex,
   getDisciplineAbbreviation,
   toKebabCase,
-} from "@forwardimpact/libpathway";
+} from "@forwardimpact/libskill";
 import { formatAgentProfile } from "../formatters/agent/profile.js";
 import {
   formatAgentSkill,
@@ -199,7 +199,7 @@ function showAgentSummary(data, agentData, skillsWithAgent) {
  */
 function listAgentCombinations(data, agentData, verbose = false) {
   if (!verbose) {
-    // Clean output for piping
+    // Descriptive output for piping and AI agent discovery
     for (const discipline of agentData.disciplines) {
       for (const track of agentData.tracks) {
         const humanDiscipline = data.disciplines.find(
@@ -209,7 +209,10 @@ function listAgentCombinations(data, agentData, verbose = false) {
         if (humanDiscipline && humanTrack) {
           const abbrev = getDisciplineAbbreviation(discipline.id);
           const agentName = `${abbrev}-${toKebabCase(track.id)}`;
-          console.log(`${agentName} ${discipline.id} ${track.id}`);
+          const specName = humanDiscipline.specialization || humanDiscipline.id;
+          console.log(
+            `${agentName} ${discipline.id} ${track.id}, ${specName} (${humanTrack.name})`,
+          );
         }
       }
     }

package/src/commands/behaviour.js

@@ -14,6 +14,15 @@ import { createEntityCommand } from "./command-factory.js";
 import { behaviourToMarkdown } from "../formatters/behaviour/markdown.js";
 import { formatTable } from "../lib/cli-output.js";
 
+/**
+ * Format behaviour list item for --list output
+ * @param {Object} behaviour - Behaviour entity
+ * @returns {string} Formatted list line
+ */
+function formatListItem(behaviour) {
+  return `${behaviour.id}, ${behaviour.name}`;
+}
+
 /**
  * Format behaviour summary output
  * @param {Array} behaviours - Raw behaviour entities
@@ -34,7 +43,7 @@ function formatSummary(behaviours, data) {
 
   console.log(formatTable(["ID", "Name", "Drivers"], rows));
   console.log(`\nTotal: ${behaviours.length} behaviours`);
-  console.log(`\nRun 'npx pathway behaviour --list' for IDs`);
+  console.log(`\nRun 'npx pathway behaviour --list' for IDs and names`);
   console.log(`Run 'npx pathway behaviour <id>' for details\n`);
 }
 
@@ -57,5 +66,6 @@ export const runBehaviourCommand = createEntityCommand({
   }),
   formatSummary,
   formatDetail,
+  formatListItem,
   emojiIcon: "🧠",
 });

package/src/commands/build.js

@@ -42,7 +42,8 @@ function resolvePackageLib(packageName) {
 }
 
 const mapLibDir = resolvePackageLib("@forwardimpact/map");
-const modelLibDir = resolvePackageLib("@forwardimpact/libpathway");
+const modelLibDir = resolvePackageLib("@forwardimpact/libskill");
+const uiLibDir = resolvePackageLib("@forwardimpact/libui");
 
 /**
  * Files and directories to copy from app/
@@ -141,13 +142,21 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
     }
   }
 
-  // Copy @forwardimpact/map and @forwardimpact/libpathway packages
+  // Copy @forwardimpact/map and @forwardimpact/libskill packages
   // These are needed by the browser's import map
   console.log("📚 Copying package dependencies...");
   await cp(mapLibDir, join(outputDir, "map/lib"), { recursive: true });
   console.log(`   ✓ map/lib`);
   await cp(modelLibDir, join(outputDir, "model/lib"), { recursive: true });
   console.log(`   ✓ model/lib`);
+  // Copy libui JS (src/) and CSS (src/css/)
+  await cp(uiLibDir, join(outputDir, "ui/lib"), { recursive: true });
+  // CSS is within uiLibDir/css/ so it's already copied as ui/lib/css/
+  // Create ui/css/ symlink-like copy for the CSS @import paths
+  await cp(join(uiLibDir, "css"), join(outputDir, "ui/css"), {
+    recursive: true,
+  });
+  console.log(`   ✓ ui/lib + ui/css`);
 
   // Copy data directory (dereference symlinks to copy actual content)
   console.log("📁 Copying data files...");

package/src/commands/command-factory.js

@@ -22,6 +22,7 @@ import { capitalize } from "../formatters/shared.js";
  * @param {Function} config.presentDetail - Function to present detail: (entity, data, options) => view
  * @param {Function} config.formatSummary - Function to format summary output: (items, data) => void
  * @param {Function} config.formatDetail - Function to format detail output: (view, framework) => void
+ * @param {Function} [config.formatListItem] - Optional function to format list item: (item) => string (defaults to item.id)
  * @param {Function} [config.sortItems] - Optional function to sort items: (items) => sortedItems
  * @param {Function} [config.validate] - Optional validation function: (data) => {errors: [], warnings: []}
  * @param {string} [config.emojiIcon] - Optional emoji for the entity
@@ -34,6 +35,7 @@ export function createEntityCommand({
   presentDetail,
   formatSummary,
   formatDetail,
+  formatListItem,
   sortItems,
   validate,
   _emojiIcon = "",
@@ -48,10 +50,10 @@ export function createEntityCommand({
       return handleValidate({ data, entityName, pluralName, validate });
     }
 
-    // --list: Output clean newline-separated IDs for piping
+    // --list: Output descriptive comma-separated lines for piping and AI agent discovery
     if (options.list) {
       for (const item of items) {
-        console.log(item.id);
+        console.log(formatListItem ? formatListItem(item) : item.id);
       }
       return;
     }

package/src/commands/dev.js

@@ -31,7 +31,8 @@ function resolvePackageLib(packageName) {
 }
 
 const mapLibDir = resolvePackageLib("@forwardimpact/map");
-const modelLibDir = resolvePackageLib("@forwardimpact/libpathway");
+const modelLibDir = resolvePackageLib("@forwardimpact/libskill");
+const uiLibDir = resolvePackageLib("@forwardimpact/libui");
 
 const MIME_TYPES = {
   ".html": "text/html; charset=utf-8",
@@ -138,8 +139,14 @@ export async function runDevCommand({ dataDir, options }) {
       // Serve @forwardimpact/map package files (resolved via Node module resolution)
       filePath = join(mapLibDir, pathname.slice(9));
     } else if (pathname.startsWith("/model/lib/")) {
-      // Serve @forwardimpact/libpathway package files (resolved via Node module resolution)
+      // Serve @forwardimpact/libskill package files (resolved via Node module resolution)
       filePath = join(modelLibDir, pathname.slice(11));
+    } else if (pathname.startsWith("/ui/lib/")) {
+      // Serve @forwardimpact/libui package JS files
+      filePath = join(uiLibDir, pathname.slice(8));
+    } else if (pathname.startsWith("/ui/css/")) {
+      // Serve @forwardimpact/libui package CSS files
+      filePath = join(uiLibDir, "css", pathname.slice(8));
     } else if (pathname === "/" || pathname === "") {
       // Serve index.html for root
       filePath = join(publicDir, "index.html");

package/src/commands/discipline.js

@@ -14,6 +14,19 @@ import { createEntityCommand } from "./command-factory.js";
 import { disciplineToMarkdown } from "../formatters/discipline/markdown.js";
 import { formatTable } from "../lib/cli-output.js";
 
+/**
+ * Format discipline list item for --list output
+ * @param {Object} discipline - Discipline entity
+ * @returns {string} Formatted list line
+ */
+function formatListItem(discipline) {
+  const type = discipline.isProfessional ? "professional" : "management";
+  const tracks = (discipline.validTracks || [])
+    .filter((t) => t !== null)
+    .join("|");
+  return `${discipline.id}, ${discipline.specialization || discipline.id}, ${type}, ${tracks || "—"}`;
+}
+
 /**
  * Format discipline summary output
  * @param {Array} disciplines - Raw discipline entities
@@ -21,16 +34,16 @@ import { formatTable } from "../lib/cli-output.js";
 function formatSummary(disciplines) {
   console.log(`\n📋 Disciplines\n`);
 
-  const rows = disciplines.map((d) => [
-    d.id,
-    d.coreSkills?.length || 0,
-    d.supportingSkills?.length || 0,
-    d.broadSkills?.length || 0,
-  ]);
+  const rows = disciplines.map((d) => {
+    const type = d.isProfessional ? "Professional" : "Management";
+    const validTracks = (d.validTracks || []).filter((t) => t !== null);
+    const trackStr = validTracks.length > 0 ? validTracks.join(", ") : "—";
+    return [d.id, d.specialization || d.id, type, trackStr];
+  });
 
-  console.log(formatTable(["ID", "Core", "Supporting", "Broad"], rows));
+  console.log(formatTable(["ID", "Specialization", "Type", "Tracks"], rows));
   console.log(`\nTotal: ${disciplines.length} disciplines`);
-  console.log(`\nRun 'npx pathway discipline --list' for IDs`);
+  console.log(`\nRun 'npx pathway discipline --list' for IDs and names`);
   console.log(`Run 'npx pathway discipline <id>' for details\n`);
 }
 
@@ -39,8 +52,8 @@ function formatSummary(disciplines) {
  * @param {Object} viewAndContext - Contains discipline entity and context
  */
 function formatDetail(viewAndContext) {
-  const { discipline, skills, behaviours } = viewAndContext;
-  console.log(disciplineToMarkdown(discipline, { skills, behaviours }));
+  const { discipline, skills, behaviours, tracks } = viewAndContext;
+  console.log(disciplineToMarkdown(discipline, { skills, behaviours, tracks }));
 }
 
 export const runDisciplineCommand = createEntityCommand({
@@ -51,8 +64,10 @@ export const runDisciplineCommand = createEntityCommand({
     discipline: entity,
     skills: data.skills,
     behaviours: data.behaviours,
+    tracks: data.tracks,
   }),
   formatSummary,
   formatDetail,
+  formatListItem,
   emojiIcon: "📋",
 });

package/src/commands/driver.js

@@ -20,6 +20,15 @@ import {
 } from "../lib/cli-output.js";
 import { getConceptEmoji } from "@forwardimpact/map/levels";
 
+/**
+ * Format driver list item for --list output
+ * @param {Object} driver - Driver entity
+ * @returns {string} Formatted list line
+ */
+function formatListItem(driver) {
+  return `${driver.id}, ${driver.name}`;
+}
+
 /**
  * Format driver summary output
  * @param {Array} drivers - Raw driver entities
@@ -43,7 +52,7 @@ function formatSummary(drivers, data) {
 
   console.log(formatTable(["ID", "Name", "Skills", "Behaviours"], rows));
   console.log(`\nTotal: ${drivers.length} drivers`);
-  console.log(`\nRun 'npx pathway driver --list' for IDs`);
+  console.log(`\nRun 'npx pathway driver --list' for IDs and names`);
   console.log(`Run 'npx pathway driver <id>' for details\n`);
 }
 
@@ -90,5 +99,6 @@ export const runDriverCommand = createEntityCommand({
   }),
   formatSummary,
   formatDetail,
+  formatListItem,
   emojiIcon: "🎯",
 });

package/src/commands/job.js

@@ -14,14 +14,17 @@
  *   npx pathway job --validate                               # Validation checks
  */
 
-import { prepareJobDetail } from "@forwardimpact/libpathway/job";
+import { prepareJobDetail } from "@forwardimpact/libskill/job";
 import { jobToMarkdown } from "../formatters/job/markdown.js";
-import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
+import {
+  generateJobTitle,
+  generateAllJobs,
+} from "@forwardimpact/libskill/derivation";
 import { formatTable } from "../lib/cli-output.js";
 import {
   deriveChecklist,
   formatChecklistMarkdown,
-} from "@forwardimpact/libpathway/checklist";
+} from "@forwardimpact/libskill/checklist";
 import { loadJobTemplate } from "../lib/template-loader.js";
 import { toolkitToPlainList } from "../formatters/toolkit/markdown.js";
 
@@ -54,13 +57,40 @@ export async function runJobCommand({ data, args, options, dataDir }) {
     validationRules: data.framework.validationRules,
   });
 
-  // --list: Output clean lines for piping (discipline level track format)
+  // Apply --track filter to list and summary modes
+  const filteredJobs = options.track
+    ? jobs.filter((j) => j.track && j.track.id === options.track)
+    : jobs;
+
+  if (options.track && filteredJobs.length === 0 && args.length === 0) {
+    const trackExists = data.tracks.some((t) => t.id === options.track);
+    if (!trackExists) {
+      console.error(`Track not found: ${options.track}`);
+      console.error(`Available: ${data.tracks.map((t) => t.id).join(", ")}`);
+    } else {
+      console.error(`No jobs found for track: ${options.track}`);
+      const trackDisciplines = data.disciplines
+        .filter((d) => d.validTracks && d.validTracks.includes(options.track))
+        .map((d) => d.id);
+      if (trackDisciplines.length > 0) {
+        console.error(
+          `Disciplines with this track: ${trackDisciplines.join(", ")}`,
+        );
+      }
+    }
+    process.exit(1);
+  }
+
+  // --list: Output descriptive comma-separated lines for piping and AI agent discovery
   if (options.list) {
-    for (const job of jobs) {
+    for (const job of filteredJobs) {
+      const title = generateJobTitle(job.discipline, job.level, job.track);
       if (job.track) {
-        console.log(`${job.discipline.id} ${job.level.id} ${job.track.id}`);
+        console.log(
+          `${job.discipline.id} ${job.level.id} ${job.track.id}, ${title}`,
+        );
       } else {
-        console.log(`${job.discipline.id} ${job.level.id}`);
+        console.log(`${job.discipline.id} ${job.level.id}, ${title}`);
       }
     }
     return;
@@ -68,19 +98,40 @@ export async function runJobCommand({ data, args, options, dataDir }) {
 
   // No args: Show summary
   if (args.length === 0) {
-    console.log(`\n💼 Jobs\n`);
+    const trackLabel = options.track ? ` — ${options.track}` : "";
+    console.log(`\n💼 Jobs${trackLabel}\n`);
 
-    // Count by discipline
+    // Count by discipline with name, grouped by track
     const byDiscipline = {};
-    for (const job of jobs) {
-      byDiscipline[job.discipline.id] =
-        (byDiscipline[job.discipline.id] || 0) + 1;
+    for (const job of filteredJobs) {
+      const key = job.discipline.id;
+      if (!byDiscipline[key]) {
+        byDiscipline[key] = {
+          name: job.discipline.specialization || job.discipline.id,
+          roleTitle: job.discipline.roleTitle || job.discipline.id,
+          type: job.discipline.isProfessional ? "Professional" : "Management",
+          tracks: new Set(),
+          count: 0,
+        };
+      }
+      if (job.track) byDiscipline[key].tracks.add(job.track.id);
+      byDiscipline[key].count++;
     }
 
-    const rows = Object.entries(byDiscipline).map(([id, count]) => [id, count]);
-    console.log(formatTable(["Discipline", "Combinations"], rows));
-    console.log(`\nTotal: ${jobs.length} valid job combinations`);
-    console.log(`\nRun 'npx pathway job --list' for all combinations`);
+    const rows = Object.entries(byDiscipline).map(([id, info]) => [
+      id,
+      info.name,
+      info.type,
+      info.count,
+      info.tracks.size > 0 ? [...info.tracks].join(", ") : "—",
+    ]);
+    console.log(
+      formatTable(["ID", "Specialization", "Type", "Jobs", "Tracks"], rows),
+    );
+    console.log(`\nTotal: ${filteredJobs.length} valid job combinations`);
+    console.log(
+      `\nRun 'npx pathway job --list' for all combinations with titles`,
+    );
     console.log(
       `Run 'npx pathway job <discipline> <level> [--track=<track>]' for details\n`,
     );
@@ -89,14 +140,28 @@ export async function runJobCommand({ data, args, options, dataDir }) {
 
   // Handle job detail view - requires discipline and level
   if (args.length < 2) {
-    console.error(
-      "Usage: npx pathway job <discipline> <level> [--track=<track>]",
-    );
-    console.error("       npx pathway job --list");
-    console.error("Example: npx pathway job software_engineering L4");
-    console.error(
-      "Example: npx pathway job software_engineering L4 --track=platform",
-    );
+    // Check if the single arg is a level or track, hinting at what's missing
+    const arg = args[0];
+    const isLevel = data.levels.some((g) => g.id === arg);
+    const isTrack = data.tracks.some((t) => t.id === arg);
+    if (isLevel) {
+      console.error(
+        `Missing discipline. Usage: npx pathway job <discipline> ${arg} [--track=<track>]`,
+      );
+      console.error(
+        `Disciplines: ${data.disciplines.map((d) => d.id).join(", ")}`,
+      );
+    } else if (isTrack) {
+      console.error(`Track must be passed as a flag: --track=${arg}`);
+      console.error(
+        `Usage: npx pathway job <discipline> <level> --track=${arg}`,
+      );
+    } else {
+      console.error(
+        "Usage: npx pathway job <discipline> <level> [--track=<track>]",
+      );
+      console.error("       npx pathway job --list");
+    }
     process.exit(1);
   }
 
@@ -107,14 +172,36 @@ export async function runJobCommand({ data, args, options, dataDir }) {
     : null;
 
   if (!discipline) {
-    console.error(`Discipline not found: ${args[0]}`);
-    console.error(`Available: ${data.disciplines.map((d) => d.id).join(", ")}`);
+    // Check if args are swapped (level first, discipline second)
+    const maybeLevel = data.levels.find((g) => g.id === args[0]);
+    const maybeDiscipline = data.disciplines.find((d) => d.id === args[1]);
+    if (maybeLevel && maybeDiscipline) {
+      console.error(`Arguments are in the wrong order. Try:`);
+      console.error(
+        `  npx pathway job ${args[1]} ${args[0]}${options.track ? ` --track=${options.track}` : ""}`,
+      );
+    } else {
+      console.error(`Discipline not found: ${args[0]}`);
+      console.error(
+        `Available: ${data.disciplines.map((d) => d.id).join(", ")}`,
+      );
+    }
     process.exit(1);
   }
 
   if (!level) {
-    console.error(`Level not found: ${args[1]}`);
-    console.error(`Available: ${data.levels.map((g) => g.id).join(", ")}`);
+    // Check if the second arg is a track ID passed as positional
+    const isTrack = data.tracks.some((t) => t.id === args[1]);
+    if (isTrack) {
+      console.error(
+        `Track must be passed as a flag, not a positional argument:`,
+      );
+      console.error(`  npx pathway job ${args[0]} <level> --track=${args[1]}`);
+      console.error(`Levels: ${data.levels.map((g) => g.id).join(", ")}`);
+    } else {
+      console.error(`Level not found: ${args[1]}`);
+      console.error(`Available: ${data.levels.map((g) => g.id).join(", ")}`);
+    }
     process.exit(1);
   }
 
@@ -151,6 +238,18 @@ export async function runJobCommand({ data, args, options, dataDir }) {
         console.error(`${discipline.id} does not support tracks`);
       }
     }
+    // Check if it's a minLevel issue
+    if (discipline.minLevel) {
+      const levelIndex = data.levels.findIndex((g) => g.id === level.id);
+      const minIndex = data.levels.findIndex(
+        (g) => g.id === discipline.minLevel,
+      );
+      if (levelIndex >= 0 && minIndex >= 0 && levelIndex < minIndex) {
+        console.error(
+          `${discipline.id} requires minimum level: ${discipline.minLevel}`,
+        );
+      }
+    }
     process.exit(1);
   }
 

package/src/commands/level.js

@@ -16,6 +16,15 @@ 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
@@ -29,14 +38,26 @@ function formatSummary(levels, data) {
 
   const rows = levels.map((g) => [
     g.id,
-    g.displayName || g.id,
+    g.professionalTitle || g.displayName || g.id,
+    g.managementTitle || "-",
     g.typicalExperienceRange || "-",
     capitalize(g.baseSkillProficiencies?.primary || "-"),
   ]);
 
-  console.log(formatTable(["ID", "Name", "Experience", "Primary Level"], rows));
+  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`);
+  console.log(`\nRun 'npx pathway level --list' for IDs and titles`);
   console.log(`Run 'npx pathway level <id>' for details\n`);
 }
 
@@ -56,5 +77,6 @@ export const runLevelCommand = createEntityCommand({
   presentDetail: (entity) => entity,
   formatSummary,
   formatDetail,
+  formatListItem,
   emojiIcon: "📊",
 });

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: "🔄",
 });