@forwardimpact/pathway 0.5.0 → 0.6.0

package/{app → src}/formatters/interview/markdown.js

@@ -3,7 +3,7 @@
  */
 
 import { formatLevel } from "../../lib/render.js";
-import { getConceptEmoji } from "../../model/levels.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Format interview detail as markdown

package/{app → src}/formatters/interview/shared.js

@@ -8,13 +8,13 @@ import {
   isValidJobCombination,
   generateJobTitle,
   getDisciplineSkillIds,
-} from "../../model/derivation.js";
+} from "@forwardimpact/model/derivation";
 import {
   deriveInterviewQuestions,
   deriveShortInterview,
   deriveBehaviourQuestions,
-} from "../../model/interview.js";
-import { getOrCreateJob } from "../../lib/job-cache.js";
+} from "@forwardimpact/model/interview";
+import { getOrCreateJob } from "@forwardimpact/model/job-cache";
 
 /**
  * Interview type configurations

package/{app → src}/formatters/job/description.js

@@ -13,7 +13,7 @@ import Mustache from "mustache";
 import {
   SKILL_LEVEL_ORDER,
   BEHAVIOUR_MATURITY_ORDER,
-} from "../../model/levels.js";
+} from "@forwardimpact/schema/levels";
 import { trimValue, trimFields } from "../shared.js";
 
 /**

package/{app → src}/formatters/job/markdown.js

@@ -9,7 +9,7 @@ import {
 } from "../shared.js";
 import { formatLevel } from "../../lib/render.js";
 import { formatJobDescription } from "./description.js";
-import { SKILL_LEVEL_ORDER } from "../../model/levels.js";
+import { SKILL_LEVEL_ORDER } from "@forwardimpact/schema/levels";
 
 /**
  * Format job detail as markdown

package/{app → src}/formatters/progress/shared.js

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

package/{app → src}/formatters/skill/dom.js

@@ -20,7 +20,7 @@ import { createBackLink } from "../../components/nav.js";
 import { createLevelCell } from "../../components/detail.js";
 import { createCodeDisplay } from "../../components/code-display.js";
 import { createToolIcon } from "../../lib/card-mappers.js";
-import { SKILL_LEVEL_ORDER } from "../../model/levels.js";
+import { SKILL_LEVEL_ORDER } from "@forwardimpact/schema/levels";
 import { prepareSkillDetail } from "./shared.js";
 import { createJsonLdScript, skillToJsonLd } from "../json-ld.js";
 

package/{app → src}/formatters/skill/markdown.js

@@ -4,7 +4,7 @@
 
 import { tableToMarkdown, capitalize } from "../shared.js";
 import { prepareSkillsList, prepareSkillDetail } from "./shared.js";
-import { getConceptEmoji } from "../../model/levels.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Format skill list as markdown

package/{app → src}/formatters/skill/shared.js

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

package/{app → src}/formatters/track/dom.js

@@ -15,7 +15,7 @@ import {
   createBehaviourModifierTable,
   createSkillModifierTableWithCapabilities,
 } from "../../components/modifier-table.js";
-import { getConceptEmoji } from "../../model/levels.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 import { prepareTrackDetail } from "./shared.js";
 import { createJsonLdScript, trackToJsonLd } from "../json-ld.js";
 

package/{app → src}/formatters/track/markdown.js

@@ -4,7 +4,7 @@
 
 import { tableToMarkdown } from "../shared.js";
 import { prepareTracksList, prepareTrackDetail } from "./shared.js";
-import { getConceptEmoji } from "../../model/levels.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Format track list as markdown

package/{app → src}/formatters/track/shared.js

@@ -4,7 +4,10 @@
  * Shared utilities for formatting track data across DOM and markdown outputs.
  */
 
