@forwardimpact/pathway 0.25.22 → 0.25.24

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,12 @@ 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";
+} from "@forwardimpact/libcli";
 
 /**
  * Format stage list item for --list output
@@ -52,8 +52,8 @@ function formatSummary(stages, _data) {
 
   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`);
+  console.log(`\nRun 'npx fit-pathway stage --list' for IDs and names`);
+  console.log(`Run 'npx fit-pathway stage <id>' for details\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,7 @@ import {
   formatTable,
   formatHeader,
   formatSubheader,
-} from "../lib/cli-output.js";
+} from "@forwardimpact/libcli";
 
 /**
  * Run tool command
@@ -89,9 +89,9 @@ function formatSummary(tools, totalCount) {
     console.log(`(showing top 15 by usage)`);
   }
   console.log(
-    `\nRun 'bunx pathway tool --list' for all tool names and descriptions`,
+    `\nRun 'npx fit-pathway tool --list' for all tool names and descriptions`,
   );
-  console.log(`Run 'bunx pathway tool <name>' for details\n`);
+  console.log(`Run 'npx fit-pathway tool <name>' for details\n`);
 }
 
 /**

package/src/commands/track.js

@@ -4,16 +4,16 @@
  * 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 } from "@forwardimpact/libcli";
 import { getConceptEmoji } from "@forwardimpact/map/levels";
 
 /**
@@ -49,8 +49,8 @@ function formatSummary(tracks, data) {
 
   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`);
+  console.log(`\nRun 'npx fit-pathway track --list' for IDs and names`);
+  console.log(`Run 'npx fit-pathway track <id>' for details\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";
 }

package/src/lib/cli-output.js

@@ -1,129 +1,12 @@
 /**
- * CLI Output Formatting Utilities
+ * Domain-specific CLI Output Formatters
  *
- * Provides consistent formatting for terminal output including colors,
- * tables, headers, and level formatting.
+ * Pathway-specific formatting for skill proficiencies, behaviour maturities,
+ * modifiers, percentages, and change indicators. Generic formatters (colors,
+ * tables, headers, etc.) live in @forwardimpact/libcli.
  */
 
-// ANSI color codes
-export const colors = {
-  reset: "\x1b[0m",
-  bold: "\x1b[1m",
-  dim: "\x1b[2m",
-  italic: "\x1b[3m",
-  underline: "\x1b[4m",
-  red: "\x1b[31m",
-  green: "\x1b[32m",
-  yellow: "\x1b[33m",
-  blue: "\x1b[34m",
-  magenta: "\x1b[35m",
-  cyan: "\x1b[36m",
-  white: "\x1b[37m",
-  gray: "\x1b[90m",
-};
-
-/**
- * Check if stdout supports colors
- * @returns {boolean}
- */
-export function supportsColor() {
-  if (process.env.NO_COLOR) return false;
-  if (process.env.FORCE_COLOR) return true;
-  return process.stdout.isTTY;
-}
-
-/**
- * Wrap text with color if supported
- * @param {string} text
- * @param {string} color
- * @returns {string}
- */
-function colorize(text, color) {
-  if (!supportsColor()) return text;
-  return `${color}${text}${colors.reset}`;
-}
-
-/**
- * Format a header
- * @param {string} text
- * @returns {string}
- */
-export function formatHeader(text) {
-  return colorize(text, colors.bold + colors.cyan);
-}
-
-/**
- * Format a subheader
- * @param {string} text
- * @returns {string}
- */
-export function formatSubheader(text) {
-  return colorize(text, colors.bold);
-}
-
-/**
- * Format a list item
- * @param {string} label
- * @param {string} value
- * @param {number} [indent=0]
- * @returns {string}
- */
-export function formatListItem(label, value, indent = 0) {
-  const padding = "  ".repeat(indent);
-  const bullet = colorize("•", colors.dim);
-  return `${padding}${bullet} ${label}: ${value}`;
-}
-
-/**
- * Format a bullet item (no label)
- * @param {string} text
- * @param {number} [indent=0]
- * @returns {string}
- */
-export function formatBullet(text, indent = 0) {
-  const padding = "  ".repeat(indent);
-  const bullet = colorize("•", colors.dim);
-  return `${padding}${bullet} ${text}`;
-}
-
-/**
- * Format a table
- * @param {string[]} headers
- * @param {Array<Array<string|number>>} rows
- * @param {Object} [options]
- * @param {boolean} [options.compact=false]
- * @returns {string}
- */
-export function formatTable(headers, rows, options = {}) {
-  const { compact = false } = options;
-
-  // Calculate column widths
-  const widths = headers.map((h, i) =>
-    Math.max(String(h).length, ...rows.map((r) => String(r[i] || "").length)),
-  );
-
-  const lines = [];
-
-  // Header
-  const headerLine = headers
-    .map((h, i) => String(h).padEnd(widths[i]))
-    .join("  ");
-  lines.push(colorize(headerLine, colors.bold));
-
-  // Separator
-  if (!compact) {
-    lines.push(widths.map((w) => "─".repeat(w)).join("──"));
-  }
-
-  // Rows
-  for (const row of rows) {
-    lines.push(
-      row.map((cell, i) => String(cell || "").padEnd(widths[i])).join("  "),
-    );
-  }
-
-  return lines.join("\n");
-}
+import { colorize, colors } from "@forwardimpact/libcli";
 
 /**
  * Format skill proficiency with color
@@ -193,78 +76,15 @@ export function formatPercent(value) {
 }
 
 /**
- * Format a change indicator (↑, ↓, →)
+ * Format a change indicator
  * @param {number} change
  * @returns {string}
  */
 export function formatChange(change) {
   if (change > 0) {
-    return colorize(`↑${change}`, colors.green);
+    return colorize(`\u2191${change}`, colors.green);
   } else if (change < 0) {
-    return colorize(`↓${Math.abs(change)}`, colors.red);
+    return colorize(`\u2193${Math.abs(change)}`, colors.red);
   }
-  return colorize("→", colors.dim);
-}
-
-/**
- * Format an error message
- * @param {string} message
- * @returns {string}
- */
-export function formatError(message) {
-  return colorize(`Error: ${message}`, colors.red);
-}
-
-/**
- * Format a success message
- * @param {string} message
- * @returns {string}
- */
-export function formatSuccess(message) {
-  return colorize(message, colors.green);
-}
-
-/**
- * Format a warning message
- * @param {string} message
-/**
- * Format a warning message
- * @param {string} message
- * @returns {string}
- */
-export function formatWarning(message) {
-  return colorize(`Warning: ${message}`, colors.yellow);
-}
-
-/**
- * Create a horizontal rule
- * @param {number} [width=60]
- * @returns {string}
- */
-export function horizontalRule(width = 60) {
-  return colorize("─".repeat(width), colors.dim);
-}
-
-/**
- * Format a section with title and content
- * @param {string} title
- * @param {string} content
- * @returns {string}
- */
-export function formatSection(title, content) {
-  return `${formatHeader(title)}\n\n${content}`;
-}
-
-/**
- * Indent all lines of text
- * @param {string} text
- * @param {number} [spaces=2]
- * @returns {string}
- */
-export function indent(text, spaces = 2) {
-  const padding = " ".repeat(spaces);
-  return text
-    .split("\n")
-    .map((line) => padding + line)
-    .join("\n");
+  return colorize("\u2192", colors.dim);
 }

