@forwardimpact/pathway 0.17.2 → 0.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.17.2",
+  "version": "0.19.0",
   "description": "Career progression web app and CLI for exploring roles and generating agent teams",
   "license": "Apache-2.0",
   "repository": {
@@ -40,8 +40,8 @@
     "./commands": "./src/commands/index.js"
   },
   "dependencies": {
-    "@forwardimpact/schema": "^0.9.0",
-    "@forwardimpact/model": "^1.1.0",
+    "@forwardimpact/schema": "^0.10.0",
+    "@forwardimpact/libpathway": "^2.0.0",
     "mustache": "^4.2.0",
     "simple-icons": "^16.7.0",
     "yaml": "^2.3.4"

package/src/commands/agent.js

@@ -40,7 +40,9 @@ import {
   generateSkillMarkdown,
   deriveToolkit,
   buildAgentIndex,
-} from "@forwardimpact/model";
+  getDisciplineAbbreviation,
+  toKebabCase,
+} from "@forwardimpact/libpathway";
 import { formatAgentProfile } from "../formatters/agent/profile.js";
 import {
   formatAgentSkill,
@@ -205,7 +207,9 @@ function listAgentCombinations(data, agentData, verbose = false) {
         );
         const humanTrack = data.tracks.find((t) => t.id === track.id);
         if (humanDiscipline && humanTrack) {
-          console.log(`${discipline.id} ${track.id}`);
+          const abbrev = getDisciplineAbbreviation(discipline.id);
+          const agentName = `${abbrev}-${toKebabCase(track.id)}`;
+          console.log(`${agentName} ${discipline.id} ${track.id}`);
         }
       }
     }
