fraim-framework 2.0.30 → 2.0.33

package/.windsurf/rules/windsurf-rules.md

@@ -1,7 +0,0 @@
----
-trigger: always_on
----
-
-# Windsurf AI Agent Rules
-
-Thoroughly review `.ai-agents/agent-guardrails.md`

package/.windsurf/workflows/resolve-issue.md

@@ -1,6 +0,0 @@
----
-description: Resolve issue (once confirmed complete)
-auto_execution_mode: 3
----
-
-Follow instructions in `.ai-agents/workflows/resolve.md`

package/.windsurf/workflows/retrospect.md

@@ -1,6 +0,0 @@
----
-description: Resolve issue (once confirmed complete)
-auto_execution_mode: 3
----
-
-Follow instructions in `.ai-agents/workflows/retrospect.md`

package/.windsurf/workflows/start-design.md

@@ -1,6 +0,0 @@
----
-description: Start working on the issue
-auto_execution_mode: 3
----
-
-Follow instructions in `.ai-agents/workflows/design.md`

package/.windsurf/workflows/start-impl.md

@@ -1,6 +0,0 @@
----
-description: Implement issue
-auto_execution_mode: 3
----
-
-Follow instructions in `.ai-agents/workflows/implement.md`

package/.windsurf/workflows/start-spec.md

@@ -1,6 +0,0 @@
----
-description: Spec Issue
-auto_execution_mode: 3
----
-
-Follow instructions in `.ai-agents/workflows/spec.md`

package/.windsurf/workflows/start-tests.md

@@ -1,6 +0,0 @@
----
-description: Start writing tests
-auto_execution_mode: 3
----
-
-Follow instructions in `.ai-agents/workflows/test.md`

package/bin/fraim.js

@@ -1,23 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * FRAIM Framework CLI Entry Point
- * 
- * This file delegates to the compiled TypeScript implementation.
- */
-
-try {
-    // In production/installed package, code is in dist/
-    require('../dist/src/cli/fraim.js');
-} catch (error) {
-    if (error.code === 'MODULE_NOT_FOUND') {
-        // In development (local clone), we might use tsx if dist is missing
-        // But typically we should just tell user to build.
-        console.error('❌ Could not find FRAIM CLI implementation.');
-        console.error('   If you are running from source, please run "npm run build" first.');
-        console.error(`   Error details: ${error.message}`);
-        process.exit(1);
-    } else {
-        throw error;
-    }
-}

package/registry/scripts/build-scripts-generator.ts

