@forwardimpact/pathway 0.25.1 → 0.25.3

package/bin/fit-pathway.js

@@ -31,6 +31,7 @@
 
 import { join, resolve, dirname } from "path";
 import { fileURLToPath } from "url";
+import { readFileSync } from "fs";
 import fs from "fs/promises";
 import { homedir } from "os";
 import { createDataLoader } from "@forwardimpact/map/loader";
@@ -62,6 +63,11 @@ import { runUpdateCommand } from "../src/commands/update.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const TEMPLATE_DIR = join(__dirname, "..", "templates");
 
+/** Package version read from package.json */
+const VERSION = JSON.parse(
+  readFileSync(join(__dirname, "..", "package.json"), "utf8"),
+).version;
+
 const COMMANDS = {
   discipline: runDisciplineCommand,
   level: runLevelCommand,
@@ -88,6 +94,7 @@ 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/)
+  --version         Show version number
   --help            Show this help message
 
 ────────────────────────────────────────────────────────────────────────────────
@@ -240,6 +247,7 @@ function parseArgs(args) {
     list: false,
     json: false,
     help: false,
+    version: false,
     type: "full",
     compare: null,
     data: null,
@@ -265,7 +273,9 @@ function parseArgs(args) {
   };
 
   for (const arg of args) {
-    if (arg === "--help" || arg === "-h") {
+    if (arg === "--version" || arg === "-v") {
+      result.version = true;
+    } else if (arg === "--help" || arg === "-h") {
       result.help = true;
     } else if (arg === "--list" || arg === "-l") {
       result.list = true;
@@ -345,6 +355,11 @@ async function main() {
   const args = process.argv.slice(2);
   const options = parseArgs(args);
 
+  if (options.version) {
+    console.log(VERSION);
+    process.exit(0);
+  }
+
   if (options.help) {
     printHelp();
     process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.25.1",
+  "version": "0.25.3",
   "description": "Career progression web app and CLI for exploring roles and generating agent teams",
   "license": "Apache-2.0",
   "repository": {
@@ -44,6 +44,7 @@
     "@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"

package/src/commands/build.js

@@ -193,6 +193,14 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
     console.log(`   ✓ data/ (from ${relative(process.cwd(), dataDir)})`);
   }
 
+  // Write version.json for the web app footer
+  const version = getPathwayVersion();
+  await writeFile(
+    join(outputDir, "version.json"),
+    JSON.stringify({ version }) + "\n",
+  );
+  console.log(`   ✓ version.json (${version})`);
+
   // Generate distribution bundle if siteUrl is configured
   const siteUrl = options.url || framework.distribution?.siteUrl;
   if (siteUrl) {

package/src/commands/dev.js

@@ -7,6 +7,7 @@
 
 import { createServer } from "http";
 import { readFile, stat } from "fs/promises";
+import { readFileSync } from "fs";
 import { join, extname, dirname } from "path";
 import { fileURLToPath } from "url";
 import { createIndexGenerator } from "@forwardimpact/map/index-generator";
@@ -17,6 +18,11 @@ const __dirname = dirname(__filename);
 const publicDir = join(__dirname, "..");
 const rootDir = join(__dirname, "../..");
 
+/** Package version for serving as /version.json */
+const VERSION = JSON.parse(
+  readFileSync(join(rootDir, "package.json"), "utf8"),
+).version;
+
 /**
  * Resolve package directory using Node's module resolution.
  * Works in both monorepo (development) and installed (production) contexts.
@@ -140,7 +146,11 @@ export async function runDevCommand({ dataDir, options }) {
 
     let filePath;
 
-    if (pathname.startsWith("/data/")) {
+    if (pathname === "/version.json") {
+      res.setHeader("Content-Type", "application/json; charset=utf-8");
+      res.end(JSON.stringify({ version: VERSION }));
+      return;
+    } else if (pathname.startsWith("/data/")) {
       // Serve from user's data directory
       filePath = join(dataDir, pathname.slice(6));
     } else if (pathname.startsWith("/templates/")) {

package/src/index.html

@@ -136,7 +136,7 @@
         </main>
 
         <footer id="app-footer">
-          <p>Engineering Pathway</p>
+          <p>Engineering Pathway <span id="app-version"></span></p>
           <nav class="footer-links">
             <a href="slides.html">Slides</a>
             <a href="handout.html">Handouts</a>

package/src/main.js

@@ -55,6 +55,9 @@ async function init() {
 
     // Populate branding from framework data
     populateBranding();
+
+    // Load and display version
+    loadVersion();
   } catch (error) {
     console.error("Failed to load data:", error);
     setError(error);
@@ -208,10 +211,27 @@ function populateBranding() {
   // Update footer
   const footer = document.querySelector("#app-footer p");
   if (footer) {
-    footer.textContent = branding.title;
+    const versionSpan = footer.querySelector("#app-version");
+    footer.textContent = branding.title + " ";
+    if (versionSpan) footer.appendChild(versionSpan);
   }
 }
 
+/**
+ * Fetch version.json and display in the footer
+ */
+function loadVersion() {
+  fetch("./version.json")
+    .then((r) => (r.ok ? r.json() : null))
+    .then((data) => {
+      if (data?.version) {
+        const el = document.getElementById("app-version");
+        if (el) el.textContent = `v${data.version}`;
+      }
+    })
+    .catch(() => {});
+}
+
 /**
  * Set up drawer overlay for mobile backdrop and auto-close behavior
  */