fraim-framework 2.0.171 → 2.0.174

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

@@ -25,8 +25,7 @@ const REPO_LEARNINGS_REL = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPat
 const DEFAULT_THRESHOLD = 3.0;
 const AGING_HORIZON_DAYS = 7;
 const MAX_ENTRIES_SCANNED = 200;
-const BACKLOG_MIN = 5;
-const OLDEST_AGE_DAYS_TRIGGER = 3;
+const L0_SLEEP_ON_LEARNINGS_PROMPT_MIN = 5;
 // ── Single source of truth for the learning-entry format contract (#533) ──────
 // The `## [P-…] <title>` entry format is a tight contract shared by three sides:
 //   1. EMIT — the synthesis jobs (sleep-on-learnings, organizational-learning-
@@ -309,51 +308,49 @@ function isUnsynthesizedRetrospective(filePath) {
         return false;
     }
 }
-/** Oldest mtime-age in days across this user's L0 signals. 0 if none. */
-function computeOldestL0AgeDays(workspaceRoot, userId) {
-    const learningsBase = (0, project_fraim_paths_1.getWorkspaceLearningsDir)(workspaceRoot);
-    const now = Date.now();
-    let oldest = 0;
-    const consider = (filePath) => {
-        try {
-            const st = (0, fs_1.statSync)(filePath);
-            const ageDays = Math.floor((now - st.mtimeMs) / (1000 * 60 * 60 * 24));
-            if (ageDays > oldest)
-                oldest = ageDays;
-        }
-        catch {
-            // ignore
-        }
-    };
-    const rawDir = (0, path_1.join)(learningsBase, 'raw');
-    if ((0, fs_1.existsSync)(rawDir)) {
+function pendingL0SortKey(fileName) {
+    const timestamp = fileName.match(/\d{4}-\d{2}-\d{2}(?:T\d{2}-\d{2}-\d{2})?/);
+    return timestamp?.[0] || fileName;
+}
+function collectPendingL0SourceFiles(workspaceRoot, resolvedUserId, roots) {
+    const sources = [];
+    const rawPath = (0, path_1.join)(roots.repoLearningsBase, 'raw');
+    if ((0, fs_1.existsSync)(rawPath)) {
         try {
-            for (const f of (0, fs_1.readdirSync)(rawDir)) {
-                if (!f.startsWith(`${userId}-`))
+            for (const fileName of (0, fs_1.readdirSync)(rawPath)) {
+                if (!fileName.startsWith(`${resolvedUserId}-`))
                     continue;
-                consider((0, path_1.join)(rawDir, f));
+                sources.push({
+                    kind: 'coaching-moment',
+                    displayPath: `${REPO_LEARNINGS_REL}/raw/${fileName}`,
+                    sortKey: pendingL0SortKey(fileName)
+                });
             }
         }
         catch {
-            // ignore
+            // Ignore read failures.
         }
     }
-    const retroDir = (0, path_1.join)(workspaceRoot, 'docs', 'retrospectives');
-    if ((0, fs_1.existsSync)(retroDir)) {
+    const retrospectivesPath = (0, path_1.join)(workspaceRoot, 'docs', 'retrospectives');
+    if ((0, fs_1.existsSync)(retrospectivesPath)) {
         try {
-            for (const f of (0, fs_1.readdirSync)(retroDir)) {
-                if (!f.startsWith(`${userId}-`) || !f.endsWith('.md'))
+            for (const fileName of (0, fs_1.readdirSync)(retrospectivesPath)) {
+                if (!fileName.startsWith(`${resolvedUserId}-`) || !fileName.endsWith('.md'))
                     continue;
-                if (!isUnsynthesizedRetrospective((0, path_1.join)(retroDir, f)))
+                if (!isUnsynthesizedRetrospective((0, path_1.join)(retrospectivesPath, fileName)))
                     continue;
-                consider((0, path_1.join)(retroDir, f));
+                sources.push({
+                    kind: 'retrospective',
+                    displayPath: `docs/retrospectives/${fileName}`,
+                    sortKey: pendingL0SortKey(fileName)
+                });
             }
         }
         catch {
-            // ignore
+            // Ignore read failures.
         }
     }
-    return oldest;
+    return sources.sort((a, b) => b.sortKey.localeCompare(a.sortKey) || a.displayPath.localeCompare(b.displayPath));
 }
 /**
  * Resolve an L2 org-scope learning file (issue #563): a repo-local override
@@ -395,28 +392,9 @@ function buildLearningContextSection(workspaceRoot, userId, forJob) {
     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;
-    const rawPath = (0, path_1.join)(roots.repoLearningsBase, 'raw');
-    if ((0, fs_1.existsSync)(rawPath)) {
-        try {
-            l0CoachingCount = (0, fs_1.readdirSync)(rawPath).filter(f => f.startsWith(`${resolvedUserId}-`)).length;
-        }
-        catch {
-            // Ignore read failures.
-        }
-    }
-    let l0RetroCount = 0;
-    const retrospectivesPath = (0, path_1.join)(workspaceRoot, 'docs', 'retrospectives');
-    if ((0, fs_1.existsSync)(retrospectivesPath)) {
-        try {
-            l0RetroCount = (0, fs_1.readdirSync)(retrospectivesPath)
-                .filter(f => f.startsWith(`${resolvedUserId}-`) && f.endsWith('.md'))
-                .filter(f => isUnsynthesizedRetrospective((0, path_1.join)(retrospectivesPath, f))).length;
-        }
-        catch {
-            // Ignore read failures.
-        }
-    }
+    const pendingL0Sources = collectPendingL0SourceFiles(workspaceRoot, resolvedUserId, roots);
+    const l0CoachingCount = pendingL0Sources.filter(source => source.kind === 'coaching-moment').length;
+    const l0RetroCount = pendingL0Sources.filter(source => source.kind === 'retrospective').length;
     const hasL2 = l2MistakePresent || l2PrefPresent || l2CoachPresent || l2ValidatedPresent;
     const hasL1 = l1Mistake.present || l1Pref.present || l1Coach.present || l1Validated.present;
     const hasContent = hasL2 || hasL1 || l0CoachingCount > 0 || l0RetroCount > 0;
@@ -458,6 +436,7 @@ function buildLearningContextSection(workspaceRoot, userId, forJob) {
         section += '\n';
     }
     if (l0CoachingCount > 0 || l0RetroCount > 0) {
+        const totalL0 = pendingL0Sources.length;
         section += '### L0 - Your unprocessed signals\n';
         if (l0CoachingCount > 0) {
             section += `${l0CoachingCount} coaching moment${l0CoachingCount !== 1 ? 's' : ''} in \`${REPO_LEARNINGS_REL}/raw/${resolvedUserId}-*\`\n`;
@@ -465,12 +444,16 @@ function buildLearningContextSection(workspaceRoot, userId, forJob) {
         if (l0RetroCount > 0) {
             section += `${l0RetroCount} retrospective${l0RetroCount !== 1 ? 's' : ''} in \`docs/retrospectives/${resolvedUserId}-*\` with unsynthesized or missing \`synthesized\` frontmatter\n`;
         }
+        section += 'Pending L0 Source Files:\n';
+        for (const source of pendingL0Sources) {
+            section += `- \`${source.displayPath}\`\n`;
+        }
+        section += 'Read these pending L0 source files before continuing; they are unsynthesized learnings for the current agent.\n';
+        if (totalL0 >= L0_SLEEP_ON_LEARNINGS_PROMPT_MIN) {
+            section += `This is ${totalL0} pending L0 file${totalL0 !== 1 ? 's' : ''}; to speed up future starts, run \`sleep-on-learnings\` to synthesize or archive them.\n`;
+        }
         section += '\n';
     }
-    const totalL0 = l0CoachingCount + l0RetroCount;
-    const oldestAgeDays = totalL0 > 0 ? computeOldestL0AgeDays(workspaceRoot, resolvedUserId) : 0;
-    const agingRisk = l1MistakeStats?.agingRisk ?? 0;
-    const backlogTriggered = totalL0 >= BACKLOG_MIN || (oldestAgeDays >= OLDEST_AGE_DAYS_TRIGGER && totalL0 > 0);
     if (forJob) {
         if (hasL2 || hasL1) {
             section += 'Use the relevant patterns and preferences in this job.\n';
@@ -478,23 +461,12 @@ function buildLearningContextSection(workspaceRoot, userId, forJob) {
                 section += 'Treat manager-coaching as feedback for how the manager should continue or improve managing AI, not as agent instruction.\n';
             }
         }
-        if (backlogTriggered) {
-            section += '\n';
-            section += `Warning: ${totalL0} unprocessed signals pending. Consider running \`sleep-on-learnings\` before starting today's work.\n`;
-            section += renderBacklogDetail(oldestAgeDays, agingRisk);
-        }
     }
     else {
         section += 'Use this synthesized learning context throughout the session.\n';
         if (l1Coach.present || l2CoachPresent) {
             section += 'Manager-coaching entries are manager-facing feedback, not instructions for the AI to follow.\n';
         }
-        if (backlogTriggered) {
-            section += '\n';
-            section += `Warning: synthesis overdue with ${totalL0} unprocessed signals.\n`;
-            section += 'Run `sleep-on-learnings` before starting today\'s work.\n';
-            section += renderBacklogDetail(oldestAgeDays, agingRisk);
-        }
     }
     return section;
 }
@@ -960,15 +932,3 @@ function isTruthyFlag(value) {
         return false;
     return normalized === 'true' || normalized === 'yes' || normalized === '1';
 }
-function renderBacklogDetail(oldestAgeDays, agingRisk) {
-    if (oldestAgeDays <= 0 && agingRisk <= 0)
-        return '';
-    const parts = [];
-    if (oldestAgeDays > 0)
-        parts.push(`oldest ${oldestAgeDays}d`);
-    parts.push('debrief takes ~3 minutes');
-    if (agingRisk > 0) {
-        parts.push(`${agingRisk} high-score pattern${agingRisk !== 1 ? 's' : ''} aging out within ${AGING_HORIZON_DAYS}d`);
-    }
-    return `Detail: ${parts.join('; ')}.\n`;
-}

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

@@ -570,7 +570,7 @@ class FraimLocalMCPServer {
         while (currentDir !== root) {
             const fraimDir = (0, project_fraim_paths_1.getWorkspaceConfigPath)(currentDir).replace(/[\\/]config\.json$/, '');
             this.log(`   Checking: ${fraimDir}`);
-            if ((0, fs_1.existsSync)(fraimDir)) {
+            if ((0, project_fraim_paths_1.workspaceFraimExists)(currentDir)) {
                 // Skip the home directory FRAIM dir and continue searching for a project-specific one
                 if (homeDir && currentDir === homeDir) {
                     this.log(`Skipping home directory ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)()}, continuing search...`);
@@ -640,8 +640,8 @@ class FraimLocalMCPServer {
             return false;
         }
     }
-    getLocalCatalogMetadataPath(projectRoot) {
-        return (0, path_1.join)((0, project_fraim_paths_1.getWorkspaceFraimDir)(projectRoot), FraimLocalMCPServer.CONNECT_SYNC_METADATA_PATH);
+    getLocalCatalogMetadataPath(_projectRoot) {
+        return (0, path_1.join)((0, project_fraim_paths_1.getUserFraimDirPath)(), FraimLocalMCPServer.CONNECT_SYNC_METADATA_PATH);
     }
     readLocalCatalogMetadata(projectRoot) {
         const metadataPath = this.getLocalCatalogMetadataPath(projectRoot);
@@ -657,6 +657,7 @@ class FraimLocalMCPServer {
     }
     writeLocalCatalogMetadata(projectRoot) {
         const metadataPath = this.getLocalCatalogMetadataPath(projectRoot);
+        (0, fs_1.mkdirSync)((0, project_fraim_paths_1.getUserFraimDirPath)(), { recursive: true });
         const metadata = {
             localVersion: this.localVersion,
             mode: this.shouldUseLocalSyncTarget() ? 'local' : 'remote',
@@ -1838,10 +1839,12 @@ class FraimLocalMCPServer {
             }
             const resolvedRequestStr = requestSubstitution.content;
             const finalRequest = JSON.parse(resolvedRequestStr);
-            const response = await axios_1.default.post(`${this.remoteUrl}/mcp`, finalRequest, {
-                headers,
-                timeout: 30000
-            });
+            const canRetryTransientRemoteReset = request.method === 'initialize' ||
+                request.method === 'tools/list' ||
+                request.method === 'resources/list' ||
+                request.method === 'prompts/list' ||
+                (request.method === 'tools/call' && request.params?.name === 'fraim_connect');
+            const response = await this.postRemoteMcpRequest(finalRequest, headers, requestId, canRetryTransientRemoteReset);
             return response.data;
         }
         catch (error) {
@@ -1884,6 +1887,38 @@ class FraimLocalMCPServer {
             };
         }
     }
+    isTransientRemoteReset(error) {
+        if (error?.response) {
+            return false;
+        }
+        const code = String(error?.code || '');
+        const message = String(error?.message || '');
+        return ['ECONNRESET', 'ETIMEDOUT', 'ECONNABORTED', 'EPIPE', 'socket hang up'].some((needle) => code.includes(needle) || message.includes(needle));
+    }
+    async postRemoteMcpRequest(requestBody, headers, requestId, retryTransientReset) {
+        let lastError;
+        const attempts = retryTransientReset ? 3 : 1;
+        for (let attempt = 1; attempt <= attempts; attempt++) {
+            try {
+                return await axios_1.default.post(`${this.remoteUrl}/mcp`, requestBody, {
+                    headers: {
+                        ...headers,
+                        Connection: 'close'
+                    },
+                    timeout: 30000
+                });
+            }
+            catch (error) {
+                lastError = error;
+                if (!retryTransientReset || !this.isTransientRemoteReset(error) || attempt === attempts) {
+                    throw error;
+                }
+                this.logError(`[req:${requestId}] Remote request reset; retrying (${attempt + 1}/${attempts})`);
+                await new Promise((resolve) => setTimeout(resolve, 250 * attempt));
+            }
+        }
+        throw lastError;
+    }
     /**
      * Try to request workspace roots from MCP client
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.171",
+  "version": "2.0.174",
   "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": {
@@ -16,6 +16,8 @@
     "test-all": "npm run test && npm run test:isolated tests/isolated/test-*.ts && npm run test:ui",
     "test": "node scripts/test-with-server.js",
     "test:isolated": "node scripts/test-isolated.js",
+    "test:evals": "node scripts/evals/run-promptfoo-evals.cjs --suite all",
+    "test:evals:smoke": "node scripts/evals/run-promptfoo-evals.cjs --suite all --tag smoke",
     "test:smoke": "node scripts/test-with-server.js --tags=smoke",
     "test:coverage": "node scripts/test-with-server.js --tags=smoke --coverage",
     "test:stripe": "node scripts/test-with-server.js tests/test-stripe-payment-complete.ts",
@@ -110,6 +112,7 @@
     "node-cron": "^4.2.1",
     "playwright": "^1.58.2",
     "pptxgenjs": "^4.0.1",
+    "promptfoo": "^0.121.17",
     "puppeteer": "^24.36.1",
     "qrcode": "^1.5.4",
     "sharp": "^0.34.5",
@@ -122,6 +125,7 @@
     "dist/src/ai-hub/",
     "dist/src/first-run/",
     "dist/src/core/",
+    "dist/src/config/",
     "bin/fraim.js",
     "bin/fraim-mcp.js",
     "public/ai-hub/",