fraim 2.0.106 → 2.0.109

package/dist/src/cli/commands/setup.js

@@ -633,24 +633,49 @@ const runSetup = async (options) => {
             console.log(chalk_1.default.cyan('   To initialize a project later, cd into a repo and run: fraim init-project'));
         }
     }
-    // Show summary
-    console.log(chalk_1.default.green('\n🎯 Setup complete!'));
-    console.log(chalk_1.default.gray(`   Mode: ${mode}`));
+    // Show mode-aware summary with clear value prop and next steps
+    console.log(chalk_1.default.green('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk_1.default.green('  FRAIM is ready!'));
+    console.log(chalk_1.default.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk_1.default.white('\n  FRAIM is an AI management layer that turns you into'));
+    console.log(chalk_1.default.white('  a manager of AI agents. Run multiple agents through'));
+    console.log(chalk_1.default.white('  structured jobs, get manager-style coaching, and build'));
+    console.log(chalk_1.default.white('  a learning loop where agents improve over time.'));
+    console.log(chalk_1.default.gray('\n  60+ jobs across engineering, marketing, fundraising,'));
+    console.log(chalk_1.default.gray('  legal, product, hiring, customer development, and more.'));
+    // Show which IDEs were configured and how to use FRAIM in each
+    const { detectInstalledIDEs: detectIDEs } = await Promise.resolve().then(() => __importStar(require('../setup/ide-detector')));
+    const configuredIDEs = detectIDEs();
+    if (configuredIDEs.length > 0) {
+        const ideNames = configuredIDEs.map(ide => ide.name).join(', ');
+        console.log(chalk_1.default.cyan(`\n  FRAIM is configured for: `) + chalk_1.default.white(ideNames));
+        console.log(chalk_1.default.cyan('\n  Get started — open any of those tools and:'));
+    }
+    else {
+        console.log(chalk_1.default.cyan('\n  Get started — open your AI tool and:'));
+    }
+    // Check if Claude is among configured IDEs
+    const hasClaude = configuredIDEs.some(ide => ide.name.toLowerCase().includes('claude'));
+    if (hasClaude) {
+        console.log(chalk_1.default.white('    /fraim                           ') + chalk_1.default.gray('(Claude Code) Browse all jobs'));
+    }
+    console.log(chalk_1.default.white('    "What can FRAIM help me with?"   ') + chalk_1.default.gray('Works in any AI tool'));
+    console.log(chalk_1.default.gray('\n  Just tell your AI what you need — FRAIM will find the right job.'));
     if (mode !== 'conversational') {
+        console.log(chalk_1.default.cyan('\n  To set up FRAIM in a specific project:'));
+        console.log(chalk_1.default.white('    cd your-project && fraim init-project'));
+        console.log(chalk_1.default.gray('    This enables project-specific customizations,'));
+        console.log(chalk_1.default.gray('    GitHub workflows, and team learning.'));
         const configuredProviders = await Promise.all(Object.keys(tokens).map(async (id) => await (0, provider_registry_1.getProviderDisplayName)(id)));
-        console.log(chalk_1.default.gray(`   Platforms: ${configuredProviders.join(', ') || 'none'}`));
-    }
-    console.log(chalk_1.default.cyan('\n📝 For future projects:'));
-    console.log(chalk_1.default.cyan('   1. cd into any project directory'));
-    console.log(chalk_1.default.cyan('   2. Run: fraim init-project'));
-    console.log(chalk_1.default.cyan('   3. Ask your AI agent: "FRAIM was just installed. Read the FRAIM docs, explain what it can do for me, then run project-onboarding."'));
-    if (mode === 'integrated') {
+        if (configuredProviders.length > 0) {
+            console.log(chalk_1.default.gray(`\n  Platforms: ${configuredProviders.join(', ')}`));
+        }
         const allProviderIds = await (0, provider_registry_1.getAllProviderIds)();
         const unconfiguredProviders = allProviderIds.filter(id => !tokens[id]);
         if (unconfiguredProviders.length > 0) {
-            console.log(chalk_1.default.gray('\n💡 To add more platforms later:'));
+            console.log(chalk_1.default.gray('\n  To add more platforms later:'));
             unconfiguredProviders.forEach(id => {
-                console.log(chalk_1.default.gray(`   fraim setup --${id}`));
+                console.log(chalk_1.default.gray(`    fraim setup --${id}`));
             });
         }
     }

package/dist/src/cli/setup/ide-global-integration.js

@@ -22,7 +22,14 @@ const FRAIM_SLASH_COMMAND_CONTENT = `The user wants to run FRAIM. The requested
 
 Follow this process:
 
-1. **If no argument was given** (the line above ends with ": "): call \`list_fraim_jobs()\` to discover available jobs. List each by name and its Intent line. Ask the user which job they want to run, then proceed to step 2.
+1. **If no argument was given** (the line above ends with ": "):
+   Call \`list_fraim_jobs()\` to discover available jobs. Present the results to the user grouped by business function (the server returns jobs organized by category — use those categories as group headings). For each group, list 3-5 of the most impactful jobs with a one-line description.
+
+   After listing, suggest 2-3 starting points based on what seems most relevant:
+   - If in a code repo: suggest jobs from engineering/product-building categories
+   - If no repo context: suggest jobs from marketing, fundraising, or business categories
+
+   Ask the user which job they want to run, then proceed to step 2.
 
 2. **Find the match**: from the list returned by \`list_fraim_jobs()\`, find the job whose name matches or closely resembles the argument. If no job matches, search for a matching skill by calling \`get_fraim_file({ path: "skills/<likely-category>/<argument>.md" })\` — try common categories like \`engineering/\`, \`marketing/\`, \`business/\`, \`product-management/\`, \`ai-tools/\`. Confirm the match with the user.
 

package/dist/src/cli/setup/user-level-sync.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -39,11 +6,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureUserLevelDirectories = ensureUserLevelDirectories;
 exports.syncUserLevelArtifacts = syncUserLevelArtifacts;
 /**
- * User-Level FRAIM Artifact Sync
+ * User-Level FRAIM Setup
+ *
+ * Ensures the user-level ~/.fraim/ directory has the minimal structure needed
+ * for FRAIM to work outside of any project:
  *
- * Syncs jobs, skills, rules, and docs stubs from the remote FRAIM server
- * to the user-level ~/.fraim/ directory. This makes FRAIM discoverable
- * everywhere without requiring fraim init-project.
+ * - config.json — auth, mode, tokens (managed by setup.ts)
+ * - scripts/ — locally-executed scripts (synced during any fraim sync)
+ * - personalized-employee/ — user-level overrides and learnings
+ *
+ * Job/skill/rule stubs are NOT synced to user-level. The MCP proxy serves
+ * those on demand via list_fraim_jobs() and get_fraim_job(). Stubs only exist
+ * at project-level (fraim/) where CLAUDE.md tells agents to scan them on disk.
  *
  * Part of: User-Level FRAIM Artifacts with Local Shadow Semantics
  */
@@ -52,21 +26,17 @@ const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const script_sync_utils_1 = require("../utils/script-sync-utils");
 /**
- * Ensure the user-level FRAIM directory structure exists for content sync.
- * Creates directories for synced content and personalized overrides.
+ * Ensure the user-level FRAIM directory structure exists.
+ * Creates personalized-employee dirs for user-level overrides.
+ * Scripts dir is handled by existing script-sync-utils during any fraim sync.
  */
 function ensureUserLevelDirectories(userFraimDir) {
     const baseDir = userFraimDir || (0, script_sync_utils_1.getUserFraimDir)();
     const dirs = [
-        path_1.default.join(baseDir, 'ai-employee', 'jobs'),
-        path_1.default.join(baseDir, 'ai-employee', 'skills'),
-        path_1.default.join(baseDir, 'ai-employee', 'rules'),
-        path_1.default.join(baseDir, 'ai-manager', 'jobs'),
         path_1.default.join(baseDir, 'personalized-employee', 'jobs'),
         path_1.default.join(baseDir, 'personalized-employee', 'skills'),
         path_1.default.join(baseDir, 'personalized-employee', 'rules'),
         path_1.default.join(baseDir, 'personalized-employee', 'learnings'),
-        path_1.default.join(baseDir, 'docs'),
     ];
     for (const dir of dirs) {
         if (!fs_1.default.existsSync(dir)) {
@@ -75,65 +45,15 @@ function ensureUserLevelDirectories(userFraimDir) {
     }
 }
 /**
- * Sync FRAIM artifacts (jobs, skills, rules, docs) from the remote server
- * to the user-level ~/.fraim/ directory.
- *
- * Uses the same remote sync endpoint as project-level sync, but writes
- * content directly to the user-level directory structure instead of under
- * a project's fraim/ subdirectory.
+ * Set up the user-level FRAIM directory.
+ * Creates the personalized-employee structure so FRAIM works outside any project.
  *
  * @param userFraimDir - Override for the target directory (for testing)
  */
 async function syncUserLevelArtifacts(userFraimDir) {
     const baseDir = userFraimDir || (0, script_sync_utils_1.getUserFraimDir)();
-    console.log(chalk_1.default.blue('📦 Syncing FRAIM content to user-level directory...'));
+    console.log(chalk_1.default.blue('📦 Setting up user-level FRAIM directory...'));
     console.log(chalk_1.default.gray(`   Target: ${baseDir}`));
-    // Ensure directory structure exists
     ensureUserLevelDirectories(baseDir);
-    // Try to sync from remote. If this fails (no network, no key),
-    // we still have the directory structure in place.
-    try {
-        const { syncFromRemote } = await Promise.resolve().then(() => __importStar(require('../utils/remote-sync')));
-        const apiKey = loadApiKeyFromConfig(baseDir);
-        if (!apiKey) {
-            console.log(chalk_1.default.yellow('⚠️  No API key found. User-level content sync skipped.'));
-            console.log(chalk_1.default.gray('   Directory structure created. Content will sync on next fraim sync --global.'));
-            return;
-        }
-        const result = await syncFromRemote({
-            apiKey,
-            projectRoot: baseDir,
-            targetIsUserLevel: true,
-            skipUpdates: true
-        });
-        if (result.success) {
-            console.log(chalk_1.default.green(`✅ Synced ${result.employeeJobsSynced} ai-employee jobs, ` +
-                `${result.managerJobsSynced} ai-manager jobs, ` +
-                `${result.skillsSynced} skills, ${result.rulesSynced} rules, ` +
-                `${result.scriptsSynced} scripts, and ${result.docsSynced} docs to ~/.fraim/`));
-        }
-        else {
-            console.log(chalk_1.default.yellow(`⚠️  User-level content sync failed: ${result.error}`));
-            console.log(chalk_1.default.gray('   Directory structure created. Content will sync on next fraim sync --global.'));
-        }
-    }
-    catch (error) {
-        console.log(chalk_1.default.yellow(`⚠️  User-level content sync failed: ${error.message}`));
-        console.log(chalk_1.default.gray('   Directory structure created. Content will sync on next fraim sync --global.'));
-    }
-}
-/**
- * Load API key from the user-level config file.
- */
-function loadApiKeyFromConfig(userFraimDir) {
-    const configPath = path_1.default.join(userFraimDir, 'config.json');
-    if (!fs_1.default.existsSync(configPath))
-        return undefined;
-    try {
-        const config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
-        return config.apiKey;
-    }
-    catch {
-        return undefined;
-    }
+    console.log(chalk_1.default.green('✅ User-level FRAIM directory ready'));
 }

package/dist/src/cli/utils/remote-sync.js

@@ -135,17 +135,8 @@ async function syncFromRemote(options) {
                 error: 'No files received'
             };
         }
-        // Helper: resolve path within the FRAIM content directory.
-        // For user-level sync, write directly to projectRoot (which IS ~/.fraim/).
-        // For project-level sync, use getWorkspaceFraimPath which prepends 'fraim/'.
-        const resolveFraimPath = (...parts) => {
-            if (options.targetIsUserLevel) {
-                return (0, path_1.join)(options.projectRoot, ...parts);
-            }
-            return (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, ...parts);
-        };
-        const lockTargets = options.targetIsUserLevel ? [] : getSyncedContentLockTargets(options.projectRoot);
-        if (!options.targetIsUserLevel && shouldLockSyncedContent()) {
+        const lockTargets = getSyncedContentLockTargets(options.projectRoot);
+        if (shouldLockSyncedContent()) {
             // If previous sync locked these paths read-only, temporarily unlock before cleanup/write.
             for (const target of lockTargets) {
                 setFileWriteLockRecursively(target, false);
@@ -155,7 +146,7 @@ async function syncFromRemote(options) {
         const allJobFiles = files.filter(f => f.type === 'job');
         const managerJobFiles = allJobFiles.filter(f => f.path.startsWith('ai-manager/'));
         const jobFiles = allJobFiles.filter(f => !f.path.startsWith('ai-manager/'));
-        const employeeJobsDir = resolveFraimPath('ai-employee', 'jobs');
+        const employeeJobsDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, 'ai-employee', 'jobs');
         if (!(0, fs_1.existsSync)(employeeJobsDir)) {
             (0, fs_1.mkdirSync)(employeeJobsDir, { recursive: true });
         }
@@ -175,7 +166,7 @@ async function syncFromRemote(options) {
             console.log(chalk_1.default.gray(`  + ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)(`ai-employee/jobs/${relPath}`)}`));
         }
         // Sync ai-manager job stubs to fraim/ai-manager/jobs/
-        const managerJobsDir = resolveFraimPath('ai-manager', 'jobs');
+        const managerJobsDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, 'ai-manager', 'jobs');
         if (!(0, fs_1.existsSync)(managerJobsDir)) {
             (0, fs_1.mkdirSync)(managerJobsDir, { recursive: true });
         }
@@ -196,7 +187,7 @@ async function syncFromRemote(options) {
         }
         // Sync skill STUBS to fraim/ai-employee/skills/
         const skillFiles = files.filter(f => f.type === 'skill');
-        const skillsDir = resolveFraimPath('ai-employee', 'skills');
+        const skillsDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, 'ai-employee', 'skills');
         if (!(0, fs_1.existsSync)(skillsDir)) {
             (0, fs_1.mkdirSync)(skillsDir, { recursive: true });
         }
@@ -216,7 +207,7 @@ async function syncFromRemote(options) {
         }
         // Sync rule STUBS to fraim/ai-employee/rules/
         const ruleFiles = files.filter(f => f.type === 'rule');
-        const rulesDir = resolveFraimPath('ai-employee', 'rules');
+        const rulesDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, 'ai-employee', 'rules');
         if (!(0, fs_1.existsSync)(rulesDir)) {
             (0, fs_1.mkdirSync)(rulesDir, { recursive: true });
         }
@@ -255,7 +246,7 @@ async function syncFromRemote(options) {
         }
         // Sync docs to fraim/docs/
         const docsFiles = files.filter(f => f.type === 'docs');
-        const docsDir = resolveFraimPath('docs');
+        const docsDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, 'docs');
         if (!(0, fs_1.existsSync)(docsDir)) {
             (0, fs_1.mkdirSync)(docsDir, { recursive: true });
         }
@@ -269,7 +260,7 @@ async function syncFromRemote(options) {
             (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
             console.log(chalk_1.default.gray(`  + ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)(`docs/${file.path}`)}`));
         }
-        if (!options.targetIsUserLevel && shouldLockSyncedContent()) {
+        if (shouldLockSyncedContent()) {
             for (const target of lockTargets) {
                 setFileWriteLockRecursively(target, true);
             }

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

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Quality Evidence Validation (Issue #251)
+ *
+ * Pure helpers for validating the `evidence.quality` object that
+ * quality-producing FRAIM jobs must emit on their final seekMentoring
+ * completion. Lives in src/core so both the local MCP proxy and the
+ * remote server can import the same contract without cross-layer
+ * dependencies.
+ *
+ * Two call sites currently:
+ *   1. src/local-mcp-server/stdio-server.ts — enforces on local
+ *      seekMentoring completion and POSTs valid scores to the remote
+ *      via /api/analytics/quality-score.
+ *   2. src/routes/analytics.ts — defense-in-depth validation on the
+ *      /api/analytics/quality-score endpoint.
+ *
+ * A third (rare) call site lives in src/services/mcp-service.ts for
+ * the case where the local proxy falls through to the remote's own
+ * seekMentoring handler (e.g., when the local AIMentor errors).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REQUIRED_QUALITY_FIELDS = exports.QUALITY_PRODUCING_JOBS = void 0;
+exports.validateQualityEvidence = validateQualityEvidence;
+exports.buildQualityRejectionMessage = buildQualityRejectionMessage;
+/**
+ * Jobs that produce a quality assessment and MUST emit a quality score
+ * via `evidence.quality` on their final seekMentoring completion.
+ */
+exports.QUALITY_PRODUCING_JOBS = [
+    'process-interview-notes',
+    'triage-customer-needs'
+];
+/**
+ * Required numeric fields inside `evidence.quality` for QUALITY_PRODUCING_JOBS.
+ * The schema is intentionally lenient beyond these — extra fields are
+ * allowed so per-job assessment can evolve — but these five gate completion.
+ */
+exports.REQUIRED_QUALITY_FIELDS = [
+    { path: 'composite', type: 'number' },
+    { path: 'participant.fit', type: 'number' },
+    { path: 'participant.urgency', type: 'number' },
+    { path: 'participant.authority', type: 'number' },
+    { path: 'evidence.quoteSpecificityAvg', type: 'number' }
+];
+/**
+ * Validate an `evidence.quality` object against REQUIRED_QUALITY_FIELDS.
+ * Returns null if valid, or an array of human-readable error strings.
+ *
+ * Design note: when `quality` is entirely missing we still walk every
+ * required field and emit a per-field error, so the agent sees the
+ * complete schema in one round rather than being told only that
+ * `quality` itself is missing.
+ */
+function validateQualityEvidence(quality) {
+    const errors = [];
+    const isMissing = quality === undefined || quality === null;
+    if (isMissing) {
+        errors.push('evidence.quality is missing');
+    }
+    else if (typeof quality !== 'object' || Array.isArray(quality)) {
+        errors.push('evidence.quality must be an object');
+    }
+    const effective = isMissing || typeof quality !== 'object' || Array.isArray(quality)
+        ? undefined
+        : quality;
+    for (const { path, type } of exports.REQUIRED_QUALITY_FIELDS) {
+        const parts = path.split('.');
+        let cursor = effective;
+        for (const part of parts) {
+            if (cursor && typeof cursor === 'object' && part in cursor) {
+                cursor = cursor[part];
+            }
+            else {
+                cursor = undefined;
+                break;
+            }
+        }
+        if (typeof cursor !== type || (type === 'number' && Number.isNaN(cursor))) {
+            const got = cursor === undefined ? 'missing' : (Number.isNaN(cursor) ? 'NaN' : typeof cursor);
+            errors.push(`evidence.quality.${path} must be a ${type} (got ${got})`);
+        }
+    }
+    return errors.length > 0 ? errors : null;
+}
+/**
+ * Build the rejection message sent back to the agent when a quality-producing
+ * job tries to complete without a valid `evidence.quality` object. The message
+ * lists the specific errors and the required minimum schema so the agent can
+ * fix everything in one round.
+ */
+function buildQualityRejectionMessage(jobName, currentPhase, errors) {
+    const errorBullets = errors.map(e => `- ${e}`).join('\n');
+    return [
+        `❌ **Job completion rejected** for \`${jobName}\`.`,
+        '',
+        `This job is required to emit a quality score on its final \`seekMentoring\` call so the result is captured in \`fraim_quality_scores\` for the manager dashboard. The following problems were found in \`evidence.quality\`:`,
+        '',
+        errorBullets,
+        '',
+        'Required minimum schema:',
+        '',
+        '```javascript',
+        'evidence: {',
+        '  quality: {',
+        '    composite: <number 0-10>,',
+        '    participant: { fit: <number 1-10>, urgency: <number 1-10>, authority: <number 1-10> },',
+        '    evidence: {',
+        '      quoteSpecificityAvg: <number 1-10>',
+        '      // other fields are allowed and encouraged but not required',
+        '    },',
+        '    interviewee: "<name>",',
+        '    company: "<company>",',
+        '    artifactPath: "docs/customer-development/<slug>-interview.md"',
+        '  }',
+        '}',
+        '```',
+        '',
+        `You are still in phase \`${currentPhase}\`. The job is **not** marked complete. Build the \`evidence.quality\` object from your Phase 4 (\`conversation-quality-assessment\`) work and resubmit this final phase.`
+    ].join('\n');
+}

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

