@forwardimpact/pathway 0.25.21 → 0.25.24

package/src/commands/agent.js

@@ -11,17 +11,17 @@
  * By default, outputs to console. Use --output to write files.
  *
  * Usage:
- *   bunx pathway agent <discipline> [--track=<track>]
- *   bunx pathway agent <discipline> --track=<track> --stage=plan
- *   bunx pathway agent <discipline> --track=<track> --output=./agents
- *   bunx pathway agent <discipline> [--track=<track>] --skills  # Plain list of skill IDs
- *   bunx pathway agent <discipline> [--track=<track>] --tools   # Plain list of tool names
- *   bunx pathway agent --list
+ *   npx fit-pathway agent <discipline> [--track=<track>]
+ *   npx fit-pathway agent <discipline> --track=<track> --stage=plan
+ *   npx fit-pathway agent <discipline> --track=<track> --output=./agents
+ *   npx fit-pathway agent <discipline> [--track=<track>] --skills  # Plain list of skill IDs
+ *   npx fit-pathway agent <discipline> [--track=<track>] --tools   # Plain list of tool names
+ *   npx fit-pathway agent --list
  *
  * Examples:
- *   bunx pathway agent software_engineering --track=platform
- *   bunx pathway agent software_engineering --track=platform --stage=plan
- *   bunx pathway agent software_engineering --track=platform --output=./agents
+ *   npx fit-pathway agent software_engineering --track=platform
+ *   npx fit-pathway agent software_engineering --track=platform --stage=plan
+ *   npx fit-pathway agent software_engineering --track=platform --output=./agents
  */
 
 import { createDataLoader } from "@forwardimpact/map/loader";
@@ -32,13 +32,13 @@ import {
   deriveReferenceLevel,
   deriveAgentSkills,
   generateSkillMarkdown,
-  deriveToolkit,
   getDisciplineAbbreviation,
   toKebabCase,
   interpolateTeamInstructions,
-} from "@forwardimpact/libskill";
+} from "@forwardimpact/libskill/agent";
+import { deriveToolkit } from "@forwardimpact/libskill/toolkit";
 import { formatAgentProfile } from "../formatters/agent/profile.js";
-import { formatError, formatSuccess } from "../lib/cli-output.js";
+import { formatError, formatSuccess } from "@forwardimpact/libcli";
 import { toolkitToPlainList } from "../formatters/toolkit/markdown.js";
 import {
   generateClaudeCodeSettings,
@@ -82,9 +82,9 @@ function showAgentSummary(data, agentData, skillsWithAgent) {
   );
   console.log(`Stages:      ${data.stages.length} available`);
   console.log(`\nValid combinations: ${validCombinations}`);
-  console.log(`\nRun 'bunx pathway agent --list' for all combinations`);
+  console.log(`\nRun 'npx fit-pathway agent --list' for all combinations`);
   console.log(
-    `Run 'bunx pathway agent <discipline> <track>' to generate files\n`,
+    `Run 'npx fit-pathway agent <discipline> <track>' to generate files\n`,
   );
 }
 