package/src/pages/agent-builder-install.js

@@ -56,13 +56,14 @@ export function getApmInstallCommand(siteUrl, packName) {
 }
 
 /**
- * Build the `npx skills add` command that discovers the published pack
- * registry at `<siteUrl>/.well-known/agent-skills/index.json`.
+ * Build the `npx skills add` command that discovers the per-pack skill
+ * repository at `<siteUrl>/packs/<packName>/.well-known/skills/index.json`.
  * @param {string} siteUrl
+ * @param {string} packName
  * @returns {string}
  */
-export function getSkillsAddCommand(siteUrl) {
-  return `npx skills add ${normalizeSiteUrl(siteUrl)}`;
+export function getSkillsAddCommand(siteUrl, packName) {
+  return `npx skills add ${normalizeSiteUrl(siteUrl)}/packs/${packName}`;
 }
 
 /**
@@ -80,7 +81,7 @@ export function createInstallSection({ discipline, track, siteUrl }) {
 
   const packName = getPackName(discipline, track);
   const apmCommand = getApmInstallCommand(siteUrl, packName);
-  const skillsCommand = getSkillsAddCommand(siteUrl);
+  const skillsCommand = getSkillsAddCommand(siteUrl, packName);
 
   return section(
     {

package/src/commands/init.js

@@ -1,64 +0,0 @@
-/**
- * Init Command
- *
- * 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 __dirname = dirname(fileURLToPath(import.meta.url));
-const starterDir = join(__dirname, "..", "..", "starter");
-
-/**
- * Run the init command
- * @param {Object} params - Command parameters
- * @param {Object} params.options - Command options
- */
-export async function runInitCommand({ options }) {
-  const targetPath = options.path || process.cwd();
-  const dataDir = join(targetPath, "data", "pathway");
-
-  // Check if data/pathway/ already exists
-  try {
-    await access(dataDir);
-    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
-  }
-
-  // Verify starter data is available
-  try {
-    await access(starterDir);
-  } catch {
-    console.error("Error: Starter data not found in package.");
-    console.error("This may indicate a corrupted package installation.");
-    process.exit(1);
-  }
-
-  // Copy starter data
-  console.log("Creating ./data/pathway/ with starter data...\n");
-  await cp(starterDir, dataDir, { recursive: true });
-
-  console.log(`✅ Created ./data/pathway/ with starter data.
-
-Next steps:
-  1. Edit data files to match your organization
-  2. npx fit-map validate
-  3. npx fit-pathway dev
-
-Data structure:
-  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/starter/behaviours/systems_thinking.yaml

@@ -1,32 +0,0 @@
-# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/behaviour.schema.json
-
-name: Think in Systems
-human:
-  description:
-    The ability to see beyond individual components to understand how the entire
-    system behaves. Engineers recognize that every service, API, and queue is
-    part of a larger whole—isolated changes ripple across the system.
-  maturityDescriptions:
-    emerging:
-      Recognizes that systems have interconnected parts; considers immediate
-      dependencies in code
-    developing:
-      Identifies upstream and downstream impacts; uses observability tools to
-      trace requests across services
-    practicing:
-      Maps complex system interactions across technical and business domains;
-      anticipates cascading effects
-    role_modeling:
-      Shapes systems design practices across their function; influences
-      cross-team architecture decisions
-    exemplifying:
-      Defines organizational systems architecture principles; recognized
-      authority on complex systems
-
-agent:
-  title: Consider the whole system
-  workingStyle: |
-    For every change:
-    1. Identify upstream and downstream impacts
-    2. Consider non-functional requirements (performance, security)
-    3. Document assumptions and trade-offs