@forwardimpact/pathway 0.25.12 → 0.25.20

package/bin/fit-pathway.js

@@ -235,6 +235,62 @@ Options:
   --format=FORMAT      Output format: table, yaml, json
 `;
 
+/** Boolean flags: exact match sets the field to true */
+const BOOLEAN_FLAGS = {
+  "--version": "version",
+  "-v": "version",
+  "--help": "help",
+  "-h": "help",
+  "--list": "list",
+  "-l": "list",
+  "--json": "json",
+  "--stats": "stats",
+  "--all-roles": "all-roles",
+  "--all-stages": "all-stages",
+  "--agent": "agent",
+  "--skills": "skills",
+  "--tools": "tools",
+};
+
+/** Negation flags: exact match sets the field to false */
+const NEGATION_FLAGS = { "--no-clean": "clean" };
+
+/** Value flags: --key=val sets result[field] = val */
+const VALUE_FLAGS = {
+  "--type": "type",
+  "--compare": "compare",
+  "--data": "data",
+  "--track": "track",
+  "--output": "output",
+  "--level": "level",
+  "--maturity": "maturity",
+  "--skill": "skill",
+  "--behaviour": "behaviour",
+  "--capability": "capability",
+  "--format": "format",
+  "--role": "role",
+  "--stage": "stage",
+  "--checklist": "checklist",
+  "--path": "path",
+  "--url": "url",
+};
+
+/**
+ * Try to parse a --key=value argument using the VALUE_FLAGS table
+ * @param {string} arg
+ * @param {Object} result
+ * @returns {boolean} true if the arg was handled
+ */
+function parseValueFlag(arg, result) {
+  const eqIndex = arg.indexOf("=");
+  if (eqIndex === -1) return false;
+  const key = arg.slice(0, eqIndex);
+  const field = VALUE_FLAGS[key];
+  if (!field) return false;
+  result[field] = arg.slice(eqIndex + 1);
+  return true;
+}
+
 /**
  * Parse command line arguments
  * @param {string[]} args
@@ -273,62 +329,14 @@ function parseArgs(args) {
   };
 
   for (const arg of args) {
-    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;
-    } else if (arg === "--json") {
-      result.json = true;
-    } else if (arg.startsWith("--type=")) {
-      result.type = arg.slice(7);
-    } else if (arg.startsWith("--compare=")) {
-      result.compare = arg.slice(10);
-    } else if (arg.startsWith("--data=")) {
-      result.data = arg.slice(7);
-    } else if (arg.startsWith("--track=")) {
-      result.track = arg.slice(8);
-    } else if (arg.startsWith("--output=")) {
-      result.output = arg.slice(9);
-    } else if (arg.startsWith("--level=")) {
-      result.level = arg.slice(8);
-    } else if (arg.startsWith("--maturity=")) {
-      result.maturity = arg.slice(11);
-    } else if (arg.startsWith("--skill=")) {
-      result.skill = arg.slice(8);
-    } else if (arg.startsWith("--behaviour=")) {
-      result.behaviour = arg.slice(12);
-    } else if (arg.startsWith("--capability=")) {
-      result.capability = arg.slice(14);
-    } else if (arg.startsWith("--format=")) {
-      result.format = arg.slice(9);
-    } else if (arg === "--stats") {
-      result.stats = true;
-    } else if (arg.startsWith("--role=")) {
-      result.role = arg.slice(7);
-    } else if (arg === "--all-roles") {
-      result["all-roles"] = true;
-    } else if (arg.startsWith("--stage=")) {
-      result.stage = arg.slice(8);
-    } else if (arg === "--all-stages") {
-      result["all-stages"] = true;
-    } else if (arg === "--agent") {
-      result.agent = true;
-    } else if (arg.startsWith("--checklist=")) {
-      result.checklist = arg.slice(12);
-    } else if (arg === "--skills") {
-      result.skills = true;
-    } else if (arg === "--tools") {
-      result.tools = true;
+    if (BOOLEAN_FLAGS[arg]) {
+      result[BOOLEAN_FLAGS[arg]] = true;
+    } else if (NEGATION_FLAGS[arg]) {
+      result[NEGATION_FLAGS[arg]] = false;
     } else if (arg.startsWith("--port=")) {
       result.port = parseInt(arg.slice(7), 10);
-    } else if (arg.startsWith("--path=")) {
-      result.path = arg.slice(7);
-    } else if (arg === "--no-clean") {
-      result.clean = false;
-    } else if (arg.startsWith("--url=")) {
-      result.url = arg.slice(6);
+    } else if (parseValueFlag(arg, result)) {
+      // handled
     } else if (!arg.startsWith("-")) {
       if (!result.command) {
         result.command = arg;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.25.12",
+  "version": "0.25.20",
   "description": "Career progression web app and CLI for exploring roles and generating agent teams",
   "license": "Apache-2.0",
   "repository": {
@@ -20,7 +20,6 @@
     "engineering"
   ],
   "type": "module",
-  "main": "src/index.js",
   "bin": {
     "fit-pathway": "./bin/fit-pathway.js"
   },
@@ -36,7 +35,6 @@
     "templates/"
   ],
   "exports": {
-    ".": "./src/index.js",
     "./formatters": "./src/formatters/index.js",
     "./commands": "./src/commands/index.js"
   },
@@ -50,7 +48,8 @@
     "yaml": "^2.8.3"
   },
   "engines": {
-    "bun": ">=1.2.0"
+    "bun": ">=1.2.0",
+    "node": ">=18.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/commands/agent-io.js

@@ -0,0 +1,120 @@
+/**
+ * Agent file I/O helpers
+ *
+ * Handles writing agent profiles, skills, settings, and team instructions
+ * to disk. Extracted from agent.js to keep command logic focused.
+ */
+
+import { writeFile, mkdir, readFile } from "fs/promises";
+import { join, dirname } from "path";
+import { existsSync } from "fs";
+import { formatAgentProfile } from "../formatters/agent/profile.js";
+import {
+  formatAgentSkill,
+  formatInstallScript,
+  formatReference,
+} from "../formatters/agent/skill.js";
+import { formatSuccess } from "../lib/cli-output.js";
+
+/**
+ * Ensure directory exists for a file path
+ * @param {string} filePath - Full file path
+ */
+async function ensureDir(filePath) {
+  await mkdir(dirname(filePath), { recursive: true });
+}
+
+/**
+ * Generate Claude Code settings file
+ * Merges with existing settings if file exists
+ * @param {string} baseDir - Base output directory
+ * @param {Object} claudeCodeSettings - Settings loaded from data
+ */
+export async function generateClaudeCodeSettings(baseDir, claudeCodeSettings) {
+  const settingsPath = join(baseDir, ".claude", "settings.json");
+
+  let settings = {};
+  if (existsSync(settingsPath)) {
+    const content = await readFile(settingsPath, "utf-8");
+    settings = JSON.parse(content);
+  }
+
+  const merged = { ...settings, ...claudeCodeSettings };
+
+  await ensureDir(settingsPath);
+  await writeFile(
+    settingsPath,
+    JSON.stringify(merged, null, 2) + "\n",
+    "utf-8",
+  );
+  console.log(formatSuccess(`Updated: ${settingsPath}`));
+}
+
+/**
+ * Write agent profile to file
+ * @param {Object} profile - Generated profile
+ * @param {string} baseDir - Base output directory
+ * @param {string} template - Mustache template for agent profile
+ */
+export async function writeProfile(profile, baseDir, template) {
+  const profilePath = join(baseDir, ".claude", "agents", profile.filename);
+  const profileContent = formatAgentProfile(profile, template);
+  await ensureDir(profilePath);
+  await writeFile(profilePath, profileContent, "utf-8");
+  console.log(formatSuccess(`Created: ${profilePath}`));
+  return profilePath;
+}
+
+/**
+ * Write team instructions to CLAUDE.md
+ * @param {string|null} teamInstructions - Interpolated team instructions content
+ * @param {string} baseDir - Base output directory
+ * @returns {string|null} Path written, or null if skipped
+ */
+export async function writeTeamInstructions(teamInstructions, baseDir) {
+  if (!teamInstructions) return null;
+  const filePath = join(baseDir, ".claude", "CLAUDE.md");
+  await ensureDir(filePath);
+  await writeFile(filePath, teamInstructions.trim() + "\n", "utf-8");
+  console.log(formatSuccess(`Created: ${filePath}`));
+  return filePath;
+}
+
+/**
+ * Write skill files (SKILL.md, scripts/install.sh, references/REFERENCE.md)
+ * @param {Array} skills - Generated skills
+ * @param {string} baseDir - Base output directory
+ * @param {Object} templates - Templates object with skill, install, reference
+ */
+export async function writeSkills(skills, baseDir, templates) {
+  let fileCount = 0;
+  for (const skill of skills) {
+    const skillDir = join(baseDir, ".claude", "skills", skill.dirname);
+
+    const skillPath = join(skillDir, "SKILL.md");
+    const skillContent = formatAgentSkill(skill, templates.skill);
+    await ensureDir(skillPath);
+    await writeFile(skillPath, skillContent, "utf-8");
+    console.log(formatSuccess(`Created: ${skillPath}`));
+    fileCount++;
+
+    if (skill.installScript) {
+      const installPath = join(skillDir, "scripts", "install.sh");
+      const installContent = formatInstallScript(skill, templates.install);
+      await ensureDir(installPath);
+      await writeFile(installPath, installContent, { mode: 0o755 });
+      console.log(formatSuccess(`Created: ${installPath}`));
+      fileCount++;
+    }
+
+    if (skill.implementationReference) {
+      const refPath = join(skillDir, "references", "REFERENCE.md");
+      const refContent = formatReference(skill, templates.reference);
+      await ensureDir(refPath);
+      await writeFile(refPath, refContent, "utf-8");
+      console.log(formatSuccess(`Created: ${refPath}`));
+      fileCount++;
+    }
+  }
+  return fileCount;
+}