npm - @forwardimpact/pathway - Versions diffs - 0.1.0 → 0.3.0 - Mend

@forwardimpact/pathway 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (140) hide show

package/app/commands/agent.js +119 -31
package/app/commands/command-factory.js +3 -3
package/app/commands/interview.js +14 -7
package/app/commands/job.js +52 -33
package/app/commands/progress.js +14 -7
package/app/commands/serve.js +5 -0
package/app/commands/stage.js +0 -10
package/app/commands/track.js +5 -8
package/app/components/builder.js +117 -30
package/app/css/components/surfaces.css +16 -0
package/app/formatters/agent/profile.js +30 -115
package/app/formatters/agent/skill.js +23 -44
package/app/formatters/behaviour/dom.js +3 -0
package/app/formatters/behaviour/microdata.js +106 -0
package/app/formatters/discipline/dom.js +28 -1
package/app/formatters/discipline/microdata.js +117 -0
package/app/formatters/discipline/shared.js +49 -8
package/app/formatters/driver/dom.js +3 -0
package/app/formatters/driver/microdata.js +91 -0
package/app/formatters/grade/dom.js +5 -4
package/app/formatters/grade/microdata.js +151 -0
package/app/formatters/index.js +32 -1
package/app/formatters/interview/shared.js +13 -8
package/app/formatters/job/description.js +70 -81
package/app/formatters/job/dom.js +40 -113
package/app/formatters/job/markdown.js +17 -13
package/app/formatters/json-ld.js +242 -0
package/app/formatters/microdata-shared.js +184 -0
package/app/formatters/progress/shared.js +14 -11
package/app/formatters/shared.js +7 -2
package/app/formatters/skill/dom.js +3 -0
package/app/formatters/skill/microdata.js +151 -0
package/app/formatters/stage/dom.js +3 -18
package/app/formatters/stage/microdata.js +110 -0
package/app/formatters/stage/shared.js +0 -27
package/app/formatters/track/dom.js +5 -30
package/app/formatters/track/markdown.js +2 -25
package/app/formatters/track/microdata.js +111 -0
package/app/formatters/track/shared.js +6 -58
package/app/handout-main.js +26 -12
package/app/handout.html +7 -0
package/app/index.html +11 -0
package/app/lib/card-mappers.js +17 -12
package/app/lib/form-controls.js +64 -1
package/app/lib/job-cache.js +12 -9
package/app/lib/render.js +8 -1
package/app/lib/template-loader.js +75 -0
package/app/lib/yaml-loader.js +25 -8
package/app/main.js +8 -4
package/app/model/agent.js +158 -130
package/app/model/checklist.js +57 -91
package/app/model/derivation.js +135 -68
package/app/model/index-generator.js +1 -7
package/app/model/job.js +19 -13
package/app/model/levels.js +20 -12
package/app/model/loader.js +41 -17
package/app/model/matching.js +33 -3
package/app/model/profile.js +38 -45
package/app/model/schema-validation.js +438 -0
package/app/model/validation.js +747 -68
package/app/pages/agent-builder.js +125 -28
package/app/pages/assessment-results.js +10 -4
package/app/pages/discipline.js +36 -6
package/app/pages/driver.js +9 -47
package/app/pages/interview-builder.js +3 -1
package/app/pages/interview.js +15 -4
package/app/pages/job-builder.js +4 -1
package/app/pages/job.js +43 -8
package/app/pages/landing.js +10 -10
package/app/pages/progress-builder.js +3 -1
package/app/pages/progress.js +78 -26
package/app/pages/self-assessment.js +3 -3
package/app/pages/stage.js +3 -126
package/app/slide-main.js +45 -17
package/app/slides/index.js +3 -1
package/app/slides/overview.js +40 -4
package/app/slides/progress.js +4 -2
package/app/slides.html +7 -0
package/bin/pathway.js +28 -75
package/examples/agents/.claude/skills/architecture-design/SKILL.md +58 -16
package/examples/agents/.claude/skills/cloud-platforms/SKILL.md +59 -18
package/examples/agents/.claude/skills/code-quality-review/SKILL.md +58 -17
package/examples/agents/.claude/skills/devops-cicd/SKILL.md +64 -18
package/examples/agents/.claude/skills/full-stack-development/SKILL.md +59 -15
package/examples/agents/.claude/skills/sre-practices/SKILL.md +64 -18
package/examples/agents/.claude/skills/technical-debt-management/SKILL.md +58 -17
package/examples/agents/.github/agents/se-platform-code.agent.md +39 -88
package/examples/agents/.github/agents/se-platform-plan.agent.md +41 -88
package/examples/agents/.github/agents/se-platform-review.agent.md +38 -15
package/examples/agents/.vscode/settings.json +1 -1
package/examples/behaviours/outcome_ownership.yaml +1 -2
package/examples/behaviours/polymathic_knowledge.yaml +1 -2
package/examples/behaviours/precise_communication.yaml +1 -2
package/examples/behaviours/relentless_curiosity.yaml +1 -2
package/examples/behaviours/systems_thinking.yaml +1 -2
package/examples/capabilities/business.yaml +80 -142
package/examples/capabilities/delivery.yaml +155 -219
package/examples/capabilities/people.yaml +2 -34
package/examples/capabilities/reliability.yaml +161 -80
package/examples/capabilities/scale.yaml +234 -252
package/examples/copilot-setup-steps.yaml +25 -0
package/examples/devcontainer.yaml +21 -0
package/examples/disciplines/_index.yaml +1 -0
package/examples/disciplines/data_engineering.yaml +14 -12
package/examples/disciplines/engineering_management.yaml +63 -0
package/examples/disciplines/software_engineering.yaml +14 -12
package/examples/drivers.yaml +1 -4
package/examples/framework.yaml +1 -2
package/examples/grades.yaml +14 -15
package/examples/questions/behaviours/outcome_ownership.yaml +1 -2
package/examples/questions/behaviours/polymathic_knowledge.yaml +1 -2
package/examples/questions/behaviours/precise_communication.yaml +1 -2
package/examples/questions/behaviours/relentless_curiosity.yaml +1 -2
package/examples/questions/behaviours/systems_thinking.yaml +1 -2
package/examples/questions/skills/architecture_design.yaml +1 -2
package/examples/questions/skills/cloud_platforms.yaml +1 -2
package/examples/questions/skills/code_quality.yaml +1 -2
package/examples/questions/skills/data_modeling.yaml +1 -2
package/examples/questions/skills/devops.yaml +1 -2
package/examples/questions/skills/full_stack_development.yaml +1 -2
package/examples/questions/skills/sre_practices.yaml +1 -2
package/examples/questions/skills/stakeholder_management.yaml +1 -2
package/examples/questions/skills/team_collaboration.yaml +1 -2
package/examples/questions/skills/technical_writing.yaml +1 -2
package/examples/self-assessments.yaml +1 -3
package/examples/stages.yaml +101 -46
package/examples/tracks/_index.yaml +0 -1
package/examples/tracks/platform.yaml +8 -13
package/examples/tracks/sre.yaml +8 -18
package/examples/vscode-settings.yaml +2 -7
package/package.json +9 -3
package/templates/agent.template.md +65 -0
package/templates/job.template.md +47 -0
package/templates/skill.template.md +28 -0
package/examples/agents/.claude/skills/data-modeling/SKILL.md +0 -99
package/examples/agents/.claude/skills/developer-experience/SKILL.md +0 -99
package/examples/agents/.claude/skills/knowledge-management/SKILL.md +0 -100
package/examples/agents/.claude/skills/pattern-generalization/SKILL.md +0 -102
package/examples/agents/.claude/skills/technical-writing/SKILL.md +0 -129
package/examples/tracks/manager.yaml +0 -53

