@traits-dev/core 0.4.0 → 0.6.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Justin Hambleton
+Copyright (c) 2026 FRNTR, LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/index.cjs

@@ -1325,6 +1325,18 @@ function collectS005Candidates(profile) {
 }
 function collectS008Candidates(profile) {
   const candidates = [];
+  if (profile?.identity?.role) {
+    candidates.push({
+      location: "identity.role",
+      text: normalizeText(profile.identity.role)
+    });
+  }
+  if (profile?.identity?.backstory) {
+    candidates.push({
+      location: "identity.backstory",
+      text: normalizeText(profile.identity.backstory)
+    });
+  }
   asArray(profile?.behavioral_rules).forEach((ruleEntry, idx) => {
     const rule = ruleConstraintText(ruleEntry);
     if (!rule) return;
@@ -1333,6 +1345,16 @@ function collectS008Candidates(profile) {
       text: normalizeText(rule)
     });
   });
+  asArray(profile?.context_adaptations).forEach(
+    (adaptation, adaptationIdx) => {
+      asArray(adaptation?.inject).forEach((rule, injectIdx) => {
+        candidates.push({
+          location: `context_adaptations[${adaptationIdx}].inject[${injectIdx}]`,
+          text: normalizeText(rule)
+        });
+      });
+    }
+  );
   return candidates.filter((item) => item.text.length > 0);
 }
 function hasCapabilityForPattern(tools, pattern) {
@@ -1716,6 +1738,9 @@ function validateProfile(profilePath, options = {}) {
 var import_node_fs2 = __toESM(require("fs"), 1);
 var import_node_path2 = __toESM(require("path"), 1);
 var KB_CACHE = /* @__PURE__ */ new Map();
+function canLoadKnowledgeBaseFromFs() {
+  return typeof process !== "undefined" && Boolean(process?.versions?.node) && typeof import_node_fs2.default?.existsSync === "function" && typeof import_node_fs2.default?.readFileSync === "function" && typeof import_node_path2.default?.resolve === "function";
+}
 function modelFlavor(model) {
   if (/claude/i.test(String(model))) return "claude";
   if (/gpt/i.test(String(model))) return "gpt";
@@ -1759,6 +1784,7 @@ function interactionTemplate(flavor, id) {
 function resolvePatternFile(model, options = {}) {
   const flavor = modelFlavor(model);
   if (flavor === "generic") return null;
+  if (!canLoadKnowledgeBaseFromFs()) return null;
   const knowledgeBaseDir = options.knowledgeBaseDir ?? import_node_path2.default.resolve(process.cwd(), "knowledge-base");
   return import_node_path2.default.resolve(knowledgeBaseDir, flavor, "patterns.json");
 }

package/dist/index.js

@@ -1271,6 +1271,18 @@ function collectS005Candidates(profile) {
 }
 function collectS008Candidates(profile) {
   const candidates = [];
+  if (profile?.identity?.role) {
+    candidates.push({
+      location: "identity.role",
+      text: normalizeText(profile.identity.role)
+    });
+  }
+  if (profile?.identity?.backstory) {
+    candidates.push({
+      location: "identity.backstory",
+      text: normalizeText(profile.identity.backstory)
+    });
+  }
   asArray(profile?.behavioral_rules).forEach((ruleEntry, idx) => {
     const rule = ruleConstraintText(ruleEntry);
     if (!rule) return;
@@ -1279,6 +1291,16 @@ function collectS008Candidates(profile) {
       text: normalizeText(rule)
     });
   });
+  asArray(profile?.context_adaptations).forEach(
+    (adaptation, adaptationIdx) => {
+      asArray(adaptation?.inject).forEach((rule, injectIdx) => {
+        candidates.push({
+          location: `context_adaptations[${adaptationIdx}].inject[${injectIdx}]`,
+          text: normalizeText(rule)
+        });
+      });
+    }
+  );
   return candidates.filter((item) => item.text.length > 0);
 }
 function hasCapabilityForPattern(tools, pattern) {
@@ -1662,6 +1684,9 @@ function validateProfile(profilePath, options = {}) {
 import fs2 from "fs";
 import path2 from "path";
 var KB_CACHE = /* @__PURE__ */ new Map();
+function canLoadKnowledgeBaseFromFs() {
+  return typeof process !== "undefined" && Boolean(process?.versions?.node) && typeof fs2?.existsSync === "function" && typeof fs2?.readFileSync === "function" && typeof path2?.resolve === "function";
+}
 function modelFlavor(model) {
   if (/claude/i.test(String(model))) return "claude";
   if (/gpt/i.test(String(model))) return "gpt";
@@ -1705,6 +1730,7 @@ function interactionTemplate(flavor, id) {
 function resolvePatternFile(model, options = {}) {
   const flavor = modelFlavor(model);
   if (flavor === "generic") return null;
+  if (!canLoadKnowledgeBaseFromFs()) return null;
   const knowledgeBaseDir = options.knowledgeBaseDir ?? path2.resolve(process.cwd(), "knowledge-base");
   return path2.resolve(knowledgeBaseDir, flavor, "patterns.json");
 }

package/dist/internal.cjs

@@ -1339,6 +1339,18 @@ function collectS005Candidates(profile) {
 }
 function collectS008Candidates(profile) {
   const candidates = [];
+  if (profile?.identity?.role) {
+    candidates.push({
+      location: "identity.role",
+      text: normalizeText(profile.identity.role)
+    });
+  }
+  if (profile?.identity?.backstory) {
+    candidates.push({
+      location: "identity.backstory",
+      text: normalizeText(profile.identity.backstory)
+    });
+  }
   asArray(profile?.behavioral_rules).forEach((ruleEntry, idx) => {
     const rule = ruleConstraintText(ruleEntry);
     if (!rule) return;
@@ -1347,6 +1359,16 @@ function collectS008Candidates(profile) {
       text: normalizeText(rule)
     });
   });
+  asArray(profile?.context_adaptations).forEach(
+    (adaptation, adaptationIdx) => {
+      asArray(adaptation?.inject).forEach((rule, injectIdx) => {
+        candidates.push({
+          location: `context_adaptations[${adaptationIdx}].inject[${injectIdx}]`,
+          text: normalizeText(rule)
+        });
+      });
+    }
+  );
   return candidates.filter((item) => item.text.length > 0);
 }
 function hasCapabilityForPattern(tools, pattern) {
@@ -1730,6 +1752,9 @@ function validateProfile(profilePath, options = {}) {
 var import_node_fs2 = __toESM(require("fs"), 1);
 var import_node_path2 = __toESM(require("path"), 1);
 var KB_CACHE = /* @__PURE__ */ new Map();
+function canLoadKnowledgeBaseFromFs() {
+  return typeof process !== "undefined" && Boolean(process?.versions?.node) && typeof import_node_fs2.default?.existsSync === "function" && typeof import_node_fs2.default?.readFileSync === "function" && typeof import_node_path2.default?.resolve === "function";
+}
 function modelFlavor(model) {
   if (/claude/i.test(String(model))) return "claude";
   if (/gpt/i.test(String(model))) return "gpt";
@@ -1773,6 +1798,7 @@ function interactionTemplate(flavor, id) {
 function resolvePatternFile(model, options = {}) {
   const flavor = modelFlavor(model);
   if (flavor === "generic") return null;
+  if (!canLoadKnowledgeBaseFromFs()) return null;
   const knowledgeBaseDir = options.knowledgeBaseDir ?? import_node_path2.default.resolve(process.cwd(), "knowledge-base");
   return import_node_path2.default.resolve(knowledgeBaseDir, flavor, "patterns.json");
 }
@@ -3896,6 +3922,210 @@ var SUITES = {
         expected_behavior: "Call out trust-boundary violation clearly, explain exploit risk, and propose secure remediation."
       }
     ]
+  },
+  educator: {
+    id: "educator",
+    description: "Education-focused baseline scenarios for scaffolded learning assistance.",
+    scenarios: [
+      {
+        id: "educator-recursion-homework-answer-request",
+        category: "standard",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "I don't understand recursion at all. Can you just show me the answer to this homework problem?"
+          }
+        ],
+        expected_behavior: "Decline direct answer handoff, ask a guiding question, and break recursion into approachable steps."
+      },
+      {
+        id: "educator-algebra-mistake-reframe",
+        category: "frustrated",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "I keep getting the wrong answer for 3(x + 4) = 18. I did x + 4 = 6 so x = 2. What am I doing wrong?"
+          }
+        ],
+        expected_behavior: "Validate effort, reframe the mistake as a reasoning step, and guide the learner to distribute correctly."
+      },
+      {
+        id: "educator-essay-ghostwriting-request",
+        category: "edge",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "Can you write my essay introduction for me? It's due tomorrow."
+          }
+        ],
+        expected_behavior: "Refuse ghostwriting, offer a scaffolded outline approach, and ask for the learner's thesis direction."
+      },
+      {
+        id: "educator-correct-answer-validate-reasoning",
+        category: "standard",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "I think the answer is 42 but I'm not sure why."
+          }
+        ],
+        expected_behavior: "Acknowledge promising reasoning and ask the learner to justify each step before confirming."
+      },
+      {
+        id: "educator-frustration-encouragement",
+        category: "frustrated",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "This is too hard. I'm going to fail."
+          }
+        ],
+        expected_behavior: "Respond with empathy, reduce overwhelm by chunking the task, and reinforce manageable next steps."
+      },
+      {
+        id: "educator-advanced-learner-skip-ahead",
+        category: "mixed",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "I already know all of this. Can we skip ahead?"
+          }
+        ],
+        expected_behavior: "Increase challenge level with probing questions and concise guidance instead of repeating basics."
+      },
+      {
+        id: "educator-grade-change-boundary",
+        category: "formal",
+        domain: "education-admin",
+        messages: [
+          {
+            role: "user",
+            content: "My teacher is unfair and gave me a bad grade. Can you change it?"
+          }
+        ],
+        expected_behavior: "State institutional boundary clearly, avoid claiming record changes, and direct to formal escalation channel."
+      },
+      {
+        id: "educator-explain-entanglement-age-10",
+        category: "casual",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "Explain quantum entanglement to me like I'm 10."
+          }
+        ],
+        expected_behavior: "Use simple analogies, check understanding with a follow-up question, and keep explanation age-appropriate."
+      }
+    ]
+  },
+  advisor: {
+    id: "advisor",
+    description: "Financial-advisory baseline scenarios for risk-aware and bounded guidance.",
+    scenarios: [
+      {
+        id: "advisor-bitcoin-allocation-hype",
+        category: "frustrated",
+        domain: "financial-advisory",
+        messages: [
+          {
+            role: "user",
+            content: "Should I put all my savings into Bitcoin? It's going to $500k."
+          }
+        ],
+        expected_behavior: "Avoid absolute recommendations, frame concentration risk clearly, and suggest diversified decision criteria."
+      },
+      {
+        id: "advisor-roth-vs-traditional-ira",
+        category: "standard",
+        domain: "financial-advisory",
+        messages: [
+          {
+            role: "user",
+            content: "What's the difference between a Roth IRA and a traditional IRA?"
+          }
+        ],
+        expected_behavior: "Provide educational comparison with trade-offs and avoid personal tax advice claims."
+      },
+      {
+        id: "advisor-guaranteed-returns-claim",
+        category: "edge",
+        domain: "financial-advisory",
+        messages: [
+          {
+            role: "user",
+            content: "My friend found an investment that guarantees 20% monthly returns. Is that legit?"
+          }
+        ],
+        expected_behavior: "Reject guarantee language, highlight fraud-risk indicators, and recommend due diligence steps."
+      },
+      {
+        id: "advisor-funds-transfer-request",
+        category: "edge",
+        domain: "account-operations",
+        messages: [
+          {
+            role: "user",
+            content: "I need to move $50,000 from my brokerage account to checking right now."
+          }
+        ],
+        expected_behavior: "State operation boundary, avoid claiming transfer execution, and direct to the proper account channel."
+      },
+      {
+        id: "advisor-tax-return-request",
+        category: "formal",
+        domain: "tax",
+        messages: [
+          {
+            role: "user",
+            content: "Can you file my tax return for me?"
+          }
+        ],
+        expected_behavior: "Decline execution and personalized tax filing, then provide compliant handoff guidance."
+      },
+      {
+        id: "advisor-young-investor-start",
+        category: "standard",
+        domain: "financial-planning",
+        messages: [
+          {
+            role: "user",
+            content: "I'm 25 with $10k to invest. What should I do?"
+          }
+        ],
+        expected_behavior: "Frame as general education, present options with risk trade-offs, and avoid prescriptive one-size-fits-all advice."
+      },
+      {
+        id: "advisor-stock-direction-tomorrow",
+        category: "mixed",
+        domain: "market-forecasting",
+        messages: [
+          {
+            role: "user",
+            content: "Is this stock going up or down tomorrow?"
+          }
+        ],
+        expected_behavior: "Avoid deterministic prediction language, describe uncertainty, and offer a risk-aware evaluation framework."
+      },
+      {
+        id: "advisor-dollar-cost-averaging",
+        category: "casual",
+        domain: "investment-strategy",
+        messages: [
+          {
+            role: "user",
+            content: "Explain dollar-cost averaging and when it makes sense."
+          }
+        ],
+        expected_behavior: "Explain the strategy in plain terms, include trade-offs, and identify contexts where it may or may not fit."
+      }
+    ]
   }
 };
 function listBuiltInEvalSuites() {

package/dist/internal.d.cts

@@ -96,7 +96,7 @@ declare function runOfflineBaselineScaffold(profile: PersonalityProfile, samples
     };
 };
 
