fraim-framework 2.0.35 → 2.0.37

package/dist/registry/scripts/cleanup-branch.js

@@ -5,9 +5,39 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
 const dotenv_1 = __importDefault(require("dotenv"));
 // Load environment variables
 dotenv_1.default.config({ override: true });
+// Self-contained utility functions (no FRAIM internal imports)
+function extractIssueNumber(branchName) {
+    const match = branchName.match(/(\d+)/);
+    return match ? match[1] : '';
+}
+function getCurrentGitBranch() {
+    try {
+        return (0, child_process_1.execSync)('git branch --show-current', { encoding: 'utf8' }).trim();
+    }
+    catch (error) {
+        return 'unknown';
+    }
+}
+function loadClientConfig() {
+    const configPath = (0, path_1.join)(process.cwd(), '.fraim', 'config.json');
+    if (!(0, fs_1.existsSync)(configPath)) {
+        throw new Error('.fraim/config.json not found. Run fraim init first.');
+    }
+    return JSON.parse((0, fs_1.readFileSync)(configPath, 'utf-8'));
+}
+function getEnvOr(keys, fallback) {
+    for (const key of keys) {
+        const value = process.env[key];
+        if (value && value.length)
+            return value;
+    }
+    return fallback;
+}
 class BranchCleanup {
     constructor(options = {}) {
         this.options = {
@@ -18,7 +48,6 @@ class BranchCleanup {
         };
     }
     async insertYourCodeHere(branchName) {
-        const { extractIssueNumber } = require('../../src/utils/git-utils');
         const branchPattern = "branch_" + extractIssueNumber(branchName) + "%";
         this.log(`Attempting to fetch and run DB cleanup for pattern: ${branchPattern}`);
         // Historically this called: npx tsx scripts/database/cleanup-mongo-schemas.ts
@@ -217,38 +246,38 @@ for (let i = 0; i < args.length; i++) {
             break;
         case '--help':
         case '-h':
-            console.log(`
-🧹 Branch Cleanup Script
-
-Usage:
-  npx tsx scripts/cleanup-branch.ts [options]
-
-Options:
-  --branch, -b <name>              Specific branch name to cleanup (default: current branch)
-  --force, -f                      Continue even if some operations fail
-  --skip-project-cleanup           Skip project-specific cleanup
-  --skip-git                       Skip Git branch deletion
-  --help, -h                       Show this help message
-
-Examples:
-  # Cleanup current branch with default settings
-  npx tsx <cleanup-script-path>
-
-  # Cleanup specific branch
-  npx tsx <cleanup-script-path> --branch feature/123
-
-  # Force cleanup even if some operations fail
-  npx tsx <cleanup-script-path> --force
-
-  # Skip project-specific cleanup (only do Git cleanup)
-  npx tsx <cleanup-script-path> --skip-project-cleanup
-
-This script performs the following cleanup operations:
-1. 🗄️  Project-specific cleanup (calls configured cleanup script)
-2. 🌿 Git branch deletion (remote and local)
-3. ✅ Verification of cleanup completion
-
-⚠️  WARNING: This script will permanently delete branches and data!
+            console.log(`
+🧹 Branch Cleanup Script
+
+Usage:
+  npx tsx scripts/cleanup-branch.ts [options]
+
+Options:
+  --branch, -b <name>              Specific branch name to cleanup (default: current branch)
+  --force, -f                      Continue even if some operations fail
+  --skip-project-cleanup           Skip project-specific cleanup
+  --skip-git                       Skip Git branch deletion
+  --help, -h                       Show this help message
+
+Examples:
+  # Cleanup current branch with default settings
+  npx tsx <cleanup-script-path>
+
+  # Cleanup specific branch
+  npx tsx <cleanup-script-path> --branch feature/123
+
+  # Force cleanup even if some operations fail
+  npx tsx <cleanup-script-path> --force
+
+  # Skip project-specific cleanup (only do Git cleanup)
+  npx tsx <cleanup-script-path> --skip-project-cleanup
+
+This script performs the following cleanup operations:
+1. 🗄️  Project-specific cleanup (calls configured cleanup script)
+2. 🌿 Git branch deletion (remote and local)
+3. ✅ Verification of cleanup completion
+
+⚠️  WARNING: This script will permanently delete branches and data!
       `);
             process.exit(0);
     }

package/dist/registry/scripts/generate-engagement-emails.js

@@ -49,8 +49,83 @@ const child_process_1 = require("child_process");
 const fs_1 = require("fs");
 const mongodb_1 = require("mongodb");
 const path_1 = require("path");
-const git_utils_js_1 = require("../../src/utils/git-utils.js");
-const fraim_config_1 = require("./fraim-config");
+// Self-contained utility functions (no FRAIM internal imports)
+function determineDatabaseName() {
+    const env = process.env.NODE_ENV || process.env.ENVIRONMENT;
+    // If explicitly set to ppe/staging, use that; otherwise default to prod
+    if (env === 'ppe' || env === 'staging') {
+        return 'fraim_ppe';
+    }
+    // Default to production
+    return process.env.MONGO_DB_NAME || 'fraim_prod';
+}
+function determineSchema(branchName) {
+    if (branchName.includes('ppe') || branchName.includes('staging'))
+        return 'ppe';
+    return 'prod';
+}
+function getCurrentGitBranch() {
+    try {
+        return (0, child_process_1.execSync)('git branch --show-current', { encoding: 'utf8' }).trim();
+    }
+    catch (error) {
+        return 'master';
+    }
+}
+function loadClientConfig() {
+    const configPath = (0, path_1.join)(process.cwd(), '.fraim', 'config.json');
+    if (!(0, fs_1.existsSync)(configPath)) {
+        throw new Error('.fraim/config.json not found. Run fraim init first.');
+    }
+    return JSON.parse((0, fs_1.readFileSync)(configPath, 'utf-8'));
+}
+function getEnvOr(keys, fallback) {
+    for (const key of keys) {
+        const value = process.env[key];
+        if (value && value.length)
+            return value;
+    }
+    return fallback;
+}
+// Load configuration
+const config = loadClientConfig();
+const personaName = config.persona.name;
+const personaDisplayNameDefault = config.persona.displayNamePattern.replace('{executiveName}', 'Your');
+const fraimConfig = {
+    repoOwner: config.git.repoOwner || 'mathursrus',
+    repoName: config.git.repoName || 'fraim-repo',
+    projectName: 'FRAIM',
+    personaName,
+    personaPronouns: getEnvOr(['FRAIM_PERSONA_PRONOUNS'], 'they/them'),
+    personaDisplayName: getEnvOr(['FRAIM_PERSONA_DISPLAY_NAME'], personaDisplayNameDefault),
+    personaDisplayNamePattern: config.persona.displayNamePattern,
+    personaThankYouSignature: config.persona.emailSignature,
+    defaultEmail: getEnvOr(['FRAIM_DEFAULT_EMAIL'], 'agent@example.com'),
+    prodDefaultEmail: getEnvOr(['PROD_FRAIM_DEFAULT_EMAIL'], 'agent@example.com'),
+    defaultAccessToken: getEnvOr(['FRAIM_DEFAULT_ACCESS_TOKEN'], ''),
+    defaultRefreshToken: getEnvOr(['FRAIM_DEFAULT_REFRESH_TOKEN'], ''),
+    prodAccessToken: getEnvOr(['PROD_FRAIM_DEFAULT_ACCESS_TOKEN'], ''),
+    prodRefreshToken: getEnvOr(['PROD_FRAIM_DEFAULT_REFRESH_TOKEN'], ''),
+    defaultOAuthClientId: getEnvOr(['FRAIM_DEFAULT_OAUTH_CLIENT_ID'], ''),
+    defaultOAuthClientSecret: getEnvOr(['FRAIM_DEFAULT_OAUTH_CLIENT_SECRET'], ''),
+    prodOAuthClientId: getEnvOr(['PROD_FRAIM_DEFAULT_OAUTH_CLIENT_ID'], ''),
+    prodOAuthClientSecret: getEnvOr(['PROD_FRAIM_DEFAULT_OAUTH_CLIENT_SECRET'], ''),
+    identityCollection: config.database?.identityCollection || 'Identity',
+    executiveCollection: config.database?.executiveCollection || 'Executive',
+    newsletterTitle: 'Weekly Update',
+    newsletterCtaText: 'Learn More',
+    newsletterUrl: getEnvOr(['FRAIM_NEWSLETTER_URL'], ''),
+    issueRepoUrl: `https://github.com/${config.git.repoOwner}/${config.git.repoName}.git`,
+    identityTokensCollection: 'Tokens',
+    webAppUrl: config.marketing?.websiteUrl || getEnvOr(['FRAIM_WEB_APP_URL'], 'http://localhost:3000'),
+    chatUrl: config.marketing?.chatUrl || getEnvOr(['FRAIM_CHAT_URL'], ''),
+};
+function formatExecutiveDisplayName(executiveName) {
+    return config.persona.displayNamePattern.replace('{executiveName}', executiveName);
+}
+function formatPersonaSignature() {
+    return `With gratitude,\n${fraimConfig.personaThankYouSignature}\n${personaName} - Your AI Executive Assistant\n\n`;
+}
 // Get template path (relative to script location)
 function getTemplatePath() {
     // Script is at <this-path>
@@ -123,7 +198,7 @@ async function getResolvedIssues(date) {
     }
     // Use ">YYYY-MM-DD" format to get issues updated AFTER the date (not on the date)
     // GitHub CLI requires quotes around the comparison operator
-    const command = `gh search issues --repo=${fraim_config_1.fraimConfig.repoOwner}/${fraim_config_1.fraimConfig.repoName} --state=closed --updated=">${date}" --label=user-reported --json number,title,body,labels,closedAt,author`;
+    const command = `gh search issues --repo=${fraimConfig.repoOwner}/${fraimConfig.repoName} --state=closed --updated=">${date}" --label=user-reported --json number,title,body,labels,closedAt,author`;
     const output = (0, child_process_1.execSync)(command, { encoding: 'utf-8' });
     return JSON.parse(output);
 }
@@ -141,7 +216,7 @@ function getDatabaseName() {
     const env = process.env.NODE_ENV || process.env.ENVIRONMENT;
     // If explicitly set to ppe/staging, use that; otherwise default to prod
     if (env === 'ppe' || env === 'staging') {
-        return (0, git_utils_js_1.determineDatabaseName)();
+        return determineDatabaseName();
     }
     // Default to production
     return process.env.MONGO_DB_NAME || 'fraim_prod';
@@ -153,7 +228,7 @@ function getCollectionName(baseName) {
     const env = process.env.NODE_ENV || process.env.ENVIRONMENT;
     // If explicitly set to ppe/staging, use that schema; otherwise default to prod
     if (env === 'ppe' || env === 'staging') {
-        const schema = (0, git_utils_js_1.determineSchema)((0, git_utils_js_1.getCurrentGitBranch)());
+        const schema = determineSchema(getCurrentGitBranch());
         return `${schema}_${baseName}`;
     }
     // Default to prod schema
@@ -184,15 +259,15 @@ async function getPersonaEmailForExecutive(executiveId) {
     const { MongoClient } = await Promise.resolve().then(() => __importStar(require('mongodb')));
     const mongoUrl = process.env.PROD_MONGO_DATABASE_URL || process.env.MONGO_DATABASE_URL;
     if (!mongoUrl) {
-        console.warn(`⚠️  PROD_MONGO_DATABASE_URL not set, using default ${fraim_config_1.fraimConfig.personaName} email`);
-        return fraim_config_1.fraimConfig.defaultEmail;
+        console.warn(`⚠️  PROD_MONGO_DATABASE_URL not set, using default ${fraimConfig.personaName} email`);
+        return fraimConfig.defaultEmail;
     }
     const client = new MongoClient(mongoUrl);
     try {
         await client.connect();
         const dbName = getDatabaseName();
         const db = client.db(dbName);
-        const collectionName = getCollectionName(fraim_config_1.fraimConfig.identityCollection);
+        const collectionName = getCollectionName(fraimConfig.identityCollection);
         // Query the identity collection (defaults to prod)
         let identity = await db.collection(collectionName).findOne({
             executive_id: executiveId,
@@ -206,11 +281,11 @@ async function getPersonaEmailForExecutive(executiveId) {
         if (identity && identity.email) {
             return identity.email;
         }
-        return fraim_config_1.fraimConfig.defaultEmail;
+        return fraimConfig.defaultEmail;
     }
     catch (error) {
-        console.warn(`⚠️  Could not get ${fraim_config_1.fraimConfig.personaName} email for executive ${executiveId}:`, error);
-        return fraim_config_1.fraimConfig.defaultEmail;
+        console.warn(`⚠️  Could not get ${fraimConfig.personaName} email for executive ${executiveId}:`, error);
+        return fraimConfig.defaultEmail;
     }
     finally {
         await client.close();
@@ -268,7 +343,7 @@ async function sendCustomerMail(candidatesFilePath, executiveId) {
                         await client.connect();
                         const dbName = getDatabaseName();
                         const db = client.db(dbName);
-                        const collectionName = getCollectionName(fraim_config_1.fraimConfig.identityCollection);
+                        const collectionName = getCollectionName(fraimConfig.identityCollection);
                         const identity = await db.collection(collectionName).findOne({
                             executive_id: candidate.executive.id,
                             status: 'active'
@@ -280,10 +355,10 @@ async function sendCustomerMail(candidatesFilePath, executiveId) {
                                 access_token: identity.access_token,
                                 refresh_token: identity.refresh_token
                             };
-                            console.log(`Found ${fraim_config_1.fraimConfig.personaName} tokens in ${dbName} database for ${candidate.from.email}`);
+                            console.log(`Found ${fraimConfig.personaName} tokens in ${dbName} database for ${candidate.from.email}`);
                         }
                         else {
-                            console.warn(`No ${fraim_config_1.fraimConfig.personaName} tokens found in ${dbName} database for executive ${candidate.executive.id}`);
+                            console.warn(`No ${fraimConfig.personaName} tokens found in ${dbName} database for executive ${candidate.executive.id}`);
                         }
                     }
                     finally {
@@ -291,7 +366,7 @@ async function sendCustomerMail(candidatesFilePath, executiveId) {
                     }
                 }
                 catch (error) {
-                    console.warn(`Could not get ${fraim_config_1.fraimConfig.personaName} tokens from database for executive ${candidate.executive.id}:`, error);
+                    console.warn(`Could not get ${fraimConfig.personaName} tokens from database for executive ${candidate.executive.id}:`, error);
                 }
             }
             // Generate plain text body for fallback (from structured format if available)
@@ -335,7 +410,7 @@ async function sendSingleEmail(params, executive, personaTokens) {
     let refreshToken;
     if (personaTokens?.access_token && personaTokens?.refresh_token) {
         // Use persona identity tokens (preferred - ensures correct From address)
-        console.log(`🔑 Using ${fraim_config_1.fraimConfig.personaName} identity tokens for ${fromEmail}`);
+        console.log(`🔑 Using ${fraimConfig.personaName} identity tokens for ${fromEmail}`);
         accessToken = personaTokens.access_token;
         refreshToken = personaTokens.refresh_token;
     }
@@ -347,11 +422,11 @@ async function sendSingleEmail(params, executive, personaTokens) {
     }
     else {
         // Use default persona tokens as last resort
-        console.log(`🔑 Using default ${fraim_config_1.fraimConfig.personaName} tokens as fallback`);
-        accessToken = fraim_config_1.fraimConfig.defaultAccessToken;
-        refreshToken = fraim_config_1.fraimConfig.defaultRefreshToken;
+        console.log(`🔑 Using default ${fraimConfig.personaName} tokens as fallback`);
+        accessToken = fraimConfig.defaultAccessToken;
+        refreshToken = fraimConfig.defaultRefreshToken;
         if (!accessToken || !refreshToken) {
-            throw new Error(`${fraim_config_1.fraimConfig.personaName} Gmail tokens not found. Need either identity tokens, executive tokens, or default tokens in environment variables.`);
+            throw new Error(`${fraimConfig.personaName} Gmail tokens not found. Need either identity tokens, executive tokens, or default tokens in environment variables.`);
         }
     }
     // Verify the From email matches the authenticated account (Gmail requirement)
@@ -416,8 +491,8 @@ async function sendSingleEmail(params, executive, personaTokens) {
         if (response.status === 401) {
             console.log('🔄 Access token expired, refreshing...');
             // Refresh the access token
-            const clientId = fraim_config_1.fraimConfig.defaultOAuthClientId || process.env.FRAIM_DEFAULT_OAUTH_CLIENT_ID || process.env.PERSONA_DEFAULT_OAUTH_CLIENT_ID;
-            const clientSecret = fraim_config_1.fraimConfig.defaultOAuthClientSecret || process.env.FRAIM_DEFAULT_OAUTH_CLIENT_SECRET || process.env.PERSONA_DEFAULT_OAUTH_CLIENT_SECRET;
+            const clientId = fraimConfig.defaultOAuthClientId || process.env.FRAIM_DEFAULT_OAUTH_CLIENT_ID || process.env.PERSONA_DEFAULT_OAUTH_CLIENT_ID;
+            const clientSecret = fraimConfig.defaultOAuthClientSecret || process.env.FRAIM_DEFAULT_OAUTH_CLIENT_SECRET || process.env.PERSONA_DEFAULT_OAUTH_CLIENT_SECRET;
             if (!clientId || !clientSecret) {
                 throw new Error('FRAIM_DEFAULT_OAUTH_CLIENT_ID and FRAIM_DEFAULT_OAUTH_CLIENT_SECRET environment variables are required for token refresh');
             }
@@ -476,9 +551,9 @@ function generateHtmlEmail(params) {
     // Replace simple template variables
     template = template.replace(/\{\{displayName\}\}/g, escapeHtml(params.displayName));
     template = template.replace(/\{\{executiveName\}\}/g, escapeHtml(params.executiveName));
-    template = template.replace(/\{\{personaName\}\}/g, escapeHtml(fraim_config_1.fraimConfig.personaName));
-    template = template.replace(/\{\{chatUrl\}\}/g, escapeHtml(fraim_config_1.fraimConfig.chatUrl || '#'));
-    template = template.replace(/\{\{webAppUrl\}\}/g, escapeHtml(fraim_config_1.fraimConfig.webAppUrl || '#'));
+    template = template.replace(/\{\{personaName\}\}/g, escapeHtml(fraimConfig.personaName));
+    template = template.replace(/\{\{chatUrl\}\}/g, escapeHtml(fraimConfig.chatUrl || '#'));
+    template = template.replace(/\{\{webAppUrl\}\}/g, escapeHtml(fraimConfig.webAppUrl || '#'));
     template = template.replace(/\{\{fromEmail\}\}/g, escapeHtml(params.fromEmail));
     template = template.replace(/\{\{greeting\}\}/g, escapeHtml(params.greeting));
     template = template.replace(/\{\{opening\}\}/g, params.opening);
@@ -495,16 +570,16 @@ function generateHtmlEmail(params) {
             html += `</div>`;
             return html;
         }).join('');
-        const improvementsSection = `
-                    <tr>
-                        <td style="padding: 0 30px 20px 30px;">
-                            <div style="background-color: #f8f9fa; border-left: 4px solid #667eea; border-radius: 6px; padding: 20px; margin: 20px 0;">
-                                <div style="font-size: 18px; font-weight: 600; color: #333333; margin-bottom: 16px;">
-                                    ✨ What's Fixed
-                                </div>
-                                ${improvementsHtml}
-                            </div>
-                        </td>
+        const improvementsSection = `
+                    <tr>
+                        <td style="padding: 0 30px 20px 30px;">
+                            <div style="background-color: #f8f9fa; border-left: 4px solid #667eea; border-radius: 6px; padding: 20px; margin: 20px 0;">
+                                <div style="font-size: 18px; font-weight: 600; color: #333333; margin-bottom: 16px;">
+                                    ✨ What's Fixed
+                                </div>
+                                ${improvementsHtml}
+                            </div>
+                        </td>
                     </tr>`;
         template = template.replace(/\{\{#if hasImprovements\}\}[\s\S]*?\{\{\/if\}\}/, improvementsSection);
     }
@@ -514,13 +589,13 @@ function generateHtmlEmail(params) {
     }
     // Replace closing paragraph
     if (params.closing) {
-        template = template.replace(/\{\{#if closing\}\}[\s\S]*?\{\{\/if\}\}/, `
-                    <tr>
-                        <td style="padding: 0 30px 20px 30px;">
-                            <div style="font-size: 16px; color: #555555; line-height: 1.8;">
-                                ${convertTextToHtml(params.closing)}
-                            </div>
-                        </td>
+        template = template.replace(/\{\{#if closing\}\}[\s\S]*?\{\{\/if\}\}/, `
+                    <tr>
+                        <td style="padding: 0 30px 20px 30px;">
+                            <div style="font-size: 16px; color: #555555; line-height: 1.8;">
+                                ${convertTextToHtml(params.closing)}
+                            </div>
+                        </td>
                     </tr>`);
     }
     else {
@@ -548,7 +623,7 @@ function generatePlainTextBody(candidate) {
         if (candidate.closing) {
             body += `${candidate.closing}\n\n`;
         }
-        body += (0, fraim_config_1.formatPersonaSignature)();
+        body += formatPersonaSignature();
         return body;
     }
     // Fallback to legacy body format
@@ -576,7 +651,7 @@ function extractFirstName(text) {
 function extractExecutiveName(displayName) {
     // "{Persona} - [Name]'s AI Executive Assistant"
     // We need to match based on the configured pattern
-    const pattern = fraim_config_1.fraimConfig.personaDisplayNamePattern.replace('{executiveName}', '(.+?)');
+    const pattern = fraimConfig.personaDisplayNamePattern.replace('{executiveName}', '(.+?)');
     try {
         // If pattern contains regex characters, they need expanding or escaping?
         // This is simple pattern matching.