@@ -29,6 +29,7 @@ const provider_utils_1 = require("../core/utils/provider-utils");
 const object_utils_1 = require("../core/utils/object-utils");
 const local_registry_resolver_1 = require("../core/utils/local-registry-resolver");
 const ai_mentor_1 = require("../core/ai-mentor");
+const quality_evidence_1 = require("../core/quality-evidence");
 const project_fraim_paths_1 = require("../core/utils/project-fraim-paths");
 const usage_collector_js_1 = require("./usage-collector.js");
 const otlp_metrics_receiver_js_1 = require("./otlp-metrics-receiver.js");
@@ -1664,6 +1665,40 @@ class FraimLocalMCPServer {
                     const mentor = this.getMentor(requestSessionId);
                     const tutoringResponse = await mentor.handleMentoringRequest(args);
                     this.log(`✅ Local seekMentoring succeeded for ${args.jobName}:${args.currentPhase}`);
+                    // Quality enforcement (Issue #251).
+                    //
+                    // The local proxy owns seekMentoring for personalized-job support.
+                    // That means the server-side enforcement in mcp-service.handleSeekMentoring
+                    // rarely fires in practice, so this is the primary enforcement point.
+                    //
+                    // When a QUALITY_PRODUCING_JOBS job reaches its final phase
+                    // (nextPhase === null) with status === 'complete', the agent MUST
+                    // include a valid `evidence.quality` object. If invalid, swap the
+                    // accomplishment message for a rejection and DO NOT emit. If valid,
+                    // fire-and-forget POST to /api/analytics/quality-score so the row
+                    // lands in fraim_quality_scores.
+                    const isQualityJob = quality_evidence_1.QUALITY_PRODUCING_JOBS.includes(args.jobName);
+                    const isFinalCompletion = args.status === 'complete' &&
+                        (tutoringResponse.nextPhase === null || tutoringResponse.nextPhase === undefined);
+                    if (isQualityJob && isFinalCompletion) {
+                        const qualityErrors = (0, quality_evidence_1.validateQualityEvidence)(args.evidence?.quality);
+                        if (qualityErrors) {
+                            this.log(`❌ Quality enforcement rejected ${args.jobName} completion: ${qualityErrors.join('; ')}`);
+                            const rejection = (0, quality_evidence_1.buildQualityRejectionMessage)(args.jobName, args.currentPhase, qualityErrors);
+                            return await this.finalizeLocalToolTextResponse(request, requestSessionId, requestId, rejection);
+                        }
+                        // Valid payload. Emit to the remote asynchronously.
+                        this.emitQualityScoreToRemote({
+                            jobName: args.jobName,
+                            jobId: args.jobId,
+                            sessionId: requestSessionId || args.sessionId || 'unknown',
+                            quality: args.evidence.quality,
+                            artifactPath: args.evidence.quality.artifactPath
+                        }).catch((err) => {
+                            // Best-effort: log but never fail the user-facing response.
+                            this.log(`⚠️ Quality score emission failed: ${err?.message || err}`);
+                        });
+                    }
                     return await this.finalizeLocalToolTextResponse(request, requestSessionId, requestId, tutoringResponse.message);
                 }
                 catch (error) {
@@ -1971,6 +2006,33 @@ class FraimLocalMCPServer {
             this.log(`⚠️ Skipping usage collection: toolName=${toolName}, sessionId=${requestSessionId}`);
         }
     }
