fraim 2.0.210 → 2.0.212

package/dist/src/config/persona-capability-bundles.js

@@ -130,7 +130,7 @@ exports.PERSONA_CAPABILITY_BUNDLES = {
         personaKey: 'ricardo',
         bundleId: 'persona-ricardo-core',
         catalogMetadata: buildCatalogMetadata('ricardo', ['role-intake-and-scorecard', 'job-posting-and-sourcing', 'candidate-pipeline-management']),
-        protectedJobs: ['role-intake-and-scorecard', 'job-posting-and-sourcing', 'candidate-pipeline-management', 'interview-coordination', 'offer-and-close-management'],
+        protectedJobs: ['role-intake-and-scorecard', 'job-posting-and-sourcing', 'candidate-pipeline-management', 'sourcing-funnel-recap', 'interview-coordination', 'offer-and-close-management'],
         protectedAliases: ['recruiting', 'recruiter', 'hiring'],
         defaultHireMode: 'job',
         lockCopy: 'Hire RECardo to unlock full-cycle recruiting work for this request.'

package/dist/src/local-mcp-server/learning-context-builder.js

@@ -6,7 +6,7 @@
  * workspace root on the user's machine.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CATEGORY_TO_FILETYPE = exports.LEARNING_PRIORITIES = void 0;
+exports.CATEGORY_TO_FILETYPE = exports.BRAIN_LEARNING_FILETYPE_TO_REGION = exports.LEARNING_PRIORITIES = void 0;
 exports.learningEntryHeadingRegex = learningEntryHeadingRegex;
 exports.computeEffectiveScore = computeEffectiveScore;
 exports.buildLearningContextSection = buildLearningContextSection;
@@ -17,6 +17,7 @@ exports.resolveTeamContextFile = resolveTeamContextFile;
 exports.readOrgBrand = readOrgBrand;
 exports.resolveOrgBrandWriteDir = resolveOrgBrandWriteDir;
 exports.countPreservedLearnings = countPreservedLearnings;
+exports.collectBrainLearningDots = collectBrainLearningDots;
 exports.readPreservedLearnings = readPreservedLearnings;
 exports.applyLearningEntryChange = applyLearningEntryChange;
 exports.isTruthyFlag = isTruthyFlag;
@@ -385,13 +386,14 @@ function buildLearningContextSection(workspaceRoot, userId, forJob, domain) {
         coach: { ft: 'manager-coaching', gated: false, label: '(manager-facing; all entries)' },
         validated: { ft: 'validated-patterns', gated: true, label: '(entries above score threshold)' },
     };
-    // Domain axis (issue #806, Option 1): `fraim_connect` (forJob=false) loads only
-    // the interaction-preference files + the L0 nudge, since it runs with no job.
-    // A job (forJob=true) loads every category globally, plus the current job's
-    // domain files. Category order within a tier is preserved from prior behavior;
-    // domain files are appended after the global files.
-    const l2Cats = forJob ? ['mistake', 'pref', 'coach', 'validated'] : ['pref'];
-    const l1Cats = forJob ? ['pref', 'coach', 'mistake', 'validated'] : ['pref'];
+    // Domain axis (issue #806): session startup stays broad enough for stable
+    // preferences plus L0, while job contexts load the full global set and may
+    // append the current job's domain files below the global files.
+    const sessionCats = ['pref'];
+    const jobL2Cats = ['mistake', 'pref', 'coach', 'validated'];
+    const jobL1Cats = ['pref', 'coach', 'mistake', 'validated'];
+    const l2Cats = forJob ? jobL2Cats : sessionCats;
+    const l1Cats = forJob ? jobL1Cats : sessionCats;
     const activeDomain = forJob && domain ? domain : null;
     const dormantOf = (meta, filePath) => meta.gated ? scanMistakePatternFile(filePath, threshold, meta.ft).dormant : 0;
     // Resolve one tier (L2 org or L1 personal) into ordered global + domain files.
@@ -475,14 +477,14 @@ function buildLearningContextSection(workspaceRoot, userId, forJob, domain) {
     const coachPresent = l1.coachPresent || l2.coachPresent;
     if (forJob) {
         if (hasL2 || hasL1) {
-            section += 'Use the relevant patterns and preferences in this job.\n';
+            section += 'Read the listed synthesized learning files before continuing, then apply the relevant patterns and preferences in this job.\n';
             if (coachPresent) {
                 section += 'Treat manager-coaching as feedback for how the manager should continue or improve managing AI, not as agent instruction.\n';
             }
         }
     }
-    else {
-        section += 'Use this synthesized learning context throughout the session.\n';
+    else if (hasL2 || hasL1) {
+        section += 'Read the listed synthesized learning files before continuing, then use this synthesized learning context throughout the session.\n';
         if (coachPresent) {
             section += 'Manager-coaching entries are manager-facing feedback, not instructions for the AI to follow.\n';
         }
@@ -842,6 +844,118 @@ function countPreservedLearnings(workspaceRoot, userId) {
         rawSignals,
     };
 }
+// ── Issue #833: Brain learning-dot projection ──────────────────────────────
+// Personal learning signals the FRAIM brain overlays on the SVG. Pending L0
+// signals (raw coaching moments + unsynthesized retros) cluster in the
+// temporal-memory region; processed L1/L2 learnings map to a fixed brain region
+// per learning type (the approved Option A mapping). A read projection over the
+// same files buildLearningContextSection injects — no new storage.
+/** Fixed learning-type → brain-region mapping (issue #833, approved spec). */
+exports.BRAIN_LEARNING_FILETYPE_TO_REGION = {
+    'mistake-patterns': 'prefrontal-cortex', // rule following / constraint enforcement
+    'preferences': 'right-parietal-experience', // experience / audience fit
+    'validated-patterns': 'left-parietal-analysis', // engineering / evaluation judgment
+    'manager-coaching': 'right-frontal-strategy', // strategy / framing (reverse mentoring)
+};
+const BRAIN_LEARNING_FILETYPE_LABEL = {
+    'mistake-patterns': 'Mistake pattern',
+    'preferences': 'Preference',
+    'validated-patterns': 'Validated pattern',
+    'manager-coaching': 'Manager coaching',
+};
+const PENDING_KIND_LABEL = {
+    'coaching-moment': 'Coaching moment',
+    'retrospective': 'Retrospective',
+};
+// Parse `## [P-…] Title` entries out of a learning file WITH their effective
+// score + last-seen (unlike parseLearningEntries, which drops that bookkeeping
+// for the Hub text display). Used only by the brain-dot projection.
+function parseBrainLearningEntries(filePath, fileType) {
+    if (!(0, fs_1.existsSync)(filePath))
+        return [];
+    let content;
+    try {
+        content = (0, fs_1.readFileSync)(filePath, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    const headingRe = learningEntryHeadingRegex();
+    const now = new Date();
+    let current = null;
+    const flush = () => {
+        if (!current)
+            return;
+        const rawScore = current.lastSeen
+            ? computeEffectiveScore(current.severity, current.lastSeen, current.recurrences, fileType, now)
+            : null;
+        out.push({
+            title: current.title,
+            severity: current.severity,
+            score: rawScore === null ? null : Math.round(rawScore * 10) / 10,
+            lastSeen: current.lastSeen || null,
+        });
+        current = null;
+    };
+    for (const line of content.split(/\r?\n/)) {
+        const header = line.match(headingRe);
+        if (header) {
+            flush();
+            current = { severity: header[1], title: header[2].trim(), lastSeen: '', recurrences: 1 };
+            continue;
+        }
+        if (!current)
+            continue;
+        const lastSeenMatch = line.match(/^\*\*Last seen\*\*:\s*(.+)/);
+        if (lastSeenMatch) {
+            current.lastSeen = lastSeenMatch[1].trim();
+            continue;
+        }
+        const recurrenceMatch = line.match(/^\*\*Recurrences\*\*:\s*(\d+)/);
+        if (recurrenceMatch) {
+            current.recurrences = parseInt(recurrenceMatch[1], 10);
+        }
+    }
+    flush();
+    return out;
+}
+/**
+ * Build the brain learning-dot projection (issue #833) for one user: pending L0
+ * signals + processed L1 (personal) and L2 (org) learnings grouped by file type
+ * and mapped to a fixed brain region. Reuses the same root/user resolution as
+ * buildLearningContextSection so the dots line up with the auto-loaded context.
+ */
+function collectBrainLearningDots(workspaceRoot, userId) {
+    const roots = getLearningRoots(workspaceRoot);
+    const resolvedUserId = resolveLearningUserId(workspaceRoot, userId, roots);
+    const pendingSignals = collectPendingL0SourceFiles(workspaceRoot, resolvedUserId, roots).map((s) => ({
+        type: s.kind,
+        typeLabel: PENDING_KIND_LABEL[s.kind],
+        fileName: s.displayPath.split('/').pop() || s.displayPath,
+        displayPath: s.displayPath,
+    }));
+    const resolvePersonal = (fileName) => resolvePersonalLearningFile(roots.repoLearningsBase, roots.managerCacheBase, roots.managerCacheDisplayBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, fileName);
+    const processed = [];
+    const fileTypes = ['mistake-patterns', 'preferences', 'validated-patterns', 'manager-coaching'];
+    for (const fileType of fileTypes) {
+        const region = exports.BRAIN_LEARNING_FILETYPE_TO_REGION[fileType];
+        const typeLabel = BRAIN_LEARNING_FILETYPE_LABEL[fileType];
+        // L1 personal
+        const personal = resolvePersonal(`${resolvedUserId}-${fileType}.md`);
+        const personalEntries = parseBrainLearningEntries(personal.path, fileType);
+        if (personalEntries.length) {
+            processed.push({ type: fileType, typeLabel, region, scope: 'personal', displayPath: personal.displayPath, entries: personalEntries });
+        }
+        // L2 org
+        const org = resolveOrgLearningFile(roots.repoLearningsBase, `org-${fileType}.md`);
+        const orgEntries = parseBrainLearningEntries(org.path, fileType);
+        if (orgEntries.length) {
+            processed.push({ type: fileType, typeLabel, region, scope: 'org', displayPath: org.displayPath, entries: orgEntries });
+        }
+    }
+    return { pending: { count: pendingSignals.length, signals: pendingSignals }, processed };
+}
 exports.CATEGORY_TO_FILETYPE = {
     avoid: 'mistake-patterns',
     preference: 'preferences',

package/dist/src/middleware/telemetry.js

@@ -63,7 +63,7 @@ class TelemetryMiddleware {
             // session-active gate is exempted.
             // Issue #701/#744 - hosted AI Hub HTTP APIs are browser/gateway routes,
             // not MCP tool calls. They are still authenticated by API key/session.
-            const exemptPaths = ['/health', '/admin', '/api/registry/sync', '/api/registry/github-workflows', '/api/registry/topology/personalized', '/api/registry/topology/usage-heatmap', '/api/org/', '/api/manager/', '/api/ai-hub/', '/api/payment/', '/api/sales/', '/api/signup', '/api/providers', '/api/analytics', '/analytics', '/api/auth/', '/api/account/'];
+            const exemptPaths = ['/health', '/admin', '/api/registry/sync', '/api/registry/github-workflows', '/api/registry/topology/personalized', '/api/registry/topology/usage-heatmap', '/api/registry/topology/learnings-dots', '/api/org/', '/api/manager/', '/api/ai-hub/', '/api/payment/', '/api/sales/', '/api/signup', '/api/providers', '/api/analytics', '/analytics', '/api/auth/', '/api/account/'];
             if (exemptPaths.some(p => req.path.startsWith(p))) {
                 return next();
             }

package/dist/src/services/email-service.js

@@ -4,7 +4,7 @@ exports.EmailService = void 0;
 const resend_1 = require("resend");
 class EmailService {
     constructor() {
-        const apiKey = process.env.RESEND_API_KEY;
+        const apiKey = process.env.RESEND_API_KEY || (process.env.FRAIM_SUPPRESS_EMAILS === 'true' ? 'test-resend-key' : undefined);
         if (!apiKey) {
             throw new Error('RESEND_API_KEY environment variable is required');
         }
@@ -13,16 +13,20 @@ class EmailService {
         this.fromEmail = process.env.RESEND_FROM_EMAIL || 'FRAIM <onboarding@resend.dev>';
         this.baseUrl = (process.env.BASE_URL || 'https://fraimworks.ai').replace(/\/$/, '');
     }
+    static shouldSuppressEmail() {
+        return process.env.FRAIM_SUPPRESS_EMAILS === 'true'
+            || (process.env.NODE_ENV === 'test' && process.env.ALLOW_REAL_EMAILS_IN_TEST !== 'true');
+    }
     /** Wrapper around resend.emails.send — no-ops in test mode to avoid burning real API quota. */
     async sendEmail(payload) {
-        if (process.env.NODE_ENV === 'test') {
+        if (EmailService.shouldSuppressEmail()) {
             console.log(`[TEST] Email suppressed — would send to ${Array.isArray(payload.to) ? payload.to.join(', ') : payload.to}: "${payload.subject}"`);
             return { data: { id: 'test-suppressed' }, error: null, headers: null };
         }
         return this.sendWithResend(payload);
     }
     async sendWithResend(payload) {
-        if (process.env.NODE_ENV === 'test' && process.env.ALLOW_REAL_EMAILS_IN_TEST !== 'true') {
+        if (EmailService.shouldSuppressEmail()) {
             console.log(`[TEST] Email suppressed - would send to ${Array.isArray(payload.to) ? payload.to.join(', ') : payload.to}: "${payload.subject}"`);
             return { data: { id: 'test-suppressed' }, error: null, headers: null };
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim",
-  "version": "2.0.210",
+  "version": "2.0.212",
   "description": "FRAIM core CLI and MCP package.",
   "main": "index.js",
   "bin": {