@forwardimpact/pathway 0.1.0

package/app/formatters/agent/skill.js

@@ -0,0 +1,58 @@
+/**
+ * Agent Skill Formatter
+ *
+ * Formats agent skill data into SKILL.md file content
+ * following the Agent Skills Standard specification.
+ */
+
+/**
+ * Format agent skill as SKILL.md file content
+ * @param {Object} skill - Skill with frontmatter and body
+ * @param {Object} skill.frontmatter - YAML frontmatter data
+ * @param {string} skill.frontmatter.name - Skill name (required)
+ * @param {string} skill.frontmatter.description - Skill description (required)
+ * @param {string} skill.body - Markdown body content
+ * @returns {string} Complete SKILL.md file content
+ */
+export function formatAgentSkill({ frontmatter, body }) {
+  const lines = ["---"];
+
+  // Name (required)
+  lines.push(`name: ${frontmatter.name}`);
+
+  // Description (required) - handle multiline
+  const description = frontmatter.description.trim();
+  if (description.includes("\n")) {
+    lines.push("description: |");
+    for (const line of description.split("\n")) {
+      lines.push(`  ${line}`);
+    }
+  } else {
+    lines.push(`description: ${description}`);
+  }
+
+  lines.push("---");
+  lines.push("");
+  lines.push(body);
+
+  return lines.join("\n");
+}
+
+/**
+ * Format agent skill for CLI output (markdown)
+ * @param {Object} skill - Skill with frontmatter and body
+ * @returns {string} Markdown formatted for CLI display
+ */
+export function formatAgentSkillForCli({ frontmatter, body }) {
+  const lines = [];
+
+  lines.push(`# Skill: ${frontmatter.name}`);
+  lines.push("");
+  lines.push(`**Description:** ${frontmatter.description.trim()}`);
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push(body);
+
+  return lines.join("\n");
+}

package/app/formatters/behaviour/dom.js

@@ -0,0 +1,91 @@
+/**
+ * Behaviour formatting for DOM output
+ */
+
+import {
+  div,
+  heading1,
+  heading2,
+  p,
+  table,
+  tbody,
+  thead,
+  tr,
+  th,
+  td,
+  ul,
+  li,
+} from "../../lib/render.js";
+import { createBackLink } from "../../components/nav.js";
+import { createLevelCell } from "../../components/detail.js";
+import {
+  BEHAVIOUR_MATURITY_ORDER,
+  getConceptEmoji,
+} from "../../model/levels.js";
+import { prepareBehaviourDetail } from "./shared.js";
+
+/**
+ * Format behaviour detail as DOM elements
+ * @param {Object} behaviour - Raw behaviour entity
+ * @param {Object} context - Additional context and options
+ * @param {Array} context.drivers - All drivers
+ * @param {Object} [context.framework] - Framework data for emoji lookup
+ * @param {boolean} [context.showBackLink=true] - Whether to show back navigation link
+ * @returns {HTMLElement}
+ */
+export function behaviourToDOM(
+  behaviour,
+  { drivers, framework, showBackLink = true } = {},
+) {
+  const view = prepareBehaviourDetail(behaviour, { drivers });
+  const emoji = getConceptEmoji(framework, "behaviour");
+  return div(
+    { className: "detail-page behaviour-detail" },
+    // Header
+    div(
+      { className: "page-header" },
+      showBackLink
+        ? createBackLink("/behaviour", "← Back to Behaviours")
+        : null,
+      heading1({ className: "page-title" }, `${emoji} `, view.name),
+      p({ className: "page-description" }, view.description),
+    ),
+
+    // Maturity descriptions
+    div(
+      { className: "detail-section" },
+      heading2({ className: "section-title" }, "Maturity Levels"),
+      table(
+        { className: "level-table" },
+        thead({}, tr({}, th({}, "Level"), th({}, "Description"))),
+        tbody(
+          {},
+          ...BEHAVIOUR_MATURITY_ORDER.map((maturity, index) => {
+            const description = view.maturityDescriptions[maturity] || "—";
+            return tr(
+              {},
+              createLevelCell(
+                index + 1,
+                BEHAVIOUR_MATURITY_ORDER.length,
+                maturity,
+              ),
+              td({}, description),
+            );
+          }),
+        ),
+      ),
+    ),
+
+    // Related drivers
+    view.relatedDrivers.length > 0
+      ? div(
+          { className: "detail-section" },
+          heading2({ className: "section-title" }, "Linked to Drivers"),
+          ul(
+            { className: "related-list" },
+            ...view.relatedDrivers.map((d) => li({}, d.name)),
+          ),
+        )
+      : null,
+  );
+}