package/app/index.html CHANGED Viewed

@@ -5,6 +5,13 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Engineering Pathway</title>
     <link rel="stylesheet" href="css/bundles/app.css" />
+    <script type="importmap">
+      {
+        "imports": {
+          "mustache": "https://esm.sh/mustache@4.2.0"
+        }
+      }
+    </script>
   </head>
   <body>
     <div id="app">
@@ -51,6 +58,10 @@
       <footer id="app-footer">
         <p>Engineering Pathway</p>
+        <nav class="footer-links">
+          <a href="slides.html">Slides</a>
+          <a href="handout.html">Handouts</a>
+        </nav>
       </footer>
     </div>

package/app/lib/card-mappers.js CHANGED Viewed

@@ -15,10 +15,18 @@ import { getCapabilityEmoji } from "../model/levels.js";
  * @returns {Object}
  */
 export function disciplineToCardConfig(discipline) {
+  const badges = [];
+  if (discipline.isProfessional) {
+    badges.push(createBadge("Professional", "secondary"));
+  }
+  if (discipline.isManagement) {
+    badges.push(createBadge("Management", "primary"));
+  }
   return {
     title: discipline.name,
     description: discipline.truncatedDescription,
     href: `/discipline/${discipline.id}`,
+    badges,
     meta: [
       createBadge(`${discipline.coreSkillsCount} core`, "primary"),
       createBadge(
@@ -118,19 +126,11 @@ export function gradeToCardConfig(grade) {
  * @returns {Object}
  */
 export function trackToCardConfig(track) {
-  const badges = [];
-  if (track.isProfessional) {
-    badges.push(createBadge("Professional", "secondary"));
-  }
-  if (track.isManagement) {
-    badges.push(createBadge("Management", "default"));
-  }
   return {
     title: track.name,
     description: track.truncatedDescription,
     href: `/track/${track.id}`,
-    meta: badges,
+    meta: [],
   };
 }
@@ -140,12 +140,17 @@ export function trackToCardConfig(track) {
  * @returns {Object}
  */
 export function jobToCardConfig(job) {
+  const href = job.track
+    ? `/job/${job.discipline.id}/${job.grade.id}/${job.track.id}`
+    : `/job/${job.discipline.id}/${job.grade.id}`;
   return {
     title: job.title,
-    description: `${job.discipline.specialization || job.discipline.name} at ${job.grade.professionalTitle} level on ${job.track.name} track`,
-    href: `/job/${job.discipline.id}/${job.track.id}/${job.grade.id}`,
+    description: job.track
+      ? `${job.discipline.specialization || job.discipline.name} at ${job.grade.professionalTitle} level on ${job.track.name} track`
+      : `${job.discipline.specialization || job.discipline.name} at ${job.grade.professionalTitle} level`,
+    href,
     badges: [createBadge(job.grade.id, "default")],
-    meta: [createBadge(job.track.name, "secondary")],
+    meta: job.track ? [createBadge(job.track.name, "secondary")] : [],
   };
 }

package/app/lib/form-controls.js CHANGED Viewed

@@ -2,7 +2,7 @@
  * Reusable form control components
  */
-import { select, option } from "./render.js";
+import { select, option, optgroup } from "./render.js";
 /**
  * Create a select element with initial value and change handler
@@ -45,3 +45,66 @@ export function createSelectWithValue({
   return selectEl;
 }
+/**
+ * Create a discipline select with optgroups for Professional and Management
+ * @param {Object} options - Configuration options
+ * @param {string} options.id - Element ID
+ * @param {Array} options.disciplines - Array of discipline objects
+ * @param {string} options.initialValue - Initial selected value
+ * @param {string} options.placeholder - Placeholder text for empty option
+ * @param {Function} options.onChange - Callback when selection changes
+ * @param {Function} [options.getDisplayName] - Optional function to get display name from item
+ * @returns {HTMLElement}
+ */
+export function createDisciplineSelect({
+  id,
+  disciplines,
+  initialValue,
+  placeholder,
+  onChange,
+  getDisplayName,
+}) {
+  const displayFn = getDisplayName || ((d) => d.specialization || d.name);
+  // Separate disciplines by type
+  const professional = disciplines.filter((d) => d.isProfessional);
+  const management = disciplines.filter((d) => d.isManagement);
+  // Sort each group alphabetically by display name
+  professional.sort((a, b) => displayFn(a).localeCompare(displayFn(b)));
+  management.sort((a, b) => displayFn(a).localeCompare(displayFn(b)));
+  // Build options for a group
+  const buildOptions = (items) =>
+    items.map((item) => {
+      const opt = option({ value: item.id }, displayFn(item));
+      if (item.id === initialValue) {
+        opt.selected = true;
+      }
+      return opt;
+    });
+  // Build optgroups - Professional first, then Management
+  const groups = [];
+  if (professional.length > 0) {
+    groups.push(
+      optgroup({ label: "Professional" }, ...buildOptions(professional)),
+    );
+  }
+  if (management.length > 0) {
+    groups.push(optgroup({ label: "Management" }, ...buildOptions(management)));
+  }
+  const selectEl = select(
+    { className: "form-select", id },
+    option({ value: "" }, placeholder),
+    ...groups,
+  );
+  selectEl.addEventListener("change", (e) => {
+    onChange(e.target.value);
+  });
+  return selectEl;
+}

package/app/lib/job-cache.js CHANGED Viewed

@@ -13,12 +13,15 @@ const cache = new Map();
 /**
  * Create a consistent cache key from job parameters
  * @param {string} disciplineId
- * @param {string} trackId
  * @param {string} gradeId
+ * @param {string} [trackId] - Optional track ID
  * @returns {string}
  */
-export function makeJobKey(disciplineId, trackId, gradeId) {
-  return `${disciplineId}_${trackId}_${gradeId}`;
+export function makeJobKey(disciplineId, gradeId, trackId = null) {
+  if (trackId) {
+    return `${disciplineId}_${gradeId}_${trackId}`;
+  }
+  return `${disciplineId}_${gradeId}`;
 }
 /**
@@ -26,7 +29,7 @@ export function makeJobKey(disciplineId, trackId, gradeId) {
  * @param {Object} params
  * @param {Object} params.discipline
  * @param {Object} params.grade
- * @param {Object} params.track
+ * @param {Object} [params.track] - Optional track
  * @param {Array} params.skills
  * @param {Array} params.behaviours
  * @param {Array} [params.capabilities]
@@ -35,12 +38,12 @@ export function makeJobKey(disciplineId, trackId, gradeId) {
 export function getOrCreateJob({
   discipline,
   grade,
-  track,
+  track = null,
   skills,
   behaviours,
   capabilities,
 }) {
-  const key = makeJobKey(discipline.id, track.id, grade.id);
+  const key = makeJobKey(discipline.id, grade.id, track?.id);
   if (!cache.has(key)) {
     const job = deriveJob({
@@ -70,11 +73,11 @@ export function clearJobCache() {
 /**
  * Invalidate a specific job from the cache
  * @param {string} disciplineId
- * @param {string} trackId
  * @param {string} gradeId
+ * @param {string} [trackId] - Optional track ID
  */
-export function invalidateJob(disciplineId, trackId, gradeId) {
-  cache.delete(makeJobKey(disciplineId, trackId, gradeId));
+export function invalidateJob(disciplineId, gradeId, trackId = null) {
+  cache.delete(makeJobKey(disciplineId, gradeId, trackId));
 }
 /**

package/app/lib/render.js CHANGED Viewed

@@ -118,6 +118,8 @@ export const select = (attrs, ...children) =>
   createElement("select", attrs, ...children);
 export const option = (attrs, ...children) =>
   createElement("option", attrs, ...children);
+export const optgroup = (attrs, ...children) =>
+  createElement("optgroup", attrs, ...children);
 export const label = (attrs, ...children) =>
   createElement("label", attrs, ...children);
 export const form = (attrs, ...children) =>
@@ -185,12 +187,17 @@ export function showError(message) {
 /**
  * Format a skill level or behaviour maturity for display
+ * Handles both snake_case and camelCase
  * @param {string} value - The level/maturity value
  * @returns {string}
  */
 export function formatLevel(value) {
   if (!value) return "";
-  return value.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+  // Insert space before uppercase letters (for camelCase), then handle snake_case
+  return value
+    .replace(/([a-z])([A-Z])/g, "$1 $2")
+    .replace(/_/g, " ")
+    .replace(/\b\w/g, (c) => c.toUpperCase());
 }
 /**

package/app/lib/template-loader.js ADDED Viewed

@@ -0,0 +1,75 @@
+/**
+ * Template Loader
+ *
+ * Loads Mustache templates from the data directory with fallback to the
+ * top-level templates directory. This allows users to customize agent
+ * and skill templates by placing them in their data directory.
+ *
+ * Resolution order:
+ * 1. {dataDir}/templates/{name} (user customization)
+ * 2. {codebaseDir}/templates/{name} (fallback)
+ */
+import { readFile } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { existsSync } from "fs";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CODEBASE_TEMPLATES_DIR = join(__dirname, "..", "..", "templates");
+/**
+ * Load a template file with fallback to codebase templates
+ * @param {string} templateName - Template filename (e.g., 'agent.template.md')
+ * @param {string} dataDir - Path to data directory
+ * @returns {Promise<string>} Template content
+ * @throws {Error} If template not found in either location
+ */
+export async function loadTemplate(templateName, dataDir) {
+  // Build list of paths to try
+  const paths = [];
+  if (dataDir) {
+    paths.push(join(dataDir, "templates", templateName));
+  }
+  paths.push(join(CODEBASE_TEMPLATES_DIR, templateName));
+  // Try each path in order
+  for (const path of paths) {
+    if (existsSync(path)) {
+      return await readFile(path, "utf-8");
+    }
+  }
+  // Not found
+  throw new Error(
+    `Template '${templateName}' not found. Checked:\n` +
+      paths.map((p) => `  - ${p}`).join("\n"),
+  );
+}
+/**
+ * Load agent profile template
+ * @param {string} dataDir - Path to data directory
+ * @returns {Promise<string>} Agent template content
+ */
+export async function loadAgentTemplate(dataDir) {
+  return loadTemplate("agent.template.md", dataDir);
+}
+/**
+ * Load agent skill template
+ * @param {string} dataDir - Path to data directory
+ * @returns {Promise<string>} Skill template content
+ */
+export async function loadSkillTemplate(dataDir) {
+  return loadTemplate("skill.template.md", dataDir);
+}
+/**
+ * Load job description template
+ * @param {string} dataDir - Path to data directory
+ * @returns {Promise<string>} Job template content
+ */
+export async function loadJobTemplate(dataDir) {
+  return loadTemplate("job.template.md", dataDir);
+}

package/app/lib/yaml-loader.js CHANGED Viewed

@@ -103,6 +103,11 @@ async function loadDisciplinesFromDir(disciplinesDir) {
       const {
         specialization,
         roleTitle,
+        // Track constraints
+        isProfessional,
+        isManagement,
+        validTracks,
+        minGrade,
         // Shared content - now at root level
         description,
         // Structural properties (derivation inputs)
@@ -118,6 +123,11 @@ async function loadDisciplinesFromDir(disciplinesDir) {
         id,
         specialization,
         roleTitle,
+        // Track constraints
+        isProfessional,
+        isManagement,
+        validTracks,
+        minGrade,
         // Shared content at top level
         description,
         // Structural properties
@@ -152,12 +162,10 @@ async function loadTracksFromDir(tracksDir) {
         description,
         roleContext,
         // Structural properties (derivation inputs)
-        isProfessional,
-        isManagement,
         skillModifiers,
         behaviourModifiers,
         matchingWeights,
-        validDisciplines,
+        minGrade,
         // Agent section (no human section anymore for tracks)
         agent,
       } = content;
@@ -168,12 +176,10 @@ async function loadTracksFromDir(tracksDir) {
         description,
         roleContext,
         // Structural properties
-        isProfessional,
-        isManagement,
         skillModifiers,
         behaviourModifiers,
         matchingWeights,
-        validDisciplines,
+        minGrade,
         ...(agent && { agent }),
       };
     }),
@@ -301,14 +307,23 @@ 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
+ * @returns {Promise<Object>} Agent data including disciplines, tracks, behaviours, vscodeSettings, devcontainer, copilotSetupSteps
  */
 export async function loadAgentDataBrowser(dataDir = "./data") {
-  const [disciplines, tracks, behaviours, vscodeSettings] = await Promise.all([
+  const [
+    disciplines,
+    tracks,
+    behaviours,
+    vscodeSettings,
+    devcontainer,
+    copilotSetupSteps,
+  ] = await Promise.all([
     loadDisciplinesFromDir(`${dataDir}/disciplines`),
     loadTracksFromDir(`${dataDir}/tracks`),
     loadBehavioursFromDir(`${dataDir}/behaviours`),
     tryLoadYamlFile(`${dataDir}/vscode-settings.yaml`),
+    tryLoadYamlFile(`${dataDir}/devcontainer.yaml`),
+    tryLoadYamlFile(`${dataDir}/copilot-setup-steps.yaml`),
   ]);
   // Extract agent sections from co-located files
@@ -323,5 +338,7 @@ export async function loadAgentDataBrowser(dataDir = "./data") {
       .filter((b) => b.agent)
       .map((b) => ({ id: b.id, ...b.agent })),
     vscodeSettings: vscodeSettings || {},
+    devcontainer: devcontainer || {},
+    copilotSetupSteps: copilotSetupSteps || null,
   };
 }

package/app/main.js CHANGED Viewed

@@ -101,15 +101,18 @@ function setupRoutes() {
   // Job builder
   router.on("/job-builder", renderJobBuilder);
-  router.on("/job/:discipline/:track/:grade", renderJobDetail);
+  router.on("/job/:discipline/:grade/:track", renderJobDetail);
+  router.on("/job/:discipline/:grade", renderJobDetail);
   // Interview prep
   router.on("/interview-prep", renderInterviewPrep);
-  router.on("/interview/:discipline/:track/:grade", renderInterviewDetail);
+  router.on("/interview/:discipline/:grade/:track", renderInterviewDetail);
+  router.on("/interview/:discipline/:grade", renderInterviewDetail);
   // Career progress
   router.on("/career-progress", renderCareerProgress);
-  router.on("/progress/:discipline/:track/:grade", renderProgressDetail);
+  router.on("/progress/:discipline/:grade/:track", renderProgressDetail);
+  router.on("/progress/:discipline/:grade", renderProgressDetail);
   // Self-assessment
   router.on("/self-assessment", renderSelfAssessment);
@@ -117,8 +120,9 @@ function setupRoutes() {
   // Agent builder
   router.on("/agent-builder", renderAgentBuilder);
-  router.on("/agent/:discipline/:track", renderAgentBuilder);
   router.on("/agent/:discipline/:track/:stage", renderAgentBuilder);
+  router.on("/agent/:discipline/:track", renderAgentBuilder);
+  router.on("/agent/:discipline", renderAgentBuilder);
 }
 /**