@@ -1,216 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * FRAIM Build Scripts Generator
- * 
- * Generates generic build scripts and validation patterns.
- * These are generic enough to apply to any project.
- * 
- * Usage:
- *   npx tsx scripts/build-scripts-generator.ts
- */
-
-import { writeFileSync, existsSync, mkdirSync } from 'fs';
-import { join } from 'path';
-import { loadFraimConfig } from '../../src/fraim/config-loader.js';
-
-/**
- * Generate package.json scripts section
- */
-export function generatePackageScripts(config: any): any {
-  return {
-    "build": "tsc && npm run validate:openapi",
-    "validate:openapi": "npx tsx " + "reg" + "istry/scripts/validate-openapi-limits.ts",
-    "start": "node dist/src/server.js",
-    "start:mcp": "node dist/src/mcp-server.js",
-    "dev": "npx tsx --watch src/server.ts",
-    "dev:mcp": "tsx src/mcp-server.ts",
-    "generate:openapi": "npx tsx " + "reg" + "istry/scripts/openapi-generator.ts",
-    "test": "npx tsx --test test*.ts",
-    "lint": "eslint *.ts",
-    "lint:fix": "eslint *.ts --fix"
-  };
-}
-
-/**
- * Generate code quality check script (generic version)
- */
-export function generateCodeQualityScript(outputDir: string): void {
-  if (!existsSync(outputDir)) {
-    mkdirSync(outputDir, { recursive: true });
-  }
-
-  const scriptContent = `#!/bin/bash
-
-# FRAIM Generic Code Quality Check
-# Validates code quality, build, and ChatGPT limits
-
-set -e
-
-MODE=\${1:-full}
-FAILED=0
-WARNINGS=0
-
-echo "================================================"
-echo "🔍 CODE QUALITY CHECK ($MODE mode)"
-echo "================================================"
-echo ""
-
-# Build check
-if [ "$MODE" = "full" ] || [ "$MODE" = "build" ]; then
-  echo "📦 Building project..."
-  if npm run build; then
-    echo "✅ Build passed"
-  else
-    echo "❌ Build failed"
-    FAILED=1
-  fi
-  echo ""
-fi
-
-# Lint check
-if [ "$MODE" = "full" ] || [ "$MODE" = "lint" ]; then
-  echo "🔍 Linting code..."
-  if npm run lint; then
-    echo "✅ Lint passed"
-  else
-    echo "⚠️  Lint warnings (non-blocking)"
-    WARNINGS=1
-  fi
-  echo ""
-fi
-
-# OpenAPI validation (ChatGPT limits)
-if [ "$MODE" = "full" ] || [ "$MODE" = "openapi" ]; then
-  echo "📋 Validating OpenAPI and ChatGPT limits..."
-  if npm run validate:openapi; then
-    echo "✅ OpenAPI validation passed"
-  else
-    echo "❌ OpenAPI validation failed"
-    FAILED=1
-  fi
-  echo ""
-fi
-
-# Summary
-echo "================================================"
-echo "📊 QUALITY CHECK SUMMARY ($MODE mode)"
-echo "================================================"
-echo ""
-
-if [ $FAILED -eq 1 ]; then
-  echo "❌ CHECKS FAILED"
-  echo ""
-  echo "Fix the errors above before proceeding."
-  exit 1
-elif [ $WARNINGS -eq 1 ]; then
-  echo "⚠️  CHECKS PASSED WITH WARNINGS"
-  echo ""
-  echo "Review warnings above."
-  exit 0
-else
-  echo "✅ ALL CHECKS PASSED"
-  echo ""
-  exit 0
-fi
-`;
-
-  const scriptPath = join(outputDir, 'code-quality-check.sh');
-  writeFileSync(scriptPath, scriptContent);
-
-  // Make executable (Unix)
-  if (process.platform !== 'win32') {
-    const { execSync } = require('child_process');
-    execSync(`chmod +x ${scriptPath}`);
-  }
-
-  console.log(`✅ Generated code quality check script at ${scriptPath}`);
-}
-
-/**
- * Generate build copy scripts (generic)
- */
-export function generateCopyScripts(outputDir: string): void {
-  if (!existsSync(outputDir)) {
-    mkdirSync(outputDir, { recursive: true });
-  }
-
-  // Copy AI agents script (if .fraim exists)
-  const copyAiAgents = `#!/usr/bin/env node
-
-/**
- * Copy registry directory to dist
- * Generic build script for FRAIM projects
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const sourceDir = path.join(__dirname, '..', '..', 'registry');
-const destDir = path.join(__dirname, '..', '..', 'dist', 'registry');
-
-if (fs.existsSync(sourceDir)) {
-  // Recursive copy
-  function copyRecursive(src, dest) {
-    if (!fs.existsSync(dest)) {
-      fs.mkdirSync(dest, { recursive: true });
-    }
-    
-    const entries = fs.readdirSync(src, { withFileTypes: true });
-    
-    for (const entry of entries) {
-      const srcPath = path.join(src, entry.name);
-      const destPath = path.join(dest, entry.name);
-      
-      if (entry.isDirectory()) {
-        copyRecursive(srcPath, destPath);
-      } else {
-        fs.copyFileSync(srcPath, destPath);
-      }
-    }
-  }
-  
-  copyRecursive(sourceDir, destDir);
-  console.log('✅ Copied registry to dist/registry');
-} else {
-  console.log('ℹ️  registry directory not found, skipping');
-}
-`;
-
-  writeFileSync(join(outputDir, 'copy-ai-agents.js'), copyAiAgents);
-  console.log(`✅ Generated copy-ai-agents.js`);
-}
-
-/**
- * Main generator function
- */
-export function generateBuildScripts(config: any, outputDir: string = "scr" + "ipts/build"): void {
-  console.log('🚀 FRAIM Build Scripts Generator\n');
-  console.log(`📁 Output directory: ${outputDir}\n`);
-
-  // Ensure output directory exists
-  if (!existsSync(outputDir)) {
-    mkdirSync(outputDir, { recursive: true });
-  }
-
-  // Generate code quality check
-  console.log('📝 Generating code quality check script...');
-  generateCodeQualityScript(outputDir);
-
-  // Generate build scripts
-  console.log('\n📝 Generating build scripts...');
-  generateCopyScripts(outputDir);
-
-  console.log('\n✅ Build scripts generation complete!');
-  console.log('\n📋 Next steps:');
-  console.log('1. Add scripts to package.json');
-  console.log('2. Run: npm run validate:openapi');
-  console.log('3. Run: ./scripts/build/code-quality-check.sh');
-}
-
-// Run if executed directly
-// @ts-ignore
-if (import.meta.url === `file://${process.argv[1]}`) {
-  const config = loadFraimConfig();
-  generateBuildScripts(config);
-}

