@forwardimpact/pathway 0.25.22 → 0.25.25

package/src/commands/stage.js

@@ -4,9 +4,9 @@
  * Handles stage summary, listing, and detail display in the terminal.
  *
  * Usage:
- *   bunx pathway stage              # Summary with lifecycle flow
- *   bunx pathway stage --list       # IDs only (for piping)
- *   bunx pathway stage <id>         # Detail view
+ *   npx fit-pathway stage              # Summary with lifecycle flow
+ *   npx fit-pathway stage --list       # IDs only (for piping)
+ *   npx fit-pathway stage <id>         # Detail view
  */
 
 import { createEntityCommand } from "./command-factory.js";
@@ -14,12 +14,13 @@ import {
   prepareStageDetail,
   getStageEmoji,
 } from "../formatters/stage/shared.js";
-import { formatTable } from "../lib/cli-output.js";
 import {
+  formatTable,
   formatHeader,
   formatSubheader,
   formatBullet,
-} from "../lib/cli-output.js";
+  formatWarning,
+} from "@forwardimpact/libcli";
 
 /**
  * Format stage list item for --list output
@@ -36,13 +37,13 @@ function formatListItem(stage) {
  * @param {Object} _data - Full data context (unused)
  */
 function formatSummary(stages, _data) {
-  console.log("\n🔄 Stages\n");
+  process.stdout.write("\n" + formatHeader("\u{1F504} Stages") + "\n\n");
 
   // Show lifecycle flow
   const flow = stages
     .map((s) => `${getStageEmoji(stages, s.id)} ${s.name}`)
     .join(" → ");
-  console.log(`Lifecycle: ${flow}\n`);
+  process.stdout.write(formatSubheader(`Lifecycle: ${flow}`) + "\n\n");
 
   const rows = stages.map((s) => {
     const toolCount = s.tools?.length || 0;
@@ -50,10 +51,18 @@ function formatSummary(stages, _data) {
     return [s.id, s.name, s.mode, toolCount, handoffCount];
   });
 
-  console.log(formatTable(["ID", "Name", "Mode", "Tools", "Handoffs"], rows));
-  console.log(`\nTotal: ${stages.length} stages`);
-  console.log(`\nRun 'bunx pathway stage --list' for IDs and names`);
-  console.log(`Run 'bunx pathway stage <id>' for details\n`);
+  process.stdout.write(
+    formatTable(["ID", "Name", "Mode", "Tools", "Handoffs"], rows) + "\n",
+  );
+  process.stdout.write(
+    "\n" + formatSubheader(`Total: ${stages.length} stages`) + "\n\n",
+  );
+  process.stdout.write(
+    formatBullet("Run 'npx fit-pathway stage --list' for IDs and names") + "\n",
+  );
+  process.stdout.write(
+    formatBullet("Run 'npx fit-pathway stage <id>' for details") + "\n\n",
+  );
 }
 
 /**
@@ -66,51 +75,52 @@ function formatDetail(viewAndContext, _framework) {
   const view = prepareStageDetail(stage);
   const emoji = getStageEmoji(stages, stage.id);
 
-  console.log(formatHeader(`\n${emoji} ${view.name}\n`));
-  console.log(`${view.description}\n`);
+  process.stdout.write("\n" + formatHeader(`${emoji} ${view.name}`) + "\n\n");
+  process.stdout.write(view.description + "\n\n");
 
   // Read checklist
   if (view.readChecklist.length > 0) {
-    console.log(formatSubheader("Read-Then-Do Checklist\n"));
+    process.stdout.write(formatSubheader("Read-Then-Do Checklist") + "\n\n");
     for (const item of view.readChecklist) {
-      console.log(formatBullet(item, 1));
+      process.stdout.write(formatBullet(item, 1) + "\n");
     }
-    console.log();
+    process.stdout.write("\n");
   }
 
   // Confirm checklist
   if (view.confirmChecklist.length > 0) {
-    console.log(formatSubheader("Do-Then-Confirm Checklist\n"));
+    process.stdout.write(formatSubheader("Do-Then-Confirm Checklist") + "\n\n");
     for (const item of view.confirmChecklist) {
-      console.log(formatBullet(item, 1));
+      process.stdout.write(formatBullet(item, 1) + "\n");
     }
-    console.log();
+    process.stdout.write("\n");
   }
 
   // Constraints
   if (view.constraints.length > 0) {
-    console.log(formatSubheader("Constraints\n"));
+    process.stdout.write(formatSubheader("Constraints") + "\n\n");
     for (const item of view.constraints) {
-      console.log(formatBullet(`⚠️  ${item}`, 1));
+      process.stdout.write("  " + formatWarning(item) + "\n");
     }
-    console.log();
+    process.stdout.write("\n");
   }
 
   // Handoffs
   if (view.handoffs.length > 0) {
-    console.log(formatSubheader("Handoffs\n"));
+    process.stdout.write(formatSubheader("Handoffs") + "\n\n");
     for (const handoff of view.handoffs) {
       const targetStage = stages.find((s) => s.id === handoff.target);
       const targetEmoji = getStageEmoji(stages, handoff.target);
       const targetName = targetStage?.name || handoff.target;
-      console.log(
-        formatBullet(`${targetEmoji} ${handoff.label} → ${targetName}`, 1),
+      process.stdout.write(
+        formatBullet(`${targetEmoji} ${handoff.label} → ${targetName}`, 1) +
+          "\n",
       );
       if (handoff.prompt) {
-        console.log(`      "${handoff.prompt}"`);
+        process.stdout.write(`      "${handoff.prompt}"\n`);
       }
     }
-    console.log();
+    process.stdout.write("\n");
   }
 }
 

package/src/commands/tool.js

@@ -4,9 +4,9 @@
  * Handles tool summary, listing, and detail display in the terminal.
  *
  * Usage:
- *   bunx pathway tool              # Summary with stats
- *   bunx pathway tool --list       # Tool names only (for piping)
- *   bunx pathway tool <name>       # Detail view for specific tool
+ *   npx fit-pathway tool              # Summary with stats
+ *   npx fit-pathway tool --list       # Tool names only (for piping)
+ *   npx fit-pathway tool <name>       # Detail view for specific tool
  */
 
 import { truncate } from "../formatters/shared.js";
@@ -15,7 +15,9 @@ import {
   formatTable,
   formatHeader,
   formatSubheader,
-} from "../lib/cli-output.js";
+  formatBullet,
+  formatError,
+} from "@forwardimpact/libcli";
 
 /**
  * Run tool command
@@ -50,8 +52,8 @@ export async function runToolCommand({ data, args, options }) {
   const tool = tools.find((t) => t.name.toLowerCase() === name.toLowerCase());
 
   if (!tool) {
-    console.error(`Tool not found: ${name}`);
-    console.error(`Available: ${tools.map((t) => t.name).join(", ")}`);
+    process.stderr.write(formatError(`Tool not found: ${name}`) + "\n");
+    process.stderr.write(`Available: ${tools.map((t) => t.name).join(", ")}\n`);
     process.exit(1);
   }
 
@@ -69,7 +71,7 @@ export async function runToolCommand({ data, args, options }) {
  * @param {number} totalCount - Total tool count
  */
 function formatSummary(tools, totalCount) {
-  console.log(`\n🔧 Tools\n`);
+  process.stdout.write("\n" + formatHeader("\u{1F527} Tools") + "\n\n");
 
   // Show tools sorted by usage count
   const sorted = [...tools].sort((a, b) => b.usages.length - a.usages.length);
@@ -83,15 +85,24 @@ function formatSummary(tools, totalCount) {
         : t.description,
     ]);
 
