fraim 2.0.109 → 2.0.114

package/README.md

@@ -1,5 +1,5 @@
-# 🚀 FRAIM: Framework for Rigor-based AI Management
-**"FRAIM is a step towards the future of how we work."** - Transforming ideas into production code by converting you into an AI manager orchestrating multiple agents with enterprise-grade discipline.
+# 🚀 FRAIM — AI Workforce Infrastructure
+**"Brilliant AI isn't how industries get built. Organizations are."** — FRAIM transforms every layer of the AI-powered company at once: **AI agents** become an accountable, improving workforce; **their operators** become capable AI managers who hold the line on quality, delegation, and evidence; and **executives** gain clear optics on AI proficiency across the entire organization.
 
 
 🚀 **The Problem with AI Coding Today**
@@ -36,7 +36,7 @@ R - Retrospectives: Continuous learning from experience
 
 🤖 **Works with any AI agent** (Cursor, Claude, Windsurf) - no vendor lock-in.
 
-**The bottom line:** FRAIM isn't just about using AI—it's about managing AI teams with the same discipline you'd apply to human developers.
+**The bottom line:** FRAIM isn't just about using AI — it transforms every layer of your AI-powered company: agents become an accountable workforce, operators become capable AI managers, and executives gain clear optics on AI proficiency across the whole org.
 
 
 
@@ -448,9 +448,9 @@ gh issue edit 123 --remove-label "phase:impl" --add-label "phase:tests"
 
 ## 🎯 **The Bottom Line**
 
-**FRAIM isn't just about using AI—it's about managing AI teams with the same discipline you'd apply to human teams.**
+**FRAIM isn't just about using AI — it transforms every layer of your AI-powered company: agents become an accountable workforce, operators become capable AI managers, and executives gain clear optics on AI proficiency across the whole org.**
 
-Stop fighting with AI agents. Start orchestrating them.
+Stop fighting with AI agents. Start building your AI organization.
 
 **This is the future of how we work.**
 

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

@@ -637,10 +637,10 @@ const runSetup = async (options) => {
     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.white('\n  FRAIM is AI Workforce Infrastructure. It transforms every'));
+    console.log(chalk_1.default.white('  layer of your AI-powered work at once: AI agents become an'));
+    console.log(chalk_1.default.white('  accountable workforce, you become a capable AI manager, and'));
+    console.log(chalk_1.default.white('  your leadership gains clear optics on AI proficiency.'));
     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

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

@@ -20,7 +20,8 @@
  * 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.REQUIRED_QUALITY_FIELDS = exports.ALL_STAGE_CATEGORIES = exports.STAGE_DISPLAY_NAMES = exports.STAGE_CATEGORY_MAP = exports.QUALITY_PRODUCING_JOBS = void 0;
+exports.getRequiredFieldsForJob = getRequiredFieldsForJob;
 exports.validateQualityEvidence = validateQualityEvidence;
 exports.buildQualityRejectionMessage = buildQualityRejectionMessage;
 /**
@@ -28,15 +29,64 @@ exports.buildQualityRejectionMessage = buildQualityRejectionMessage;
  * via `evidence.quality` on their final seekMentoring completion.
  */
 exports.QUALITY_PRODUCING_JOBS = [
+    // Customer Development
     'process-interview-notes',
-    'triage-customer-needs'
+    'triage-customer-needs',
+    // Business Strategy
+    'business-plan-creation',
+    'pricing-strategy-definition',
+    'founder-market-fit-analysis',
+    'review-business-strategy',
+    // Product Quality
+    'code-quality-assessment',
+    // Test Quality
+    'test-standards-evaluation',
+    'test-coverage-evaluation',
+    'review-test-quality',
 ];
 /**
- * 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.
+ * Maps job names to their founder journey stage category.
+ * Used to auto-populate `stageCategory` on quality score records.
  */
