@forwardimpact/pathway 0.25.25 → 0.25.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.25.25",
+  "version": "0.25.27",
   "description": "Career progression web app and CLI for exploring roles and generating agent teams",
   "license": "Apache-2.0",
   "repository": {
@@ -20,6 +20,7 @@
     "engineering"
   ],
   "type": "module",
+  "main": "./src/index.js",
   "bin": {
     "fit-pathway": "./bin/fit-pathway.js"
   },
@@ -34,10 +35,12 @@
     "templates/"
   ],
   "exports": {
+    ".": "./src/index.js",
     "./formatters": "./src/formatters/index.js",
     "./commands": "./src/commands/index.js"
   },
   "dependencies": {
+    "@forwardimpact/libtelemetry": "^0.1.33",
     "@forwardimpact/map": "^0.15.5",
     "@forwardimpact/libcli": "^0.1.0",
     "@forwardimpact/libskill": "^4.0.0",

package/src/commands/agent-io.js

@@ -15,6 +15,9 @@ import {
   formatReference,
 } from "../formatters/agent/skill.js";
 import { formatSuccess } from "@forwardimpact/libcli";
+import { createLogger } from "@forwardimpact/libtelemetry";
+
+const logger = createLogger("pathway");
 
 /**
  * Ensure directory exists for a file path
@@ -47,7 +50,7 @@ export async function generateClaudeCodeSettings(baseDir, claudeCodeSettings) {
     JSON.stringify(merged, null, 2) + "\n",
     "utf-8",
   );
-  console.log(formatSuccess(`Updated: ${settingsPath}`));
+  logger.info(formatSuccess(`Updated: ${settingsPath}`));
 }
 
 /**
@@ -61,7 +64,7 @@ export async function writeProfile(profile, baseDir, template) {
   const profileContent = formatAgentProfile(profile, template);
   await ensureDir(profilePath);
   await writeFile(profilePath, profileContent, "utf-8");
-  console.log(formatSuccess(`Created: ${profilePath}`));
+  logger.info(formatSuccess(`Created: ${profilePath}`));
   return profilePath;
 }
 
@@ -76,7 +79,7 @@ export async function writeTeamInstructions(teamInstructions, baseDir) {
   const filePath = join(baseDir, ".claude", "CLAUDE.md");
   await ensureDir(filePath);
   await writeFile(filePath, teamInstructions.trim() + "\n", "utf-8");
-  console.log(formatSuccess(`Created: ${filePath}`));
+  logger.info(formatSuccess(`Created: ${filePath}`));
   return filePath;
 }
 
@@ -95,7 +98,7 @@ export async function writeSkills(skills, baseDir, templates) {
     const skillContent = formatAgentSkill(skill, templates.skill);
     await ensureDir(skillPath);
     await writeFile(skillPath, skillContent, "utf-8");
-    console.log(formatSuccess(`Created: ${skillPath}`));
+    logger.info(formatSuccess(`Created: ${skillPath}`));
     fileCount++;
 
     if (skill.installScript) {
@@ -103,7 +106,7 @@ export async function writeSkills(skills, baseDir, templates) {
       const installContent = formatInstallScript(skill, templates.install);
       await ensureDir(installPath);
       await writeFile(installPath, installContent, { mode: 0o755 });
-      console.log(formatSuccess(`Created: ${installPath}`));
+      logger.info(formatSuccess(`Created: ${installPath}`));
       fileCount++;
     }
 
@@ -112,7 +115,7 @@ export async function writeSkills(skills, baseDir, templates) {
       const refContent = formatReference(skill, templates.reference);
       await ensureDir(refPath);
       await writeFile(refPath, refContent, "utf-8");
-      console.log(formatSuccess(`Created: ${refPath}`));
+      logger.info(formatSuccess(`Created: ${refPath}`));
       fileCount++;
     }
   }

package/src/commands/agent-list.js

@@ -16,8 +16,6 @@ import {
   SummaryRenderer,
 } from "@forwardimpact/libcli";
 
-const summary = new SummaryRenderer({ process });
-
 /**
  * Find valid agent combination pairs
  * @param {Object} data - Pathway data
@@ -47,6 +45,7 @@ export function findValidCombinations(data, agentData) {
  * @param {Array} skillsWithAgent - Skills with agent sections
  */
 export function showAgentSummary(data, agentData, skillsWithAgent) {
+  const summary = new SummaryRenderer({ process });
   const validCombinations = findValidCombinations(data, agentData).length;
   const skillsWithAgentCount = skillsWithAgent.filter((s) => s.agent).length;
 
@@ -101,9 +100,8 @@ function listAgentCombinationsCompact(data, agentData) {
     const abbrev = getDisciplineAbbreviation(discipline.id);
     const agentName = `${abbrev}-${toKebabCase(track.id)}`;
     const specName = humanDiscipline.specialization || humanDiscipline.id;
-    // Piped output — keep as plain console.log for stable format
-    console.log(
-      `${agentName} ${discipline.id} ${track.id}, ${specName} (${humanTrack.name})`,
+    process.stdout.write(
+      `${agentName} ${discipline.id} ${track.id}, ${specName} (${humanTrack.name})\n`,
     );
   }
 }

package/src/commands/agent.js

@@ -347,7 +347,8 @@ export async function runAgentCommand({
       level,
       skills: skillsWithAgent,
     });
-    for (const skill of derivedSkills) console.log(skill.skillId);
+    for (const skill of derivedSkills)
+      process.stdout.write(skill.skillId + "\n");
     return;
   }
 
@@ -362,7 +363,7 @@ export async function runAgentCommand({
       skillMatrix: derivedSkills,
       skills: skillsWithAgent,
     });
-    console.log(toolkitToPlainList(toolkit));
+    process.stdout.write(toolkitToPlainList(toolkit) + "\n");
     return;
   }
 