@@ -338,6 +342,16 @@ export async function runAgentCommand({ data, args, options, dataDir }) {
   const [disciplineId] = args;
   const trackId = options.track;
 
+  // Reject unexpected positional args (track must use --track=<id>)
+  if (args.length > 1) {
+    console.error(
+      formatError(
+        `Unexpected argument: ${args[1]}. Did you mean --track=${args[1]}?`,
+      ),
+    );
+    process.exit(1);
+  }
+
   if (!disciplineId) {
     console.error(
       formatError(

package/src/commands/build.js

@@ -42,7 +42,7 @@ function resolvePackageLib(packageName) {
 }
 
 const schemaLibDir = resolvePackageLib("@forwardimpact/schema");
-const modelLibDir = resolvePackageLib("@forwardimpact/model");
+const modelLibDir = resolvePackageLib("@forwardimpact/libpathway");
 
 /**
  * Files and directories to copy from app/
@@ -141,7 +141,7 @@ ${framework.emojiIcon} Generating ${framework.title} static site...
     }
   }
 
-  // Copy @forwardimpact/schema and @forwardimpact/model packages
+  // Copy @forwardimpact/schema and @forwardimpact/libpathway packages
   // These are needed by the browser's import map
   console.log("📚 Copying package dependencies...");
   await cp(schemaLibDir, join(outputDir, "schema/lib"), { recursive: true });

package/src/commands/dev.js

@@ -31,7 +31,7 @@ function resolvePackageLib(packageName) {
 }
 
 const schemaLibDir = resolvePackageLib("@forwardimpact/schema");
-const modelLibDir = resolvePackageLib("@forwardimpact/model");
+const modelLibDir = resolvePackageLib("@forwardimpact/libpathway");
 
 const MIME_TYPES = {
   ".html": "text/html; charset=utf-8",
@@ -138,7 +138,7 @@ export async function runDevCommand({ dataDir, options }) {
       // Serve @forwardimpact/schema package files (resolved via Node module resolution)
       filePath = join(schemaLibDir, pathname.slice(12));
     } else if (pathname.startsWith("/model/lib/")) {
-      // Serve @forwardimpact/model package files (resolved via Node module resolution)
+      // Serve @forwardimpact/libpathway package files (resolved via Node module resolution)
       filePath = join(modelLibDir, pathname.slice(11));
     } else if (pathname === "/" || pathname === "") {
       // Serve index.html for root

package/src/commands/job.js

@@ -14,14 +14,14 @@
  *   npx pathway job --validate                               # Validation checks
  */
 
-import { prepareJobDetail } from "@forwardimpact/model/job";
+import { prepareJobDetail } from "@forwardimpact/libpathway/job";
 import { jobToMarkdown } from "../formatters/job/markdown.js";
-import { generateAllJobs } from "@forwardimpact/model/derivation";
+import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
 import { formatTable } from "../lib/cli-output.js";
 import {
   deriveChecklist,
   formatChecklistMarkdown,
-} from "@forwardimpact/model/checklist";
+} from "@forwardimpact/libpathway/checklist";
 import { loadJobTemplate } from "../lib/template-loader.js";
 import { toolkitToPlainList } from "../formatters/toolkit/markdown.js";
 

package/src/commands/skill.js

@@ -16,7 +16,7 @@ import { skillToMarkdown } from "../formatters/skill/markdown.js";
 import { prepareSkillsList } from "../formatters/skill/shared.js";
 import { getConceptEmoji } from "@forwardimpact/schema/levels";
 import { formatTable, formatError } from "../lib/cli-output.js";
-import { generateSkillMarkdown } from "@forwardimpact/model/agent";
+import { generateSkillMarkdown } from "@forwardimpact/libpathway/agent";
 import { formatAgentSkill } from "../formatters/agent/skill.js";
 import { loadSkillTemplate } from "../lib/template-loader.js";
 

package/src/components/comparison-radar.js

@@ -13,7 +13,7 @@ import {
   getBehaviourMaturityIndex,
   formatLevel,
 } from "../lib/render.js";
-import { compareByCapability } from "@forwardimpact/model/policies";
+import { compareByCapability } from "@forwardimpact/libpathway/policies";
 
 /**
  * Create a comparison skill radar chart

package/src/css/views/print.css

@@ -546,6 +546,15 @@
       padding-top: 3rem;
     }
 
+    /* Handout view: hide brand header — chapter covers provide branding */
+    .handout-view .page-brand-header {
+      display: none !important;
+    }
+
+    .handout-view main {
+      padding-top: 0;
+    }
+
     /* Chapter cover print styles */
     .chapter-cover {
       page-break-after: always;
@@ -556,6 +565,23 @@
       align-items: center;
     }
 
+    /* Handout view: page breaks between chapters and sections */
+    .handout-view .chapter-cover {
+      page-break-before: always;
+      page-break-after: auto;
+    }
+
+    .handout-view .detail-page {
+      page-break-before: always;
+      border-bottom: none;
+      margin-bottom: 0;
+      padding-bottom: 0;
+    }
+
+    .handout-view main > :first-child {
+      page-break-before: auto;
+    }
+
     /* Checklist print styles */
     .checklist-section {
       page-break-inside: avoid;

package/src/formatters/interview/shared.js

@@ -8,13 +8,13 @@ import {
   isValidJobCombination,
   generateJobTitle,
   getDisciplineSkillIds,
-} from "@forwardimpact/model/derivation";
+} from "@forwardimpact/libpathway/derivation";
 import {
   deriveMissionFitInterview,
   deriveDecompositionInterview,
   deriveStakeholderInterview,
-} from "@forwardimpact/model/interview";
-import { getOrCreateJob } from "@forwardimpact/model/job-cache";
+} from "@forwardimpact/libpathway/interview";
+import { getOrCreateJob } from "@forwardimpact/libpathway/job-cache";
 
 /**
  * Interview type configurations

package/src/formatters/progress/shared.js

@@ -7,13 +7,13 @@
 import {
   isValidJobCombination,
   generateJobTitle,
-} from "@forwardimpact/model/derivation";
+} from "@forwardimpact/libpathway/derivation";
 import {
   analyzeProgression,
   analyzeCustomProgression,
   getNextGrade,
-} from "@forwardimpact/model/progression";
-import { getOrCreateJob } from "@forwardimpact/model/job-cache";
+} from "@forwardimpact/libpathway/progression";
+import { getOrCreateJob } from "@forwardimpact/libpathway/job-cache";
 
 /**
  * Get the next grade for progression

package/src/formatters/skill/shared.js

@@ -8,7 +8,7 @@ import {
   groupSkillsByCapability,
   getCapabilityEmoji,
 } from "@forwardimpact/schema/levels";
-import { getSkillTypeForDiscipline } from "@forwardimpact/model/derivation";
+import { getSkillTypeForDiscipline } from "@forwardimpact/libpathway/derivation";
 import { truncate } from "../shared.js";
 
 /**

package/src/formatters/track/shared.js

@@ -7,7 +7,7 @@
 import {
   isCapability,
   getSkillsByCapability,
-} from "@forwardimpact/model/modifiers";
+} from "@forwardimpact/libpathway/modifiers";
 import { truncate } from "../shared.js";
 
 /**

package/src/handout.html

@@ -13,19 +13,19 @@
           "@forwardimpact/schema/levels": "/schema/lib/levels.js",
           "@forwardimpact/schema/loader": "/schema/lib/loader.js",
           "@forwardimpact/schema/validation": "/schema/lib/validation.js",
-          "@forwardimpact/model": "/model/lib/index.js",
-          "@forwardimpact/model/derivation": "/model/lib/derivation.js",
-          "@forwardimpact/model/modifiers": "/model/lib/modifiers.js",
-          "@forwardimpact/model/agent": "/model/lib/agent.js",
-          "@forwardimpact/model/interview": "/model/lib/interview.js",
-          "@forwardimpact/model/job": "/model/lib/job.js",
-          "@forwardimpact/model/job-cache": "/model/lib/job-cache.js",
-          "@forwardimpact/model/checklist": "/model/lib/checklist.js",
-          "@forwardimpact/model/matching": "/model/lib/matching.js",
-          "@forwardimpact/model/profile": "/model/lib/profile.js",
-          "@forwardimpact/model/progression": "/model/lib/progression.js",
-          "@forwardimpact/model/policies": "/model/lib/policies/index.js",
-          "@forwardimpact/model/toolkit": "/model/lib/toolkit.js"
+          "@forwardimpact/libpathway": "/model/lib/index.js",
+          "@forwardimpact/libpathway/derivation": "/model/lib/derivation.js",
+          "@forwardimpact/libpathway/modifiers": "/model/lib/modifiers.js",
+          "@forwardimpact/libpathway/agent": "/model/lib/agent.js",
+          "@forwardimpact/libpathway/interview": "/model/lib/interview.js",
+          "@forwardimpact/libpathway/job": "/model/lib/job.js",
+          "@forwardimpact/libpathway/job-cache": "/model/lib/job-cache.js",
+          "@forwardimpact/libpathway/checklist": "/model/lib/checklist.js",
+          "@forwardimpact/libpathway/matching": "/model/lib/matching.js",
+          "@forwardimpact/libpathway/profile": "/model/lib/profile.js",
+          "@forwardimpact/libpathway/progression": "/model/lib/progression.js",
+          "@forwardimpact/libpathway/policies": "/model/lib/policies/index.js",
+          "@forwardimpact/libpathway/toolkit": "/model/lib/toolkit.js"
         }
       }
     </script>

package/src/index.html

@@ -25,19 +25,19 @@
           "@forwardimpact/schema/levels": "/schema/lib/levels.js",
           "@forwardimpact/schema/loader": "/schema/lib/loader.js",
           "@forwardimpact/schema/validation": "/schema/lib/validation.js",
-          "@forwardimpact/model": "/model/lib/index.js",
-          "@forwardimpact/model/derivation": "/model/lib/derivation.js",
-          "@forwardimpact/model/modifiers": "/model/lib/modifiers.js",
-          "@forwardimpact/model/agent": "/model/lib/agent.js",
-          "@forwardimpact/model/interview": "/model/lib/interview.js",
-          "@forwardimpact/model/job": "/model/lib/job.js",
-          "@forwardimpact/model/job-cache": "/model/lib/job-cache.js",
-          "@forwardimpact/model/checklist": "/model/lib/checklist.js",
-          "@forwardimpact/model/matching": "/model/lib/matching.js",
-          "@forwardimpact/model/profile": "/model/lib/profile.js",
-          "@forwardimpact/model/progression": "/model/lib/progression.js",
-          "@forwardimpact/model/policies": "/model/lib/policies/index.js",
-          "@forwardimpact/model/toolkit": "/model/lib/toolkit.js"
+          "@forwardimpact/libpathway": "/model/lib/index.js",
+          "@forwardimpact/libpathway/derivation": "/model/lib/derivation.js",
+          "@forwardimpact/libpathway/modifiers": "/model/lib/modifiers.js",
+          "@forwardimpact/libpathway/agent": "/model/lib/agent.js",
+          "@forwardimpact/libpathway/interview": "/model/lib/interview.js",
+          "@forwardimpact/libpathway/job": "/model/lib/job.js",
+          "@forwardimpact/libpathway/job-cache": "/model/lib/job-cache.js",
+          "@forwardimpact/libpathway/checklist": "/model/lib/checklist.js",
+          "@forwardimpact/libpathway/matching": "/model/lib/matching.js",
+          "@forwardimpact/libpathway/profile": "/model/lib/profile.js",
+          "@forwardimpact/libpathway/progression": "/model/lib/progression.js",
+          "@forwardimpact/libpathway/policies": "/model/lib/policies/index.js",
+          "@forwardimpact/libpathway/toolkit": "/model/lib/toolkit.js"
         }
       }
     </script>

package/src/lib/job-cache.js

@@ -5,7 +5,7 @@
  * Provides consistent key generation and get-or-create pattern.
  */
 
-import { deriveJob } from "@forwardimpact/model/derivation";
+import { deriveJob } from "@forwardimpact/libpathway/derivation";
 
 /** @type {Map<string, Object>} */
 const cache = new Map();

package/src/pages/agent-builder.js

@@ -29,7 +29,7 @@ import {
   deriveReferenceGrade,
   deriveToolkit,
   buildAgentIndex,
-} from "@forwardimpact/model";
+} from "@forwardimpact/libpathway";
 import {
   createSelectWithValue,
   createDisciplineSelect,

package/src/pages/assessment-results.js

@@ -19,7 +19,7 @@ import { getState } from "../lib/state.js";
 import { createBadge } from "../components/card.js";
 import { formatLevel } from "../lib/render.js";
 import { getAssessmentState, resetAssessment } from "./self-assessment.js";
-import { findRealisticMatches } from "@forwardimpact/model/matching";
+import { findRealisticMatches } from "@forwardimpact/libpathway/matching";
 
 /**
  * Render the assessment results page

package/src/pages/job-builder.js

@@ -5,7 +5,7 @@
 import { render } from "../lib/render.js";
 import { getState } from "../lib/state.js";
 import { createBuilder, createStandardPreview } from "../components/builder.js";
-import { prepareJobBuilderPreview } from "@forwardimpact/model/job";
+import { prepareJobBuilderPreview } from "@forwardimpact/libpathway/job";
 
 /**
  * Render job builder page

package/src/pages/job.js

@@ -5,7 +5,7 @@
 import { render, div, p } from "../lib/render.js";
 import { getState } from "../lib/state.js";
 import { renderError } from "../components/error-page.js";
-import { prepareJobDetail } from "@forwardimpact/model/job";
+import { prepareJobDetail } from "@forwardimpact/libpathway/job";
 import { jobToDOM } from "../formatters/job/dom.js";
 
 /** @type {string|null} Cached job template */

package/src/pages/skill.js

@@ -14,7 +14,7 @@ import {
   getCapabilityEmoji,
   getConceptEmoji,
 } from "@forwardimpact/schema/levels";
-import { generateSkillMarkdown } from "@forwardimpact/model";
+import { generateSkillMarkdown } from "@forwardimpact/libpathway";
 import { formatAgentSkill } from "../formatters/agent/skill.js";
 
 /** @type {string|null} Cached skill template */

package/src/slide-main.js

@@ -8,7 +8,7 @@ import { createSlideRouter } from "./lib/router-slides.js";
 import { setData, getState } from "./lib/state.js";
 import { loadAllData } from "./lib/yaml-loader.js";
 import { span, a } from "./lib/render.js";
-import { generateAllJobs } from "@forwardimpact/model/derivation";
+import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
 import { sortTracksByName } from "./formatters/track/shared.js";
 
 // Import slide renderers

package/src/slides/index.js

@@ -6,7 +6,7 @@
 
 import { div, heading1, heading2, p, a, ul, li, span } from "../lib/render.js";
 import { getConceptEmoji } from "@forwardimpact/schema/levels";
-import { generateAllJobs } from "@forwardimpact/model/derivation";
+import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
 
 /**
  * Render the slide index

package/src/slides/job.js

@@ -5,7 +5,7 @@
  */
 
 import { div, h1, p } from "../lib/render.js";
-import { prepareJobDetail } from "@forwardimpact/model/job";
+import { prepareJobDetail } from "@forwardimpact/libpathway/job";
 import { jobToDOM } from "../formatters/index.js";
 
 /**

package/src/slides/overview.js

@@ -22,7 +22,7 @@ import { prepareBehavioursList } from "../formatters/behaviour/shared.js";
 import { prepareDriversList } from "../formatters/driver/shared.js";
 import { prepareGradesList } from "../formatters/grade/shared.js";
 import { prepareTracksList } from "../formatters/track/shared.js";
-import { generateAllJobs } from "@forwardimpact/model/derivation";
+import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
 
 /**
  * Format discipline group name for display

package/src/slides.html

@@ -13,19 +13,19 @@
           "@forwardimpact/schema/levels": "/schema/lib/levels.js",
           "@forwardimpact/schema/loader": "/schema/lib/loader.js",
           "@forwardimpact/schema/validation": "/schema/lib/validation.js",
-          "@forwardimpact/model": "/model/lib/index.js",
-          "@forwardimpact/model/derivation": "/model/lib/derivation.js",
-          "@forwardimpact/model/modifiers": "/model/lib/modifiers.js",
-          "@forwardimpact/model/agent": "/model/lib/agent.js",
-          "@forwardimpact/model/interview": "/model/lib/interview.js",
-          "@forwardimpact/model/job": "/model/lib/job.js",
-          "@forwardimpact/model/job-cache": "/model/lib/job-cache.js",
-          "@forwardimpact/model/checklist": "/model/lib/checklist.js",
-          "@forwardimpact/model/matching": "/model/lib/matching.js",
-          "@forwardimpact/model/profile": "/model/lib/profile.js",
-          "@forwardimpact/model/progression": "/model/lib/progression.js",
-          "@forwardimpact/model/policies": "/model/lib/policies/index.js",
-          "@forwardimpact/model/toolkit": "/model/lib/toolkit.js"
+          "@forwardimpact/libpathway": "/model/lib/index.js",
+          "@forwardimpact/libpathway/derivation": "/model/lib/derivation.js",
+          "@forwardimpact/libpathway/modifiers": "/model/lib/modifiers.js",
+          "@forwardimpact/libpathway/agent": "/model/lib/agent.js",
+          "@forwardimpact/libpathway/interview": "/model/lib/interview.js",
+          "@forwardimpact/libpathway/job": "/model/lib/job.js",
+          "@forwardimpact/libpathway/job-cache": "/model/lib/job-cache.js",
+          "@forwardimpact/libpathway/checklist": "/model/lib/checklist.js",
+          "@forwardimpact/libpathway/matching": "/model/lib/matching.js",
+          "@forwardimpact/libpathway/profile": "/model/lib/profile.js",
+          "@forwardimpact/libpathway/progression": "/model/lib/progression.js",
+          "@forwardimpact/libpathway/policies": "/model/lib/policies/index.js",
+          "@forwardimpact/libpathway/toolkit": "/model/lib/toolkit.js"
         }
       }
     </script>

package/templates/agent.template.md

@@ -52,10 +52,17 @@ handoffs:
 
 ## Required skills
 
-**MANDATORY:** Before starting work, you MUST read the relevant skill files for
-project-specific guidance, required tools, and technology standards. Pre-training
-knowledge alone is insufficient—skills contain organizational standards that
-override general knowledge.
+**MANDATORY:** Before starting work, you MUST read ALL listed skill files below,
+not just the most relevant one. Every skill contributes project-specific
+guidance, required tools, and technology standards. Pre-training knowledge alone
+is insufficient—skills contain organizational standards that override general
+knowledge.
+
+**FIRST ACTION:** Read every skill file listed below. For each skill, note
+its `<read_then_do_{{stageId}}>` and `<do_then_confirm_{{stageId}}>` checklist
+items. List all checklist items from all skills before beginning any work. Do
+not start implementation until every skill has been read and its checklists
+acknowledged.
 
 Each skill contains marked-up sections and references for precise navigation:
 
@@ -70,8 +77,10 @@ Each skill contains marked-up sections and references for precise navigation:
   preferences.
 {{#isOnboard}}
 - `scripts/install.sh` — Self-contained install script for environment setup.
-  Run this script to install prerequisites and configure the development
-  environment. Focus on setup only — do not begin feature implementation.
+  **Step 1 of onboarding — run FIRST:** Execute
+  `bash .claude/skills/<skill-name>/scripts/install.sh` for each skill before
+  doing any manual setup. Only install manually if the script is missing or
+  fails. Do not skip this step even if you can install the same tools manually.
 - `references/REFERENCE.md` — Detailed code examples and reference material.
   Consult this for implementation patterns, common pitfalls, and verification
   steps.