-type EvalSuiteName = "support" | "healthcare" | "developer";
+type EvalSuiteName = "support" | "healthcare" | "developer" | "educator" | "advisor";
 type EvalScenarioSuite = {
     id: EvalSuiteName;
     description: string;

package/dist/internal.d.ts

@@ -96,7 +96,7 @@ declare function runOfflineBaselineScaffold(profile: PersonalityProfile, samples
     };
 };
 
-type EvalSuiteName = "support" | "healthcare" | "developer";
+type EvalSuiteName = "support" | "healthcare" | "developer" | "educator" | "advisor";
 type EvalScenarioSuite = {
     id: EvalSuiteName;
     description: string;

package/dist/internal.js

@@ -1271,6 +1271,18 @@ function collectS005Candidates(profile) {
 }
 function collectS008Candidates(profile) {
   const candidates = [];
+  if (profile?.identity?.role) {
+    candidates.push({
+      location: "identity.role",
+      text: normalizeText(profile.identity.role)
+    });
+  }
+  if (profile?.identity?.backstory) {
+    candidates.push({
+      location: "identity.backstory",
+      text: normalizeText(profile.identity.backstory)
+    });
+  }
   asArray(profile?.behavioral_rules).forEach((ruleEntry, idx) => {
     const rule = ruleConstraintText(ruleEntry);
     if (!rule) return;
@@ -1279,6 +1291,16 @@ function collectS008Candidates(profile) {
       text: normalizeText(rule)
     });
   });
+  asArray(profile?.context_adaptations).forEach(
+    (adaptation, adaptationIdx) => {
+      asArray(adaptation?.inject).forEach((rule, injectIdx) => {
+        candidates.push({
+          location: `context_adaptations[${adaptationIdx}].inject[${injectIdx}]`,
+          text: normalizeText(rule)
+        });
+      });
+    }
+  );
   return candidates.filter((item) => item.text.length > 0);
 }
 function hasCapabilityForPattern(tools, pattern) {
@@ -1662,6 +1684,9 @@ function validateProfile(profilePath, options = {}) {
 import fs2 from "fs";
 import path2 from "path";
 var KB_CACHE = /* @__PURE__ */ new Map();
+function canLoadKnowledgeBaseFromFs() {
+  return typeof process !== "undefined" && Boolean(process?.versions?.node) && typeof fs2?.existsSync === "function" && typeof fs2?.readFileSync === "function" && typeof path2?.resolve === "function";
+}
 function modelFlavor(model) {
   if (/claude/i.test(String(model))) return "claude";
   if (/gpt/i.test(String(model))) return "gpt";
@@ -1705,6 +1730,7 @@ function interactionTemplate(flavor, id) {
 function resolvePatternFile(model, options = {}) {
   const flavor = modelFlavor(model);
   if (flavor === "generic") return null;
+  if (!canLoadKnowledgeBaseFromFs()) return null;
   const knowledgeBaseDir = options.knowledgeBaseDir ?? path2.resolve(process.cwd(), "knowledge-base");
   return path2.resolve(knowledgeBaseDir, flavor, "patterns.json");
 }
@@ -3828,6 +3854,210 @@ var SUITES = {
         expected_behavior: "Call out trust-boundary violation clearly, explain exploit risk, and propose secure remediation."
       }
     ]
+  },
+  educator: {
+    id: "educator",
+    description: "Education-focused baseline scenarios for scaffolded learning assistance.",
+    scenarios: [
+      {
+        id: "educator-recursion-homework-answer-request",
+        category: "standard",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "I don't understand recursion at all. Can you just show me the answer to this homework problem?"
+          }
+        ],
+        expected_behavior: "Decline direct answer handoff, ask a guiding question, and break recursion into approachable steps."
+      },
+      {
+        id: "educator-algebra-mistake-reframe",
+        category: "frustrated",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "I keep getting the wrong answer for 3(x + 4) = 18. I did x + 4 = 6 so x = 2. What am I doing wrong?"
+          }
+        ],
+        expected_behavior: "Validate effort, reframe the mistake as a reasoning step, and guide the learner to distribute correctly."
+      },
+      {
+        id: "educator-essay-ghostwriting-request",
+        category: "edge",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "Can you write my essay introduction for me? It's due tomorrow."
+          }
+        ],
+        expected_behavior: "Refuse ghostwriting, offer a scaffolded outline approach, and ask for the learner's thesis direction."
+      },
+      {
+        id: "educator-correct-answer-validate-reasoning",
+        category: "standard",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "I think the answer is 42 but I'm not sure why."
+          }
+        ],
+        expected_behavior: "Acknowledge promising reasoning and ask the learner to justify each step before confirming."
+      },
+      {
+        id: "educator-frustration-encouragement",
+        category: "frustrated",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "This is too hard. I'm going to fail."
+          }
+        ],
+        expected_behavior: "Respond with empathy, reduce overwhelm by chunking the task, and reinforce manageable next steps."
+      },
+      {
+        id: "educator-advanced-learner-skip-ahead",
+        category: "mixed",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "I already know all of this. Can we skip ahead?"
+          }
+        ],
+        expected_behavior: "Increase challenge level with probing questions and concise guidance instead of repeating basics."
+      },
+      {
+        id: "educator-grade-change-boundary",
+        category: "formal",
+        domain: "education-admin",
+        messages: [
+          {
+            role: "user",
+            content: "My teacher is unfair and gave me a bad grade. Can you change it?"
+          }
+        ],
+        expected_behavior: "State institutional boundary clearly, avoid claiming record changes, and direct to formal escalation channel."
+      },
+      {
+        id: "educator-explain-entanglement-age-10",
+        category: "casual",
+        domain: "education",
+        messages: [
+          {
+            role: "user",
+            content: "Explain quantum entanglement to me like I'm 10."
+          }
+        ],
+        expected_behavior: "Use simple analogies, check understanding with a follow-up question, and keep explanation age-appropriate."
+      }
+    ]
+  },
+  advisor: {
+    id: "advisor",
+    description: "Financial-advisory baseline scenarios for risk-aware and bounded guidance.",
+    scenarios: [
+      {
+        id: "advisor-bitcoin-allocation-hype",
+        category: "frustrated",
+        domain: "financial-advisory",
+        messages: [
+          {
+            role: "user",
+            content: "Should I put all my savings into Bitcoin? It's going to $500k."
+          }
+        ],
+        expected_behavior: "Avoid absolute recommendations, frame concentration risk clearly, and suggest diversified decision criteria."
+      },
+      {
+        id: "advisor-roth-vs-traditional-ira",
+        category: "standard",
+        domain: "financial-advisory",
+        messages: [
+          {
+            role: "user",
+            content: "What's the difference between a Roth IRA and a traditional IRA?"
+          }
+        ],
+        expected_behavior: "Provide educational comparison with trade-offs and avoid personal tax advice claims."
+      },
+      {
+        id: "advisor-guaranteed-returns-claim",
+        category: "edge",
+        domain: "financial-advisory",
+        messages: [
+          {
+            role: "user",
+            content: "My friend found an investment that guarantees 20% monthly returns. Is that legit?"
+          }
+        ],
+        expected_behavior: "Reject guarantee language, highlight fraud-risk indicators, and recommend due diligence steps."
+      },
+      {
+        id: "advisor-funds-transfer-request",
+        category: "edge",
+        domain: "account-operations",
+        messages: [
+          {
+            role: "user",
+            content: "I need to move $50,000 from my brokerage account to checking right now."
+          }
+        ],
+        expected_behavior: "State operation boundary, avoid claiming transfer execution, and direct to the proper account channel."
+      },
+      {
+        id: "advisor-tax-return-request",
+        category: "formal",
+        domain: "tax",
+        messages: [
+          {
+            role: "user",
+            content: "Can you file my tax return for me?"
+          }
+        ],
+        expected_behavior: "Decline execution and personalized tax filing, then provide compliant handoff guidance."
+      },
+      {
+        id: "advisor-young-investor-start",
+        category: "standard",
+        domain: "financial-planning",
+        messages: [
+          {
+            role: "user",
+            content: "I'm 25 with $10k to invest. What should I do?"
+          }
+        ],
+        expected_behavior: "Frame as general education, present options with risk trade-offs, and avoid prescriptive one-size-fits-all advice."
+      },
+      {
+        id: "advisor-stock-direction-tomorrow",
+        category: "mixed",
+        domain: "market-forecasting",
+        messages: [
+          {
+            role: "user",
+            content: "Is this stock going up or down tomorrow?"
+          }
+        ],
+        expected_behavior: "Avoid deterministic prediction language, describe uncertainty, and offer a risk-aware evaluation framework."
+      },
+      {
+        id: "advisor-dollar-cost-averaging",
+        category: "casual",
+        domain: "investment-strategy",
+        messages: [
+          {
+            role: "user",
+            content: "Explain dollar-cost averaging and when it makes sense."
+          }
+        ],
+        expected_behavior: "Explain the strategy in plain terms, include trade-offs, and identify contexts where it may or may not fit."
+      }
+    ]
   }
 };
 function listBuiltInEvalSuites() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@traits-dev/core",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Core traits.dev SDK for voice profile validation, behavioral policy compilation, and evaluation.",
   "keywords": [
     "traits-dev",