@forwardimpact/pathway 0.23.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.23.0",
+  "version": "0.23.1",
   "description": "Career progression web app and CLI for exploring roles and generating agent teams",
   "license": "Apache-2.0",
   "repository": {
@@ -49,5 +49,8 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/src/commands/agent.js

@@ -209,8 +209,7 @@ function listAgentCombinations(data, agentData, verbose = false) {
         if (humanDiscipline && humanTrack) {
           const abbrev = getDisciplineAbbreviation(discipline.id);
           const agentName = `${abbrev}-${toKebabCase(track.id)}`;
-          const specName =
-            humanDiscipline.specialization || humanDiscipline.id;
+          const specName = humanDiscipline.specialization || humanDiscipline.id;
           console.log(
             `${agentName} ${discipline.id} ${track.id}, ${specName} (${humanTrack.name})`,
           );

package/src/commands/discipline.js

@@ -20,7 +20,11 @@ import { formatTable } from "../lib/cli-output.js";
  * @returns {string} Formatted list line
  */
 function formatListItem(discipline) {
-  return `${discipline.id}, ${discipline.specialization || discipline.id}, ${discipline.roleTitle || discipline.id}`;
+  const type = discipline.isProfessional ? "professional" : "management";
+  const tracks = (discipline.validTracks || [])
+    .filter((t) => t !== null)
+    .join("|");
+  return `${discipline.id}, ${discipline.specialization || discipline.id}, ${type}, ${tracks || "—"}`;
 }
 
 /**
@@ -30,21 +34,14 @@ function formatListItem(discipline) {
 function formatSummary(disciplines) {
   console.log(`\n📋 Disciplines\n`);
 
-  const rows = disciplines.map((d) => [
-    d.id,
-    d.specialization || d.id,
-    d.roleTitle || 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", "Specialization", "Role Title", "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 and names`);
   console.log(`Run 'npx pathway discipline <id>' for details\n`);
@@ -55,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({
@@ -67,6 +64,7 @@ export const runDisciplineCommand = createEntityCommand({
     discipline: entity,
     skills: data.skills,
     behaviours: data.behaviours,
+    tracks: data.tracks,
   }),
   formatSummary,
   formatDetail,

package/src/commands/job.js

@@ -16,7 +16,10 @@
 
 import { prepareJobDetail } from "@forwardimpact/libskill/job";
 import { jobToMarkdown } from "../formatters/job/markdown.js";
-import { generateJobTitle, generateAllJobs } from "@forwardimpact/libskill/derivation";
+import {
+  generateJobTitle,
+  generateAllJobs,
+} from "@forwardimpact/libskill/derivation";
 import { formatTable } from "../lib/cli-output.js";
 import {
   deriveChecklist,
@@ -54,9 +57,33 @@ export async function runJobCommand({ data, args, options, dataDir }) {
     validationRules: data.framework.validationRules,
   });
 
+  // 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(
@@ -71,29 +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 with name
+    // Count by discipline with name, grouped by track
     const byDiscipline = {};
-    for (const job of jobs) {
+    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, info]) => [
       id,
       info.name,
+      info.type,
       info.count,
+      info.tracks.size > 0 ? [...info.tracks].join(", ") : "—",
     ]);
-    console.log(formatTable(["ID", "Specialization", "Combinations"], rows));
-    console.log(`\nTotal: ${jobs.length} valid job combinations`);
-    console.log(`\nRun 'npx pathway job --list' for all combinations with titles`);
+    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`,
     );
@@ -102,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);
   }
 
@@ -120,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);
   }
 
@@ -164,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

@@ -46,7 +46,13 @@ function formatSummary(levels, data) {
 
   console.log(
     formatTable(
-      ["ID", "Professional Title", "Management Title", "Experience", "Primary Level"],
+      [
+        "ID",
+        "Professional Title",
+        "Management Title",
+        "Experience",
+        "Primary Level",
+      ],
       rows,
     ),
   );

package/src/commands/tool.js

@@ -88,7 +88,9 @@ 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 and descriptions`);
+  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

@@ -31,17 +31,23 @@ function formatListItem(track) {
  * @param {Object} data - Full data context
  */
 function formatSummary(tracks, data) {
-  const { framework } = data;
+  const { framework, disciplines } = data;
   const emoji = framework ? getConceptEmoji(framework, "track") : "🛤️";
 
   console.log(`\n${emoji} Tracks\n`);
 
   const rows = tracks.map((t) => {
     const modCount = Object.keys(t.skillModifiers || {}).length;
-    return [t.id, t.name, modCount];
+    const usedBy = disciplines
+      ? disciplines.filter((d) => d.validTracks && d.validTracks.includes(t.id))
+      : [];
+    const disciplineNames = usedBy
+      .map((d) => d.specialization || d.id)
+      .join(", ");
+    return [t.id, t.name, modCount, disciplineNames || "—"];
   });
 
-  console.log(formatTable(["ID", "Name", "Modifiers"], rows));
+  console.log(formatTable(["ID", "Name", "Modifiers", "Disciplines"], rows));
   console.log(`\nTotal: ${tracks.length} tracks`);
   console.log(`\nRun 'npx pathway track --list' for IDs and names`);
   console.log(`Run 'npx pathway track <id>' for details\n`);

package/src/formatters/discipline/markdown.js

@@ -35,16 +35,31 @@ export function disciplineListToMarkdown(disciplines) {
  * @param {Object} context - Additional context
  * @param {Array} context.skills - All skills
  * @param {Array} context.behaviours - All behaviours
+ * @param {Array} [context.tracks] - All tracks (for showing valid track names)
  * @param {boolean} [context.showBehaviourModifiers=true] - Whether to show behaviour modifiers section
  * @returns {string}
  */
 export function disciplineToMarkdown(
   discipline,
-  { skills, behaviours, showBehaviourModifiers = true } = {},
+  { skills, behaviours, tracks, showBehaviourModifiers = true } = {},
 ) {
   const view = prepareDisciplineDetail(discipline, { skills, behaviours });
+  const type = discipline.isProfessional ? "Professional" : "Management";
   const lines = [`# 📋 ${view.name}`, "", view.description, ""];
 
+  // Type and valid tracks
+  const validTracks = (discipline.validTracks || []).filter((t) => t !== null);
+  if (validTracks.length > 0) {
+    const trackNames = validTracks.map((tid) => {
+      const track = tracks?.find((t) => t.id === tid);
+      return track ? track.name : tid;
+    });
+    lines.push(`**Type:** ${type}  `);
+    lines.push(`**Valid Tracks:** ${trackNames.join(", ")}`, "");
+  } else {
+    lines.push(`**Type:** ${type}`, "");
+  }
+
   // Core skills
   if (view.coreSkills.length > 0) {
     lines.push("## Core Skills", "");

package/src/formatters/track/markdown.js

@@ -44,6 +44,20 @@ export function trackToMarkdown(
   const emoji = framework ? getConceptEmoji(framework, "track") : "🛤️";
   const lines = [`# ${emoji} ${view.name}`, "", view.description, ""];
 
+  // Show which disciplines use this track
+  if (disciplines) {
+    const usedBy = disciplines.filter(
+      (d) => d.validTracks && d.validTracks.includes(track.id),
+    );
+    if (usedBy.length > 0) {
+      const names = usedBy.map(
+        (d) =>
+          `${d.specialization || d.id} (${d.isProfessional ? "professional" : "management"})`,
+      );
+      lines.push(`**Used by:** ${names.join(", ")}`, "");
+    }
+  }
+
   // Skill modifiers - show expanded skills for capabilities
   if (view.skillModifiers.length > 0) {
     lines.push("## Skill Modifiers", "");