@forwardimpact/pathway 0.25.6 → 0.25.8

package/bin/fit-pathway.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 /**
  * Engineering Pathway CLI
  *
@@ -6,7 +6,7 @@
  * interview questions, career progression analysis, and AI agent configurations.
  *
  * Usage:
- *   npx fit-pathway <command> [options]
+ *   bunx fit-pathway <command> [options]
  *
  * Commands:
  *   discipline [<id>]           Show disciplines
@@ -88,12 +88,12 @@ const HELP_TEXT = `
 Engineering Pathway CLI
 
 Usage:
-  npx fit-pathway <command> [options]
+  bunx fit-pathway <command> [options]
 
 Global Options:
   --list            Output IDs only (for piping to other commands)
   --json            Output as JSON
-  --data=PATH       Path to data directory (default: ./data or examples/)
+  --data=PATH       Path to data directory (default: ./data)
   --version         Show version number
   --help            Show this help message
 
@@ -131,15 +131,15 @@ JOB COMMAND
 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
-  npx fit-pathway job <d> <l> --tools                  Plain list of tool names
-  npx fit-pathway job <d> <l> --checklist=<stage>      Show handoff checklist
+  bunx fit-pathway job                                  Summary with stats
+  bunx fit-pathway job --track=<track>                  Summary filtered by track
+  bunx fit-pathway job --list                           All valid combinations
+  bunx fit-pathway job --list --track=<track>            Combinations for a track
+  bunx fit-pathway job <discipline> <level>             Detail view (trackless)
+  bunx fit-pathway job <d> <l> --track=<track>          Detail view (with track)
+  bunx fit-pathway job <d> <l> --skills                 Plain list of skill IDs
+  bunx fit-pathway job <d> <l> --tools                  Plain list of tool names
+  bunx fit-pathway job <d> <l> --checklist=<stage>      Show handoff checklist
 
 Options:
   --track=TRACK       Track specialization (e.g., platform, forward_deployed)
@@ -149,11 +149,11 @@ Options:
   --checklist=STAGE   Show checklist for stage handoff (plan, code)
 
 Examples:
-  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
+  bunx fit-pathway job                                  # overview of all jobs
+  bunx fit-pathway job --track=forward_deployed         # jobs on a specific track
+  bunx fit-pathway job --list --track=forward_deployed  # list for piping
+  bunx fit-pathway job software_engineering J060        # trackless job detail
+  bunx fit-pathway job software_engineering J060 --track=platform  # with track
 
 ────────────────────────────────────────────────────────────────────────────────
 AGENT COMMAND
@@ -162,12 +162,12 @@ AGENT COMMAND
 Generate AI coding agent configurations from discipline × track × stage.
 
 Usage:
-  npx fit-pathway agent                                Summary with stats
-  npx fit-pathway agent --list                         All valid combinations
-  npx fit-pathway agent <discipline> --track=<track>   Generate all stage agents
-  npx fit-pathway agent <d> --track=<t> --stage=<s>    Generate single stage agent
-  npx fit-pathway agent <d> --track=<t> --skills       Plain list of skill IDs
-  npx fit-pathway agent <d> --track=<t> --tools        Plain list of tool names
+  bunx fit-pathway agent                                Summary with stats
+  bunx fit-pathway agent --list                         All valid combinations
+  bunx fit-pathway agent <discipline> --track=<track>   Generate all stage agents
+  bunx fit-pathway agent <d> --track=<t> --stage=<s>    Generate single stage agent
+  bunx fit-pathway agent <d> --track=<t> --skills       Plain list of skill IDs
+  bunx fit-pathway agent <d> --track=<t> --tools        Plain list of tool names
 
 Options:
   --track=TRACK       Track for the agent (required for generation)
@@ -177,10 +177,10 @@ Options:
   --tools             Output plain list of tool names (for piping)
 
 Examples:
-  npx fit-pathway agent software_engineering --track=platform
-  npx fit-pathway agent software_engineering --track=platform --stage=plan
-  npx fit-pathway agent software_engineering --track=platform --output=./agents
-  npx fit-pathway agent software_engineering --track=platform --skills
+  bunx fit-pathway agent software_engineering --track=platform
+  bunx fit-pathway agent software_engineering --track=platform --stage=plan
+  bunx fit-pathway agent software_engineering --track=platform --output=./agents
+  bunx fit-pathway agent software_engineering --track=platform --skills
 
 ────────────────────────────────────────────────────────────────────────────────
 INTERVIEW COMMAND
@@ -189,9 +189,9 @@ INTERVIEW COMMAND
 Generate interview question sets based on job requirements.
 
 Usage:
-  npx fit-pathway interview <discipline> <level>                     All types
-  npx fit-pathway interview <d> <l> --track=<track>                  With track
-  npx fit-pathway interview <d> <l> --track=<t> --type=<type>        Single type
+  bunx fit-pathway interview <discipline> <level>                     All types
+  bunx fit-pathway interview <d> <l> --track=<track>                  With track
+  bunx fit-pathway interview <d> <l> --track=<t> --type=<type>        Single type
 
 Options:
   --track=TRACK       Track specialization
@@ -205,9 +205,9 @@ PROGRESS COMMAND
 Analyze career progression between levels.
 
 Usage:
-  npx fit-pathway progress <discipline> <level>
-  npx fit-pathway progress <d> <l> --track=<track>
-  npx fit-pathway progress <d> <l> --compare=<to_level>
+  bunx fit-pathway progress <discipline> <level>
+  bunx fit-pathway progress <d> <l> --track=<track>
+  bunx fit-pathway progress <d> <l> --compare=<to_level>
 
 Options:
   --track=TRACK        Track specialization
@@ -220,10 +220,10 @@ QUESTIONS COMMAND
 Browse and filter interview questions.
 
 Usage:
-  npx fit-pathway questions
-  npx fit-pathway questions --level=practitioner
-  npx fit-pathway questions --skill=architecture_design
-  npx fit-pathway questions --stats
+  bunx fit-pathway questions
+  bunx fit-pathway questions --level=practitioner
+  bunx fit-pathway questions --skill=architecture_design
+  bunx fit-pathway questions --stats
 
 Options:
   --level=LEVEL        Filter by skill proficiency
@@ -411,7 +411,7 @@ async function main() {
 
   if (!handler) {
     console.error(formatError(`Unknown command: ${command}`));
-    console.error(`Run 'npx fit-pathway --help' for usage.`);
+    console.error(`Run 'bunx fit-pathway --help' for usage.`);
     process.exit(1);
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.25.6",
+  "version": "0.25.8",
   "description": "Career progression web app and CLI for exploring roles and generating agent teams",
   "license": "Apache-2.0",
   "repository": {
@@ -25,13 +25,14 @@
     "fit-pathway": "./bin/fit-pathway.js"
   },
   "scripts": {
-    "start": "node ./bin/fit-pathway.js serve",
-    "pathway": "node ./bin/fit-pathway.js",
-    "site": "node ./bin/fit-pathway.js site"
+    "start": "bun ./bin/fit-pathway.js serve",
+    "pathway": "bun ./bin/fit-pathway.js",
+    "site": "bun ./bin/fit-pathway.js site"
   },
   "files": [
     "bin/",
     "src/",
+    "starter/",
     "templates/"
   ],
   "exports": {
@@ -40,17 +41,16 @@
     "./commands": "./src/commands/index.js"
   },
   "dependencies": {
-    "@forwardimpact/map": "^0.14.0",
+    "@forwardimpact/map": "^0.15.5",
     "@forwardimpact/libskill": "^4.0.0",
     "@forwardimpact/libtemplate": "^0.2.0",
     "@forwardimpact/libui": "^1.0.0",
     "@forwardimpact/libutil": "^0.1.64",
     "mustache": "^4.2.0",
-    "simple-icons": "^16.13.0",
     "yaml": "^2.8.3"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "bun": ">=1.2.0"
   },
   "publishConfig": {
     "access": "public"

package/src/commands/agent.js

@@ -11,17 +11,17 @@
  * By default, outputs to console. Use --output to write files.
  *
  * Usage:
- *   npx pathway agent <discipline> [--track=<track>]
- *   npx pathway agent <discipline> --track=<track> --stage=plan
- *   npx pathway agent <discipline> --track=<track> --output=./agents
- *   npx pathway agent <discipline> [--track=<track>] --skills  # Plain list of skill IDs
- *   npx pathway agent <discipline> [--track=<track>] --tools   # Plain list of tool names
- *   npx pathway agent --list
+ *   bunx pathway agent <discipline> [--track=<track>]
+ *   bunx pathway agent <discipline> --track=<track> --stage=plan
+ *   bunx pathway agent <discipline> --track=<track> --output=./agents
+ *   bunx pathway agent <discipline> [--track=<track>] --skills  # Plain list of skill IDs
+ *   bunx pathway agent <discipline> [--track=<track>] --tools   # Plain list of tool names
+ *   bunx pathway agent --list
  *
  * Examples:
- *   npx pathway agent software_engineering --track=platform
- *   npx pathway agent software_engineering --track=platform --stage=plan
- *   npx pathway agent software_engineering --track=platform --output=./agents
+ *   bunx pathway agent software_engineering --track=platform
+ *   bunx pathway agent software_engineering --track=platform --stage=plan
+ *   bunx pathway agent software_engineering --track=platform --output=./agents
  */
 
 import { writeFile, mkdir, readFile } from "fs/promises";
