@forwardimpact/pathway 0.22.0 → 0.23.1

package/src/lib/yaml-loader.js

@@ -1,56 +1,21 @@
 /**
  * Browser-compatible YAML loading
  *
- * Uses _index.yaml files to discover files in directory structures.
- * These index files are auto-generated by the CLI (npx pathway --generate-index).
+ * Generic utilities from @forwardimpact/libui/yaml-loader,
+ * plus Pathway-specific entity loaders.
  */
 
-import { parse as parseYaml } from "https://cdn.jsdelivr.net/npm/yaml@2.3.4/+esm";
+export {
+  loadYamlFile,
+  tryLoadYamlFile,
+  loadDirIndex,
+} from "@forwardimpact/libui/yaml-loader";
 
-/**
- * Load and parse a YAML file
- * @param {string} path - Path to the YAML file
- * @returns {Promise<*>}
- */
-export async function loadYamlFile(path) {
-  const response = await fetch(path);
-  if (!response.ok) {
-    throw new Error(
-      `Failed to load ${path}: ${response.status} ${response.statusText}`,
-    );
-  }
-  const text = await response.text();
-  return parseYaml(text);
-}
-
-/**
- * Try to load a YAML file, return null if not found
- * @param {string} path - Path to the YAML file
- * @returns {Promise<*|null>}
- */
-async function tryLoadYamlFile(path) {
-  const response = await fetch(path);
-  if (response.status === 404) {
-    return null;
-  }
-  if (!response.ok) {
-    throw new Error(
-      `Failed to load ${path}: ${response.status} ${response.statusText}`,
-    );
-  }
-  const text = await response.text();
-  return parseYaml(text);
-}
-
-/**
- * Load directory index (list of file IDs)
- * @param {string} dir - Directory path
- * @returns {Promise<string[]>} Array of file IDs
- */
-async function loadDirIndex(dir) {
-  const index = await loadYamlFile(`${dir}/_index.yaml`);
-  return index.files || [];
-}
+import {
+  loadYamlFile,
+  tryLoadYamlFile,
+  loadDirIndex,
+} from "@forwardimpact/libui/yaml-loader";
 
 /**
  * Load skills from capability files
@@ -115,23 +80,18 @@ async function loadDisciplinesFromDir(disciplinesDir) {
   const disciplines = await Promise.all(
     disciplineIds.map(async (id) => {
       const content = await loadYamlFile(`${disciplinesDir}/${id}.yaml`);
-      // Shared content at top level, role summaries under human:
       const {
         specialization,
         roleTitle,
-        // Track constraints
         isProfessional,
         isManagement,
         validTracks,
         minLevel,
-        // Shared content - now at root level
         description,
-        // Structural properties (derivation inputs)
         coreSkills,
         supportingSkills,
         broadSkills,
         behaviourModifiers,
-        // Presentation sections
         human,
         agent,
       } = content;
@@ -139,19 +99,15 @@ async function loadDisciplinesFromDir(disciplinesDir) {
         id,
         specialization,
         roleTitle,
-        // Track constraints
         isProfessional,
         isManagement,
         validTracks,
         minLevel,
-        // Shared content at top level
         description,
-        // Structural properties
         coreSkills,
         supportingSkills,
         broadSkills,
         behaviourModifiers,
-        // Human presentation content (role summaries only)
         ...human,
         ...(agent && { agent }),
       };
@@ -171,27 +127,21 @@ async function loadTracksFromDir(tracksDir) {
   const tracks = await Promise.all(
     trackIds.map(async (id) => {
       const content = await loadYamlFile(`${tracksDir}/${id}.yaml`);
-      // Shared content at top level (no human section for tracks anymore)
       const {
         name,
-        // Shared content - now at root level
         description,
         roleContext,
-        // Structural properties (derivation inputs)
         skillModifiers,
         behaviourModifiers,
         matchingWeights,
         minLevel,
-        // Agent section (no human section anymore for tracks)
         agent,
       } = content;
       return {
         id,
         name,
-        // Shared content at top level
         description,
         roleContext,
-        // Structural properties
         skillModifiers,
         behaviourModifiers,
         matchingWeights,
@@ -214,7 +164,6 @@ async function loadBehavioursFromDir(behavioursDir) {
   const behaviours = await Promise.all(
     behaviourIds.map(async (id) => {
       const content = await loadYamlFile(`${behavioursDir}/${id}.yaml`);
-      // Flatten human properties to top level (behaviours use human: section in YAML)
       const { name, human, agent } = content;
       return {
         id,
@@ -297,13 +246,9 @@ async function loadQuestionFolder(
  * @returns {Promise<Object>}
  */
 export async function loadAllData(dataDir = "./data") {
-  // Load capabilities first (skills are embedded in capabilities)
   const capabilities = await loadCapabilitiesFromDir(`${dataDir}/capabilities`);
-
-  // Extract skills from capabilities
   const skills = await loadSkillsFromCapabilities(`${dataDir}/capabilities`);
 
-  // Load remaining core data in parallel (using _index.yaml for discovery)
   const [drivers, behaviours, disciplines, tracks, levels, stages, framework] =
     await Promise.all([
       loadYamlFile(`${dataDir}/drivers.yaml`),
@@ -315,7 +260,6 @@ export async function loadAllData(dataDir = "./data") {
       loadYamlFile(`${dataDir}/framework.yaml`),
     ]);
 
-  // Load questions using skill/behaviour/capability IDs
   const questions = await loadQuestionFolder(
     `${dataDir}/questions`,
     skills,
@@ -339,9 +283,8 @@ export async function loadAllData(dataDir = "./data") {
 
 /**
  * Load agent-specific data for browser-based agent generation
- * Uses co-located files where agent sections are embedded in entity files
  * @param {string} [dataDir='./data'] - Path to data directory
- * @returns {Promise<Object>} Agent data including disciplines, tracks, behaviours, vscodeSettings, devcontainer, copilotSetupSteps
+ * @returns {Promise<Object>}
  */
 export async function loadAgentDataBrowser(dataDir = "./data") {
   const [
@@ -360,7 +303,6 @@ export async function loadAgentDataBrowser(dataDir = "./data") {
     tryLoadYamlFile(`${dataDir}/copilot-setup-steps.yaml`),
   ]);
 
-  // Extract agent sections from co-located files
   return {
     disciplines: disciplines
       .filter((d) => d.agent)

package/src/pages/agent-builder.js

@@ -29,7 +29,7 @@ import {
   deriveReferenceLevel,
   deriveToolkit,
   buildAgentIndex,
-} from "@forwardimpact/libpathway";
+} from "@forwardimpact/libskill";
 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/libpathway/matching";
+import { findRealisticMatches } from "@forwardimpact/libskill/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/libpathway/job";
+import { prepareJobBuilderPreview } from "@forwardimpact/libskill/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/libpathway/job";
+import { prepareJobDetail } from "@forwardimpact/libskill/job";
 import { jobToDOM } from "../formatters/job/dom.js";
 
 /** @type {string|null} Cached job template */

package/src/pages/skill.js

@@ -11,7 +11,7 @@ import { prepareSkillsList } from "../formatters/skill/shared.js";
 import { skillToDOM } from "../formatters/skill/dom.js";
 import { skillToCardConfig } from "../lib/card-mappers.js";
 import { getCapabilityEmoji, getConceptEmoji } from "@forwardimpact/map/levels";
-import { generateSkillMarkdown } from "@forwardimpact/libpathway";
+import { generateSkillMarkdown } from "@forwardimpact/libskill";
 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/libpathway/derivation";
+import { generateAllJobs } from "@forwardimpact/libskill/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/map/levels";
-import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
+import { generateAllJobs } from "@forwardimpact/libskill/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/libpathway/job";
+import { prepareJobDetail } from "@forwardimpact/libskill/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 { prepareLevelsList } from "../formatters/level/shared.js";
 import { prepareTracksList } from "../formatters/track/shared.js";
-import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
+import { generateAllJobs } from "@forwardimpact/libskill/derivation";
 
 /**
  * Format discipline group name for display

package/src/slides.html

@@ -13,19 +13,38 @@
           "@forwardimpact/map/levels": "/map/lib/levels.js",
           "@forwardimpact/map/loader": "/map/lib/loader.js",
           "@forwardimpact/map/validation": "/map/lib/validation.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"
+          "@forwardimpact/libskill": "/model/lib/index.js",
+          "@forwardimpact/libskill/derivation": "/model/lib/derivation.js",
+          "@forwardimpact/libskill/modifiers": "/model/lib/modifiers.js",
+          "@forwardimpact/libskill/agent": "/model/lib/agent.js",
+          "@forwardimpact/libskill/interview": "/model/lib/interview.js",
+          "@forwardimpact/libskill/job": "/model/lib/job.js",
+          "@forwardimpact/libskill/job-cache": "/model/lib/job-cache.js",
+          "@forwardimpact/libskill/checklist": "/model/lib/checklist.js",
+          "@forwardimpact/libskill/matching": "/model/lib/matching.js",
+          "@forwardimpact/libskill/profile": "/model/lib/profile.js",
+          "@forwardimpact/libskill/progression": "/model/lib/progression.js",
+          "@forwardimpact/libskill/policies": "/model/lib/policies/index.js",
+          "@forwardimpact/libskill/toolkit": "/model/lib/toolkit.js",
+          "@forwardimpact/libui": "/ui/lib/index.js",
+          "@forwardimpact/libui/render": "/ui/lib/render.js",
+          "@forwardimpact/libui/reactive": "/ui/lib/reactive.js",
+          "@forwardimpact/libui/state": "/ui/lib/state.js",
+          "@forwardimpact/libui/errors": "/ui/lib/errors.js",
+          "@forwardimpact/libui/error-boundary": "/ui/lib/error-boundary.js",
+          "@forwardimpact/libui/router-core": "/ui/lib/router-core.js",
+          "@forwardimpact/libui/router-pages": "/ui/lib/router-pages.js",
+          "@forwardimpact/libui/router-slides": "/ui/lib/router-slides.js",
+          "@forwardimpact/libui/yaml-loader": "/ui/lib/yaml-loader.js",
+          "@forwardimpact/libui/markdown": "/ui/lib/markdown.js",
+          "@forwardimpact/libui/utils": "/ui/lib/utils.js",
+          "@forwardimpact/libui/components": "/ui/lib/components/index.js",
+          "@forwardimpact/libui/components/card": "/ui/lib/components/card.js",
+          "@forwardimpact/libui/components/grid": "/ui/lib/components/grid.js",
+          "@forwardimpact/libui/components/list": "/ui/lib/components/list.js",
+          "@forwardimpact/libui/components/detail": "/ui/lib/components/detail.js",
+          "@forwardimpact/libui/components/nav": "/ui/lib/components/nav.js",
+          "@forwardimpact/libui/components/error-page": "/ui/lib/components/error-page.js"
         }
       }
     </script>

package/src/css/base.css

@@ -1,56 +0,0 @@
-/**
- * Base Styles
- *
- * Typography, links, and body defaults using design tokens.
- * Import after tokens.css and reset.css.
- */
-
-@layer base {
-  body {
-    font-family: var(--font-family);
-    font-size: var(--font-size-base);
-    line-height: 1.6;
-    color: var(--color-text);
-    background-color: var(--color-bg);
-  }
-
-  h1,
-  h2,
-  h3,
-  h4,
-  h5,
-  h6 {
-    margin-bottom: var(--space-md);
-  }
-
-  h1 {
-    font-size: var(--font-size-3xl);
-    font-weight: 700;
-  }
-
-  h2 {
-    font-size: var(--font-size-2xl);
-  }
-
-  h3 {
-    font-size: var(--font-size-xl);
-  }
-
-  h4 {
-    font-size: var(--font-size-lg);
-  }
-
-  p {
-    margin-bottom: var(--space-md);
-  }
-
-  a {
-    color: var(--color-primary);
-    text-decoration: none;
-  }
-
-  a:hover {
-    color: var(--color-primary-dark);
-    text-decoration: underline;
-  }
-}

package/src/css/components/badges.css

@@ -1,232 +0,0 @@
-/**
- * Badge Components
- *
- * All badge variants consolidated: type badges, level badges, capability badges, modifiers.
- */
-
-@layer components {
-  /* Base badge - 28px height matches tool icons for consistent row heights */
-  .badge {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    height: 28px;
-    padding: 0 var(--space-sm);
-    border-radius: var(--radius-md);
-    font-size: var(--font-size-xs);
-    font-weight: 500;
-    text-transform: uppercase;
-    letter-spacing: 0.025em;
-  }
-
-  .badge-default {
-    background: var(--color-primary-light);
-    color: var(--color-primary-dark);
-  }
-
-  .badge-human-only {
-    background: #fef3c7;
-    color: #92400e;
-  }
-
-  /* Skill type badges */
-  .badge-primary {
-    background: var(--color-primary-skill-light);
-    color: var(--color-primary-skill);
-  }
-
-  .badge-secondary {
-    background: var(--color-secondary-light);
-    color: #92400e;
-  }
-
-  .badge-broad {
-    background: var(--color-broad-light);
-    color: #047857;
-  }
-
-  .badge-negative {
-    background: var(--color-primary-skill-light);
-    color: var(--color-primary-skill);
-  }
-
-  /* Level badges (1-5) - consolidated definition */
-  .badge-1,
-  .level-badge-1 {
-    background: var(--color-level-1);
-    color: #991b1b;
-  }
-
-  .badge-2,
-  .level-badge-2 {
-    background: var(--color-level-2);
-    color: #92400e;
-  }
-
-  .badge-3,
-  .level-badge-3 {
-    background: var(--color-level-3);
-    color: #166534;
-  }
-
-  .badge-4,
-  .level-badge-4 {
-    background: var(--color-level-4);
-    color: #0e7490;
-  }
-
-  .badge-5,
-  .level-badge-5 {
-    background: var(--color-level-5);
-    color: #5b21b6;
-  }
-
-  /* Level badge base style - 28px height matches tool icons */
-  .level-badge {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    height: 28px;
-    padding: 0 var(--space-sm);
-    border-radius: var(--radius-md);
-    font-size: var(--font-size-sm);
-    font-weight: 500;
-  }
-
-  /* Capability badges - each capability ID maps to its own distinct color */
-  .badge-ai {
-    background: var(--color-cap-ai-light);
-    color: var(--color-cap-ai);
-  }
-
-  .badge-business {
-    background: var(--color-cap-business-light);
-    color: var(--color-cap-business);
-  }
-
-  .badge-data {
-    background: var(--color-cap-data-light);
-    color: var(--color-cap-data);
-  }
-
-  .badge-delivery {
-    background: var(--color-cap-delivery-light);
-    color: var(--color-cap-delivery);
-  }
-
-  .badge-documentation {
-    background: var(--color-cap-documentation-light);
-    color: var(--color-cap-documentation);
-  }
-
-  .badge-ml {
-    background: var(--color-cap-ml-light);
-    color: var(--color-cap-ml);
-  }
-
-  .badge-people {
-    background: var(--color-cap-people-light);
-    color: var(--color-cap-people);
-  }
-
-  .badge-process {
-    background: var(--color-cap-process-light);
-    color: var(--color-cap-process);
-  }
-
-  .badge-product {
-    background: var(--color-cap-product-light);
-    color: var(--color-cap-product);
-  }
-
-  .badge-reliability {
-    background: var(--color-cap-reliability-light);
-    color: var(--color-cap-reliability);
-  }
-
-  .badge-scale {
-    background: var(--color-cap-scale-light);
-    color: var(--color-cap-scale);
-  }
-
-  /* Tool badge */
-  .badge-tool {
-    background: var(--color-bg);
-    color: var(--color-text);
-    border: 1px solid var(--color-border);
-    font-size: 0.9rem;
-    padding: var(--space-xs) var(--space-sm);
-  }
-
-  /* Modifier tags - 28px height matches badges and tool icons */
-  .modifier {
-    display: inline-flex;
-    align-items: center;
-    height: 28px;
-    padding: 0 var(--space-sm);
-    border-radius: var(--radius-sm);
-    font-size: var(--font-size-sm);
-    font-weight: 600;
-    line-height: 1;
-  }
-
-  .modifier-positive {
-    background: var(--color-level-3);
-    color: #166534;
-  }
-
-  .modifier-negative {
-    background: var(--color-level-1);
-    color: #991b1b;
-  }
-
-  .modifier-neutral {
-    background: var(--color-surface);
-    color: var(--color-text-muted);
-    border: 1px solid var(--color-border);
-  }
-
-  /* Info tags */
-  .info-tags {
-    display: flex;
-    gap: var(--space-sm);
-    flex-wrap: wrap;
-  }
-
-  .info-tag {
-    display: inline-block;
-    padding: var(--space-xs) var(--space-sm);
-    background: var(--color-bg);
-    border-radius: var(--radius-md);
-    font-size: var(--font-size-sm);
-    color: var(--color-text-muted);
-  }
-
-  /* Tool/skill badges container */
-  .tool-badges,
-  .skill-badges {
-    display: flex;
-    flex-wrap: wrap;
-    gap: var(--space-sm);
-  }
-
-  /* Change indicators */
-  .change-indicator {
-    display: inline-flex;
-    align-items: center;
-    gap: var(--space-xs);
-    font-weight: 500;
-  }
-
-  .change-up {
-    color: var(--color-success);
-  }
-
-  .change-down {
-    color: var(--color-error);
-  }
-
-  .change-same {
-    color: var(--color-text-muted);
-  }
-}