@forwardimpact/model 0.3.0 → 0.5.0

package/lib/agent.js

@@ -19,7 +19,7 @@
  */
 
 import { deriveSkillMatrix, deriveBehaviourProfile } from "./derivation.js";
-import { deriveChecklist, formatChecklistMarkdown } from "./checklist.js";
+import { deriveChecklist } from "./checklist.js";
 import {
   filterSkillsForAgent,
   sortByLevelDescending,
@@ -308,7 +308,6 @@ function estimateBodyDataLength(bodyData) {
     "priority",
     "roleContext",
     "workingStyle",
-    "beforeHandoff",
   ];
   for (const field of stringFields) {
     if (bodyData[field]) {
@@ -487,7 +486,7 @@ function getChecklistStage(stageId) {
  * @param {Array} params.derivedBehaviours - Behaviours sorted by maturity
  * @param {Array} params.agentBehaviours - Agent behaviour definitions
  * @param {Array} params.skills - All skill definitions (for agent section lookup)
- * @param {string} params.checklistMarkdown - Pre-formatted checklist markdown
+ * @param {Array<{skill: Object, capability: Object, items: string[]}>} params.checklist - Raw checklist from deriveChecklist
  * @param {Array<{id: string, name: string, description: string}>} [params.agentIndex] - List of all available agents
  * @returns {Object} Structured profile body data
  */
@@ -501,7 +500,7 @@ function buildStageProfileBodyData({
   derivedBehaviours,
   agentBehaviours,
   skills,
-  checklistMarkdown,
+  checklist,
   agentIndex,
 }) {
   const name = `${humanDiscipline.specialization || humanDiscipline.name} - ${humanTrack.name}`;
@@ -563,7 +562,7 @@ function buildStageProfileBodyData({
     skillIndex,
     roleContext,
     workingStyles,
-    beforeHandoff: checklistMarkdown || null,
+    beforeHandoff: checklist || [],
     constraints,
     agentIndex: filteredAgentIndex,
     hasAgentIndex: filteredAgentIndex.length > 0,
@@ -706,15 +705,10 @@ export function generateStageAgentProfile({
   const fullName = `${abbrev}-${toKebabCase(track.id)}-${stage.id}`;
   const filename = `${fullName}.agent.md`;
 
-  // Build description
-  const disciplineDesc = discipline.description.trim().split("\n")[0];
-  const stageDesc = stage.description.split(" - ")[0]; // Just the short part
-  const description = `${stageDesc} agent for ${discipline.specialization || discipline.name} on ${track.name} track. ${disciplineDesc}`;
-
-  // Format checklist as markdown
-  const checklistMarkdown = formatChecklistMarkdown(agent.checklist);
+  // Build description using shared helper
+  const description = buildAgentDescription(discipline, track, stage);
 
-  // Build structured profile body data
+  // Build structured profile body data (pass raw checklist for template iteration)
   const bodyData = buildStageProfileBodyData({
     stage,
     humanDiscipline: discipline,
@@ -725,7 +719,7 @@ export function generateStageAgentProfile({
     derivedBehaviours: agent.derivedBehaviours,
     agentBehaviours,
     skills,
-    checklistMarkdown,
+    checklist: agent.checklist,
     agentIndex,
   });
 
@@ -746,16 +740,16 @@ export function generateStageAgentProfile({
 
 /**
  * Build an agent description from discipline, track, and stage
- * Uses the same format as generateStageAgentProfile for consistency
+ * Uses stage.summary for third-person metadata description
  * @param {Object} discipline - Human discipline definition
  * @param {Object} track - Human track definition
- * @param {Object} stage - Stage definition
+ * @param {Object} stage - Stage definition with summary field
  * @returns {string} Agent description
  */
 function buildAgentDescription(discipline, track, stage) {
   const disciplineDesc = discipline.description.trim().split("\n")[0];
-  const stageDesc = stage.description.split(" - ")[0];
-  return `${stageDesc} agent for ${discipline.specialization || discipline.name} on ${track.name} track. ${disciplineDesc}`;
+  const stageSummary = stage.summary || stage.name;
+  return `${stageSummary} agent for ${discipline.specialization || discipline.name} on ${track.name} track. ${disciplineDesc}`;
 }
 
 /**

package/lib/toolkit.js

@@ -2,9 +2,12 @@
  * Toolkit Derivation Functions
  *
  * Derives a de-duplicated list of tools from a skill matrix by looking up
- * toolReferences from skill definitions.
+ * toolReferences from skill definitions. Only skills at the highest derived
+ * level contribute tools, ensuring focused toolkits for both jobs and agents.
  */
 
+import { filterByHighestLevel } from "./profile.js";
+
 /**
  * @typedef {Object} ToolkitEntry
  * @property {string} name - Tool name
@@ -17,22 +20,26 @@
 /**
  * Derive a de-duplicated toolkit from a skill matrix
  *
- * Extracts all tools referenced by skills in the matrix, de-duplicates by name,
- * and collects which skills reference each tool.
+ * Extracts tools from skills at the highest derived level, de-duplicates by name,
+ * and collects which skills reference each tool. This keeps toolkits focused on
+ * the engineer's core competencies for both jobs and agents.
  *
  * @param {Object} params
- * @param {Array<{skillId: string}>} params.skillMatrix - Skill matrix with skill IDs
+ * @param {Array<{skillId: string, level: string}>} params.skillMatrix - Skill matrix with skill IDs and levels
  * @param {Array} params.skills - All skill definitions with toolReferences
  * @returns {ToolkitEntry[]} De-duplicated toolkit sorted by name
  */
 export function deriveToolkit({ skillMatrix, skills }) {
+  // Filter to highest level skills only
+  const sourceMatrix = filterByHighestLevel(skillMatrix);
+
   // Build skill lookup map for O(1) access
   const skillMap = new Map(skills.map((s) => [s.id, s]));
 
   // Tool map for de-duplication: name -> ToolkitEntry
   const toolMap = new Map();
 
-  for (const entry of skillMatrix) {
+  for (const entry of sourceMatrix) {
     const skill = skillMap.get(entry.skillId);
     if (!skill?.toolReferences) continue;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/model",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Derivation engine for roles, skills, and AI agent profiles",
   "license": "Apache-2.0",
   "repository": {
@@ -28,7 +28,7 @@
     "./progression": "./lib/progression.js"
   },
   "dependencies": {
-    "@forwardimpact/schema": "^0.3.0"
+    "@forwardimpact/schema": "^0.4.0"
   },
   "engines": {
     "node": ">=18.0.0"