@@ -117,9 +117,9 @@ function showAgentSummary(data, agentData, skillsWithAgent) {
   );
   console.log(`Stages:      ${data.stages.length} available`);
   console.log(`\nValid combinations: ${validCombinations}`);
-  console.log(`\nRun 'npx pathway agent --list' for all combinations`);
+  console.log(`\nRun 'bunx pathway agent --list' for all combinations`);
   console.log(
-    `Run 'npx pathway agent <discipline> <track>' to generate files\n`,
+    `Run 'bunx pathway agent <discipline> <track>' to generate files\n`,
   );
 }
 
@@ -181,7 +181,7 @@ function listAgentCombinations(data, agentData, verbose = false) {
       );
       const humanTrack = data.tracks.find((t) => t.id === track.id);
       if (humanDiscipline && humanTrack) {
-        console.log(`  npx pathway agent ${discipline.id} ${track.id}`);
+        console.log(`  bunx pathway agent ${discipline.id} ${track.id}`);
       }
     }
   }
@@ -298,11 +298,11 @@ export async function runAgentCommand({
   if (!disciplineId) {
     console.error(
       formatError(
-        "Usage: npx pathway agent <discipline_id> [--track=<track_id>]",
+        "Usage: bunx pathway agent <discipline_id> [--track=<track_id>]",
       ),
     );
     console.error(
-      "\nRun 'npx pathway agent --list' to see available combinations.",
+      "\nRun 'bunx pathway agent --list' to see available combinations.",
     );
     process.exit(1);
   }

package/src/commands/behaviour.js

@@ -4,10 +4,10 @@
  * Handles behaviour summary, listing, and detail display in the terminal.
  *
  * Usage:
- *   npx pathway behaviour              # Summary with stats
- *   npx pathway behaviour --list       # IDs only (for piping)
- *   npx pathway behaviour <id>         # Detail view
- *   npx pathway behaviour --validate   # Validation checks
+ *   bunx pathway behaviour              # Summary with stats
+ *   bunx pathway behaviour --list       # IDs only (for piping)
+ *   bunx pathway behaviour <id>         # Detail view
+ *   bunx pathway behaviour --validate   # Validation checks
  */
 
 import { createEntityCommand } from "./command-factory.js";
@@ -43,8 +43,8 @@ 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 and names`);
-  console.log(`Run 'npx pathway behaviour <id>' for details\n`);
+  console.log(`\nRun 'bunx pathway behaviour --list' for IDs and names`);
+  console.log(`Run 'bunx pathway behaviour <id>' for details\n`);
 }
 
 /**

package/src/commands/build.js

@@ -215,7 +215,7 @@ Output: ${outputDir}
 ${siteUrl ? `\nDistribution:\n  ${outputDir}/bundle.tar.gz\n  ${outputDir}/install.sh\n` : ""}
 To serve locally:
   cd ${relative(process.cwd(), outputDir) || "."}
-  npx serve .
+  bunx serve .
 `);
 }
 

