fraim-framework 2.0.119 → 2.0.120

package/dist/src/core/quality-evidence.js

@@ -38,6 +38,7 @@ exports.QUALITY_REGISTRY = {
     // Business Strategy
     'review-business-strategy': { stage: 'business-strategy', enforced: true },
     'business-plan-creation': { stage: 'business-strategy', enforced: false },
+    'branding-quality-audit': { stage: 'branding', enforced: true },
     // Product Quality
     'code-quality-assessment': { stage: 'product-quality', enforced: true },
     // Test Quality
@@ -63,6 +64,7 @@ exports.STAGE_CATEGORY_MAP = Object.keys(exports.QUALITY_REGISTRY).reduce((acc,
 exports.STAGE_DISPLAY_NAMES = {
     'customer-development': 'Customer Development',
     'business-strategy': 'Business Strategy',
+    'branding': 'Branding',
     'product-quality': 'Product Quality',
     'test-quality': 'Test Quality',
     'fundraising': 'Fundraising',
@@ -74,6 +76,7 @@ exports.STAGE_DISPLAY_NAMES = {
 exports.ALL_STAGE_CATEGORIES = [
     'customer-development',
     'business-strategy',
+    'branding',
     'product-quality',
     'test-quality',
     'fundraising',

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

@@ -6,37 +6,130 @@
  * workspace root on the user's machine.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeEffectiveScore = computeEffectiveScore;
 exports.buildLearningContextSection = buildLearningContextSection;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const project_fraim_paths_1 = require("../core/utils/project-fraim-paths");
 const LEARNINGS_REL = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('personalized-employee/learnings').replace(/\/$/, '');
 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;
 function getLearningsBase(workspaceRoot) {
     return (0, path_1.join)(workspaceRoot, LEARNINGS_REL);
 }
-function getScoreThreshold(workspaceRoot) {
+function buildUserIdCandidates(userId) {
+    const candidates = new Set();
+    const trimmed = userId.trim();
+    if (trimmed)
+        candidates.add(trimmed);
+    const atIndex = trimmed.indexOf('@');
+    if (atIndex > 0)
+        candidates.add(trimmed.slice(0, atIndex));
+    return Array.from(candidates);
+}
+function countMatchingFilesByPrefix(dirPath, matcher) {
+    if (!(0, fs_1.existsSync)(dirPath))
+        return 0;
+    try {
+        return (0, fs_1.readdirSync)(dirPath).filter(matcher).length;
+    }
+    catch {
+        return 0;
+    }
+}
+function collectAvailableUserPrefixes(workspaceRoot, learningsBase) {
+    const prefixes = new Set();
+    const collect = (dirPath, extractor) => {
+        if (!(0, fs_1.existsSync)(dirPath))
+            return;
+        try {
+            for (const fileName of (0, fs_1.readdirSync)(dirPath)) {
+                const prefix = extractor(fileName);
+                if (prefix)
+                    prefixes.add(prefix);
+            }
+        }
+        catch {
+            // Ignore unreadable directories.
+        }
+    };
+    collect(learningsBase, (fileName) => {
+        if (!fileName.endsWith('.md') || fileName.startsWith('org-'))
+            return null;
+        const match = fileName.match(/^(.*?)-(preferences|manager-coaching|mistake-patterns)\.md$/);
+        return match ? match[1] : null;
+    });
+    collect((0, path_1.join)(learningsBase, 'raw'), (fileName) => {
+        const match = fileName.match(/^(.*?)-\d{4}-\d{2}-\d{2}-.*\.md$/);
+        return match ? match[1] : null;
+    });
+    collect((0, path_1.join)(workspaceRoot, 'docs', 'retrospectives'), (fileName) => {
+        const match = fileName.match(/^(.*?)-\d{4}-\d{2}-\d{2}-.*\.md$/);
+        return match ? match[1] : null;
+    });
+    return prefixes;
+}
+function resolveLearningUserId(workspaceRoot, userId) {
+    const learningsBase = getLearningsBase(workspaceRoot);
+    const candidates = buildUserIdCandidates(userId);
+    let bestCandidate = candidates[0] || userId;
+    let bestScore = -1;
+    for (const candidate of candidates) {
+        const score = ((0, fs_1.existsSync)((0, path_1.join)(learningsBase, `${candidate}-preferences.md`)) ? 1 : 0) +
+            ((0, fs_1.existsSync)((0, path_1.join)(learningsBase, `${candidate}-manager-coaching.md`)) ? 1 : 0) +
+            ((0, fs_1.existsSync)((0, path_1.join)(learningsBase, `${candidate}-mistake-patterns.md`)) ? 1 : 0) +
+            countMatchingFilesByPrefix((0, path_1.join)(learningsBase, 'raw'), (fileName) => fileName.startsWith(`${candidate}-`)) +
+            countMatchingFilesByPrefix((0, path_1.join)(workspaceRoot, 'docs', 'retrospectives'), (fileName) => fileName.startsWith(`${candidate}-`) && fileName.endsWith('.md'));
+        if (score > bestScore) {
+            bestCandidate = candidate;
+            bestScore = score;
+        }
+    }
+    if (bestScore > 0)
+        return bestCandidate;
+    const availablePrefixes = collectAvailableUserPrefixes(workspaceRoot, learningsBase);
+    if (availablePrefixes.size === 1) {
+        return Array.from(availablePrefixes)[0];
+    }
+    return bestCandidate;
+}
+function readWorkspaceConfig(workspaceRoot) {
     try {
         const configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(workspaceRoot);
         if ((0, fs_1.existsSync)(configPath)) {
-            const config = JSON.parse((0, fs_1.readFileSync)(configPath, 'utf8'));
-            const t = config?.learning?.scoreThreshold;
-            if (typeof t === 'number' && t > 0)
-                return t;
+            return JSON.parse((0, fs_1.readFileSync)(configPath, 'utf8'));
         }
     }
     catch {
-        // Fall through to default.
+        // Fall through.
     }
+    return null;
+}
+function getScoreThreshold(workspaceRoot) {
+    const config = readWorkspaceConfig(workspaceRoot);
+    const t = config?.learning?.scoreThreshold;
+    if (typeof t === 'number' && t > 0)
+        return t;
     return DEFAULT_THRESHOLD;
 }
-function computeEffectiveScore(severity, lastSeenDate, recurrences, fileType) {
+/**
+ * Effective score for an L1 learning entry. The aging-risk count below uses
+ * this same decay model with `now` shifted forward.
+ *
+ * @param now Optional override for "now" (for forward-looking aging-risk
+ *            calculations). Defaults to the current wall clock.
+ */
+function computeEffectiveScore(severity, lastSeenDate, recurrences, fileType, now = new Date()) {
     const baseScore = severity === 'P-HIGH' ? 8 : severity === 'P-MED' ? 5 : 3;
+    // Mistake patterns decay faster (90d) — they're tied to environments that change.
+    // Preferences, manager-coaching, and validated-patterns express durable judgment (180d half-life).
     const halfLife = fileType === 'mistake-patterns' ? 90 : 180;
     let daysSinceLastSeen = 0;
     try {
         const lastSeen = new Date(lastSeenDate);
-        const now = new Date();
         daysSinceLastSeen = Math.max(0, (now.getTime() - lastSeen.getTime()) / (1000 * 60 * 60 * 24));
     }
     catch {
@@ -46,55 +139,71 @@ function computeEffectiveScore(severity, lastSeenDate, recurrences, fileType) {
     const recurrenceBoost = Math.log2(Math.max(1, recurrences) + 1);
     return baseScore * decay * recurrenceBoost;
 }
-function countMistakePatternEntries(filePath, threshold) {
+function scanMistakePatternFile(filePath, threshold, fileType = 'mistake-patterns') {
+    const empty = { active: 0, dormant: 0, agingRisk: 0 };
     if (!(0, fs_1.existsSync)(filePath))
-        return { active: 0, dormant: 0 };
+        return empty;
+    let content;
     try {
-        const content = (0, fs_1.readFileSync)(filePath, 'utf8');
-        const lines = content.split('\n');
-        let active = 0;
-        let dormant = 0;
-        let inEntry = false;
-        let currentSeverity = null;
-        let currentLastSeen = '';
-        let currentRecurrences = 1;
-        const processCurrentEntry = () => {
-            if (!currentSeverity)
-                return;
-            const score = computeEffectiveScore(currentSeverity, currentLastSeen, currentRecurrences, 'mistake-patterns');
-            if (score >= threshold)
-                active++;
-            else
-                dormant++;
-        };
-        for (const line of lines) {
-            const headerMatch = line.match(/^## \[(P-HIGH|P-MED|P-LOW)\]/);
-            if (headerMatch) {
-                processCurrentEntry();
-                inEntry = true;
-                currentSeverity = headerMatch[1];
-                currentLastSeen = '';
-                currentRecurrences = 1;
-                continue;
-            }
-            if (!inEntry)
-                continue;
-            const lastSeenMatch = line.match(/^\*\*Last seen\*\*:\s*(.+)/);
-            if (lastSeenMatch) {
-                currentLastSeen = lastSeenMatch[1].trim();
-                continue;
-            }
-            const recurrenceMatch = line.match(/^\*\*Recurrences\*\*:\s*(\d+)/);
-            if (recurrenceMatch) {
-                currentRecurrences = parseInt(recurrenceMatch[1], 10);
-            }
-        }
-        processCurrentEntry();
-        return { active, dormant };
+        content = (0, fs_1.readFileSync)(filePath, 'utf8');
     }
     catch {
-        return { active: 0, dormant: 0 };
+        return empty;
     }
+    const lines = content.split(/\r?\n/);
+    const now = new Date();
+    const horizon = new Date(now.getTime() + AGING_HORIZON_DAYS * 86_400_000);
+    let active = 0;
+    let dormant = 0;
+    let agingRisk = 0;
+    let scanned = 0;
+    let inEntry = false;
+    let severity = null;
+    let lastSeen = '';
+    let recurrences = 1;
+    const flush = () => {
+        if (!severity)
+            return;
+        scanned++;
+        const today = computeEffectiveScore(severity, lastSeen, recurrences, fileType, now);
+        if (today >= threshold) {
+            active++;
+            if (lastSeen) {
+                const future = computeEffectiveScore(severity, lastSeen, recurrences, fileType, horizon);
+                if (future < threshold)
+                    agingRisk++;
+            }
+        }
+        else {
+            dormant++;
+        }
+    };
+    for (const line of lines) {
+        if (scanned >= MAX_ENTRIES_SCANNED)
+            break;
+        const headerMatch = line.match(/^## \[(P-HIGH|P-MED|P-LOW)\]/);
+        if (headerMatch) {
+            flush();
+            inEntry = true;
+            severity = headerMatch[1];
+            lastSeen = '';
+            recurrences = 1;
+            continue;
+        }
+        if (!inEntry)
+            continue;
+        const lastSeenMatch = line.match(/^\*\*Last seen\*\*:\s*(.+)/);
+        if (lastSeenMatch) {
+            lastSeen = lastSeenMatch[1].trim();
+            continue;
+        }
+        const recurrenceMatch = line.match(/^\*\*Recurrences\*\*:\s*(\d+)/);
+        if (recurrenceMatch) {
+            recurrences = parseInt(recurrenceMatch[1], 10);
+        }
+    }
+    flush();
+    return { active, dormant, agingRisk };
 }
 function readFrontmatter(content) {
     const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
@@ -124,28 +233,81 @@ 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 = getLearningsBase(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)) {
+        try {
+            for (const f of (0, fs_1.readdirSync)(rawDir)) {
+                if (!f.startsWith(`${userId}-`))
+                    continue;
+                consider((0, path_1.join)(rawDir, f));
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    const retroDir = (0, path_1.join)(workspaceRoot, 'docs', 'retrospectives');
+    if ((0, fs_1.existsSync)(retroDir)) {
+        try {
+            for (const f of (0, fs_1.readdirSync)(retroDir)) {
+                if (!f.startsWith(`${userId}-`) || !f.endsWith('.md'))
+                    continue;
+                if (!isUnsynthesizedRetrospective((0, path_1.join)(retroDir, f)))
+                    continue;
+                consider((0, path_1.join)(retroDir, f));
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return oldest;
+}
 function buildLearningContextSection(workspaceRoot, userId, forJob) {
     const learningsBase = getLearningsBase(workspaceRoot);
+    const resolvedUserId = resolveLearningUserId(workspaceRoot, userId);
     const threshold = getScoreThreshold(workspaceRoot);
     const l2MistakePath = (0, path_1.join)(learningsBase, 'org-mistake-patterns.md');
     const l2PrefPath = (0, path_1.join)(learningsBase, 'org-preferences.md');
     const l2CoachPath = (0, path_1.join)(learningsBase, 'org-manager-coaching.md');
+    const l2ValidatedPath = (0, path_1.join)(learningsBase, 'org-validated-patterns.md');
     const l2MistakePresent = (0, fs_1.existsSync)(l2MistakePath);
     const l2PrefPresent = (0, fs_1.existsSync)(l2PrefPath);
     const l2CoachPresent = (0, fs_1.existsSync)(l2CoachPath);
-    const l2MistakeCounts = l2MistakePresent ? countMistakePatternEntries(l2MistakePath, threshold) : null;
-    const l1MistakePath = (0, path_1.join)(learningsBase, `${userId}-mistake-patterns.md`);
-    const l1PrefPath = (0, path_1.join)(learningsBase, `${userId}-preferences.md`);
-    const l1CoachPath = (0, path_1.join)(learningsBase, `${userId}-manager-coaching.md`);
+    const l2ValidatedPresent = (0, fs_1.existsSync)(l2ValidatedPath);
+    const l2MistakeStats = l2MistakePresent ? scanMistakePatternFile(l2MistakePath, threshold, 'mistake-patterns') : null;
+    const l2ValidatedStats = l2ValidatedPresent ? scanMistakePatternFile(l2ValidatedPath, threshold, 'validated-patterns') : null;
+    const l1MistakePath = (0, path_1.join)(learningsBase, `${resolvedUserId}-mistake-patterns.md`);
+    const l1PrefPath = (0, path_1.join)(learningsBase, `${resolvedUserId}-preferences.md`);
+    const l1CoachPath = (0, path_1.join)(learningsBase, `${resolvedUserId}-manager-coaching.md`);
+    const l1ValidatedPath = (0, path_1.join)(learningsBase, `${resolvedUserId}-validated-patterns.md`);
     const l1MistakePresent = (0, fs_1.existsSync)(l1MistakePath);
     const l1PrefPresent = (0, fs_1.existsSync)(l1PrefPath);
     const l1CoachPresent = (0, fs_1.existsSync)(l1CoachPath);
-    const l1MistakeCounts = l1MistakePresent ? countMistakePatternEntries(l1MistakePath, threshold) : null;
+    const l1ValidatedPresent = (0, fs_1.existsSync)(l1ValidatedPath);
+    const l1MistakeStats = l1MistakePresent ? scanMistakePatternFile(l1MistakePath, threshold, 'mistake-patterns') : null;
+    const l1ValidatedStats = l1ValidatedPresent ? scanMistakePatternFile(l1ValidatedPath, threshold, 'validated-patterns') : null;
     let l0CoachingCount = 0;
     const rawPath = (0, path_1.join)(learningsBase, 'raw');
     if ((0, fs_1.existsSync)(rawPath)) {
         try {
-            l0CoachingCount = (0, fs_1.readdirSync)(rawPath).filter(f => f.startsWith(`${userId}-`)).length;
+            l0CoachingCount = (0, fs_1.readdirSync)(rawPath).filter(f => f.startsWith(`${resolvedUserId}-`)).length;
         }
         catch {
             // Ignore read failures.
@@ -156,15 +318,15 @@ function buildLearningContextSection(workspaceRoot, userId, forJob) {
     if ((0, fs_1.existsSync)(retrospectivesPath)) {
         try {
             l0RetroCount = (0, fs_1.readdirSync)(retrospectivesPath)
-                .filter(f => f.startsWith(`${userId}-`) && f.endsWith('.md'))
+                .filter(f => f.startsWith(`${resolvedUserId}-`) && f.endsWith('.md'))
                 .filter(f => isUnsynthesizedRetrospective((0, path_1.join)(retrospectivesPath, f))).length;
         }
         catch {
             // Ignore read failures.
         }
     }
-    const hasL2 = l2MistakePresent || l2PrefPresent || l2CoachPresent;
-    const hasL1 = l1MistakePresent || l1PrefPresent || l1CoachPresent;
+    const hasL2 = l2MistakePresent || l2PrefPresent || l2CoachPresent || l2ValidatedPresent;
+    const hasL1 = l1MistakePresent || l1PrefPresent || l1CoachPresent || l1ValidatedPresent;
     const hasContent = hasL2 || hasL1 || l0CoachingCount > 0 || l0RetroCount > 0;
     if (!hasContent)
         return '';
@@ -179,51 +341,74 @@ function buildLearningContextSection(workspaceRoot, userId, forJob) {
             section += `\`${LEARNINGS_REL}/org-preferences.md\`  (all entries)\n`;
         if (l2CoachPresent)
             section += `\`${LEARNINGS_REL}/org-manager-coaching.md\`  (all entries)\n`;
-        if (l2MistakeCounts && l2MistakeCounts.dormant > 0) {
-            section += `Dormant: ${l2MistakeCounts.dormant} org pattern${l2MistakeCounts.dormant !== 1 ? 's' : ''} below threshold\n`;
+        if (l2ValidatedPresent)
+            section += `\`${LEARNINGS_REL}/org-validated-patterns.md\`  (entries above score threshold)\n`;
+        const l2DormantTotal = (l2MistakeStats?.dormant || 0) + (l2ValidatedStats?.dormant || 0);
+        if (l2DormantTotal > 0) {
+            section += `Dormant: ${l2DormantTotal} org pattern${l2DormantTotal !== 1 ? 's' : ''} below threshold\n`;
         }
         section += '\n';
     }
     if (hasL1) {
         section += '### L1 - Your patterns\n';
         if (l1PrefPresent)
-            section += `\`${LEARNINGS_REL}/${userId}-preferences.md\`  (all entries)\n`;
+            section += `\`${LEARNINGS_REL}/${resolvedUserId}-preferences.md\`  (all entries)\n`;
         if (l1CoachPresent)
-            section += `\`${LEARNINGS_REL}/${userId}-manager-coaching.md\`  (all entries)\n`;
+            section += `\`${LEARNINGS_REL}/${resolvedUserId}-manager-coaching.md\`  (all entries)\n`;
         if (l1MistakePresent)
-            section += `\`${LEARNINGS_REL}/${userId}-mistake-patterns.md\`  (entries above score threshold)\n`;
-        if (l1MistakeCounts && l1MistakeCounts.dormant > 0) {
-            section += `Dormant: ${l1MistakeCounts.dormant} personal pattern${l1MistakeCounts.dormant !== 1 ? 's' : ''} below threshold\n`;
+            section += `\`${LEARNINGS_REL}/${resolvedUserId}-mistake-patterns.md\`  (entries above score threshold)\n`;
+        if (l1ValidatedPresent)
+            section += `\`${LEARNINGS_REL}/${resolvedUserId}-validated-patterns.md\`  (entries above score threshold)\n`;
+        const l1DormantTotal = (l1MistakeStats?.dormant || 0) + (l1ValidatedStats?.dormant || 0);
+        if (l1DormantTotal > 0) {
+            section += `Dormant: ${l1DormantTotal} personal pattern${l1DormantTotal !== 1 ? 's' : ''} below threshold\n`;
         }
         section += '\n';
     }
     if (l0CoachingCount > 0 || l0RetroCount > 0) {
         section += '### L0 - Your unprocessed signals\n';
         if (l0CoachingCount > 0) {
-            section += `${l0CoachingCount} coaching moment${l0CoachingCount !== 1 ? 's' : ''} in \`${LEARNINGS_REL}/raw/${userId}-*\`\n`;
+            section += `${l0CoachingCount} coaching moment${l0CoachingCount !== 1 ? 's' : ''} in \`${LEARNINGS_REL}/raw/${resolvedUserId}-*\`\n`;
         }
         if (l0RetroCount > 0) {
-            section += `${l0RetroCount} retrospective${l0RetroCount !== 1 ? 's' : ''} in \`docs/retrospectives/${userId}-*\` with \`synthesized: false\` or missing\n`;
+            section += `${l0RetroCount} retrospective${l0RetroCount !== 1 ? 's' : ''} in \`docs/retrospectives/${resolvedUserId}-*\` with \`synthesized: false\` or missing\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, preferences, and coaching signals in this job.\n';
         }
-        if (totalL0 >= 5) {
+        if (backlogTriggered) {
             section += '\n';
             section += `Warning: ${totalL0} unprocessed signals pending. Consider running \`end-of-day-debrief\` before starting today's work.\n`;
+            section += renderBacklogDetail(oldestAgeDays, agingRisk);
         }
     }
     else {
         section += 'Use this synthesized learning context throughout the session.\n';
-        if (totalL0 >= 5) {
+        if (backlogTriggered) {
             section += '\n';
             section += `Warning: synthesis overdue with ${totalL0} unprocessed signals.\n`;
             section += 'Run `end-of-day-debrief` before starting today\'s work.\n';
+            section += renderBacklogDetail(oldestAgeDays, agingRisk);
         }
     }
     return section;
 }
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.119",
+  "version": "2.0.120",
   "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": {