fraim-framework 2.0.123 → 2.0.124

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

@@ -20,31 +20,25 @@
  * seekMentoring handler (e.g., when the local AIMentor errors).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REQUIRED_QUALITY_FIELDS = exports.ALL_STAGE_CATEGORIES = exports.STAGE_DISPLAY_NAMES = exports.STAGE_CATEGORY_MAP = exports.QUALITY_PRODUCING_JOBS = exports.QUALITY_REGISTRY = void 0;
+exports.REQUIRED_QUALITY_FIELDS = exports.ALL_STAGE_CATEGORIES = exports.STAGE_DISPLAY_NAMES = exports.STAGE_CATEGORY_MAP = exports.QUALITY_GATE_JOBS = exports.QUALITY_SCORE_JOBS = exports.QUALITY_PRODUCING_JOBS = exports.QUALITY_REGISTRY = void 0;
 exports.getRequiredFieldsForJob = getRequiredFieldsForJob;
 exports.validateQualityEvidence = validateQualityEvidence;
 exports.buildQualityRejectionMessage = buildQualityRejectionMessage;
-/**
- * Central registry of FRAIM jobs that interact with the quality telemetry system.
- * This is the SINGLE SOURCE OF TRUTH for:
- *   1. Stage mapping (where it appears on the dashboard).
- *   2. Enforcement (whether it MUST emit a quality score to complete).
- */
 exports.QUALITY_REGISTRY = {
     // Customer Development
-    'process-interview-notes': { stage: 'customer-development', enforced: true },
-    'triage-customer-needs': { stage: 'customer-development', enforced: true },
+    'process-interview-notes': { stage: 'customer-development', enforced: true, telemetryKind: 'score' },
+    'triage-customer-needs': { stage: 'customer-development', enforced: true, telemetryKind: 'gate' },
     'interview-preparation': { stage: 'customer-discovery', enforced: false },
     // Business Strategy
-    'review-business-strategy': { stage: 'business-strategy', enforced: true },
+    'review-business-strategy': { stage: 'business-strategy', enforced: true, telemetryKind: 'score' },
     'business-plan-creation': { stage: 'business-strategy', enforced: false },
-    'branding-quality-audit': { stage: 'branding', enforced: true },
+    'branding-quality-audit': { stage: 'branding', enforced: true, telemetryKind: 'score' },
     // Product Quality
-    'code-quality-assessment': { stage: 'product-quality', enforced: true },
+    'code-quality-assessment': { stage: 'product-quality', enforced: true, telemetryKind: 'score' },
     // Test Quality
-    'test-quality-assessment': { stage: 'test-quality', enforced: true },
+    'test-quality-assessment': { stage: 'test-quality', enforced: true, telemetryKind: 'score' },
     // Security
-    'security-review': { stage: 'security', enforced: true },
+    'security-review': { stage: 'security', enforced: true, telemetryKind: 'score' },
     // Fundraising
     'investor-pitch-preparation': { stage: 'fundraising', enforced: false },
     // Go-to-Market
@@ -55,6 +49,15 @@ exports.QUALITY_REGISTRY = {
  * Derived enforcement list for backward compatibility.
  */
 exports.QUALITY_PRODUCING_JOBS = Object.keys(exports.QUALITY_REGISTRY).filter((job) => exports.QUALITY_REGISTRY[job].enforced);
+/**
+ * Jobs that write scored review rows used by the Quality tab scorecards.
+ * Gate-only telemetry jobs (for example `triage-customer-needs`) are excluded.
+ */
+exports.QUALITY_SCORE_JOBS = Object.keys(exports.QUALITY_REGISTRY).filter((job) => exports.QUALITY_REGISTRY[job].enforced && exports.QUALITY_REGISTRY[job].telemetryKind !== 'gate');
+/**
+ * Jobs that emit gate-style telemetry without a composite score.
+ */
+exports.QUALITY_GATE_JOBS = Object.keys(exports.QUALITY_REGISTRY).filter((job) => exports.QUALITY_REGISTRY[job].enforced && exports.QUALITY_REGISTRY[job].telemetryKind === 'gate');
 /**
  * @deprecated Use QUALITY_REGISTRY for new code.
  * Derived stage mappings for backward compatibility.
@@ -97,6 +100,12 @@ const CUSTOMER_DEV_REQUIRED_FIELDS = [
     { path: 'participant.authority', type: 'number' },
     { path: 'evidence.quoteSpecificityAvg', type: 'number' }
 ];
+/**
+ * Gate-only customer development jobs emit a decision without a composite score.
+ */
+const GATE_REQUIRED_FIELDS = [
+    { path: 'gateDecision', type: 'string' }
+];
 /**
  * Required fields for all other quality-producing jobs.
  * Only composite and coaching are universally required — sub-dimensions
@@ -112,6 +121,9 @@ const UNIVERSAL_REQUIRED_FIELDS = [
  */
 function getRequiredFieldsForJob(jobName) {
     const entry = exports.QUALITY_REGISTRY[jobName];
+    if (entry?.telemetryKind === 'gate') {
+        return GATE_REQUIRED_FIELDS;
+    }
     if (entry?.stage === 'customer-development') {
         return CUSTOMER_DEV_REQUIRED_FIELDS;
     }
@@ -174,38 +186,53 @@ function validateQualityEvidence(quality, jobName) {
 function buildQualityRejectionMessage(jobName, currentPhase, errors) {
     const errorBullets = errors.map(e => `- ${e}`).join('\n');
     const entry = exports.QUALITY_REGISTRY[jobName];
+    const isGateOnly = entry?.telemetryKind === 'gate';
     const isCustomerDev = entry?.stage === 'customer-development';
-    const schemaExample = isCustomerDev
+    const schemaExample = isGateOnly
         ? [
             '```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',
-            '    },',
-            '    coaching: "<actionable recommendation>",',
-            '    interviewee: "<name>",',
-            '    company: "<company>"',
+            '    gateDecision: "<pass|flag|fail>",',
+            '    interviewsAnalyzed: <number>,',
+            '    distinctPainPatterns: <number>,',
+            '    gaps: ["<gap summary>"],',
+            '    coaching: "<actionable recommendation>"',
             '  }',
             '}',
             '```'
         ]
-        : [
-            '```javascript',
-            'evidence: {',
-            '  quality: {',
-            '    composite: <number 0-10>,',
-            '    coaching: "<actionable recommendation>",',
-            '    marketEvidence: { score: <number>, rationale: "<string>" }, // flat, NO "dimensions" wrapper',
-            '    unitEconomics: { score: <number>, rationale: "<string>" },',
-            '    // add other sub-scores as direct properties',
-            '  }',
-            '}',
-            '```'
-        ];
+        : isCustomerDev
+            ? [
+                '```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',
+                '    },',
+                '    coaching: "<actionable recommendation>",',
+                '    interviewee: "<name>",',
+                '    company: "<company>"',
+                '  }',
+                '}',
+                '```'
+            ]
+            : [
+                '```javascript',
+                'evidence: {',
+                '  quality: {',
+                '    composite: <number 0-10>,',
+                '    coaching: "<actionable recommendation>",',
+                '    marketEvidence: { score: <number>, rationale: "<string>" }, // flat, NO "dimensions" wrapper',
+                '    unitEconomics: { score: <number>, rationale: "<string>" },',
+                '    // add other sub-scores as direct properties',
+                '  }',
+                '}',
+                '```'
+            ];
     const importantNote = [
         '',
         '> [!IMPORTANT]',

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

@@ -1689,12 +1689,21 @@ class FraimLocalMCPServer {
                             return await this.finalizeLocalToolTextResponse(request, requestSessionId, requestId, rejection);
                         }
                         // Valid payload. Emit to the remote asynchronously.
+                        if (!this.repoInfo) {
+                            this.detectRepoInfo();
+                        }
                         this.emitQualityScoreToRemote({
                             jobName: args.jobName,
                             jobId: args.jobId,
                             sessionId: requestSessionId || args.sessionId || 'unknown',
                             quality: args.evidence.quality,
-                            artifactPath: args.evidence.quality.artifactPath
+                            artifactPath: args.evidence.quality.artifactPath,
+                            repoIdentifier: args.evidence?.reviewContext?.repoIdentifier || this.repoInfo?.url,
+                            reviewContext: {
+                                ...(args.evidence?.reviewContext || {}),
+                                repoIdentifier: args.evidence?.reviewContext?.repoIdentifier || this.repoInfo?.url,
+                                branchRef: args.evidence?.reviewContext?.branchRef || this.repoInfo?.branch
+                            }
                         }).catch((err) => {
                             // Best-effort: log but never fail the user-facing response.
                             this.log(`⚠️ Quality score emission failed: ${err?.message || err}`);

package/package.json

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