@forwardimpact/pathway 0.6.0 → 0.8.0

package/src/formatters/agent/profile.js

@@ -12,6 +12,12 @@ import Mustache from "mustache";
 
 import { trimValue, trimRequired, trimFields } from "../shared.js";
 
+/**
+ * @typedef {Object} WorkingStyleEntry
+ * @property {string} title - Section title
+ * @property {string} content - Working style content (markdown)
+ */
+
 /**
  * Prepare agent profile data for template rendering
  * Normalizes string values by trimming trailing newlines for consistent template output.
@@ -27,30 +33,32 @@ import { trimValue, trimRequired, trimFields } from "../shared.js";
  * @param {string} params.bodyData.identity - Core identity text
  * @param {string} [params.bodyData.priority] - Priority/philosophy statement
  * @param {Array<{name: string, dirname: string, useWhen: string}>} params.bodyData.skillIndex - Skill index entries
- * @param {Array<{index: number, text: string}>} params.bodyData.beforeMakingChanges - Numbered steps
- * @param {string} [params.bodyData.delegation] - Delegation guidance
- * @param {string} params.bodyData.operationalContext - Operational context text
- * @param {string} params.bodyData.workingStyle - Working style markdown section
+ * @param {string} params.bodyData.roleContext - Role context text
+ * @param {WorkingStyleEntry[]} params.bodyData.workingStyles - Working style entries
  * @param {string} [params.bodyData.beforeHandoff] - Before handoff checklist markdown
  * @param {string[]} params.bodyData.constraints - List of constraints
+ * @param {Array<{id: string, name: string, description: string}>} [params.bodyData.agentIndex] - List of all available agents
+ * @param {boolean} [params.bodyData.hasAgentIndex] - Whether agent index is available
  * @returns {Object} Data object ready for Mustache template
  */
 function prepareAgentProfileData({ frontmatter, bodyData }) {
-  // Trim array fields using helpers
+  // Trim array fields using shared helpers
   const handoffs = trimFields(frontmatter.handoffs, { prompt: "required" });
-  const beforeMakingChanges = trimFields(bodyData.beforeMakingChanges, {
-    text: "required",
-  });
-
-  // Trim simple string arrays
   const constraints = (bodyData.constraints || []).map((c) => trimRequired(c));
-
-  // Trim skill index entries
-  const skillIndex = (bodyData.skillIndex || []).map((s) => ({
-    name: trimRequired(s.name),
-    dirname: trimRequired(s.dirname),
-    useWhen: trimRequired(s.useWhen),
-  }));
+  const skillIndex = trimFields(bodyData.skillIndex, {
+    name: "required",
+    dirname: "required",
+    useWhen: "required",
+  });
+  const agentIndex = trimFields(bodyData.agentIndex, {
+    id: "required",
+    name: "required",
+    description: "required",
+  });
+  const workingStyles = trimFields(bodyData.workingStyles, {
+    title: "required",
+    content: "required",
+  });
 
   return {
     // Frontmatter
@@ -66,12 +74,14 @@ function prepareAgentProfileData({ frontmatter, bodyData }) {
     priority: trimValue(bodyData.priority),
     skillIndex,
     hasSkills: skillIndex.length > 0,
-    beforeMakingChanges,
-    delegation: trimValue(bodyData.delegation),
-    operationalContext: trimValue(bodyData.operationalContext),
-    workingStyle: trimValue(bodyData.workingStyle),
+    roleContext: trimValue(bodyData.roleContext),
+    workingStyles,
+    hasWorkingStyles: workingStyles.length > 0,
     beforeHandoff: trimValue(bodyData.beforeHandoff),
     constraints,
+    hasConstraints: constraints.length > 0,
+    agentIndex,
+    hasAgentIndex: agentIndex.length > 0,
   };
 }
 
@@ -90,10 +100,8 @@ function prepareAgentProfileData({ frontmatter, bodyData }) {
  * @param {string} profile.bodyData.identity - Core identity text
  * @param {string} [profile.bodyData.priority] - Priority/philosophy statement (optional)
  * @param {Array<{name: string, dirname: string, useWhen: string}>} profile.bodyData.skillIndex - Skill index entries
- * @param {Array<{index: number, text: string}>} profile.bodyData.beforeMakingChanges - Numbered steps
- * @param {string} [profile.bodyData.delegation] - Delegation guidance (optional)
- * @param {string} profile.bodyData.operationalContext - Operational context text
- * @param {string} profile.bodyData.workingStyle - Working style markdown section
+ * @param {string} profile.bodyData.roleContext - Role context text
+ * @param {WorkingStyleEntry[]} profile.bodyData.workingStyles - Working style entries
  * @param {string} [profile.bodyData.beforeHandoff] - Before handoff checklist markdown (optional)
  * @param {string[]} profile.bodyData.constraints - List of constraints
  * @param {string} template - Mustache template string

package/src/formatters/agent/skill.js

@@ -40,14 +40,24 @@ function prepareAgentSkillData({
     ready: "array",
   });
 
+  const descriptionLines = splitLines(frontmatter.description);
+  const useWhenLines = splitLines(frontmatter.useWhen);
+  const trimmedReference = trimValue(reference) || "";
+  const tools = toolReferences || [];
+
   return {
     name: frontmatter.name,
-    descriptionLines: splitLines(frontmatter.description),
-    useWhenLines: splitLines(frontmatter.useWhen),
+    descriptionLines,
+    hasDescription: descriptionLines.length > 0,
+    useWhenLines,
+    hasUseWhen: useWhenLines.length > 0,
     title,
     stages: processedStages,
-    reference: trimValue(reference) || "",
-    toolReferences: toolReferences || [],
+    hasStages: processedStages.length > 0,
+    reference: trimmedReference,
+    hasReference: !!trimmedReference,
+    toolReferences: tools,
+    hasToolReferences: tools.length > 0,
   };
 }
 

package/src/formatters/behaviour/microdata.js

@@ -2,7 +2,7 @@
  * Behaviour formatting for microdata HTML output
  *
  * Generates clean, class-less HTML with microdata aligned with behaviour.schema.json
- * RDF vocab: https://schema.forwardimpact.team/rdf/
+ * RDF vocab: https://www.forwardimpact.team/schema/rdf/
  */
 
 import {

package/src/formatters/discipline/microdata.js

@@ -2,7 +2,7 @@
  * Discipline formatting for microdata HTML output
  *
  * Generates clean, class-less HTML with microdata aligned with discipline.schema.json
- * RDF vocab: https://schema.forwardimpact.team/rdf/
+ * RDF vocab: https://www.forwardimpact.team/schema/rdf/
  */
 
 import {

package/src/formatters/driver/microdata.js

@@ -2,7 +2,7 @@
  * Driver formatting for microdata HTML output
  *
  * Generates clean, class-less HTML with microdata aligned with drivers.schema.json
- * RDF vocab: https://schema.forwardimpact.team/rdf/
+ * RDF vocab: https://www.forwardimpact.team/schema/rdf/
  */
 
 import {

package/src/formatters/grade/microdata.js

@@ -2,7 +2,7 @@
  * Grade formatting for microdata HTML output
  *
  * Generates clean, class-less HTML with microdata aligned with grades.schema.json
- * RDF vocab: https://schema.forwardimpact.team/rdf/
+ * RDF vocab: https://www.forwardimpact.team/schema/rdf/
  */
 
 import {

package/src/formatters/job/description.js

@@ -129,25 +129,38 @@ function prepareJobDescriptionData({ job, discipline, grade, track }) {
       grade.typicalExperienceRange || "",
     ) || null;
 
+  const responsibilities = trimFields(job.derivedResponsibilities, {
+    responsibility: "required",
+  });
+  const behaviours = trimFields(sortedBehaviours, {
+    maturityDescription: "optional",
+  });
+  const trimmedTrackRoleContext = trimValue(track?.roleContext);
+  const trimmedExpectationsParagraph = trimValue(expectationsParagraph);
+  const trimmedQualificationSummary = trimValue(qualificationSummary);
+
   return {
     title: job.title,
     gradeId: grade.id,
     typicalExperienceRange: grade.typicalExperienceRange,
     trackName: track?.name || null,
+    hasTrack: !!track,
     roleSummary: trimValue(roleSummary),
-    trackRoleContext: trimValue(track?.roleContext),
-    expectationsParagraph: trimValue(expectationsParagraph),
-    responsibilities: trimFields(job.derivedResponsibilities, {
-      responsibility: "required",
-    }),
-    behaviours: trimFields(sortedBehaviours, {
-      maturityDescription: "optional",
-    }),
+    trackRoleContext: trimmedTrackRoleContext,
+    hasTrackRoleContext: !!trimmedTrackRoleContext,
+    expectationsParagraph: trimmedExpectationsParagraph,
+    hasExpectationsParagraph: !!trimmedExpectationsParagraph,
+    responsibilities,
+    hasResponsibilities: responsibilities.length > 0,
+    behaviours,
+    hasBehaviours: behaviours.length > 0,
     skillLevels: skillLevels.map((level) => ({
       ...level,
       skills: trimFields(level.skills, { levelDescription: "optional" }),
     })),
-    qualificationSummary: trimValue(qualificationSummary),
+    hasSkillLevels: skillLevels.length > 0,
+    qualificationSummary: trimmedQualificationSummary,
+    hasQualificationSummary: !!trimmedQualificationSummary,
   };
 }
 

package/src/formatters/job/dom.js

@@ -17,6 +17,7 @@ import { createBehaviourProfile } from "../../components/behaviour-profile.js";
 import { createCodeDisplay } from "../../components/code-display.js";
 import { markdownToHtml } from "../../lib/markdown.js";
 import { formatJobDescription } from "./description.js";
+import { createToolkitTable } from "../toolkit/dom.js";
 
 /**
  * Format job detail as DOM elements
@@ -77,14 +78,14 @@ export function jobToDOM(view, options = {}) {
     // Radar charts
     div(
       { className: "section auto-grid-lg" },
-      createSkillRadar(view.skillMatrix, {
-        title: "Skills Radar",
-        size: 420,
-      }),
       createBehaviourRadar(view.behaviourProfile, {
         title: "Behaviours Radar",
         size: 420,
       }),
+      createSkillRadar(view.skillMatrix, {
+        title: "Skills Radar",
+        size: 420,
+      }),
     ),
 
     // Job Description HTML (for print view)
@@ -104,21 +105,29 @@ export function jobToDOM(view, options = {}) {
         })
       : null,
 
-    // Skill matrix, Behaviour profile, Driver coverage tables
+    // Behaviour profile, Skill matrix, Toolkit, Driver coverage tables
     showTables
       ? div(
           { className: "job-tables-section" },
-          createDetailSection({
-            title: "Skill Matrix",
-            content: createSkillMatrix(view.skillMatrix),
-          }),
-
           // Behaviour profile table
           createDetailSection({
             title: "Behaviour Profile",
             content: createBehaviourProfile(view.behaviourProfile),
           }),
 
+          createDetailSection({
+            title: "Skill Matrix",
+            content: createSkillMatrix(view.skillMatrix),
+          }),
+
+          // Toolkit (after skill matrix)
+          view.toolkit && view.toolkit.length > 0
+            ? createDetailSection({
+                title: "Tool Kit",
+                content: createToolkitTable(view.toolkit),
+              })
+            : null,
+
           // Driver coverage
           view.driverCoverage.length > 0
             ? createDetailSection({

package/src/formatters/job/markdown.js

@@ -10,6 +10,7 @@ import {
 import { formatLevel } from "../../lib/render.js";
 import { formatJobDescription } from "./description.js";
 import { SKILL_LEVEL_ORDER } from "@forwardimpact/schema/levels";
+import { toolkitToMarkdown } from "../toolkit/markdown.js";
 
 /**
  * Format job detail as markdown
@@ -33,6 +34,15 @@ export function jobToMarkdown(view, entities = {}, jobTemplate) {
     lines.push("");
   }
 
+  // Behaviour Profile
+  lines.push("## Behaviour Profile", "");
+  const behaviourRows = view.behaviourProfile.map((b) => [
+    b.behaviourName,
+    formatLevel(b.maturity),
+  ]);
+  lines.push(tableToMarkdown(["Behaviour", "Maturity"], behaviourRows));
+  lines.push("");
+
   // Skill Matrix - sorted by level descending
   lines.push("## Skill Matrix", "");
   const sortedSkills = [...view.skillMatrix].sort((a, b) => {
@@ -50,14 +60,12 @@ export function jobToMarkdown(view, entities = {}, jobTemplate) {
   lines.push(tableToMarkdown(["Skill", "Level"], skillRows));
   lines.push("");
 
-  // Behaviour Profile
-  lines.push("## Behaviour Profile", "");
-  const behaviourRows = view.behaviourProfile.map((b) => [
-    b.behaviourName,
-    formatLevel(b.maturity),
-  ]);
-  lines.push(tableToMarkdown(["Behaviour", "Maturity"], behaviourRows));
-  lines.push("");
+  // Toolkit
+  if (view.toolkit && view.toolkit.length > 0) {
+    lines.push("## Tool Kit", "");
+    lines.push(toolkitToMarkdown(view.toolkit));
+    lines.push("");
+  }
 
   // Driver Coverage
   if (view.driverCoverage.length > 0) {

package/src/formatters/json-ld.js

@@ -2,10 +2,10 @@
  * JSON-LD structured data generation
  *
  * Generates JSON-LD for entity pages to enable machine-readable data.
- * Aligns with the RDF schema at https://schema.forwardimpact.team/rdf/
+ * Aligns with the RDF schema at https://www.forwardimpact.team/schema/rdf/
  */
 
-const VOCAB_BASE = "https://schema.forwardimpact.team/rdf/";
+const VOCAB_BASE = "https://www.forwardimpact.team/schema/rdf/";
 
 /**
  * Create a JSON-LD script element

package/src/formatters/microdata-shared.js

@@ -2,10 +2,10 @@
  * Shared microdata HTML utilities
  *
  * Helper functions for generating clean, class-less HTML with microdata attributes
- * aligned with the RDF schema at https://schema.forwardimpact.team/rdf/
+ * aligned with the RDF schema at https://www.forwardimpact.team/schema/rdf/
  */
 
-const VOCAB_BASE = "https://schema.forwardimpact.team/rdf/";
+const VOCAB_BASE = "https://www.forwardimpact.team/schema/rdf/";
 
 /**
  * Create an opening tag with microdata attributes

package/src/formatters/skill/microdata.js

@@ -2,7 +2,7 @@
  * Skill formatting for microdata HTML output
  *
  * Generates clean, class-less HTML with microdata aligned with capability.schema.json
- * RDF vocab: https://schema.forwardimpact.team/rdf/
+ * RDF vocab: https://www.forwardimpact.team/schema/rdf/
  */
 
 import {

package/src/formatters/stage/microdata.js

@@ -2,7 +2,7 @@
  * Stage formatting for microdata HTML output
  *
  * Generates clean, class-less HTML with microdata aligned with stages.schema.json
- * RDF vocab: https://schema.forwardimpact.team/rdf/
+ * RDF vocab: https://www.forwardimpact.team/schema/rdf/
  */
 
 import {

package/src/formatters/toolkit/dom.js

@@ -0,0 +1,75 @@
+/**
+ * Toolkit formatting for DOM/web output
+ *
+ * Displays a compact toolkit table showing tools with icons and descriptions.
+ */
+
+import {
+  div,
+  table,
+  thead,
+  tbody,
+  tr,
+  th,
+  td,
+  a,
+  span,
+} from "../../lib/render.js";
+import { createToolIcon } from "../../lib/card-mappers.js";
+
+/**
+ * Create a toolkit table for display in job/agent detail pages
+ * @param {Array<{name: string, description: string, url?: string, simpleIcon?: string, skillIds: string[]}>} toolkit - Derived toolkit entries
+ * @returns {HTMLElement}
+ */
+export function createToolkitTable(toolkit) {
+  if (!toolkit || toolkit.length === 0) {
+    return div({ className: "empty-state" }, "No tools in toolkit");
+  }
+
+  const rows = toolkit.map((tool) => {
+    const iconCell = tool.simpleIcon
+      ? td(
+          { className: "tool-icon-cell" },
+          createToolIcon(tool.simpleIcon, tool.name),
+        )
+      : td({ className: "tool-icon-cell" });
+
+    const nameContent = tool.url
+      ? a(
+          {
+            href: tool.url,
+            target: "_blank",
+            rel: "noopener noreferrer",
+            className: "tool-link",
+          },
+          tool.name,
+          span({ className: "external-icon" }, " ↗"),
+        )
+      : span({}, tool.name);
+
+    return tr(
+      {},
+      iconCell,
+      td({ className: "tool-name-cell" }, nameContent),
+      td({ className: "tool-description-cell" }, tool.description),
+    );
+  });
+
+  return div(
+    { className: "table-container" },
+    table(
+      { className: "table toolkit-table" },
+      thead(
+        {},
+        tr(
+          {},
+          th({ style: "width: 40px" }, ""),
+          th({}, "Tool"),
+          th({}, "Description"),
+        ),
+      ),
+      tbody({}, ...rows),
+    ),
+  );
+}

package/src/formatters/toolkit/markdown.js

@@ -0,0 +1,38 @@
+/**
+ * Toolkit formatting for markdown/CLI output
+ *
+ * Displays toolkit as a markdown table with tools, icons, and descriptions.
+ */
+
+import { tableToMarkdown } from "../shared.js";
+
+/**
+ * Format toolkit as markdown table
+ * @param {Array<{name: string, description: string, url?: string, simpleIcon?: string, skillIds: string[]}>} toolkit - Derived toolkit entries
+ * @returns {string}
+ */
+export function toolkitToMarkdown(toolkit) {
+  if (!toolkit || toolkit.length === 0) {
+    return "";
+  }
+
+  const rows = toolkit.map((tool) => {
+    const name = tool.url ? `[${tool.name}](${tool.url})` : tool.name;
+    return [name, tool.description];
+  });
+
+  return tableToMarkdown(["Tool", "Description"], rows);
+}
+
+/**
+ * Format toolkit as a plain list of tool names (for --tools flag)
+ * @param {Array<{name: string}>} toolkit - Derived toolkit entries
+ * @returns {string}
+ */
+export function toolkitToPlainList(toolkit) {
+  if (!toolkit || toolkit.length === 0) {
+    return "";
+  }
+
+  return toolkit.map((tool) => tool.name).join("\n");
+}

package/src/formatters/track/microdata.js

@@ -2,7 +2,7 @@
  * Track formatting for microdata HTML output
  *
  * Generates clean, class-less HTML with microdata aligned with track.schema.json
- * RDF vocab: https://schema.forwardimpact.team/rdf/
+ * RDF vocab: https://www.forwardimpact.team/schema/rdf/
  */
 
 import {

package/src/pages/agent-builder.js

@@ -27,7 +27,9 @@ import {
   generateSkillMd,
   deriveAgentSkills,
   deriveReferenceGrade,
-} from "@forwardimpact/model/agent";
+  deriveToolkit,
+  buildAgentIndex,
+} from "@forwardimpact/model";
 import {
   createSelectWithValue,
   createDisciplineSelect,
@@ -37,6 +39,8 @@ import { getStageEmoji } from "../formatters/stage/shared.js";
 import { formatAgentProfile } from "../formatters/agent/profile.js";
 import { formatAgentSkill } from "../formatters/agent/skill.js";
 import { createCodeDisplay } from "../components/code-display.js";
+import { createToolkitTable } from "../formatters/toolkit/dom.js";
+import { createDetailSection } from "../components/detail.js";
 
 /** All stages option value */
 const ALL_STAGES_VALUE = "all";
@@ -247,6 +251,15 @@ export async function renderAgentBuilder() {
     // Get reference grade for derivation
     const grade = deriveReferenceGrade(data.grades);
 
+    // Build agent index for all valid combinations
+    const agentIndex = buildAgentIndex({
+      disciplines: data.disciplines,
+      tracks: data.tracks,
+      stages,
+      agentDisciplines: agentData.disciplines,
+      agentTracks: agentData.tracks,
+    });
+
     // Build context for generation
     const context = {
       humanDiscipline,
@@ -262,6 +275,7 @@ export async function renderAgentBuilder() {
       vscodeSettings: agentData.vscodeSettings,
       devcontainer: agentData.devcontainer,
       templates,
+      agentIndex,
     };
 
     // Generate preview based on stage selection
@@ -439,6 +453,7 @@ function createAllStagesPreview(context) {
     vscodeSettings,
     devcontainer,
     templates,
+    agentIndex,
   } = context;
 
   // Generate all stage agents
@@ -469,6 +484,7 @@ function createAllStagesPreview(context) {
       agentTrack,
       capabilities,
       stages,
+      agentIndex,
     });
 
     return { stage, derived, profile };
@@ -488,6 +504,12 @@ function createAllStagesPreview(context) {
     .filter((skill) => skill?.agent)
     .map((skill) => generateSkillMd(skill, stages));
 
+  // Derive toolkit from agent skills
+  const toolkit = deriveToolkit({
+    skillMatrix: derivedSkills,
+    skills,
+  });
+
   return div(
     { className: "agent-deployment" },
 
@@ -533,6 +555,14 @@ function createAllStagesPreview(context) {
           ),
     ),
 
+    // Tool Kit section
+    toolkit.length > 0
+      ? createDetailSection({
+          title: `Tool Kit (${toolkit.length})`,
+          content: createToolkitTable(toolkit),
+        })
+      : null,
+
     // CLI hint
     createCliHint(humanDiscipline.id, humanTrack.id),
   );
@@ -559,6 +589,7 @@ function createSingleStagePreview(context, stage) {
     devcontainer,
     stages,
     templates,
+    agentIndex,
   } = context;
 
   // Derive stage agent
@@ -588,6 +619,7 @@ function createSingleStagePreview(context, stage) {
     agentTrack,
     capabilities,
     stages,
+    agentIndex,
   });
 
   // Get skills for this stage (using full derived skills)
@@ -603,6 +635,12 @@ function createSingleStagePreview(context, stage) {
     .filter((skill) => skill?.agent)
     .map((skill) => generateSkillMd(skill, stages));
 
+  // Derive toolkit from agent skills
+  const toolkit = deriveToolkit({
+    skillMatrix: derivedSkills,
+    skills,
+  });
+
   return div(
     { className: "agent-deployment" },
 
@@ -642,6 +680,14 @@ function createSingleStagePreview(context, stage) {
           ),
     ),
 
+    // Tool Kit section
+    toolkit.length > 0
+      ? createDetailSection({
+          title: `Tool Kit (${toolkit.length})`,
+          content: createToolkitTable(toolkit),
+        })
+      : null,
+
     // CLI hint
     createCliHint(humanDiscipline.id, humanTrack.id, stage.id),
   );