fraim-framework 2.0.166 → 2.0.168

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

@@ -47,10 +47,12 @@ function getLearningRoots(workspaceRoot) {
     return {
         globalPersonalBase: (0, project_fraim_paths_1.getConfiguredPortableLearningsDir)(workspaceRoot),
         globalPersonalDisplayBase: (0, project_fraim_paths_1.getConfiguredPortableLearningsDisplayPath)(workspaceRoot),
+        managerCacheBase: (0, path_1.join)((0, project_fraim_paths_1.getUserFraimDirPath)(), 'manager', 'learnings'),
+        managerCacheDisplayBase: (0, project_fraim_paths_1.getUserFraimDisplayPath)('manager/learnings'),
         repoLearningsBase: (0, project_fraim_paths_1.getWorkspaceLearningsDir)(workspaceRoot)
     };
 }
-function resolvePersonalLearningFile(repoBase, globalBase, globalDisplayBase, fileName) {
+function resolvePersonalLearningFile(repoBase, managerCacheBase, managerCacheDisplayBase, globalBase, globalDisplayBase, fileName) {
     const repoPath = (0, path_1.join)(repoBase, fileName);
     if ((0, fs_1.existsSync)(repoPath)) {
         return {
@@ -67,6 +69,14 @@ function resolvePersonalLearningFile(repoBase, globalBase, globalDisplayBase, fi
             displayPath: `${globalDisplayBase.replace(/\/$/, '')}/${fileName}`
         };
     }
+    const managerCachePath = (0, path_1.join)(managerCacheBase, fileName);
+    if ((0, fs_1.existsSync)(managerCachePath)) {
+        return {
+            present: true,
+            path: managerCachePath,
+            displayPath: `${managerCacheDisplayBase.replace(/\/$/, '')}/${fileName}`
+        };
+    }
     return { present: false, path: globalPath, displayPath: `${globalDisplayBase.replace(/\/$/, '')}/${fileName}` };
 }
 function buildUserIdCandidates(userId) {
@@ -132,6 +142,10 @@ function resolveLearningUserId(workspaceRoot, userId, roots) {
             ((0, fs_1.existsSync)((0, path_1.join)(roots.globalPersonalBase, `${candidate}-manager-coaching.md`)) ? 1 : 0) +
             ((0, fs_1.existsSync)((0, path_1.join)(roots.globalPersonalBase, `${candidate}-mistake-patterns.md`)) ? 1 : 0) +
             ((0, fs_1.existsSync)((0, path_1.join)(roots.globalPersonalBase, `${candidate}-validated-patterns.md`)) ? 1 : 0) +
+            ((0, fs_1.existsSync)((0, path_1.join)(roots.managerCacheBase, `${candidate}-preferences.md`)) ? 1 : 0) +
+            ((0, fs_1.existsSync)((0, path_1.join)(roots.managerCacheBase, `${candidate}-manager-coaching.md`)) ? 1 : 0) +
+            ((0, fs_1.existsSync)((0, path_1.join)(roots.managerCacheBase, `${candidate}-mistake-patterns.md`)) ? 1 : 0) +
+            ((0, fs_1.existsSync)((0, path_1.join)(roots.managerCacheBase, `${candidate}-validated-patterns.md`)) ? 1 : 0) +
             ((0, fs_1.existsSync)((0, path_1.join)(roots.repoLearningsBase, `${candidate}-preferences.md`)) ? 1 : 0) +
             ((0, fs_1.existsSync)((0, path_1.join)(roots.repoLearningsBase, `${candidate}-manager-coaching.md`)) ? 1 : 0) +
             ((0, fs_1.existsSync)((0, path_1.join)(roots.repoLearningsBase, `${candidate}-mistake-patterns.md`)) ? 1 : 0) +
@@ -145,7 +159,7 @@ function resolveLearningUserId(workspaceRoot, userId, roots) {
     }
     if (bestScore > 0)
         return bestCandidate;
-    const availablePrefixes = collectAvailableUserPrefixes(workspaceRoot, [roots.repoLearningsBase, roots.globalPersonalBase]);
+    const availablePrefixes = collectAvailableUserPrefixes(workspaceRoot, [roots.repoLearningsBase, roots.managerCacheBase, roots.globalPersonalBase]);
     if (availablePrefixes.size === 1) {
         return Array.from(availablePrefixes)[0];
     }
@@ -375,10 +389,10 @@ function buildLearningContextSection(workspaceRoot, userId, forJob) {
     const l2ValidatedPresent = l2Validated.present;
     const l2MistakeStats = l2MistakePresent ? scanMistakePatternFile(l2Mistake.path, threshold, 'mistake-patterns') : null;
     const l2ValidatedStats = l2ValidatedPresent ? scanMistakePatternFile(l2Validated.path, threshold, 'validated-patterns') : null;
-    const l1Mistake = resolvePersonalLearningFile(roots.repoLearningsBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, `${resolvedUserId}-mistake-patterns.md`);
-    const l1Pref = resolvePersonalLearningFile(roots.repoLearningsBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, `${resolvedUserId}-preferences.md`);
-    const l1Coach = resolvePersonalLearningFile(roots.repoLearningsBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, `${resolvedUserId}-manager-coaching.md`);
-    const l1Validated = resolvePersonalLearningFile(roots.repoLearningsBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, `${resolvedUserId}-validated-patterns.md`);
+    const l1Mistake = resolvePersonalLearningFile(roots.repoLearningsBase, roots.managerCacheBase, roots.managerCacheDisplayBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, `${resolvedUserId}-mistake-patterns.md`);
+    const l1Pref = resolvePersonalLearningFile(roots.repoLearningsBase, roots.managerCacheBase, roots.managerCacheDisplayBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, `${resolvedUserId}-preferences.md`);
+    const l1Coach = resolvePersonalLearningFile(roots.repoLearningsBase, roots.managerCacheBase, roots.managerCacheDisplayBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, `${resolvedUserId}-manager-coaching.md`);
+    const l1Validated = resolvePersonalLearningFile(roots.repoLearningsBase, roots.managerCacheBase, roots.managerCacheDisplayBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, `${resolvedUserId}-validated-patterns.md`);
     const l1MistakeStats = l1Mistake.present ? scanMistakePatternFile(l1Mistake.path, threshold, 'mistake-patterns') : null;
     const l1ValidatedStats = l1Validated.present ? scanMistakePatternFile(l1Validated.path, threshold, 'validated-patterns') : null;
     let l0CoachingCount = 0;
@@ -509,6 +523,15 @@ function resolveOrgContextFile(workspaceRoot, relativePath, orgCacheEligible = t
                 };
             }
         }
+        if (!orgCacheEligible) {
+            const managerCachePath = (0, path_1.join)((0, project_fraim_paths_1.getUserFraimDirPath)(), 'manager', relativePath);
+            if ((0, fs_1.existsSync)(managerCachePath)) {
+                return {
+                    present: true,
+                    displayPath: (0, project_fraim_paths_1.getUserFraimDisplayPath)(`manager/${relativePath}`)
+                };
+            }
+        }
         const userPath = (0, path_1.join)((0, project_fraim_paths_1.getUserFraimDirPath)(), 'personalized-employee', relativePath);
         if ((0, fs_1.existsSync)(userPath)) {
             return {
@@ -675,6 +698,19 @@ function resolveTeamContextFile(workspaceRoot, key) {
             };
         }
     }
+    if (key === 'manager' || key === 'managerRules') {
+        const managerCachePath = (0, path_1.join)((0, project_fraim_paths_1.getUserFraimDirPath)(), 'manager', relativePath);
+        if ((0, fs_1.existsSync)(managerCachePath)) {
+            return {
+                present: true,
+                readPath: managerCachePath,
+                writePath: '',
+                displayPath: (0, project_fraim_paths_1.getUserFraimDisplayPath)(`manager/${relativePath}`),
+                scope,
+                managedByManagerSync: true
+            };
+        }
+    }
     const userPath = (0, path_1.join)((0, project_fraim_paths_1.getUserFraimDirPath)(), 'personalized-employee', relativePath);
     const userDisplay = (0, project_fraim_paths_1.getUserFraimDisplayPath)(`personalized-employee/${relativePath}`);
     return {
@@ -728,7 +764,7 @@ function countPreservedLearnings(workspaceRoot, userId) {
         countLearningEntries(resolveOrgLearningFile(roots.repoLearningsBase, 'org-preferences.md').path) +
         countLearningEntries(resolveOrgLearningFile(roots.repoLearningsBase, 'org-manager-coaching.md').path) +
         countLearningEntries(resolveOrgLearningFile(roots.repoLearningsBase, 'org-validated-patterns.md').path);
-    const resolve = (fileName) => resolvePersonalLearningFile(roots.repoLearningsBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, fileName);
+    const resolve = (fileName) => resolvePersonalLearningFile(roots.repoLearningsBase, roots.managerCacheBase, roots.managerCacheDisplayBase, roots.globalPersonalBase, roots.globalPersonalDisplayBase, fileName);
     // L1 manager-facing reverse-mentoring file.
     const manager = countLearningEntries(resolve(`${resolvedUserId}-manager-coaching.md`).path);
     // L1 personal work patterns (project scope).
@@ -818,8 +854,9 @@ function parseLearningEntries(filePath, displayPath, category, level) {
     return out;
 }
 function levelDir(roots, level) {
-    if (level === 'machine')
+    if (level === 'machine') {
         return { dir: roots.globalPersonalBase, displayBase: roots.globalPersonalDisplayBase.replace(/\/$/, '') };
+    }
     return { dir: roots.repoLearningsBase, displayBase: REPO_LEARNINGS_REL };
 }
 function readPreservedLearnings(workspaceRoot, userId, scope, level = 'machine') {

package/dist/src/local-mcp-server/stdio-server.js

@@ -416,6 +416,7 @@ class FraimLocalMCPServer {
         this.connectSyncInFlight = null;
         this.latestConnectSyncWarning = null;
         this.orgCacheRefreshInFlight = false;
+        this.managerCacheRefreshInFlight = false;
         this.writer = writer || process.stdout.write.bind(process.stdout);
         this.remoteUrl = process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
         this.apiKey = this.loadApiKey();
@@ -750,6 +751,7 @@ class FraimLocalMCPServer {
             this.connectSyncInFlight = null;
         }
         this.maybeRefreshOrgCache(String(requestId));
+        this.maybeRefreshManagerCache(String(requestId));
     }
     /**
      * Issue #563 (R4.2): opportunistically refresh the managed org cache
@@ -779,6 +781,32 @@ class FraimLocalMCPServer {
             this.orgCacheRefreshInFlight = false;
         });
     }
+    /**
+     * Issue #580: opportunistically refresh the managed manager cache
+     * (~/.fraim/manager/) at session bootstrap when it is missing or older than
+     * 24 hours. Fire-and-forget; a failed refresh leaves existing cache available.
+     */
+    maybeRefreshManagerCache(requestId) {
+        if (this.managerCacheRefreshInFlight)
+            return;
+        this.managerCacheRefreshInFlight = true;
+        void Promise.resolve().then(() => __importStar(require('../cli/utils/manager-pack-sync'))).then(async ({ getManagerCacheAgeHours, syncManagerCache }) => {
+            const ageHours = getManagerCacheAgeHours();
+            if (ageHours !== null && ageHours < 24)
+                return;
+            const outcome = await syncManagerCache();
+            if (outcome.status !== 'disabled') {
+                const version = outcome.metadata ? ` (version ${outcome.metadata.version.slice(0, 12)})` : '';
+                this.log(`[req:${requestId}] Manager cache refresh at connect: ${outcome.status}${version}`);
+            }
+        })
+            .catch((error) => {
+            this.logError(`[req:${requestId}] Manager cache refresh failed: ${error?.message || error}`);
+        })
+            .finally(() => {
+            this.managerCacheRefreshInFlight = false;
+        });
+    }
     /**
      * Automatically detect machine information
      */

package/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM Framework - Smart Entry Point

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.166",
+  "version": "2.0.168",
   "description": "FRAIM: AI Workforce Infrastructure — the organizational capability that turns AI agents into an accountable workforce, their operators into capable AI managers, and executives into leaders with clear optics on AI proficiency.",
   "main": "index.js",
   "bin": {
@@ -100,12 +100,14 @@
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/node": "^20.0.0",
+    "@types/node-cron": "^3.0.11",
     "@types/node-fetch": "^2.6.13",
     "@types/prompts": "^2.4.9",
     "@types/semver": "^7.7.1",
     "fast-glob": "^3.3.3",
     "markdown-it": "^14.1.1",
     "markdown-it-highlightjs": "^4.3.0",
+    "node-cron": "^4.2.1",
     "playwright": "^1.58.2",
     "pptxgenjs": "^4.0.1",
     "puppeteer": "^24.36.1",
@@ -124,6 +126,7 @@
     "bin/fraim-mcp.js",
     "public/ai-hub/",
     "public/first-run/",
+    "public/portfolio/",
     "index.js",
     "README.md",
     "CHANGELOG.md",