@forwardimpact/model 0.3.0 → 0.4.0

package/lib/agent.js

@@ -706,10 +706,8 @@ 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}`;
+  // Build description using shared helper
+  const description = buildAgentDescription(discipline, track, stage);
 
   // Format checklist as markdown
   const checklistMarkdown = formatChecklistMarkdown(agent.checklist);
@@ -746,16 +744,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.4.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"