package/registry/scripts/cleanup-branch.ts

@@ -1,303 +0,0 @@
-#!/usr/bin/env npx tsx
-
-import { execSync } from 'child_process';
-import dotenv from 'dotenv';
-
-// Load environment variables
-dotenv.config({ override: true });
-
-interface CleanupOptions {
-  branchName?: string;
-  force?: boolean;
-  skipProjectCleanup?: boolean;
-  skipGit?: boolean;
-}
-
-class BranchCleanup {
-  private options: CleanupOptions;
-
-  constructor(options: CleanupOptions = {}) {
-    this.options = {
-      branchName: options.branchName,
-      force: options.force || false,
-      skipProjectCleanup: options.skipProjectCleanup || false,
-      skipGit: options.skipGit || false,
-    };
-  }
-
-  private async insertYourCodeHere(branchName: string): Promise<void> {
-    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
-    // In FRAIM 2.0, we should fetch it if possible, or skip if it's an internal-only script
-    // that doesn't exist in the registry but was incorrectly referenced.
-
-    // NOTE: In this specific case, cleanup-mongo-schemas.ts is likely an internal script.
-    // If it's not in the registry, get_fraim_file will fail.
-    // For now, we fix the path to be more agnostic or explicitly documented as a dependency.
-
-    try {
-      // NOTE: Users should define their own cleanup script location in .fraim/config.json
-      // or the agent should fetch it. For now, we try to run it from a standard location
-      // if it exists, but we don't hardcode it as a requirement for the script to run.
-      const cleanupScript = process.env.FRAIM_PROJECT_CLEANUP_SCRIPT || (['scripts', 'database', 'cleanup-mongo-schemas.ts'].join('/'));
-      this.log(`Checking for project cleanup script: ${cleanupScript}`);
-
-      await this.executeCommand(
-        `npx tsx ${cleanupScript} "${branchPattern}"`,
-        'Run project-specific cleanup script'
-      );
-    } catch (e) {
-      this.log('Skipping project-specific cleanup (script not found or failed).', 'info');
-    }
-  }
-
-
-  private log(message: string, level: 'info' | 'warn' | 'error' | 'success' = 'info') {
-    const timestamp = new Date().toISOString();
-    const prefix = {
-      info: 'ℹ️ ',
-      warn: '⚠️ ',
-      error: '❌',
-      success: '✅'
-    }[level];
-
-    console.log(`${prefix} [${timestamp}] ${message}`);
-  }
-
-  private async executeCommand(command: string, description: string): Promise<string> {
-    this.log(`Executing: ${description}`);
-
-    try {
-      const result = execSync(command, {
-        encoding: 'utf8',
-        stdio: 'pipe',
-        cwd: process.cwd()
-      });
-      this.log(`Success: ${description}`, 'success');
-      return result;
-    } catch (error: any) {
-      this.log(`Failed: ${description} - ${error.message}`, 'error');
-      throw error;
-    }
-  }
-
-  private async getCurrentBranch(): Promise<string> {
-    try {
-      const result = await this.executeCommand('git branch --show-current', 'Get current branch');
-      return result.trim();
-    } catch (error) {
-      this.log('Could not determine current branch', 'warn');
-      return 'unknown';
-    }
-  }
-
-  private async getBranchName(): Promise<string> {
-    if (this.options.branchName) {
-      return this.options.branchName;
-    }
-
-    const currentBranch = await this.getCurrentBranch();
-    if (currentBranch === 'master' || currentBranch === 'main') {
-      throw new Error('Cannot cleanup master/main branch. Please specify a feature branch name.');
-    }
-
-    return currentBranch;
-  }
-
-  private async checkBranchExists(branchName: string, remote: boolean = false): Promise<boolean> {
-    try {
-      const command = remote
-        ? `git ls-remote --heads origin ${branchName}`
-        : `git branch --list ${branchName}`;
-
-      const result = await this.executeCommand(command, `Check if ${remote ? 'remote' : 'local'} branch exists`);
-      return result.trim().length > 0;
-    } catch (error) {
-      return false;
-    }
-  }
-
-  private async doProjectSpecificCleanup(branchName: string): Promise<void> {
-    try {
-      if (this.options.skipProjectCleanup) {
-        this.log('Skipping project-specific cleanup', 'warn');
-        return;
-      }
-
-      this.log('Starting project-specific cleanup...');
-
-      await this.insertYourCodeHere(branchName);
-
-      this.log('Project-specific cleanup completed successfully', 'success');
-    } catch (error: any) {
-      this.log(`Project-specific cleanup failed: ${error.message}`, 'error');
-      if (!this.options.force) {
-        throw error;
-      }
-    }
-  }
-
-  private async cleanupGitBranches(branchName: string): Promise<void> {
-    if (this.options.skipGit) {
-      this.log('Skipping Git cleanup', 'warn');
-      return;
-    }
-
-    this.log(`Starting Git branch cleanup for: ${branchName}`);
-
-    // Check if we're on the branch we want to delete
-    const currentBranch = await this.getCurrentBranch();
-    if (currentBranch === branchName) {
-      this.log(`Currently on branch ${branchName}, switching to master first`, 'warn');
-      await this.executeCommand('git checkout master', 'Switch to master branch');
-    }
-
-    // Delete remote branch
-    const remoteExists = await this.checkBranchExists(branchName, true);
-    if (remoteExists) {
-      this.log(`Deleting remote branch: origin/${branchName}`);
-      await this.executeCommand(`git push origin --delete ${branchName}`, `Delete remote branch ${branchName}`);
-    } else {
-      this.log(`Remote branch origin/${branchName} does not exist`, 'info');
-    }
-
-    // Delete local branch
-    const localExists = await this.checkBranchExists(branchName, false);
-    if (localExists) {
-      this.log(`Deleting local branch: ${branchName}`);
-      await this.executeCommand(`git branch -D ${branchName}`, `Delete local branch ${branchName}`);
-    } else {
-      this.log(`Local branch ${branchName} does not exist`, 'info');
-    }
-
-    // Clean up any untracked files
-    this.log('Cleaning up untracked files...');
-    await this.executeCommand('git clean -fd', 'Remove untracked files and directories');
-
-    // Reset any uncommitted changes
-    this.log('Resetting uncommitted changes...');
-    await this.executeCommand('git reset --hard HEAD', 'Reset to HEAD');
-
-    this.log('Git branch cleanup completed', 'success');
-  }
-
-
-  private async verifyCleanup(branchName: string): Promise<void> {
-    this.log('Verifying cleanup...');
-
-    // Verify branch deletion
-    const remoteExists = await this.checkBranchExists(branchName, true);
-    const localExists = await this.checkBranchExists(branchName, false);
-
-    if (remoteExists || localExists) {
-      this.log(`Warning: Branch ${branchName} still exists (remote: ${remoteExists}, local: ${localExists})`, 'warn');
-    } else {
-      this.log(`Branch ${branchName} successfully deleted`, 'success');
-    }
-
-    // Verify we're on master
-    const currentBranch = await this.getCurrentBranch();
-    if (currentBranch === 'master' || currentBranch === 'main') {
-      this.log('Currently on master/main branch', 'success');
-    } else {
-      this.log(`Warning: Not on master branch, currently on ${currentBranch}`, 'warn');
-    }
-
-    this.log('Cleanup verification completed', 'success');
-  }
-
-  async cleanup(): Promise<void> {
-    try {
-      this.log('🚀 Starting branch cleanup process...');
-
-      const branchName = await this.getBranchName();
-      this.log(`Target branch: ${branchName}`);
-
-      // Step 1: Project-specific cleanup
-      await this.doProjectSpecificCleanup(branchName);
-
-      // Step 2: Git branch cleanup
-      await this.cleanupGitBranches(branchName);
-
-      // Step 3: Verification
-      await this.verifyCleanup(branchName);
-
-      this.log('🎉 Branch cleanup completed successfully!', 'success');
-
-    } catch (error: any) {
-      this.log(`Cleanup failed: ${error.message}`, 'error');
-      if (!this.options.force) {
-        process.exit(1);
-      }
-    }
-  }
-}
-
-// Parse command line arguments
-const args = process.argv.slice(2);
-const options: CleanupOptions = {};
-
-// Parse arguments
-for (let i = 0; i < args.length; i++) {
-  const arg = args[i];
-
-  switch (arg) {
-    case '--branch':
-    case '-b':
-      options.branchName = args[++i];
-      break;
-    case '--force':
-    case '-f':
-      options.force = true;
-      break;
-    case '--skip-project-cleanup':
-      options.skipProjectCleanup = true;
-      break;
-    case '--skip-git':
-      options.skipGit = true;
-      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!
-      `);
-      process.exit(0);
-  }
-}
-
-// Run the cleanup
-const cleanup = new BranchCleanup(options);
-cleanup.cleanup();

package/registry/scripts/fraim-config.ts

@@ -1,63 +0,0 @@
-import { loadFraimConfig } from '../../src/fraim/config-loader';
-
-const config = loadFraimConfig();
-
-const envOr = (keys: string[], fallback: string): string => {
-  for (const key of keys) {
-    const value = process.env[key];
-    if (value && value.length) {
-      return value;
-    }
-  }
-  return fallback;
-};
-
-const personaName = config.persona.name;
-const personaDisplayNameDefault = config.persona.displayNamePattern.replace('{executiveName}', 'Your');
-
-export const fraimConfig = {
-  repoOwner: config.git.repoOwner || 'mathursrus',
-  repoName: config.git.repoName || 'fraim-repo',
-  projectName: config.project.name,
-  personaName,
-  personaPronouns: envOr(['FRAIM_PERSONA_PRONOUNS'], 'they/them'), // Could add to config if needed
-  personaDisplayName: envOr(['FRAIM_PERSONA_DISPLAY_NAME'], personaDisplayNameDefault),
-  personaDisplayNamePattern: config.persona.displayNamePattern,
-  personaThankYouSignature: config.persona.emailSignature,
-  defaultEmail: envOr(['FRAIM_DEFAULT_EMAIL'], 'agent@example.com'),
-  prodDefaultEmail: envOr(['PROD_FRAIM_DEFAULT_EMAIL'], 'agent@example.com'),
-  defaultAccessToken: envOr(['FRAIM_DEFAULT_ACCESS_TOKEN'], ''),
-  defaultRefreshToken: envOr(['FRAIM_DEFAULT_REFRESH_TOKEN'], ''),
-  prodAccessToken: envOr(['PROD_FRAIM_DEFAULT_ACCESS_TOKEN'], ''),
-  prodRefreshToken: envOr(['PROD_FRAIM_DEFAULT_REFRESH_TOKEN'], ''),
-  defaultOAuthClientId: envOr(['FRAIM_DEFAULT_OAUTH_CLIENT_ID'], ''),
-  defaultOAuthClientSecret: envOr(['FRAIM_DEFAULT_OAUTH_CLIENT_SECRET'], ''),
-  prodOAuthClientId: envOr(['PROD_FRAIM_DEFAULT_OAUTH_CLIENT_ID'], ''),
-  prodOAuthClientSecret: envOr(['PROD_FRAIM_DEFAULT_OAUTH_CLIENT_SECRET'], ''),
-  identityCollection: config.database?.identityCollection || 'Identity',
-  executiveCollection: config.database?.executiveCollection || 'Executive',
-  newsletterTitle: config.marketing?.newsletterTitle || 'Weekly Update',
-  newsletterCtaText: config.marketing?.newsletterCtaText || 'Learn More',
-  newsletterUrl: config.marketing?.newsletterUrl || envOr(['FRAIM_NEWSLETTER_URL'], ''),
-  issueRepoUrl: config.git.url || `https://github.com/${config.git.repoOwner}/${config.git.repoName}.git`,
-  identityTokensCollection: config.database?.tokensCollection || 'Tokens',
-  webAppUrl: config.marketing?.websiteUrl || envOr(['FRAIM_WEB_APP_URL'], 'http://localhost:3000'),
-  chatUrl: config.marketing?.chatUrl || envOr(['FRAIM_CHAT_URL'], ''),
-  azure: {
-    prodAppName: envOr(['FRAIM_AZURE_PROD_APP_NAME'], 'fraim-app-prod'),
-    prodResourceGroup: envOr(['FRAIM_AZURE_PROD_RESOURCE_GROUP'], 'fraim-prod-rg'),
-    preprodAppName: envOr(['FRAIM_AZURE_PREPROD_APP_NAME'], 'fraim-app-pre-prod'),
-    preprodResourceGroup: envOr(['FRAIM_AZURE_PREPROD_RESOURCE_GROUP'], 'fraim-pre-prod-rg'),
-    localAppName: envOr(['FRAIM_AZURE_LOCAL_APP_NAME'], 'local'),
-    localResourceGroup: envOr(['FRAIM_AZURE_LOCAL_RESOURCE_GROUP'], 'local')
-  }
-};
-
-export function formatExecutiveDisplayName(executiveName: string): string {
-  return config.persona.displayNamePattern.replace('{executiveName}', executiveName);
-}
-
-export function formatPersonaSignature(): string {
-  return `With gratitude,\n${fraimConfig.personaThankYouSignature}\n${personaName} - Your AI Executive Assistant\n\n`;
-}
-