package/src/commands/command-factory.js

@@ -89,7 +89,7 @@ export function createEntityCommand({
 function handleValidate({ data, _entityName, pluralName, validate }) {
   if (!validate) {
     console.log(`No specific validation for ${pluralName}.`);
-    console.log(`Run 'npx pathway --validate' for full data validation.`);
+    console.log(`Run 'bunx pathway --validate' for full data validation.`);
     return;
   }
 
@@ -178,7 +178,7 @@ export function createCompositeCommand({
   return async function runCommand({ data, args, options }) {
     if (args.length < requiredArgs.length) {
       const argsList = requiredArgs.map((arg) => `<${arg}>`).join(" ");
-      console.error(`Usage: npx pathway ${commandName} ${argsList}`);
+      console.error(`Usage: bunx pathway ${commandName} ${argsList}`);
       if (usageExample) {
         console.error(`Example: ${usageExample}`);
       }

package/src/commands/discipline.js

@@ -4,10 +4,10 @@
  * Handles discipline summary, listing, and detail display in the terminal.
  *
  * Usage:
- *   npx pathway discipline              # Summary with stats
- *   npx pathway discipline --list       # IDs only (for piping)
- *   npx pathway discipline <id>         # Detail view
- *   npx pathway discipline --validate   # Validation checks
+ *   bunx pathway discipline              # Summary with stats
+ *   bunx pathway discipline --list       # IDs only (for piping)
+ *   bunx pathway discipline <id>         # Detail view
+ *   bunx pathway discipline --validate   # Validation checks
  */
 
 import { createEntityCommand } from "./command-factory.js";
@@ -43,8 +43,8 @@ function formatSummary(disciplines) {
 
   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`);
+  console.log(`\nRun 'bunx pathway discipline --list' for IDs and names`);
+  console.log(`Run 'bunx pathway discipline <id>' for details\n`);
 }
 
 /**

package/src/commands/driver.js

@@ -4,10 +4,10 @@
  * Handles driver summary, listing, and detail display in the terminal.
  *
  * Usage:
- *   npx pathway driver              # Summary with stats
- *   npx pathway driver --list       # IDs only (for piping)
- *   npx pathway driver <id>         # Detail view
- *   npx pathway driver --validate   # Validation checks
+ *   bunx pathway driver              # Summary with stats
+ *   bunx pathway driver --list       # IDs only (for piping)
+ *   bunx pathway driver <id>         # Detail view
+ *   bunx pathway driver --validate   # Validation checks
  */
 
 import { createEntityCommand } from "./command-factory.js";
@@ -52,8 +52,8 @@ 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 and names`);
-  console.log(`Run 'npx pathway driver <id>' for details\n`);
+  console.log(`\nRun 'bunx pathway driver --list' for IDs and names`);
+  console.log(`Run 'bunx pathway driver <id>' for details\n`);
 }
 
 /**

package/src/commands/init.js

@@ -1,26 +1,15 @@
 /**
  * Init Command
  *
- * Initializes a new Engineering Pathway project by copying example data.
+ * Initializes a new Engineering Pathway project by copying starter data.
  */
 
 import { cp, access } from "fs/promises";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-// Prefer monorepo root examples/framework/, fall back to legacy co-located examples/
-const monorepoExamplesDir = join(
-  __dirname,
-  "..",
-  "..",
-  "..",
-  "..",
-  "examples",
-  "framework",
-);
-const legacyExamplesDir = join(__dirname, "..", "..", "examples");
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const starterDir = join(__dirname, "..", "..", "starter");
 
 /**
  * Run the init command
@@ -29,56 +18,47 @@ const legacyExamplesDir = join(__dirname, "..", "..", "examples");
  */
 export async function runInitCommand({ options }) {
   const targetPath = options.path || process.cwd();
-  const dataDir = join(targetPath, "data");
+  const dataDir = join(targetPath, "data", "pathway");
 
-  // Check if data/ already exists
+  // Check if data/pathway/ already exists
   try {
     await access(dataDir);
-    console.error("Error: ./data/ already exists.");
+    console.error("Error: ./data/pathway/ already exists.");
     console.error("Remove it first or use a different directory.");
     process.exit(1);
   } catch {
     // Directory doesn't exist, proceed
   }
 
-  // Find examples directory — monorepo root first, then legacy
-  let examplesDir;
+  // Verify starter data is available
   try {
-    await access(monorepoExamplesDir);
-    examplesDir = monorepoExamplesDir;
+    await access(starterDir);
   } catch {
-    try {
-      await access(legacyExamplesDir);
-      examplesDir = legacyExamplesDir;
-    } catch {
-      console.error("Error: Examples directory not found in package.");
-      console.error("This may indicate a corrupted package installation.");
-      process.exit(1);
-    }
+    console.error("Error: Starter data not found in package.");
+    console.error("This may indicate a corrupted package installation.");
+    process.exit(1);
   }
 
-  // Copy example data
-  console.log("Creating ./data/ with example data...\n");
-  await cp(examplesDir, dataDir, { recursive: true });
+  // Copy starter data
+  console.log("Creating ./data/pathway/ with starter data...\n");
+  await cp(starterDir, dataDir, { recursive: true });
 
-  console.log(`✅ Created ./data/ with example data.
+  console.log(`✅ Created ./data/pathway/ with starter data.
 
 Next steps:
   1. Edit data files to match your organization
-  2. npx pathway --validate
-  3. npx pathway serve
+  2. bunx fit-map validate
+  3. bunx fit-pathway dev
 
 Data structure:
-  data/
-  ├── framework.yaml      # Framework metadata
-  ├── levels.yaml         # Career levels
-  ├── stages.yaml         # Lifecycle stages
-  ├── drivers.yaml        # Business drivers
-  ├── capabilities.yaml   # Capability areas
-  ├── disciplines/        # Engineering disciplines
-  ├── tracks/             # Role tracks
-  ├── skills/             # Technical skills
-  ├── behaviours/         # Behavioural expectations
-  └── questions/          # Interview questions
+  data/pathway/
+  ├── framework.yaml        # Framework metadata
+  ├── levels.yaml           # Career levels
+  ├── stages.yaml           # Lifecycle stages
+  ├── drivers.yaml          # Business drivers
+  ├── disciplines/          # Engineering disciplines
+  ├── capabilities/         # Capability areas with skills
+  ├── behaviours/           # Behavioural expectations
+  └── tracks/               # Track specializations
 `);
 }

package/src/commands/interview.js

@@ -4,9 +4,9 @@
  * Generates and displays interview questions in the terminal.
  *
  * Usage:
- *   npx fit-pathway interview <discipline> <level>                                  # All interview types
- *   npx fit-pathway interview <discipline> <level> --track=<track>                  # With track
- *   npx fit-pathway interview <discipline> <level> --track=<track> --type=mission   # Single type
+ *   bunx fit-pathway interview <discipline> <level>                                  # All interview types
+ *   bunx fit-pathway interview <discipline> <level> --track=<track>                  # With track
+ *   bunx fit-pathway interview <discipline> <level> --track=<track> --type=mission   # Single type
  */
 
 import { createCompositeCommand } from "./command-factory.js";
@@ -109,5 +109,5 @@ export const runInterviewCommand = createCompositeCommand({
     }
   },
   usageExample:
-    "npx fit-pathway interview software_engineering J090 --track=platform --type=mission",
+    "bunx fit-pathway interview software_engineering J090 --track=platform --type=mission",
 });

package/src/commands/job.js

@@ -4,14 +4,14 @@
  * Generates and displays job definitions in the terminal.
  *
  * Usage:
- *   npx pathway job                                          # Summary with stats
- *   npx pathway job --list                                   # All valid combinations (for piping)
- *   npx pathway job <discipline> <level>                     # Detail view (trackless)
- *   npx pathway job <discipline> <level> --track=<track>     # Detail view (with track)
- *   npx pathway job <d> <l> [--track=<t>] --skills           # Plain list of skill IDs
- *   npx pathway job <d> <l> [--track=<t>] --tools            # Plain list of tool names
- *   npx pathway job se L3 --track=platform --checklist=code  # Show checklist for handoff
- *   npx pathway job --validate                               # Validation checks
+ *   bunx pathway job                                          # Summary with stats
+ *   bunx pathway job --list                                   # All valid combinations (for piping)
+ *   bunx pathway job <discipline> <level>                     # Detail view (trackless)
+ *   bunx pathway job <discipline> <level> --track=<track>     # Detail view (with track)
+ *   bunx pathway job <d> <l> [--track=<t>] --skills           # Plain list of skill IDs
+ *   bunx pathway job <d> <l> [--track=<t>] --tools            # Plain list of tool names
+ *   bunx pathway job se L3 --track=platform --checklist=code  # Show checklist for handoff
+ *   bunx pathway job --validate                               # Validation checks
  */
 
 import { prepareJobDetail } from "@forwardimpact/libskill/job";
@@ -135,10 +135,10 @@ export async function runJobCommand({
     );
     console.log(`\nTotal: ${filteredJobs.length} valid job combinations`);
     console.log(
-      `\nRun 'npx pathway job --list' for all combinations with titles`,
+      `\nRun 'bunx pathway job --list' for all combinations with titles`,
     );
     console.log(
-      `Run 'npx pathway job <discipline> <level> [--track=<track>]' for details\n`,
+      `Run 'bunx pathway job <discipline> <level> [--track=<track>]' for details\n`,
     );
     return;
   }
@@ -151,7 +151,7 @@ export async function runJobCommand({
     const isTrack = data.tracks.some((t) => t.id === arg);
     if (isLevel) {
       console.error(
-        `Missing discipline. Usage: npx pathway job <discipline> ${arg} [--track=<track>]`,
+        `Missing discipline. Usage: bunx pathway job <discipline> ${arg} [--track=<track>]`,
       );
       console.error(
         `Disciplines: ${data.disciplines.map((d) => d.id).join(", ")}`,
@@ -159,13 +159,13 @@ export async function runJobCommand({
     } else if (isTrack) {
       console.error(`Track must be passed as a flag: --track=${arg}`);
       console.error(
-        `Usage: npx pathway job <discipline> <level> --track=${arg}`,
+        `Usage: bunx pathway job <discipline> <level> --track=${arg}`,
       );
     } else {
       console.error(
-        "Usage: npx pathway job <discipline> <level> [--track=<track>]",
+        "Usage: bunx pathway job <discipline> <level> [--track=<track>]",
       );
-      console.error("       npx pathway job --list");
+      console.error("       bunx pathway job --list");
     }
     process.exit(1);
   }
@@ -183,7 +183,7 @@ export async function runJobCommand({
     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}` : ""}`,
+        `  bunx pathway job ${args[1]} ${args[0]}${options.track ? ` --track=${options.track}` : ""}`,
       );
     } else {
       console.error(`Discipline not found: ${args[0]}`);
@@ -201,7 +201,7 @@ export async function runJobCommand({
       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(`  bunx 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]}`);

package/src/commands/level.js

@@ -4,10 +4,10 @@
  * 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
+ *   bunx pathway level              # Summary with stats
+ *   bunx pathway level --list       # IDs only (for piping)
+ *   bunx pathway level <id>         # Detail view
+ *   bunx pathway level --validate   # Validation checks
  */
 
 import { createEntityCommand } from "./command-factory.js";
@@ -57,8 +57,8 @@ function formatSummary(levels, data) {
     ),
   );
   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`);
+  console.log(`\nRun 'bunx pathway level --list' for IDs and titles`);
+  console.log(`Run 'bunx pathway level <id>' for details\n`);
 }
 
 /**

package/src/commands/progress.js

@@ -4,9 +4,9 @@
  * Shows career progression analysis in the terminal.
  *
  * Usage:
- *   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
+ *   bunx pathway progress <discipline> <level>                            # Progress for trackless job
+ *   bunx pathway progress <discipline> <level> --track=<track>            # Progress with track
+ *   bunx pathway progress <discipline> <from_level> --compare=<to_level>  # Compare levels
  */
 
 import { createCompositeCommand } from "./command-factory.js";
@@ -80,5 +80,5 @@ export const runProgressCommand = createCompositeCommand({
     }),
   formatter: formatProgress,
   usageExample:
-    "npx pathway progress software_engineering L3 --track=platform --compare=L4",
+    "bunx pathway progress software_engineering L3 --track=platform --compare=L4",
 });