package/src/commands/behaviour.js

@@ -65,7 +65,7 @@ function formatSummary(behaviours, data) {
  */
 function formatDetail(viewAndContext) {
   const { behaviour, drivers } = viewAndContext;
-  console.log(behaviourToMarkdown(behaviour, { drivers }));
+  process.stdout.write(behaviourToMarkdown(behaviour, { drivers }) + "\n");
 }
 
 export const runBehaviourCommand = createEntityCommand({

package/src/commands/build-bundle.js

@@ -11,6 +11,9 @@ import { cp, mkdir, rm, readFile, writeFile } from "fs/promises";
 import { join } from "path";
 import { execFileSync } from "child_process";
 import Mustache from "mustache";
+import { createLogger } from "@forwardimpact/libtelemetry";
+
+const logger = createLogger("pathway");
 
 /**
  * Generate distribution bundle (bundle.tar.gz + install.sh)
@@ -30,7 +33,7 @@ export async function generateBundle({
   version,
   templatesDir,
 }) {
-  console.log("📦 Generating distribution bundle...");
+  logger.info("📦 Generating distribution bundle...");
 
   const frameworkTitle = framework.title || "Engineering Pathway";
 
@@ -51,14 +54,14 @@ export async function generateBundle({
     join(bundleDir, "package.json"),
     JSON.stringify(bundlePkg, null, 2) + "\n",
   );
-  console.log(`   ✓ package.json (pathway ^${version})`);
+  logger.info(`   ✓ package.json (pathway ^${version})`);
 
   // 3. Copy data files into bundle
   await cp(dataDir, join(bundleDir, "data"), {
     recursive: true,
     dereference: true,
   });
-  console.log("   ✓ data/");
+  logger.info("   ✓ data/");
 
   // 4. Create tar.gz from the bundle directory
   execFileSync("tar", [
@@ -68,7 +71,7 @@ export async function generateBundle({
     outputDir,
     "_bundle",
   ]);
-  console.log("   ✓ bundle.tar.gz");
+  logger.info("   ✓ bundle.tar.gz");
 
   // 5. Clean up temporary bundle directory
   await rm(bundleDir, { recursive: true });
@@ -84,5 +87,5 @@ export async function generateBundle({
   await writeFile(join(outputDir, "install.sh"), installScript, {
     mode: 0o755,
   });
-  console.log("   ✓ install.sh");
+  logger.info("   ✓ install.sh");
 }

package/src/commands/build-packs.js

@@ -18,7 +18,10 @@ import { join } from "path";
 import { execFileSync } from "child_process";
 import { createHash } from "crypto";
 
+import { createLogger } from "@forwardimpact/libtelemetry";
 import { createDataLoader } from "@forwardimpact/map/loader";
+
+const logger = createLogger("pathway");
 import { createTemplateLoader } from "@forwardimpact/libtemplate";
 import {
   generateStageAgentProfile,
@@ -467,7 +470,7 @@ export async function generatePacks({
   version,
   templatesDir,
 }) {
-  console.log("📦 Generating agent/skill packs...");
+  logger.info("📦 Generating agent/skill packs...");
 
   const normalizedSiteUrl = siteUrl.replace(/\/$/, "");
   const frameworkTitle = framework.title || "Engineering Pathway";
@@ -495,7 +498,7 @@ export async function generatePacks({
 
   const combinations = findValidCombinations(data, agentData);
   if (combinations.length === 0) {
-    console.log("   (no valid discipline/track combinations — skipping)");
+    logger.info("   (no valid discipline/track combinations — skipping)");
     await rm(stagingDir, { recursive: true, force: true });
     return;
   }
@@ -538,7 +541,7 @@ export async function generatePacks({
       digest,
     });
 
-    console.log(`   ✓ packs/${agentName}.tar.gz`);
+    logger.info(`   ✓ packs/${agentName}.tar.gz`);
   }
 
   // Write per-pack skill repositories (one per discipline/track combination)
@@ -550,17 +553,17 @@ export async function generatePacks({
       pack.name,
     );
     allPackEntries.push({ packName: pack.name, entries });
-    console.log(
+    logger.info(
       `   ✓ packs/${pack.name}/.well-known/skills/ (${entries.length} skills)`,
     );
   }
 
   // Write aggregate repository at packs/ level
   await writeAggregateRepository(packsDir, allPackEntries);
-  console.log("   ✓ packs/.well-known/skills/index.json (aggregate)");
+  logger.info("   ✓ packs/.well-known/skills/index.json (aggregate)");
 
   await rm(stagingDir, { recursive: true, force: true });
 
   await writeApmManifest(outputDir, packs, version, frameworkTitle);
-  console.log("   ✓ apm.yml");
+  logger.info("   ✓ apm.yml");
 }

package/src/commands/build.js

@@ -13,8 +13,11 @@ import { cp, mkdir, rm, access, realpath, writeFile } from "fs/promises";
 import { readFileSync } from "fs";
 import { join, dirname, relative, resolve } from "path";
 import { fileURLToPath } from "url";
+import { createLogger } from "@forwardimpact/libtelemetry";
 import { createIndexGenerator } from "@forwardimpact/map/index-generator";
 import { createDataLoader } from "@forwardimpact/map/loader";
+
+const logger = createLogger("pathway");
 import { generateBundle } from "./build-bundle.js";
 import { generatePacks } from "./build-packs.js";
 
@@ -85,7 +88,7 @@ export async function runBuildCommand({ dataDir, options }) {
     framework = { emojiIcon: "🚀", title: "Engineering Pathway" };
   }
 
-  console.log(`
+  logger.info(`
 ${framework.emojiIcon} Generating ${framework.title} static site...
 `);
 
@@ -93,7 +96,7 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
   if (clean) {
     try {
       await access(outputDir);
-      console.log(`🗑️  Cleaning ${outputDir}...`);
+      logger.info(`🗑️  Cleaning ${outputDir}...`);
       await rm(outputDir, { recursive: true });
     } catch {
       // Directory doesn't exist, nothing to clean
@@ -104,12 +107,12 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
   await mkdir(outputDir, { recursive: true });
 
   // Generate index files in data directory
-  console.log("📇 Generating index files...");
+  logger.info("📇 Generating index files...");
   const indexGenerator = createIndexGenerator();
   await indexGenerator.generateAllIndexes(dataDir);
 
   // Copy app assets
-  console.log("📦 Copying application files...");
+  logger.info("📦 Copying application files...");
   for (const asset of PUBLIC_ASSETS) {
     const src = join(appDir, asset);
     const dest = join(outputDir, asset);
@@ -117,9 +120,9 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
     try {
       await access(src);
       await cp(src, dest, { recursive: true });
-      console.log(`   ✓ ${asset}`);
+      logger.info(`   ✓ ${asset}`);
     } catch (err) {
-      console.log(`   ⚠️  Skipped ${asset}: ${err.message}`);
+      logger.info(`   ⚠️  Skipped ${asset}: ${err.message}`);
     }
   }
 
@@ -132,19 +135,19 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
     try {
       await access(src);
       await cp(src, dest, { recursive: true });
-      console.log(`   ✓ ${asset}`);
+      logger.info(`   ✓ ${asset}`);
     } catch (err) {
-      console.log(`   ⚠️  Skipped ${asset}: ${err.message}`);
+      logger.info(`   ⚠️  Skipped ${asset}: ${err.message}`);
     }
   }
 
   // Copy @forwardimpact/map and @forwardimpact/libskill packages
   // These are needed by the browser's import map
-  console.log("📚 Copying package dependencies...");
+  logger.info("📚 Copying package dependencies...");
   await cp(mapLibDir, join(outputDir, "map/lib"), { recursive: true });
-  console.log(`   ✓ map/lib`);
+  logger.info(`   ✓ map/lib`);
   await cp(modelLibDir, join(outputDir, "model/lib"), { recursive: true });
-  console.log(`   ✓ model/lib`);
+  logger.info(`   ✓ model/lib`);
   // Copy libui JS (src/) and CSS (src/css/)
   await cp(uiLibDir, join(outputDir, "ui/lib"), { recursive: true });
   // CSS is within uiLibDir/css/ so it's already copied as ui/lib/css/
@@ -152,10 +155,10 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
   await cp(join(uiLibDir, "css"), join(outputDir, "ui/css"), {
     recursive: true,
   });
-  console.log(`   ✓ ui/lib + ui/css`);
+  logger.info(`   ✓ ui/lib + ui/css`);
 
   // Copy vendor dependencies for offline usage
-  console.log("📦 Copying vendor dependencies...");
+  logger.info("📦 Copying vendor dependencies...");
   const vendorDir = join(outputDir, "vendor");
   await mkdir(vendorDir, { recursive: true });
 
@@ -163,17 +166,17 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
   const mustacheSrc = fileURLToPath(import.meta.resolve("mustache"));
   const mustacheMjs = join(dirname(mustacheSrc), "mustache.mjs");
   await cp(mustacheMjs, join(vendorDir, "mustache.mjs"));
-  console.log("   ✓ vendor/mustache.mjs");
+  logger.info("   ✓ vendor/mustache.mjs");
 
   // yaml (browser ESM build — not in package exports, resolve via filesystem)
   // import.meta.resolve("yaml") → .../yaml/dist/index.js, go up two levels
   const yamlPkg = dirname(dirname(fileURLToPath(import.meta.resolve("yaml"))));
   const yamlBrowserDist = join(yamlPkg, "browser", "dist");
   await cp(yamlBrowserDist, join(vendorDir, "yaml"), { recursive: true });
-  console.log("   ✓ vendor/yaml/");
+  logger.info("   ✓ vendor/yaml/");
 
   // Copy data directory (dereference symlinks to copy actual content)
-  console.log("📁 Copying data files...");
+  logger.info("📁 Copying data files...");
   const dataOutputDir = join(outputDir, "data");
 
   // Check if source and destination are the same (e.g., when --output=.)
@@ -181,10 +184,10 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
   const resolvedDataOutputDir = resolve(dataOutputDir);
 
   if (resolvedDataDir === resolvedDataOutputDir) {
-    console.log(`   ✓ data/ (already in place)`);
+    logger.info(`   ✓ data/ (already in place)`);
   } else {
     await cp(dataDir, dataOutputDir, { recursive: true, dereference: true });
-    console.log(`   ✓ data/ (from ${relative(process.cwd(), dataDir)})`);
+    logger.info(`   ✓ data/ (from ${relative(process.cwd(), dataDir)})`);
   }
 
   // Write version.json for the web app footer
@@ -193,7 +196,7 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
     join(outputDir, "version.json"),
     JSON.stringify({ version }) + "\n",
   );
-  console.log(`   ✓ version.json (${version})`);
+  logger.info(`   ✓ version.json (${version})`);
 
   // Generate distribution surfaces if siteUrl is configured
   const siteUrl = options.url || framework.distribution?.siteUrl;
@@ -218,7 +221,7 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
   }
 
   // Show summary
-  console.log(`
+  logger.info(`
 ✅ Site generated successfully!
 
 Output: ${outputDir}

package/src/commands/command-factory.js

@@ -59,7 +59,9 @@ export function createEntityCommand({
     // --list: Output descriptive comma-separated lines for piping and AI agent discovery
     if (options.list) {
       for (const item of items) {
-        console.log(formatListItem ? formatListItem(item) : item.id);
+        process.stdout.write(
+          (formatListItem ? formatListItem(item) : item.id) + "\n",
+        );
       }
       return;
     }
@@ -67,7 +69,7 @@ export function createEntityCommand({
     // No args: Show summary
     if (!id) {
       if (options.json) {
-        console.log(JSON.stringify(items, null, 2));
+        process.stdout.write(JSON.stringify(items, null, 2) + "\n");
         return;
       }
       formatSummary(items, data);
@@ -168,7 +170,7 @@ function handleDetail({
   }
 
   if (options.json) {
-    console.log(JSON.stringify(view, null, 2));
+    process.stdout.write(JSON.stringify(view, null, 2) + "\n");
     return;
   }
 
@@ -226,7 +228,7 @@ export function createCompositeCommand({
     }
 
     if (options.json) {
-      console.log(JSON.stringify(view, null, 2));
+      process.stdout.write(JSON.stringify(view, null, 2) + "\n");
       return;
     }
 

package/src/commands/dev.js

@@ -10,9 +10,12 @@ import { readFile, stat } from "fs/promises";
 import { readFileSync } from "fs";
 import { join, extname, dirname } from "path";
 import { fileURLToPath } from "url";
+import { createLogger } from "@forwardimpact/libtelemetry";
 import { createIndexGenerator } from "@forwardimpact/map/index-generator";
 import { createDataLoader } from "@forwardimpact/map/loader";
 
+const logger = createLogger("pathway");
+
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const publicDir = join(__dirname, "..");
@@ -131,7 +134,7 @@ export async function runDevCommand({ dataDir, options }) {
   }
 
   // Generate _index.yaml files before serving
-  console.log("Generating index files...");
+  logger.info("Generating index files...");
   const indexGenerator = createIndexGenerator();
   await indexGenerator.generateAllIndexes(dataDir);
 
@@ -191,7 +194,7 @@ export async function runDevCommand({ dataDir, options }) {
   });
 
   server.listen(port, () => {
-    console.log(`
+    logger.info(`
 ${framework.emojiIcon} ${framework.title} running at http://localhost:${port}
 📁 Data directory: ${dataDir}
 

package/src/commands/discipline.js

@@ -67,7 +67,9 @@ function formatSummary(disciplines) {
  */
 function formatDetail(viewAndContext) {
   const { discipline, skills, behaviours, tracks } = viewAndContext;
-  console.log(disciplineToMarkdown(discipline, { skills, behaviours, tracks }));
+  process.stdout.write(
+    disciplineToMarkdown(discipline, { skills, behaviours, tracks }) + "\n",
+  );
 }
 
 export const runDisciplineCommand = createEntityCommand({

package/src/commands/index.js

@@ -16,6 +16,4 @@ export { runJobCommand } from "./job.js";
 export { runInterviewCommand } from "./interview.js";
 export { runProgressCommand } from "./progress.js";
 export { runQuestionsCommand } from "./questions.js";
-export { runServeCommand } from "./serve.js";
-export { runSiteCommand } from "./site.js";
 export { runUpdateCommand } from "./update.js";

package/src/commands/job.js

@@ -41,7 +41,7 @@ import { toolkitToPlainList } from "../formatters/toolkit/markdown.js";
  * @param {string} jobTemplate - Mustache template for job description
  */
 function formatJob(view, _options, entities, jobTemplate) {
-  console.log(jobToMarkdown(view, entities, jobTemplate));
+  process.stdout.write(jobToMarkdown(view, entities, jobTemplate) + "\n");
 }
 
 /**
@@ -56,11 +56,11 @@ function printJobList(filteredJobs) {
       track: job.track,
     });
     if (job.track) {
-      console.log(
-        `${job.discipline.id} ${job.level.id} ${job.track.id}, ${title}`,
+      process.stdout.write(
+        `${job.discipline.id} ${job.level.id} ${job.track.id}, ${title}\n`,
       );
     } else {
-      console.log(`${job.discipline.id} ${job.level.id}, ${title}`);
+      process.stdout.write(`${job.discipline.id} ${job.level.id}, ${title}\n`);
     }
   }
 }
@@ -401,18 +401,18 @@ export async function runJobCommand({
 
   if (options.skills) {
     for (const skill of view.skillMatrix) {
-      console.log(skill.skillId);
+      process.stdout.write(skill.skillId + "\n");
     }
     return;
   }
 
   if (options.tools) {
-    console.log(toolkitToPlainList(view.toolkit));
+    process.stdout.write(toolkitToPlainList(view.toolkit) + "\n");
     return;
   }
 
   if (options.json) {
-    console.log(JSON.stringify(view, null, 2));
+    process.stdout.write(JSON.stringify(view, null, 2) + "\n");
     return;
   }
 

package/src/commands/level.js

@@ -79,7 +79,7 @@ function formatSummary(levels, data) {
  * @param {Object} framework - Framework config
  */
 function formatDetail(level, framework) {
-  console.log(levelToMarkdown(level, framework));
+  process.stdout.write(levelToMarkdown(level, framework) + "\n");
 }
 
 export const runLevelCommand = createEntityCommand({

package/src/commands/questions.js

@@ -162,7 +162,7 @@ export async function runQuestionsCommand({
       filter,
     });
     for (const q of view.questions) {
-      console.log(q.id);
+      process.stdout.write(q.id + "\n");
     }
     return;
   }
@@ -196,5 +196,5 @@ export async function runQuestionsCommand({
       break;
   }
 
-  console.log(output);
+  process.stdout.write(output + "\n");
 }

package/src/commands/skill.js

@@ -65,14 +65,14 @@ function formatSummary(skills, data) {
  */
 function formatDetail(viewAndContext, framework) {
   const { skill, disciplines, tracks, drivers, capabilities } = viewAndContext;
-  console.log(
+  process.stdout.write(
     skillToMarkdown(skill, {
       disciplines,
       tracks,
       drivers,
       capabilities,
       framework,
-    }),
+    }) + "\n",
   );
 }
 

package/src/commands/tool.js

@@ -33,7 +33,7 @@ export async function runToolCommand({ data, args, options }) {
   // --list: Output descriptive comma-separated tool lines for piping
   if (options.list) {
     for (const tool of tools) {
-      console.log(`${tool.name}, ${truncate(tool.description, 60)}`);
+      process.stdout.write(`${tool.name}, ${truncate(tool.description, 60)}\n`);
     }
     return;
   }
@@ -41,7 +41,7 @@ export async function runToolCommand({ data, args, options }) {
   // No args: Show summary
   if (!name) {
     if (options.json) {
-      console.log(JSON.stringify(tools, null, 2));
+      process.stdout.write(JSON.stringify(tools, null, 2) + "\n");
       return;
     }
     formatSummary(tools, totalCount);
@@ -58,7 +58,7 @@ export async function runToolCommand({ data, args, options }) {
   }
 
   if (options.json) {
-    console.log(JSON.stringify(tool, null, 2));
+    process.stdout.write(JSON.stringify(tool, null, 2) + "\n");
     return;
   }
 

package/src/commands/track.js

@@ -73,8 +73,9 @@ function formatSummary(tracks, data) {
  */
 function formatDetail(viewAndContext, framework) {
   const { track, skills, behaviours, disciplines } = viewAndContext;
-  console.log(
-    trackToMarkdown(track, { skills, behaviours, disciplines, framework }),
+  process.stdout.write(
+    trackToMarkdown(track, { skills, behaviours, disciplines, framework }) +
+      "\n",
   );
 }
 

package/src/commands/update.js

@@ -11,8 +11,11 @@ import { join } from "path";
 import { homedir } from "os";
 import { execFileSync } from "child_process";
 import { tmpdir } from "os";
+import { createLogger } from "@forwardimpact/libtelemetry";
 import { createDataLoader } from "@forwardimpact/map/loader";
 
+const logger = createLogger("pathway");
+
 const BASE_DIR = join(homedir(), ".fit", "data");
 const INSTALL_DIR = join(BASE_DIR, "pathway");
 
@@ -53,7 +56,7 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
   const baseUrl = siteUrl.replace(/\/$/, "");
   const bundleName = "bundle.tar.gz";
 
-  console.log(`\n🔄 Updating from ${baseUrl}...\n`);
+  logger.info(`\n🔄 Updating from ${baseUrl}...\n`);
 
   // 1. Download bundle to temp location
   const tmpDir = join(tmpdir(), "fit-pathway-update");
@@ -62,17 +65,17 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
   const tmpBundle = join(tmpDir, bundleName);
 
   try {
-    console.log("   Downloading bundle...");
+    logger.info("   Downloading bundle...");
     execFileSync("curl", [
       "-fsSL",
       `${baseUrl}/${bundleName}`,
       "-o",
       tmpBundle,
     ]);
-    console.log("   ✓ Downloaded");
+    logger.info("   ✓ Downloaded");
 
     // 2. Extract bundle
-    console.log("   Extracting...");
+    logger.info("   Extracting...");
     const extractDir = join(tmpDir, "extracted");
     await mkdir(extractDir, { recursive: true });
     execFileSync("tar", [
@@ -82,7 +85,7 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
       extractDir,
       "--strip-components=1",
     ]);
-    console.log("   ✓ Extracted");
+    logger.info("   ✓ Extracted");
 
     // 3. Compare versions from bundle's package.json (version manifest)
     const newPkgPath = join(extractDir, "package.json");
@@ -101,17 +104,17 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
       newPkg.dependencies?.["@forwardimpact/pathway"] || "unknown";
 
     // 4. Replace data
-    console.log("   Updating data files...");
+    logger.info("   Updating data files...");
     await rm(INSTALL_DIR, { recursive: true });
     await cp(join(extractDir, "data"), INSTALL_DIR, { recursive: true });
-    console.log("   ✓ Data updated");
+    logger.info("   ✓ Data updated");
 
     // 5. Update version manifest
     await writeFile(oldPkgPath, JSON.stringify(newPkg, null, 2) + "\n");
 
     // 6. Update global pathway package if version changed
     if (oldVersion !== newVersion) {
-      console.log(`   Updating pathway ${oldVersion} → ${newVersion}...`);
+      logger.info(`   Updating pathway ${oldVersion} → ${newVersion}...`);
       execFileSync(
         "npm",
         ["install", "-g", `@forwardimpact/pathway@${newVersion}`],
@@ -119,11 +122,11 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
           stdio: "ignore",
         },
       );
-      console.log("   ✓ Global package updated");
+      logger.info("   ✓ Global package updated");
     }
 
     // 7. Report
-    console.log(`
+    logger.info(`
 ✅ Update complete!
 
   Pathway: ${oldVersion === newVersion ? newVersion + " (unchanged)" : oldVersion + " → " + newVersion}

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";