package/app/formatters/behaviour/markdown.js

@@ -0,0 +1,54 @@
+/**
+ * Behaviour formatting for markdown/CLI output
+ */
+
+import { tableToMarkdown, capitalize } from "../shared.js";
+import { prepareBehavioursList, prepareBehaviourDetail } from "./shared.js";
+
+/**
+ * Format behaviour list as markdown
+ * @param {Array} behaviours - Raw behaviour entities
+ * @returns {string}
+ */
+export function behaviourListToMarkdown(behaviours) {
+  const { items } = prepareBehavioursList(behaviours);
+  const lines = ["# 🧠 Behaviours", ""];
+
+  for (const behaviour of items) {
+    lines.push(`- **${behaviour.name}**: ${behaviour.truncatedDescription}`);
+  }
+  lines.push("");
+
+  return lines.join("\n");
+}
+
+/**
+ * Format behaviour detail as markdown
+ * @param {Object} behaviour - Raw behaviour entity
+ * @param {Object} context - Additional context
+ * @param {Array} context.drivers - All drivers
+ * @returns {string}
+ */
+export function behaviourToMarkdown(behaviour, { drivers }) {
+  const view = prepareBehaviourDetail(behaviour, { drivers });
+  const lines = [`# 🧠 ${view.name}`, "", view.description, ""];
+
+  // Maturity descriptions table
+  lines.push("## Maturity Levels", "");
+  const maturityRows = Object.entries(view.maturityDescriptions).map(
+    ([maturity, desc]) => [capitalize(maturity.replace(/_/g, " ")), desc],
+  );
+  lines.push(tableToMarkdown(["Maturity", "Description"], maturityRows));
+  lines.push("");
+
+  // Related drivers
+  if (view.relatedDrivers.length > 0) {
+    lines.push("## Linked to Drivers", "");
+    for (const d of view.relatedDrivers) {
+      lines.push(`- ${d.name}`);
+    }
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}

package/app/formatters/behaviour/shared.js

@@ -0,0 +1,64 @@
+/**
+ * Behaviour presentation helpers
+ *
+ * Shared utilities for formatting behaviour data across DOM and markdown outputs.
+ */
+
+import { truncate } from "../shared.js";
+
+/**
+ * @typedef {Object} BehaviourListItem
+ * @property {string} id
+ * @property {string} name
+ * @property {string} description
+ * @property {string} truncatedDescription
+ */
+
+/**
+ * Transform behaviours for list view
+ * @param {Array} behaviours - Raw behaviour entities
+ * @param {number} [descriptionLimit=150] - Maximum description length
+ * @returns {{ items: BehaviourListItem[] }}
+ */
+export function prepareBehavioursList(behaviours, descriptionLimit = 150) {
+  const items = behaviours.map((behaviour) => ({
+    id: behaviour.id,
+    name: behaviour.name,
+    description: behaviour.description,
+    truncatedDescription: truncate(behaviour.description, descriptionLimit),
+  }));
+
+  return { items };
+}
+
+/**
+ * @typedef {Object} BehaviourDetailView
+ * @property {string} id
+ * @property {string} name
+ * @property {string} description
+ * @property {Object<string, string>} maturityDescriptions
+ * @property {Array<{id: string, name: string}>} relatedDrivers
+ */
+
+/**
+ * Transform behaviour for detail view
+ * @param {Object} behaviour - Raw behaviour entity
+ * @param {Object} context - Additional context
+ * @param {Array} context.drivers - All drivers
+ * @returns {BehaviourDetailView|null}
+ */
+export function prepareBehaviourDetail(behaviour, { drivers }) {
+  if (!behaviour) return null;
+
+  const relatedDrivers = drivers
+    .filter((d) => d.contributingBehaviours?.includes(behaviour.id))
+    .map((d) => ({ id: d.id, name: d.name }));
+
+  return {
+    id: behaviour.id,
+    name: behaviour.name,
+    description: behaviour.description,
+    maturityDescriptions: behaviour.maturityDescriptions,
+    relatedDrivers,
+  };
+}

package/app/formatters/discipline/dom.js

@@ -0,0 +1,187 @@
+/**
+ * Discipline formatting for DOM output
+ */
+
+import {
+  a,
+  div,
+  heading1,
+  heading2,
+  heading3,
+  p,
+  span,
+  ul,
+  li,
+} from "../../lib/render.js";
+import { createBackLink } from "../../components/nav.js";
+import {
+  createJobBuilderButton,
+  createInterviewPrepButton,
+} from "../../components/action-buttons.js";
+import { getConceptEmoji } from "../../model/levels.js";
+import { prepareDisciplineDetail } from "./shared.js";
+
+/**
+ * Format discipline detail as DOM elements
+ * @param {Object} discipline - Raw discipline entity
+ * @param {Object} context - Additional context and options
+ * @param {Array} context.skills - All skills
+ * @param {Array} context.behaviours - All behaviours
+ * @param {Object} [context.framework] - Framework data for emoji lookup
+ * @param {boolean} [context.showBackLink=true] - Whether to show back navigation link
+ * @param {boolean} [context.showBehaviourModifiers=true] - Whether to show behaviour modifiers section
+ * @returns {HTMLElement}
+ */
+export function disciplineToDOM(
+  discipline,
+  {
+    skills,
+    behaviours,
+    framework,
+    showBackLink = true,
+    showBehaviourModifiers = true,
+  } = {},
+) {
+  const view = prepareDisciplineDetail(discipline, { skills, behaviours });
+  const emoji = getConceptEmoji(framework, "discipline");
+  return div(
+    { className: "detail-page discipline-detail" },
+    // Header
+    div(
+      { className: "page-header" },
+      showBackLink
+        ? createBackLink("/discipline", "← Back to Disciplines")
+        : null,
+      heading1({ className: "page-title" }, `${emoji} `, view.name),
+      p({ className: "page-description" }, view.description),
+      showBackLink
+        ? div(
+            { className: "page-actions" },
+            createJobBuilderButton({
+              paramName: "discipline",
+              paramValue: discipline.id,
+            }),
+            createInterviewPrepButton({
+              paramName: "discipline",
+              paramValue: discipline.id,
+            }),
+          )
+        : null,
+    ),
+
+    // Stats
+    div(
+      { className: "stats" },
+      div(
+        { className: "stat" },
+        div({ className: "stat-value" }, String(view.coreSkills.length)),
+        div({ className: "stat-label" }, "Core Skills"),
+      ),
+      div(
+        { className: "stat" },
+        div({ className: "stat-value" }, String(view.supportingSkills.length)),
+        div({ className: "stat-label" }, "Supporting Skills"),
+      ),
+      div(
+        { className: "stat" },
+        div({ className: "stat-value" }, String(view.broadSkills.length)),
+        div({ className: "stat-label" }, "Broad Skills"),
+      ),
+    ),
+
+    // Skills sections - all three columns
+    div(
+      { className: "detail-section" },
+      heading2({ className: "section-title" }, "Skill Profile"),
+      div(
+        { className: "content-columns" },
+        // Core skills
+        div(
+          {},
+          heading3(
+            {},
+            span({ className: "badge badge-primary" }, "Core Skills"),
+          ),
+          view.coreSkills.length > 0
+            ? ul(
+                { className: "related-list" },
+                ...view.coreSkills.map((s) =>
+                  li(
+                    {},
+                    showBackLink
+                      ? a({ href: `#/skill/${s.id}` }, s.name)
+                      : span({}, s.name),
+                  ),
+                ),
+              )
+            : p({ className: "text-muted" }, "None"),
+        ),
+        // Supporting skills
+        div(
+          {},
+          heading3(
+            {},
+            span({ className: "badge badge-secondary" }, "Supporting Skills"),
+          ),
+          view.supportingSkills.length > 0
+            ? ul(
+                { className: "related-list" },
+                ...view.supportingSkills.map((s) =>
+                  li(
+                    {},
+                    showBackLink
+                      ? a({ href: `#/skill/${s.id}` }, s.name)
+                      : span({}, s.name),
+                  ),
+                ),
+              )
+            : p({ className: "text-muted" }, "None"),
+        ),
+        // Broad skills
+        div(
+          {},
+          heading3(
+            {},
+            span({ className: "badge badge-broad" }, "Broad Skills"),
+          ),
+          view.broadSkills.length > 0
+            ? ul(
+                { className: "related-list" },
+                ...view.broadSkills.map((s) =>
+                  li(
+                    {},
+                    showBackLink
+                      ? a({ href: `#/skill/${s.id}` }, s.name)
+                      : span({}, s.name),
+                  ),
+                ),
+              )
+            : p({ className: "text-muted" }, "None"),
+        ),
+      ),
+    ),
+
+    // Behaviour modifiers
+    showBehaviourModifiers && view.behaviourModifiers.length > 0
+      ? div(
+          { className: "detail-section" },
+          heading2({ className: "section-title" }, "Behaviour Modifiers"),
+          ...view.behaviourModifiers.map((b) =>
+            div(
+              { className: "list-item" },
+              showBackLink
+                ? a({ href: `#/behaviour/${b.id}` }, b.name)
+                : span({}, b.name),
+              " ",
+              span(
+                {
+                  className: `modifier ${b.modifier > 0 ? "modifier-positive" : b.modifier < 0 ? "modifier-negative" : "modifier-neutral"}`,
+                },
+                b.modifier > 0 ? `+${b.modifier}` : String(b.modifier),
+              ),
+            ),
+          ),
+        )
+      : null,
+  );
+}

package/app/formatters/discipline/markdown.js

@@ -0,0 +1,87 @@
+/**
+ * Discipline formatting for markdown/CLI output
+ */
+
+import { tableToMarkdown } from "../shared.js";
+import { prepareDisciplinesList, prepareDisciplineDetail } from "./shared.js";
+
+/**
+ * Format discipline list as markdown
+ * @param {Array} disciplines - Raw discipline entities
+ * @returns {string}
+ */
+export function disciplineListToMarkdown(disciplines) {
+  const { items } = prepareDisciplinesList(disciplines);
+  const lines = ["# 📋 Disciplines", ""];
+
+  const rows = items.map((d) => [
+    d.name,
+    `${d.coreSkillsCount}C`,
+    `${d.supportingSkillsCount}S`,
+    `${d.broadSkillsCount}B`,
+  ]);
+
+  lines.push(
+    tableToMarkdown(["Discipline", "Core", "Supporting", "Broad"], rows),
+  );
+  lines.push("");
+
+  return lines.join("\n");
+}
+
+/**
+ * Format discipline detail as markdown
+ * @param {Object} discipline - Raw discipline entity
+ * @param {Object} context - Additional context
+ * @param {Array} context.skills - All skills
+ * @param {Array} context.behaviours - All behaviours
+ * @param {boolean} [context.showBehaviourModifiers=true] - Whether to show behaviour modifiers section
+ * @returns {string}
+ */
+export function disciplineToMarkdown(
+  discipline,
+  { skills, behaviours, showBehaviourModifiers = true } = {},
+) {
+  const view = prepareDisciplineDetail(discipline, { skills, behaviours });
+  const lines = [`# 📋 ${view.name}`, "", view.description, ""];
+
+  // Core skills
+  if (view.coreSkills.length > 0) {
+    lines.push("## Core Skills", "");
+    for (const s of view.coreSkills) {
+      lines.push(`- ${s.name}`);
+    }
+    lines.push("");
+  }
+
+  // Supporting skills
+  if (view.supportingSkills.length > 0) {
+    lines.push("## Supporting Skills", "");
+    for (const s of view.supportingSkills) {
+      lines.push(`- ${s.name}`);
+    }
+    lines.push("");
+  }
+
+  // Broad skills
+  if (view.broadSkills.length > 0) {
+    lines.push("## Broad Skills", "");
+    for (const s of view.broadSkills) {
+      lines.push(`- ${s.name}`);
+    }
+    lines.push("");
+  }
+
+  // Behaviour modifiers
+  if (showBehaviourModifiers && view.behaviourModifiers.length > 0) {
+    lines.push("## Behaviour Modifiers", "");
+    const modifierRows = view.behaviourModifiers.map((b) => [
+      b.name,
+      b.modifier > 0 ? `+${b.modifier}` : `${b.modifier}`,
+    ]);
+    lines.push(tableToMarkdown(["Behaviour", "Modifier"], modifierRows));
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}

package/app/formatters/discipline/shared.js

@@ -0,0 +1,131 @@
+/**
+ * Discipline presentation helpers
+ *
+ * Shared utilities for formatting discipline data across DOM and markdown outputs.
+ */
+
+import { truncate } from "../shared.js";
+
+/**
+ * Get items by their IDs
+ * @param {Array} items - Array of items with id property
+ * @param {string[]} ids - Array of IDs to find
+ * @returns {Array} - Found items
+ */
+function getItemsByIds(items, ids) {
+  if (!ids) return [];
+  return ids.map((id) => items.find((item) => item.id === id)).filter(Boolean);
+}
+
+/**
+ * Get discipline display name
+ * @param {Object} discipline
+ * @returns {string}
+ */
+export function getDisciplineDisplayName(discipline) {
+  return discipline.specialization || discipline.name || discipline.id;
+}
+
+/**
+ * @typedef {Object} DisciplineListItem
+ * @property {string} id
+ * @property {string} name
+ * @property {string} description
+ * @property {string} truncatedDescription
+ * @property {number} coreSkillsCount
+ * @property {number} supportingSkillsCount
+ * @property {number} broadSkillsCount
+ */
+
+/**
+ * Transform disciplines for list view
+ * @param {Array} disciplines - Raw discipline entities
+ * @param {number} [descriptionLimit=120] - Maximum description length
+ * @returns {{ items: DisciplineListItem[] }}
+ */
+export function prepareDisciplinesList(disciplines, descriptionLimit = 120) {
+  const items = disciplines.map((discipline) => ({
+    id: discipline.id,
+    name: getDisciplineDisplayName(discipline),
+    description: discipline.description,
+    truncatedDescription: truncate(discipline.description, descriptionLimit),
+    coreSkillsCount: discipline.coreSkills?.length || 0,
+    supportingSkillsCount: discipline.supportingSkills?.length || 0,
+    broadSkillsCount: discipline.broadSkills?.length || 0,
+  }));
+
+  return { items };
+}
+
+/**
+ * @typedef {Object} SkillReference
+ * @property {string} id
+ * @property {string} name
+ */
+
+/**
+ * @typedef {Object} BehaviourModifier
+ * @property {string} id
+ * @property {string} name
+ * @property {number} modifier
+ */
+
+/**
+ * @typedef {Object} DisciplineDetailView
+ * @property {string} id
+ * @property {string} name
+ * @property {string} description
+ * @property {SkillReference[]} coreSkills
+ * @property {SkillReference[]} supportingSkills
+ * @property {SkillReference[]} broadSkills
+ * @property {BehaviourModifier[]} behaviourModifiers
+ */
+
+/**
+ * Transform discipline for detail view
+ * @param {Object} discipline - Raw discipline entity
+ * @param {Object} context - Additional context
+ * @param {Array} context.skills - All skills
+ * @param {Array} context.behaviours - All behaviours
+ * @returns {DisciplineDetailView|null}
+ */
+export function prepareDisciplineDetail(discipline, { skills, behaviours }) {
+  if (!discipline) return null;
+
+  const coreSkills = getItemsByIds(skills, discipline.coreSkills).map((s) => ({
+    id: s.id,
+    name: s.name,
+  }));
+
+  const supportingSkills = getItemsByIds(
+    skills,
+    discipline.supportingSkills,
+  ).map((s) => ({ id: s.id, name: s.name }));
+
+  const broadSkills = getItemsByIds(skills, discipline.broadSkills).map(
+    (s) => ({ id: s.id, name: s.name }),
+  );
+
+  const behaviourModifiers = discipline.behaviourModifiers
+    ? Object.entries(discipline.behaviourModifiers).map(
+        ([behaviourId, modifier]) => {
+          const behaviour = behaviours.find((b) => b.id === behaviourId);
+          return {
+            id: behaviourId,
+            name: behaviour?.name || behaviourId,
+            modifier,
+          };
+        },
+      )
+    : [];
+
+  return {
+    id: discipline.id,
+    name: getDisciplineDisplayName(discipline),
+    description: discipline.description,
+    coreSkills,
+    supportingSkills,
+    broadSkills,
+    behaviourModifiers,
+  };
+}