@@ -94,7 +94,7 @@ function showAgentSummary(data, agentData, skillsWithAgent) {
  * @param {Object} agentData - Agent-specific data
  * @returns {Array<{discipline: Object, track: Object, humanDiscipline: Object, humanTrack: Object}>}
  */
-function findValidCombinations(data, agentData) {
+export function findValidCombinations(data, agentData) {
   const pairs = [];
   for (const discipline of agentData.disciplines) {
     for (const track of agentData.tracks) {
@@ -158,7 +158,7 @@ function listAgentCombinationsVerbose(data, agentData) {
 
   console.log("\n## Valid combinations:\n");
   for (const { discipline, track } of findValidCombinations(data, agentData)) {
-    console.log(`  bunx pathway agent ${discipline.id} ${track.id}`);
+    console.log(`  npx fit-pathway agent ${discipline.id} ${track.id}`);
   }
 
   console.log("\n## Available stages:\n");
@@ -237,10 +237,10 @@ function resolveAgentEntities(data, agentData, disciplineId, trackId) {
  * @param {Object} humanDiscipline
  */
 function printTeamInstructions(agentTrack, humanDiscipline) {
-  const teamInstructions = interpolateTeamInstructions(
+  const teamInstructions = interpolateTeamInstructions({
     agentTrack,
     humanDiscipline,
-  );
+  });
   if (teamInstructions) {
     console.log("# Team Instructions (CLAUDE.md)\n");
     console.log(teamInstructions.trim());
@@ -287,10 +287,10 @@ async function handleSingleStage({
     return;
   }
 
-  const teamInstructions = interpolateTeamInstructions(
+  const teamInstructions = interpolateTeamInstructions({
     agentTrack,
     humanDiscipline,
-  );
+  });
   await writeTeamInstructions(teamInstructions, baseDir);
   await writeProfile(profile, baseDir, agentTemplate);
   await generateClaudeCodeSettings(baseDir, agentData.claudeCodeSettings);
@@ -331,7 +331,9 @@ async function handleAllStages({
   const skillFiles = derivedSkills
     .map((derived) => skillsWithAgent.find((s) => s.id === derived.skillId))
     .filter((skill) => skill?.agent)
-    .map((skill) => generateSkillMarkdown(skill, data.stages));
+    .map((skill) =>
+      generateSkillMarkdown({ skillData: skill, stages: data.stages }),
+    );
 
   for (const profile of profiles) {
     const errors = validateAgentProfile(profile);
@@ -373,10 +375,10 @@ async function handleAllStages({
     return;
   }
 
-  const teamInstructions = interpolateTeamInstructions(
+  const teamInstructions = interpolateTeamInstructions({
     agentTrack,
     humanDiscipline,
-  );
+  });
   await writeTeamInstructions(teamInstructions, baseDir);
   for (const profile of profiles) {
     await writeProfile(profile, baseDir, agentTemplate);

package/src/commands/behaviour.js

@@ -4,15 +4,15 @@
  * Handles behaviour summary, listing, and detail display in the terminal.
  *
  * Usage:
- *   bunx pathway behaviour              # Summary with stats
- *   bunx pathway behaviour --list       # IDs only (for piping)
- *   bunx pathway behaviour <id>         # Detail view
- *   bunx pathway behaviour --validate   # Validation checks
+ *   npx fit-pathway behaviour              # Summary with stats
+ *   npx fit-pathway behaviour --list       # IDs only (for piping)
+ *   npx fit-pathway behaviour <id>         # Detail view
+ *   npx fit-pathway behaviour --validate   # Validation checks
  */
 
 import { createEntityCommand } from "./command-factory.js";
 import { behaviourToMarkdown } from "../formatters/behaviour/markdown.js";
-import { formatTable } from "../lib/cli-output.js";
+import { formatTable } from "@forwardimpact/libcli";
 
 /**
  * Format behaviour list item for --list output
@@ -43,8 +43,8 @@ function formatSummary(behaviours, data) {
 
   console.log(formatTable(["ID", "Name", "Drivers"], rows));
   console.log(`\nTotal: ${behaviours.length} behaviours`);
-  console.log(`\nRun 'bunx pathway behaviour --list' for IDs and names`);
-  console.log(`Run 'bunx pathway behaviour <id>' for details\n`);
+  console.log(`\nRun 'npx fit-pathway behaviour --list' for IDs and names`);
+  console.log(`Run 'npx fit-pathway behaviour <id>' for details\n`);
 }
 
 /**

package/src/commands/build-bundle.js

@@ -0,0 +1,88 @@
+/**
+ * Bundle generation for Pathway distribution.
+ *
+ * Emits `bundle.tar.gz` and `install.sh` alongside the static site so
+ * engineers can install `@forwardimpact/pathway` globally via
+ * `curl -fsSL <site>/install.sh | bash`. Invoked from build.js when
+ * `framework.distribution.siteUrl` is configured.
+ */
+
+import { cp, mkdir, rm, readFile, writeFile } from "fs/promises";
+import { join } from "path";
+import { execFileSync } from "child_process";
+import Mustache from "mustache";
+
+/**
+ * Generate distribution bundle (bundle.tar.gz + install.sh)
+ * @param {Object} params
+ * @param {string} params.outputDir - Build output directory
+ * @param {string} params.dataDir - Source data directory
+ * @param {string} params.siteUrl - Base URL for the published site
+ * @param {Object} params.framework - Framework configuration
+ * @param {string} params.version - Pathway package version
+ * @param {string} params.templatesDir - Absolute path to pathway/templates
+ */
+export async function generateBundle({
+  outputDir,
+  dataDir,
+  siteUrl,
+  framework,
+  version,
+  templatesDir,
+}) {
+  console.log("📦 Generating distribution bundle...");
+
+  const frameworkTitle = framework.title || "Engineering Pathway";
+
+  // 1. Create temporary bundle directory
+  const bundleDir = join(outputDir, "_bundle");
+  await mkdir(bundleDir, { recursive: true });
+
+  // 2. Generate minimal package.json for the bundle
+  const bundlePkg = {
+    name: "fit-pathway-local",
+    version: version,
+    private: true,
+    dependencies: {
+      "@forwardimpact/pathway": `^${version}`,
+    },
+  };
+  await writeFile(
+    join(bundleDir, "package.json"),
+    JSON.stringify(bundlePkg, null, 2) + "\n",
+  );
+  console.log(`   ✓ package.json (pathway ^${version})`);
+
+  // 3. Copy data files into bundle
+  await cp(dataDir, join(bundleDir, "data"), {
+    recursive: true,
+    dereference: true,
+  });
+  console.log("   ✓ data/");
+
+  // 4. Create tar.gz from the bundle directory
+  execFileSync("tar", [
+    "-czf",
+    join(outputDir, "bundle.tar.gz"),
+    "-C",
+    outputDir,
+    "_bundle",
+  ]);
+  console.log("   ✓ bundle.tar.gz");
+
+  // 5. Clean up temporary bundle directory
+  await rm(bundleDir, { recursive: true });
+
+  // 6. Render install.sh from template
+  const templatePath = join(templatesDir, "install.template.sh");
+  const template = await readFile(templatePath, "utf8");
+  const installScript = Mustache.render(template, {
+    siteUrl: siteUrl.replace(/\/$/, ""),
+    version,
+    frameworkTitle,
+  });
+  await writeFile(join(outputDir, "install.sh"), installScript, {
+    mode: 0o755,
+  });
+  console.log("   ✓ install.sh");
+}