-exports.REQUIRED_QUALITY_FIELDS = [
+exports.STAGE_CATEGORY_MAP = {
+    'process-interview-notes': 'customer-development',
+    'triage-customer-needs': 'customer-development',
+    'business-plan-creation': 'business-strategy',
+    'pricing-strategy-definition': 'business-strategy',
+    'founder-market-fit-analysis': 'business-strategy',
+    'review-business-strategy': 'business-strategy',
+    'code-quality-assessment': 'product-quality',
+    'test-standards-evaluation': 'test-quality',
+    'test-coverage-evaluation': 'test-quality',
+    'review-test-quality': 'test-quality',
+};
+/**
+ * Human-readable stage names for dashboard display.
+ */
+exports.STAGE_DISPLAY_NAMES = {
+    'customer-development': 'Customer Development',
+    'business-strategy': 'Business Strategy',
+    'product-quality': 'Product Quality',
+    'test-quality': 'Test Quality',
+    'fundraising': 'Fundraising',
+    'go-to-market': 'Go-to-Market',
+};
+/**
+ * All known stage categories, in display order for the tile grid.
+ */
+exports.ALL_STAGE_CATEGORIES = [
+    'customer-development',
+    'business-strategy',
+    'product-quality',
+    'test-quality',
+    'fundraising',
+    'go-to-market',
+];
+/**
+ * Required fields for customer-development jobs (legacy V1 schema).
+ * These jobs require participant and evidence sub-dimensions.
+ */
+const CUSTOMER_DEV_REQUIRED_FIELDS = [
     { path: 'composite', type: 'number' },
     { path: 'participant.fit', type: 'number' },
     { path: 'participant.urgency', type: 'number' },
@@ -44,15 +94,38 @@ exports.REQUIRED_QUALITY_FIELDS = [
     { 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.
+ * Required fields for all other quality-producing jobs.
+ * Only composite and coaching are universally required — sub-dimensions
+ * vary by stage and are validated holistically, not mechanically.
+ */
+const UNIVERSAL_REQUIRED_FIELDS = [
+    { path: 'composite', type: 'number' },
+];
+/**
+ * Returns the required quality fields for a given job.
+ * Customer-development jobs retain the strict V1 schema.
+ * All other jobs require only a composite score (principle-based, not prescriptive).
+ */
+function getRequiredFieldsForJob(jobName) {
+    const stage = exports.STAGE_CATEGORY_MAP[jobName];
+    if (stage === 'customer-development') {
+        return CUSTOMER_DEV_REQUIRED_FIELDS;
+    }
+    return UNIVERSAL_REQUIRED_FIELDS;
+}
+/**
+ * @deprecated Use getRequiredFieldsForJob() for stage-aware validation.
+ * Kept for backward compatibility with existing imports.
+ */
+exports.REQUIRED_QUALITY_FIELDS = CUSTOMER_DEV_REQUIRED_FIELDS;
+/**
+ * Validate an `evidence.quality` object against the required fields for
+ * a given job. If no jobName is provided, falls back to the universal
+ * schema (composite only).
  *
- * 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.
+ * Returns null if valid, or an array of human-readable error strings.
  */
-function validateQualityEvidence(quality) {
+function validateQualityEvidence(quality, jobName) {
     const errors = [];
     const isMissing = quality === undefined || quality === null;
     if (isMissing) {
@@ -64,7 +137,8 @@ function validateQualityEvidence(quality) {
     const effective = isMissing || typeof quality !== 'object' || Array.isArray(quality)
         ? undefined
         : quality;
-    for (const { path, type } of exports.REQUIRED_QUALITY_FIELDS) {
+    const requiredFields = jobName ? getRequiredFieldsForJob(jobName) : UNIVERSAL_REQUIRED_FIELDS;
+    for (const { path, type } of requiredFields) {
         const parts = path.split('.');
         let cursor = effective;
         for (const part of parts) {
@@ -91,31 +165,49 @@ function validateQualityEvidence(quality) {
  */
 function buildQualityRejectionMessage(jobName, currentPhase, errors) {
     const errorBullets = errors.map(e => `- ${e}`).join('\n');
+    const stage = exports.STAGE_CATEGORY_MAP[jobName];
+    const isCustomerDev = stage === 'customer-development';
+    const schemaExample = 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>",',
+            '    // include per-dimension scores with rationale fields',
+            '    // additional fields are encouraged — schema is flexible per stage',
+            '  }',
+            '}',
+            '```'
+        ];
     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\`:`,
+        `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 quality dashboard. The following problems were found in \`evidence.quality\`:`,
         '',
         errorBullets,
         '',
-        'Required minimum schema:',
+        `Required minimum schema for \`${stage ?? 'unknown'}\` stage:`,
         '',
-        '```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"',
-        '  }',
-        '}',
-        '```',
+        ...schemaExample,
         '',
-        `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.`
+        `You are still in phase \`${currentPhase}\`. The job is **not** marked complete. Build the \`evidence.quality\` object from your quality assessment work and resubmit this final phase.`
     ].join('\n');
 }

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

@@ -1681,7 +1681,7 @@ class FraimLocalMCPServer {
                     const isFinalCompletion = args.status === 'complete' &&
                         (tutoringResponse.nextPhase === null || tutoringResponse.nextPhase === undefined);
                     if (isQualityJob && isFinalCompletion) {
-                        const qualityErrors = (0, quality_evidence_1.validateQualityEvidence)(args.evidence?.quality);
+                        const qualityErrors = (0, quality_evidence_1.validateQualityEvidence)(args.evidence?.quality, args.jobName);
                         if (qualityErrors) {
                             this.log(`❌ Quality enforcement rejected ${args.jobName} completion: ${qualityErrors.join('; ')}`);
                             const rejection = (0, quality_evidence_1.buildQualityRejectionMessage)(args.jobName, args.currentPhase, qualityErrors);

package/package.json

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