@forwardimpact/model 0.4.0 → 0.7.0

package/README.md

@@ -29,8 +29,8 @@ import {
   deriveSkillMatrix,
   deriveBehaviourProfile,
 } from "@forwardimpact/model/derivation";
-import { prepareAgentProfile } from "@forwardimpact/model/agent";
-import { selectInterviewQuestions } from "@forwardimpact/model/interview";
+import { prepareAgentProfile } from "@forwardimpact/model/profile";
+import { deriveInterviewQuestions } from "@forwardimpact/model/interview";
 import { analyzeProgression } from "@forwardimpact/model/progression";
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/model",
-  "version": "0.4.0",
+  "version": "0.7.0",
   "description": "Derivation engine for roles, skills, and AI agent profiles",
   "license": "Apache-2.0",
   "repository": {
@@ -10,25 +10,27 @@
   },
   "homepage": "https://www.forwardimpact.team/model",
   "type": "module",
-  "main": "lib/index.js",
+  "main": "src/index.js",
   "files": [
-    "lib/"
+    "src/"
   ],
   "exports": {
-    ".": "./lib/index.js",
-    "./derivation": "./lib/derivation.js",
-    "./modifiers": "./lib/modifiers.js",
-    "./agent": "./lib/agent.js",
-    "./interview": "./lib/interview.js",
-    "./job": "./lib/job.js",
-    "./job-cache": "./lib/job-cache.js",
-    "./checklist": "./lib/checklist.js",
-    "./matching": "./lib/matching.js",
-    "./profile": "./lib/profile.js",
-    "./progression": "./lib/progression.js"
+    ".": "./src/index.js",
+    "./derivation": "./src/derivation.js",
+    "./modifiers": "./src/modifiers.js",
+    "./agent": "./src/agent.js",
+    "./interview": "./src/interview.js",
+    "./job": "./src/job.js",
+    "./job-cache": "./src/job-cache.js",
+    "./checklist": "./src/checklist.js",
+    "./matching": "./src/matching.js",
+    "./profile": "./src/profile.js",
+    "./progression": "./src/progression.js",
+    "./policies": "./src/policies/index.js",
+    "./toolkit": "./src/toolkit.js"
   },
   "dependencies": {
-    "@forwardimpact/schema": "^0.4.0"
+    "@forwardimpact/schema": "^0.6.0"
   },
   "engines": {
     "node": ">=18.0.0"

package/{lib → src}/agent.js

@@ -19,12 +19,13 @@
  */
 
 import { deriveSkillMatrix, deriveBehaviourProfile } from "./derivation.js";
-import { deriveChecklist, formatChecklistMarkdown } from "./checklist.js";
+import { deriveChecklist } from "./checklist.js";
 import {
-  filterSkillsForAgent,
-  sortByLevelDescending,
-  sortByMaturityDescending,
-} from "./profile.js";
+  filterAgentSkills,
+  sortAgentSkills,
+  sortAgentBehaviours,
+} from "./policies/composed.js";
+import { ORDER_AGENT_STAGE } from "./policies/orderings.js";
 import { SkillLevel } from "@forwardimpact/schema/levels";
 
 /**
@@ -123,9 +124,9 @@ export function deriveAgentSkills({ discipline, track, grade, skills }) {
     skills,
   });
 
-  // Apply agent-specific filtering and sorting
-  const filtered = filterSkillsForAgent(skillMatrix);
-  return sortByLevelDescending(filtered);
+  // Apply agent-specific filtering and sorting using policies
+  const filtered = filterAgentSkills(skillMatrix);
+  return sortAgentSkills(filtered);
 }
 
 /**
@@ -151,7 +152,7 @@ export function deriveAgentBehaviours({
     behaviours,
   });
 
-  return sortByMaturityDescending(profile);
+  return sortAgentBehaviours(profile);
 }
 
 /**
@@ -229,7 +230,7 @@ function buildWorkingStyleFromBehaviours(
  * @param {Array} stages - All stage entities
  * @returns {Object} Skill with frontmatter, title, stages array, reference, dirname
  */