-import { isCapability, getSkillsByCapability } from "../../model/modifiers.js";
+import {
+  isCapability,
+  getSkillsByCapability,
+} from "@forwardimpact/model/modifiers";
 import { truncate } from "../shared.js";
 
 /**

package/{app → src}/handout-main.js

@@ -25,7 +25,10 @@ import {
 } from "./lib/render.js";
 
 // Import model functions
-import { getCapabilityOrder, getConceptEmoji } from "./model/levels.js";
+import {
+  getCapabilityOrder,
+  getConceptEmoji,
+} from "@forwardimpact/schema/levels";
 
 // Import formatters
 import {

package/src/handout.html

@@ -0,0 +1,43 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Engineering Pathway - Handout View</title>
+    <link rel="stylesheet" href="css/bundles/handout.css" />
+    <script type="importmap">
+      {
+        "imports": {
+          "mustache": "https://esm.sh/mustache@4.2.0",
+          "@forwardimpact/schema": "/schema/lib/index.js",
+          "@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"
+        }
+      }
+    </script>
+  </head>
+  <body class="slide-view handout-view">
+    <header
+      id="page-brand-header"
+      class="page-brand-header"
+      style="display: none"
+    ></header>
+    <div id="slide-loading" class="slide-loading">
+      <p>Loading...</p>
+    </div>
+    <main id="handout-content"></main>
+    <script type="module" src="handout-main.js"></script>
+  </body>
+</html>

package/{app → src}/index.html

@@ -20,7 +20,22 @@
     <script type="importmap">
       {
         "imports": {
-          "mustache": "https://esm.sh/mustache@4.2.0"
+          "mustache": "https://esm.sh/mustache@4.2.0",
+          "@forwardimpact/schema": "/schema/lib/index.js",
+          "@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"
         }
       }
     </script>

package/{app → src}/lib/card-mappers.js

@@ -7,7 +7,7 @@
 
 import { createBadge } from "../components/card.js";
 import { formatLevel } from "./render.js";
-import { getCapabilityEmoji } from "../model/levels.js";
+import { getCapabilityEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Create an external link element styled as a badge

package/{app → src}/lib/job-cache.js

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

package/{app → src}/lib/render.js

@@ -5,7 +5,7 @@
 import {
   SKILL_LEVEL_ORDER,
   BEHAVIOUR_MATURITY_ORDER,
-} from "../model/levels.js";
+} from "@forwardimpact/schema/levels";
 
 /**
  * Get the main content container

package/{app → src}/pages/agent-builder.js

@@ -27,7 +27,7 @@ import {
   generateSkillMd,
   deriveAgentSkills,
   deriveReferenceGrade,
-} from "../model/agent.js";
+} from "@forwardimpact/model/agent";
 import {
   createSelectWithValue,
   createDisciplineSelect,

package/{app → 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 "../model/matching.js";
+import { findRealisticMatches } from "@forwardimpact/model/matching";
 
 /**
  * Render the assessment results page

package/{app → src}/pages/interview.js

@@ -21,7 +21,7 @@ import { createBadge } from "../components/card.js";
 import { createBackLink } from "../components/nav.js";
 import { createDetailSection } from "../components/detail.js";
 import { renderError } from "../components/error-page.js";
-import { getConceptEmoji } from "../model/levels.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 import {
   prepareAllInterviews,
   INTERVIEW_TYPES,

package/{app → 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 "../model/job.js";
+import { prepareJobBuilderPreview } from "@forwardimpact/model/job";
 
 /**
  * Render job builder page

package/{app → 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 "../model/job.js";
+import { prepareJobDetail } from "@forwardimpact/model/job";
 import { jobToDOM } from "../formatters/job/dom.js";
 
 /** @type {string|null} Cached job template */

package/{app → src}/pages/landing.js

@@ -5,7 +5,10 @@
 import { render, div, h1, h2, p, a, span } from "../lib/render.js";
 import { getState } from "../lib/state.js";
 import { createStatCard } from "../components/card.js";
-import { groupSkillsByCapability, getConceptEmoji } from "../model/levels.js";
+import {
+  groupSkillsByCapability,
+  getConceptEmoji,
+} from "@forwardimpact/schema/levels";
 import { getStageEmoji } from "../formatters/stage/shared.js";
 import { aggregateTools } from "../formatters/tool/shared.js";
 

package/{app → src}/pages/self-assessment.js