-  console.log(formatTable(["Tool", "Skills", "Description"], rows));
-  console.log(`\nTotal: ${totalCount} tools`);
+  process.stdout.write(
+    formatTable(["Tool", "Skills", "Description"], rows) + "\n",
+  );
+  process.stdout.write(
+    "\n" + formatSubheader(`Total: ${totalCount} tools`) + "\n",
+  );
   if (sorted.length > 15) {
-    console.log(`(showing top 15 by usage)`);
+    process.stdout.write(formatBullet("(showing top 15 by usage)") + "\n");
   }
-  console.log(
-    `\nRun 'bunx pathway tool --list' for all tool names and descriptions`,
+  process.stdout.write("\n");
+  process.stdout.write(
+    formatBullet(
+      "Run 'npx fit-pathway tool --list' for all tool names and descriptions",
+    ) + "\n",
+  );
+  process.stdout.write(
+    formatBullet("Run 'npx fit-pathway tool <name>' for details") + "\n\n",
   );
-  console.log(`Run 'bunx pathway tool <name>' for details\n`);
 }
 
 /**
@@ -99,17 +110,16 @@ function formatSummary(tools, totalCount) {
  * @param {Object} tool - Aggregated tool with usages
  */
 function formatDetail(tool) {
-  console.log(formatHeader(`\n🔧 ${tool.name}\n`));
-  console.log(`${tool.description}\n`);
+  process.stdout.write("\n" + formatHeader(`\u{1F527} ${tool.name}`) + "\n\n");
+  process.stdout.write(tool.description + "\n\n");
 
   if (tool.url) {
-    console.log(`Documentation: ${tool.url}\n`);
+    process.stdout.write(`Documentation: ${tool.url}\n\n`);
   }
 
   if (tool.usages.length > 0) {
-    console.log(formatSubheader("Used in Skills\n"));
+    process.stdout.write(formatSubheader("Used in Skills") + "\n\n");
     const rows = tool.usages.map((u) => [u.skillName, u.useWhen]);
-    console.log(formatTable(["Skill", "Use When"], rows));
-    console.log();
+    process.stdout.write(formatTable(["Skill", "Use When"], rows) + "\n\n");
   }
 }

