@forwardimpact/pathway 0.25.24 → 0.25.26

package/src/commands/questions.js

@@ -17,7 +17,12 @@ import {
 import { questionsToMarkdown } from "../formatters/questions/markdown.js";
 import { questionsToYaml } from "../formatters/questions/yaml.js";
 import { questionsToJson } from "../formatters/questions/json.js";
-import { formatTable } from "@forwardimpact/libcli";
+import {
+  formatTable,
+  formatHeader,
+  formatSubheader,
+  formatBullet,
+} from "@forwardimpact/libcli";
 
 /**
  * Parse questions command options
@@ -46,7 +51,7 @@ function showQuestionsSummary(data) {
   const { skills, behaviours } = data;
   const questions = data.questions;
 
-  console.log(`\n❓ Questions\n`);
+  process.stdout.write("\n" + formatHeader("\u2753 Questions") + "\n\n");
 
   // Skill questions by level
   const skillProficiencies = [
@@ -70,8 +75,8 @@ function showQuestionsSummary(data) {
     return [level, count];
   });
 
-  console.log("Skill Questions:");
-  console.log(formatTable(["Level", "Count"], skillRows));
+  process.stdout.write(formatSubheader("Skill Questions") + "\n");
+  process.stdout.write(formatTable(["Level", "Count"], skillRows) + "\n");
 
   // Behaviour questions by maturity
   const maturities = [
@@ -94,13 +99,24 @@ function showQuestionsSummary(data) {
     return [maturity.replace(/_/g, " "), count];
   });
 
-  console.log("\nBehaviour Questions:");
-  console.log(formatTable(["Maturity", "Count"], behaviourRows));
+  process.stdout.write("\n" + formatSubheader("Behaviour Questions") + "\n");
+  process.stdout.write(
+    formatTable(["Maturity", "Count"], behaviourRows) + "\n",
+  );
 
-  console.log(`\nRun 'npx fit-pathway questions --list' for question IDs`);
-  console.log(`Run 'npx fit-pathway questions --stats' for detailed stats`);
-  console.log(
-    `Run 'npx fit-pathway questions --level=practitioner' to filter\n`,
+  process.stdout.write("\n");
+  process.stdout.write(
+    formatBullet("Run 'npx fit-pathway questions --list' for question IDs") +
+      "\n",
+  );
+  process.stdout.write(
+    formatBullet("Run 'npx fit-pathway questions --stats' for detailed stats") +
+      "\n",
+  );
+  process.stdout.write(
+    formatBullet(
+      "Run 'npx fit-pathway questions --level=practitioner' to filter",
+    ) + "\n\n",
   );
 }
 

package/src/commands/skill.js

@@ -15,7 +15,13 @@ import { createEntityCommand } from "./command-factory.js";
 import { skillToMarkdown } from "../formatters/skill/markdown.js";
 import { prepareSkillsList } from "../formatters/skill/shared.js";
 import { getConceptEmoji } from "@forwardimpact/map/levels";
-import { formatTable, formatError } from "@forwardimpact/libcli";
+import {
+  formatTable,
+  formatError,
+  formatHeader,
+  formatSubheader,
+  formatBullet,
+} from "@forwardimpact/libcli";
 import { generateSkillMarkdown } from "@forwardimpact/libskill/agent";
 import { formatAgentSkill } from "../formatters/agent/skill.js";
 
@@ -29,7 +35,7 @@ function formatSummary(skills, data) {
   const { groups, groupOrder } = prepareSkillsList(skills, capabilities);
   const emoji = framework ? getConceptEmoji(framework, "skill") : "📚";
 
-  console.log(`\n${emoji} Skills\n`);
+  process.stdout.write("\n" + formatHeader(`${emoji} Skills`) + "\n\n");
 
   // Summary table by capability
   const rows = groupOrder.map((capability) => {
@@ -38,10 +44,18 @@ function formatSummary(skills, data) {
     return [capability, count, withAgent];
   });
 
-  console.log(formatTable(["Capability", "Count", "Agent"], rows));
-  console.log(`\nTotal: ${skills.length} skills`);
-  console.log(`\nRun 'npx fit-pathway skill --list' for IDs`);
-  console.log(`Run 'npx fit-pathway skill <id>' for details\n`);
+  process.stdout.write(
+    formatTable(["Capability", "Count", "Agent"], rows) + "\n",
+  );
+  process.stdout.write(
+    "\n" + formatSubheader(`Total: ${skills.length} skills`) + "\n\n",
+  );
+  process.stdout.write(
+    formatBullet("Run 'npx fit-pathway skill --list' for IDs") + "\n",
+  );
+  process.stdout.write(
+    formatBullet("Run 'npx fit-pathway skill <id>' for details") + "\n\n",
+  );
 }
 
 /**
@@ -70,10 +84,12 @@ function formatDetail(viewAndContext, framework) {
  */
 async function formatAgentDetail(skill, stages, templateLoader, dataDir) {
   if (!skill.agent) {
-    console.error(formatError(`Skill '${skill.id}' has no agent section`));
-    console.error(`\nSkills with agent support:`);
-    console.error(
-      `  npx fit-pathway skill --list | xargs -I{} sh -c 'npx fit-pathway skill {} --json | jq -e .skill.agent > /dev/null && echo {}'`,
+    process.stderr.write(
+      formatError(`Skill '${skill.id}' has no agent section`) + "\n",
+    );
+    process.stderr.write("\nSkills with agent support:\n");
+    process.stderr.write(
+      `  npx fit-pathway skill --list | xargs -I{} sh -c 'npx fit-pathway skill {} --json | jq -e .skill.agent > /dev/null && echo {}'\n`,
     );
     process.exit(1);
   }
@@ -81,7 +97,7 @@ async function formatAgentDetail(skill, stages, templateLoader, dataDir) {
   const template = templateLoader.load("skill.template.md", dataDir);
   const skillMd = generateSkillMarkdown({ skillData: skill, stages });
   const output = formatAgentSkill(skillMd, template);
-  console.log(output);
+  process.stdout.write(output + "\n");
 }
 
 /**
@@ -131,8 +147,10 @@ export async function runSkillCommand({
     const skill = data.skills.find((s) => s.id === id);
 
     if (!skill) {
-      console.error(formatError(`Skill not found: ${id}`));
-      console.error(`Available: ${data.skills.map((s) => s.id).join(", ")}`);
+      process.stderr.write(formatError(`Skill not found: ${id}`) + "\n");
+      process.stderr.write(
+        `Available: ${data.skills.map((s) => s.id).join(", ")}\n`,
+      );
       process.exit(1);
     }
 

package/src/commands/stage.js

@@ -19,6 +19,7 @@ import {
   formatHeader,
   formatSubheader,
   formatBullet,
+  formatWarning,
 } from "@forwardimpact/libcli";
 
 /**
@@ -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 'npx fit-pathway stage --list' for IDs and names`);
-  console.log(`Run 'npx fit-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

@@ -15,6 +15,8 @@ import {
   formatTable,
   formatHeader,
   formatSubheader,
+  formatBullet,
+  formatError,
 } from "@forwardimpact/libcli";
 
 /**
@@ -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 'npx fit-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 'npx fit-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

@@ -13,7 +13,12 @@
 import { createEntityCommand } from "./command-factory.js";
 import { trackToMarkdown } from "../formatters/track/markdown.js";
 import { sortTracksByName } from "../formatters/track/shared.js";
-import { formatTable } from "@forwardimpact/libcli";
+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 'npx fit-pathway track --list' for IDs and names`);
-  console.log(`Run 'npx fit-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/index.js

@@ -0,0 +1,7 @@
+// Public entry point for @forwardimpact/pathway.
+// The primary consumption mode is the CLI (fit-pathway) — this
+// re-export exists so the package conforms to the repo-wide layout
+// contract (spec 390) and so consumers who import
+// @forwardimpact/pathway directly receive the shared type
+// definitions.
+export * from "./types.js";