@@ -25,7 +25,7 @@ import {
   CAPABILITY_ORDER,
   getCapabilityEmoji,
   getConceptEmoji,
-} from "../model/levels.js";
+} from "@forwardimpact/schema/levels";
 import { formatLevel } from "../lib/render.js";
 
 /**

package/{app → src}/pages/skill.js

@@ -10,7 +10,7 @@ import { renderNotFound } from "../components/error-page.js";
 import { prepareSkillsList } from "../formatters/skill/shared.js";
 import { skillToDOM } from "../formatters/skill/dom.js";
 import { skillToCardConfig } from "../lib/card-mappers.js";
-import { getCapabilityEmoji } from "../model/levels.js";
+import { getCapabilityEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Render skills list page

package/{app → src}/pages/stage.js

@@ -7,7 +7,7 @@ import { getState } from "../lib/state.js";
 import { createCardList } from "../components/list.js";
 import { renderNotFound } from "../components/error-page.js";
 import { prepareStagesList, stageToDOM } from "../formatters/stage/index.js";
-import { getConceptEmoji } from "../model/levels.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Map stage to card configuration

package/{app → src}/pages/tool.js

@@ -10,7 +10,7 @@ import { prepareToolsList } from "../formatters/tool/shared.js";
 import { createBadge } from "../components/card.js";
 import { createCardList } from "../components/list.js";
 import { toolToCardConfig } from "../lib/card-mappers.js";
-import { getConceptEmoji } from "../model/levels.js";
+import { getConceptEmoji } from "@forwardimpact/schema/levels";
 
 /**
  * Render tools list page

package/{app → 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 "./model/derivation.js";
+import { generateAllJobs } from "@forwardimpact/model/derivation";
 import { sortTracksByName } from "./formatters/track/shared.js";
 
 // Import slide renderers

package/{app → src}/slides/index.js

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

package/{app → src}/slides/job.js

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

package/{app → 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 "../model/derivation.js";
+import { generateAllJobs } from "@forwardimpact/model/derivation";
 
 /**
  * Format discipline group name for display

package/{app → src}/slides.html

@@ -8,7 +8,22 @@
     <script type="importmap">
       {
         "imports": {
-          "mustache": "https://esm.sh/mustache@4.2.0"
+          "mustache": "https://esm.sh/mustache@4.2.0",
+          "@forwardimpact/schema": "/schema/lib/index.js",
+          "@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"
         }
       }
     </script>

package/templates/agent.template.md

@@ -29,43 +29,44 @@ handoffs:
 
 {{{identity}}}
 
-{{#priority}}
-{{{priority}}}
+{{#priority}} {{{priority}}}
 
-{{/priority}}
-{{#hasSkills}}
-## Available Skills
+{{/priority}} {{#hasSkills}}
 
-IMPORTANT: Before starting work, read the relevant skill file for project-specific
-guidance. Do not rely solely on pre-training knowledge.
+## Available Skills and Tools
+
+**IMPORTANT:** Before starting work, read the relevant skill file for
+project-specific guidance, tools and technology recommendations. Do not rely
+solely on pre-training knowledge.
+
+Skills represent validated organizational patterns. When a skill recommends
+specific tools in its "Recommended Tools" section, use them unless a blocking
+constraint exists. If you choose a different tool, document in your output: (1)
+which skill recommendation you're overriding, (2) the constraint preventing use,
+and (3) trade-offs of the alternative.
 
 | Skill | Location | Use When |
-|-------|----------|----------|
-{{#skillIndex}}
-| {{{name}}} | `.claude/skills/{{dirname}}/SKILL.md` | {{{useWhen}}} |
-{{/skillIndex}}
-
-{{/hasSkills}}
-{{#beforeMakingChanges.length}}
-Before making changes:
-
-{{#beforeMakingChanges}}
-{{index}}. {{{text}}}
-{{/beforeMakingChanges}}
+| ----- | -------- | -------- |
+
+{{#skillIndex}} | {{{name}}} | `.claude/skills/{{dirname}}/SKILL.md` |
+{{{useWhen}}} | {{/skillIndex}}
+
+{{/hasSkills}} {{#beforeMakingChanges.length}} Before making changes:
+
+{{#beforeMakingChanges}} {{index}}. {{{text}}} {{/beforeMakingChanges}}
 {{/beforeMakingChanges.length}}
 
 {{#delegation}}
+
 ## Delegation
 
-{{{delegation}}}
-{{/delegation}}
+{{{delegation}}} {{/delegation}}
 
 ## Operational Context
 
 {{{operationalContext}}}
 
-{{{workingStyle}}}
-{{#beforeHandoff}}
+{{{workingStyle}}} {{#beforeHandoff}}
 
 ## Before Handoff
 
@@ -87,9 +88,9 @@ When completing work (for handoff or as a subagent), provide:
 3. **Recommendation**: Ready for next stage, or needs more work
 
 {{#constraints.length}}
+
 ## Constraints
 
 {{#constraints}}
-- {{{.}}}
-{{/constraints}}
-{{/constraints.length}}
+
+- {{{.}}} {{/constraints}} {{/constraints.length}}

package/templates/job.template.md

@@ -1,47 +1,41 @@
 # {{{title}}}
 
 - **Level:** {{{gradeId}}}
-- **Experience:** {{{typicalExperienceRange}}}
-{{#trackName}}- **Track:** {{{trackName}}}
-{{/trackName}}
+- **Experience:** {{{typicalExperienceRange}}} {{#trackName}}- **Track:**
+  {{{trackName}}} {{/trackName}}
 
 ## ROLE SUMMARY
 
 {{{roleSummary}}}
 
-{{#trackRoleContext}}
-{{{trackRoleContext}}}
+{{#trackRoleContext}} {{{trackRoleContext}}}
 
-{{/trackRoleContext}}
-{{#expectationsParagraph}}
-{{{expectationsParagraph}}}
+{{/trackRoleContext}} {{#expectationsParagraph}} {{{expectationsParagraph}}}
 
 {{/expectationsParagraph}}
 
 ## ROLE RESPONSIBILITIES
 
 {{#responsibilities}}
-- **{{{capabilityName}}}:** {{{responsibility}}}
-{{/responsibilities}}
+
+- **{{{capabilityName}}}:** {{{responsibility}}} {{/responsibilities}}
 
 ## ROLE BEHAVIOURS
 
 {{#behaviours}}
-- **{{{behaviourName}}}:** {{{maturityDescription}}}
-{{/behaviours}}
+
+- **{{{behaviourName}}}:** {{{maturityDescription}}} {{/behaviours}}
 
 {{#skillLevels}}
 
 ## {{{levelHeading}}}
 
 {{#skills}}
-- **{{{skillName}}}:** {{{levelDescription}}}
-{{/skills}}
+
+- **{{{skillName}}}:** {{{levelDescription}}} {{/skills}}
 
 {{/skillLevels}}
 
 ## QUALIFICATIONS
 
-{{#qualificationSummary}}
-{{{qualificationSummary}}}
-{{/qualificationSummary}}
+{{#qualificationSummary}} {{{qualificationSummary}}} {{/qualificationSummary}}

package/templates/skill.template.md

@@ -11,40 +11,34 @@ description: |
 
 # {{{title}}}
 
-{{#useWhenLines.length}}
-**Use This Skill When:** {{#useWhenLines}}{{{.}}}{{/useWhenLines}}
-{{/useWhenLines.length}}
+{{#useWhenLines.length}} **Use This Skill When:**
+{{#useWhenLines}}{{{.}}}{{/useWhenLines}} {{/useWhenLines.length}}
 
 ## Stage Guidance
+
 {{#stages}}
 
 ### {{stageName}} Stage
 
 **Focus:** {{{focus}}}
 
-**Activities:**
-{{#activities}}
-- {{{.}}}
-{{/activities}}
+**Activities:** {{#activities}}
 
-**Ready for {{nextStageName}} when:**
-{{#ready}}
-- [ ] {{{.}}}
-{{/ready}}
-{{/stages}}
-{{#toolReferences.length}}
+- {{{.}}} {{/activities}}
+
+**Ready for {{nextStageName}} when:** {{#ready}}
+
+- [ ] {{{.}}} {{/ready}} {{/stages}} {{#toolReferences.length}}
 
 ## Recommended Tools
 
 | Tool | Use When |
-|------|----------|
-{{#toolReferences}}
-| {{#url}}[{{{name}}}]({{{url}}}){{/url}}{{^url}}{{{name}}}{{/url}} | {{{useWhen}}} |
-{{/toolReferences}}
-{{/toolReferences.length}}
-{{#reference}}
+| ---- | -------- |
+
+{{#toolReferences}} |
+{{#url}}[{{{name}}}]({{{url}}}){{/url}}{{^url}}{{{name}}}{{/url}} |
+{{{useWhen}}} | {{/toolReferences}} {{/toolReferences.length}} {{#reference}}
 
 ## Reference
 
-{{{reference}}}
-{{/reference}}
+{{{reference}}} {{/reference}}