package/src/commands/track.js

@@ -4,16 +4,21 @@
  * Handles track summary, listing, and detail display in the terminal.
  *
  * Usage:
- *   bunx pathway track              # Summary with stats
- *   bunx pathway track --list       # IDs only (for piping)
- *   bunx pathway track <id>         # Detail view
- *   bunx pathway track --validate   # Validation checks
+ *   npx fit-pathway track              # Summary with stats
+ *   npx fit-pathway track --list       # IDs only (for piping)
+ *   npx fit-pathway track <id>         # Detail view
+ *   npx fit-pathway track --validate   # Validation checks
  */
 
 import { createEntityCommand } from "./command-factory.js";
 import { trackToMarkdown } from "../formatters/track/markdown.js";
 import { sortTracksByName } from "../formatters/track/shared.js";
-import { formatTable } from "../lib/cli-output.js";
+import {
+  formatTable,
+  formatHeader,
+  formatSubheader,
+  formatBullet,
+} from "@forwardimpact/libcli";
 import { getConceptEmoji } from "@forwardimpact/map/levels";
 
 /**
@@ -34,7 +39,7 @@ function formatSummary(tracks, data) {
   const { framework, disciplines } = data;
   const emoji = framework ? getConceptEmoji(framework, "track") : "🛤️";
 
-  console.log(`\n${emoji} Tracks\n`);
+  process.stdout.write("\n" + formatHeader(`${emoji} Tracks`) + "\n\n");
 
   const rows = tracks.map((t) => {
     const modCount = Object.keys(t.skillModifiers || {}).length;
@@ -47,10 +52,18 @@ function formatSummary(tracks, data) {
     return [t.id, t.name, modCount, disciplineNames || "—"];
   });
 
-  console.log(formatTable(["ID", "Name", "Modifiers", "Disciplines"], rows));
-  console.log(`\nTotal: ${tracks.length} tracks`);
-  console.log(`\nRun 'bunx pathway track --list' for IDs and names`);
-  console.log(`Run 'bunx pathway track <id>' for details\n`);
+  process.stdout.write(
+    formatTable(["ID", "Name", "Modifiers", "Disciplines"], rows) + "\n",
+  );
+  process.stdout.write(
+    "\n" + formatSubheader(`Total: ${tracks.length} tracks`) + "\n\n",
+  );
+  process.stdout.write(
+    formatBullet("Run 'npx fit-pathway track --list' for IDs and names") + "\n",
+  );
+  process.stdout.write(
+    formatBullet("Run 'npx fit-pathway track <id>' for details") + "\n\n",
+  );
 }
 
 /**

package/src/formatters/questions/yaml.js

@@ -26,7 +26,7 @@ export function questionsToYaml(view, _options = {}) {
 
   const filterStr =
     filterParts.length > 0 ? filterParts.join(" ") : "(no filters)";
-  const header = `# Generated by: bunx pathway questions ${filterStr}\n# Questions: ${questions.length}\n\n`;
+  const header = `# Generated by: npx fit-pathway questions ${filterStr}\n# Questions: ${questions.length}\n\n`;
 
   // Group questions by source
   const bySource = {};

package/src/index.html

@@ -83,7 +83,7 @@
         <div class="top-bar__command">
           <span class="top-bar__prompt">$</span>
           <span class="top-bar__command-text" id="cli-command"
-            >bunx fit-pathway</span
+            >npx fit-pathway</span
           >
           <button class="top-bar__copy" id="cli-copy" aria-label="Copy command">
             <svg viewBox="0 0 24 24">

package/src/lib/cli-command.js

@@ -1,7 +1,7 @@
 /**
  * CLI Command Mapping
  *
- * Maps hash routes to their equivalent `bunx fit-pathway` CLI commands.
+ * Maps hash routes to their equivalent `npx fit-pathway` CLI commands.
  */
 
 /**
@@ -11,122 +11,122 @@
  */
 const ROUTE_COMMANDS = [
   // Landing
-  { pattern: /^\/$/, toCommand: () => "bunx fit-pathway" },
+  { pattern: /^\/$/, toCommand: () => "npx fit-pathway" },
 
   // Entity lists
-  { pattern: /^\/skill$/, toCommand: () => "bunx fit-pathway skill" },
-  { pattern: /^\/behaviour$/, toCommand: () => "bunx fit-pathway behaviour" },
+  { pattern: /^\/skill$/, toCommand: () => "npx fit-pathway skill" },
+  { pattern: /^\/behaviour$/, toCommand: () => "npx fit-pathway behaviour" },
   {
     pattern: /^\/discipline$/,
-    toCommand: () => "bunx fit-pathway discipline",
+    toCommand: () => "npx fit-pathway discipline",
   },
-  { pattern: /^\/track$/, toCommand: () => "bunx fit-pathway track" },
-  { pattern: /^\/level$/, toCommand: () => "bunx fit-pathway level" },
-  { pattern: /^\/driver$/, toCommand: () => "bunx fit-pathway driver" },
-  { pattern: /^\/stage$/, toCommand: () => "bunx fit-pathway stage" },
-  { pattern: /^\/tool$/, toCommand: () => "bunx fit-pathway tool" },
+  { pattern: /^\/track$/, toCommand: () => "npx fit-pathway track" },
+  { pattern: /^\/level$/, toCommand: () => "npx fit-pathway level" },
+  { pattern: /^\/driver$/, toCommand: () => "npx fit-pathway driver" },
+  { pattern: /^\/stage$/, toCommand: () => "npx fit-pathway stage" },
+  { pattern: /^\/tool$/, toCommand: () => "npx fit-pathway tool" },
 
   // Entity details
   {
     pattern: /^\/skill\/(.+)$/,
-    toCommand: (m) => `bunx fit-pathway skill ${m[1]}`,
+    toCommand: (m) => `npx fit-pathway skill ${m[1]}`,
   },
   {
     pattern: /^\/behaviour\/(.+)$/,
-    toCommand: (m) => `bunx fit-pathway behaviour ${m[1]}`,
+    toCommand: (m) => `npx fit-pathway behaviour ${m[1]}`,
   },
   {
     pattern: /^\/discipline\/(.+)$/,
-    toCommand: (m) => `bunx fit-pathway discipline ${m[1]}`,
+    toCommand: (m) => `npx fit-pathway discipline ${m[1]}`,
   },
   {
     pattern: /^\/track\/(.+)$/,
-    toCommand: (m) => `bunx fit-pathway track ${m[1]}`,
+    toCommand: (m) => `npx fit-pathway track ${m[1]}`,
   },
   {
     pattern: /^\/level\/(.+)$/,
-    toCommand: (m) => `bunx fit-pathway level ${m[1]}`,
+    toCommand: (m) => `npx fit-pathway level ${m[1]}`,
   },
   {
     pattern: /^\/driver\/(.+)$/,
-    toCommand: (m) => `bunx fit-pathway driver ${m[1]}`,
+    toCommand: (m) => `npx fit-pathway driver ${m[1]}`,
   },
   {
     pattern: /^\/stage\/(.+)$/,
-    toCommand: (m) => `bunx fit-pathway stage ${m[1]}`,
+    toCommand: (m) => `npx fit-pathway stage ${m[1]}`,
   },
 
   // Job builder + detail
   {
     pattern: /^\/job-builder$/,
-    toCommand: () => "bunx fit-pathway job --list",
+    toCommand: () => "npx fit-pathway job --list",
   },
   {
     pattern: /^\/job\/([^/]+)\/([^/]+)\/([^/]+)$/,
-    toCommand: (m) => `bunx fit-pathway job ${m[1]} ${m[2]} --track=${m[3]}`,
+    toCommand: (m) => `npx fit-pathway job ${m[1]} ${m[2]} --track=${m[3]}`,
   },
   {
     pattern: /^\/job\/([^/]+)\/([^/]+)$/,
-    toCommand: (m) => `bunx fit-pathway job ${m[1]} ${m[2]}`,
+    toCommand: (m) => `npx fit-pathway job ${m[1]} ${m[2]}`,
   },
 
   // Interview builder + detail
   {
     pattern: /^\/interview-prep$/,
-    toCommand: () => "bunx fit-pathway interview --list",
+    toCommand: () => "npx fit-pathway interview --list",
   },
   {
     pattern: /^\/interview\/([^/]+)\/([^/]+)\/([^/]+)$/,
     toCommand: (m) =>
-      `bunx fit-pathway interview ${m[1]} ${m[2]} --track=${m[3]}`,
+      `npx fit-pathway interview ${m[1]} ${m[2]} --track=${m[3]}`,
   },
   {
     pattern: /^\/interview\/([^/]+)\/([^/]+)$/,
-    toCommand: (m) => `bunx fit-pathway interview ${m[1]} ${m[2]}`,
+    toCommand: (m) => `npx fit-pathway interview ${m[1]} ${m[2]}`,
   },
 
   // Career progress builder + detail
   {
     pattern: /^\/career-progress$/,
-    toCommand: () => "bunx fit-pathway progress --list",
+    toCommand: () => "npx fit-pathway progress --list",
   },
   {
     pattern: /^\/progress\/([^/]+)\/([^/]+)\/([^/]+)$/,
     toCommand: (m) =>
-      `bunx fit-pathway progress ${m[1]} ${m[2]} --track=${m[3]}`,
+      `npx fit-pathway progress ${m[1]} ${m[2]} --track=${m[3]}`,
   },
   {
     pattern: /^\/progress\/([^/]+)\/([^/]+)$/,
-    toCommand: (m) => `bunx fit-pathway progress ${m[1]} ${m[2]}`,
+    toCommand: (m) => `npx fit-pathway progress ${m[1]} ${m[2]}`,
   },
 
   // Self-assessment
   {
     pattern: /^\/self-assessment$/,
-    toCommand: () => "bunx fit-pathway self-assessment",
+    toCommand: () => "npx fit-pathway self-assessment",
   },
   {
     pattern: /^\/self-assessment\/results$/,
-    toCommand: () => "bunx fit-pathway self-assessment",
+    toCommand: () => "npx fit-pathway self-assessment",
   },
 
   // Agent builder + detail
   {
     pattern: /^\/agent-builder$/,
-    toCommand: () => "bunx fit-pathway agent --list",
+    toCommand: () => "npx fit-pathway agent --list",
   },
   {
     pattern: /^\/agent\/([^/]+)\/([^/]+)\/([^/]+)$/,
     toCommand: (m) =>
-      `bunx fit-pathway agent ${m[1]} --track=${m[2]} --stage=${m[3]}`,
+      `npx fit-pathway agent ${m[1]} --track=${m[2]} --stage=${m[3]}`,
   },
   {
     pattern: /^\/agent\/([^/]+)\/([^/]+)$/,
-    toCommand: (m) => `bunx fit-pathway agent ${m[1]} --track=${m[2]}`,
+    toCommand: (m) => `npx fit-pathway agent ${m[1]} --track=${m[2]}`,
   },
   {
     pattern: /^\/agent\/([^/]+)$/,
-    toCommand: (m) => `bunx fit-pathway agent ${m[1]}`,
+    toCommand: (m) => `npx fit-pathway agent ${m[1]}`,
   },
 ];
 
@@ -141,5 +141,5 @@ export function getCliCommand(hashPath) {
     const match = path.match(pattern);
     if (match) return toCommand(match);
   }
-  return "bunx fit-pathway";
+  return "npx fit-pathway";
 }