-export function generateSkillMd(skillData, stages) {
+export function generateSkillMarkdown(skillData, stages) {
   const { agent, name } = skillData;
 
   if (!agent) {
@@ -272,10 +273,11 @@ export function generateSkillMd(skillData, stages) {
     },
   );
 
-  // Sort stages in order: plan, code, review
-  const stageOrder = ["plan", "code", "review"];
+  // Sort stages using canonical ordering from policies
   stagesArray.sort(
-    (a, b) => stageOrder.indexOf(a.stageId) - stageOrder.indexOf(b.stageId),
+    (a, b) =>
+      ORDER_AGENT_STAGE.indexOf(a.stageId) -
+      ORDER_AGENT_STAGE.indexOf(b.stageId),
   );
 
   return {
@@ -308,7 +310,6 @@ function estimateBodyDataLength(bodyData) {
     "priority",
     "roleContext",
     "workingStyle",
-    "beforeHandoff",
   ];
   for (const field of stringFields) {
     if (bodyData[field]) {
@@ -487,7 +488,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 +502,7 @@ function buildStageProfileBodyData({
   derivedBehaviours,
   agentBehaviours,
   skills,
-  checklistMarkdown,
+  checklist,
   agentIndex,
 }) {
   const name = `${humanDiscipline.specialization || humanDiscipline.name} - ${humanTrack.name}`;
@@ -563,7 +564,7 @@ function buildStageProfileBodyData({
     skillIndex,
     roleContext,
     workingStyles,
-    beforeHandoff: checklistMarkdown || null,
+    beforeHandoff: checklist || [],
     constraints,
     agentIndex: filteredAgentIndex,
     hasAgentIndex: filteredAgentIndex.length > 0,
@@ -709,10 +710,7 @@ export function generateStageAgentProfile({
   // Build description using shared helper
   const description = buildAgentDescription(discipline, track, stage);
 
-  // Format checklist as markdown
-  const checklistMarkdown = formatChecklistMarkdown(agent.checklist);
-
-  // Build structured profile body data
+  // Build structured profile body data (pass raw checklist for template iteration)
   const bodyData = buildStageProfileBodyData({
     stage,
     humanDiscipline: discipline,
@@ -723,7 +721,7 @@ export function generateStageAgentProfile({
     derivedBehaviours: agent.derivedBehaviours,
     agentBehaviours,
     skills,
-    checklistMarkdown,
+    checklist: agent.checklist,
     agentIndex,
   });
 

package/{lib → src}/derivation.js

@@ -18,6 +18,7 @@ import {
 } from "@forwardimpact/schema/levels";
 
 import { resolveSkillModifier } from "./modifiers.js";
+import { ORDER_SKILL_TYPE } from "./policies/orderings.js";
 
 /**
  * Build a Map of skillId → skillType for a discipline
@@ -226,14 +227,10 @@ export function deriveSkillMatrix({ discipline, grade, track = null, skills }) {
   }
 
   // Sort by type (primary first, then secondary, then broad, then track) and then by name
-  const typeOrder = {
-    [SkillType.PRIMARY]: 0,
-    [SkillType.SECONDARY]: 1,
-    [SkillType.BROAD]: 2,
-    [SkillType.TRACK]: 3,
-  };
+  // Use ORDER_SKILL_TYPE from policies for canonical ordering
   matrix.sort((a, b) => {
-    const typeCompare = typeOrder[a.type] - typeOrder[b.type];
+    const typeCompare =
+      ORDER_SKILL_TYPE.indexOf(a.type) - ORDER_SKILL_TYPE.indexOf(b.type);
     if (typeCompare !== 0) return typeCompare;
     return a.skillName.localeCompare(b.skillName);
   });
@@ -485,7 +482,7 @@ export function deriveResponsibilities({
         capability: capabilityId,
         capabilityName: capability.name,
         emojiIcon: capability.emojiIcon || "💡",
-        displayOrder: capability.displayOrder ?? 999,
+        ordinalRank: capability.ordinalRank ?? 999,
         responsibility: responsibilityText,
         level,
         levelIndex: SKILL_LEVEL_ORDER.indexOf(level),
@@ -498,7 +495,7 @@ export function deriveResponsibilities({
     if (b.levelIndex !== a.levelIndex) {
       return b.levelIndex - a.levelIndex;
     }
-    return a.displayOrder - b.displayOrder;
+    return a.ordinalRank - b.ordinalRank;
   });
 
   // Remove levelIndex from output (internal use only)

package/{lib → src}/index.js

@@ -33,11 +33,11 @@ export {
 
 // Job caching
 export {
-  makeJobKey,
+  buildJobKey,
   getOrCreateJob,
-  clearJobCache,
-  invalidateJob,
-  getCacheSize,
+  clearCache,
+  invalidateCachedJob,
+  getCachedJobCount,
 } from "./job-cache.js";
 
 // Modifiers
@@ -45,17 +45,17 @@ export {
   isCapability,
   getSkillsByCapability,
   buildCapabilityToSkillsMap,
-  expandSkillModifiers,
+  expandModifiersToSkills,
   extractCapabilityModifiers,
-  extractIndividualModifiers,
+  extractSkillModifiers,
   resolveSkillModifier,
 } from "./modifiers.js";
 
 // Matching
 export {
   MatchTier,
-  MATCH_TIER_CONFIG,
-  classifyMatchTier,
+  CONFIG_MATCH_TIER,
+  classifyMatch,
   GAP_SCORES,
   calculateGapScore,
   calculateJobMatch,
@@ -87,16 +87,18 @@ export {
   deriveShortInterview,
   deriveBehaviourQuestions,
   deriveFocusedInterview,
+  deriveMissionFitInterview,
+  deriveDecompositionInterview,
+  deriveStakeholderInterview,
 } from "./interview.js";
 
 // Agent generation
 export {
   deriveReferenceGrade,
   getDisciplineAbbreviation,
-  toKebabCase,
   deriveAgentSkills,
   deriveAgentBehaviours,
-  generateSkillMd,
+  generateSkillMarkdown,
   validateAgentProfile,
   validateAgentSkill,
   deriveHandoffs,
@@ -111,15 +113,55 @@ export { deriveChecklist, formatChecklistMarkdown } from "./checklist.js";
 // Toolkit
 export { deriveToolkit } from "./toolkit.js";
 
-// Profile filtering (for agents)
+// Profile derivation
 export {
   getPositiveTrackCapabilities,
-  filterHumanOnlySkills,
-  filterByHighestLevel,
-  filterSkillsForAgent,
-  sortByLevelDescending,
-  sortByMaturityDescending,
   prepareBaseProfile,
-  AGENT_PROFILE_OPTIONS,
   prepareAgentProfile,
 } from "./profile.js";
+
+// Policies - re-export key items for convenience
+export {
+  // Thresholds
+  THRESHOLD_MATCH_STRONG,
+  THRESHOLD_MATCH_GOOD,
+  THRESHOLD_MATCH_STRETCH,
+  THRESHOLD_MATCH_ASPIRATIONAL,
+  SCORE_GAP,
+  WEIGHT_SKILL_TYPE,
+  WEIGHT_CAPABILITY_BOOST,
+  // Predicates
+  isHumanOnly,
+  isAgentEligible,
+  isPrimary,
+  isSecondary,
+  isBroad,
+  isTrack,
+  isCore,
+  isSupporting,
+  hasMinLevel,
+  allOf,
+  anyOf,
+  not,
+  // Filters
+  filterHighestLevel,
+  filterAboveAwareness,
+  applyFilters,
+  composeFilters,
+  // Orderings
+  ORDER_SKILL_TYPE,
+  ORDER_STAGE,
+  ORDER_AGENT_STAGE,
+  compareByLevelDesc,
+  compareByType,
+  compareBySkillPriority,
+  compareByMaturityDesc,
+  compareByBehaviourPriority,
+  // Composed policies
+  filterAgentSkills,
+  filterToolkitSkills,
+  sortAgentSkills,
+  sortAgentBehaviours,
+  prepareAgentSkillMatrix,
+  prepareAgentBehaviourProfile,
+} from "./policies/index.js";