+    /**
+     * Emit a quality score to the remote FRAIM server (Issue #251).
+     *
+     * Called from the seekMentoring short-circuit when a QUALITY_PRODUCING_JOBS
+     * job reaches its final phase with a validated `evidence.quality` payload.
+     * Fire-and-forget from the caller's perspective: a failure here is logged
+     * but does not block the user-facing response (analytics capture is best
+     * effort, not blocking).
+     *
+     * On success the remote writes a row to the `fraim_quality_scores` MongoDB
+     * collection which powers the manager dashboard trajectory chart.
+     */
+    async emitQualityScoreToRemote(payload) {
+        const url = `${this.remoteUrl}/api/analytics/quality-score`;
+        this.log(`📊 Emitting quality score → ${url} (job=${payload.jobName}, jobId=${payload.jobId})`);
+        const response = await axios_1.default.post(url, payload, {
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': this.apiKey
+            },
+            timeout: 10000
+        });
+        if (response.status < 200 || response.status >= 300) {
+            throw new Error(`quality-score endpoint returned ${response.status}: ${JSON.stringify(response.data)}`);
+        }
+        this.log(`📊 ✅ Quality score accepted by remote (composite=${payload.quality.composite})`);
+    }
     /**
      * Flush collected usage data to the remote server
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim",
-  "version": "2.0.106",
+  "version": "2.0.109",
   "description": "FRAIM CLI - Framework for Rigor-based AI Management (alias for fraim-framework)",
   "main": "index.js",
   "bin": {