fraim-framework 1.0.2 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "FRAIM: Framework for Rigor-based AI Management - Where humans become AI managers through rigorous methodology",
   "main": "index.js",
   "bin": {

package/setup.js

@@ -2,6 +2,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const { execSync } = require('child_process');
 
 // Colors for console output
 const colors = {
@@ -53,6 +54,25 @@ function writeFile(filePath, content) {
     logSuccess(`Created file: ${filePath}`);
 }
 
+function copyDirectory(src, dest) {
+    if (!fs.existsSync(dest)) {
+        fs.mkdirSync(dest, { recursive: true });
+    }
+    
+    const items = fs.readdirSync(src);
+    for (const item of items) {
+        const srcPath = path.join(src, item);
+        const destPath = path.join(dest, item);
+        
+        if (fs.statSync(srcPath).isDirectory()) {
+            copyDirectory(srcPath, destPath);
+        } else {
+            fs.copyFileSync(srcPath, destPath);
+            logSuccess(`Copied: ${destPath}`);
+        }
+    }
+}
+
 function createGitHubLabels() {
     const labels = [
         { name: 'phase:design', color: '0e8a16', description: 'Design phase - RFC creation and review' },
@@ -61,16 +81,30 @@ function createGitHubLabels() {
         { name: 'status:wip', color: 'fbca04', description: 'Work in progress' },
         { name: 'status:needs-review', color: 'd93f0b', description: 'Ready for review' },
         { name: 'status:complete', color: '0e8a16', description: 'Completed and approved' },
+        { name: 'status:approved', color: '0e8a16', description: 'Approved and ready to merge' },
+        { name: 'status:changes-requested', color: 'd93f0b', description: 'Changes requested in review' },
         { name: 'ai-agent:cursor', color: '5319e7', description: 'Assigned to Cursor AI agent' },
         { name: 'ai-agent:claude', color: 'c2e0c6', description: 'Assigned to Claude AI agent' },
         { name: 'ai-agent:windsurf', color: 'bfdadc', description: 'Assigned to Windsurf AI agent' }
     ];
 
-    const labelsContent = JSON.stringify(labels, null, 2);
-    writeFile('.github/labels.json', labelsContent);
+    logInfo('Creating GitHub labels...');
+    
+    for (const label of labels) {
+        try {
+            const command = `gh label create "${label.name}" --color "${label.color}" --description "${label.description}"`;
+            execSync(command, { stdio: 'pipe' });
+            logSuccess(`Created label: ${label.name}`);
+        } catch (error) {
+            if (error.message.includes('already exists')) {
+                logInfo(`Label already exists: ${label.name}`);
+            } else {
+                logWarning(`Failed to create label ${label.name}: ${error.message}`);
+            }
+        }
+    }
     
-    logInfo('GitHub labels configuration created');
-    logInfo('You can import these labels using GitHub CLI or the web interface');
+    logSuccess('GitHub labels created');
 }
 
 function createGitHubWorkflows() {
@@ -127,205 +161,110 @@ jobs:
           echo "Issue ready for review - notifying team"
 `;
 
+    // Sync on PR review workflow
+    const syncOnPRReviewWorkflow = `name: Sync on PR Review
+
+on:
+  pull_request_review:
+    types: [submitted, edited, dismissed]
+
+jobs:
+  sync-review:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Sync Review Status
+        env:
+          GITHUB_TOKEN: \${{ secrets.GITHUB_TOKEN }}
+        run: |
+          PR_NUMBER="\${{ github.event.pull_request.number }}"
+          REVIEW_STATE="\${{ github.event.review.state }}"
+          
+          echo "PR #\$PR_NUMBER review state: \$REVIEW_STATE"
+          
+          if [ "\$REVIEW_STATE" = "approved" ]; then
+            echo "PR approved - updating status"
+            gh pr edit \$PR_NUMBER --add-label "status:approved"
+          elif [ "\$REVIEW_STATE" = "changes_requested" ]; then
+            echo "Changes requested - updating status"
+            gh pr edit \$PR_NUMBER --add-label "status:changes-requested"
+          fi
+          
+          echo "Review sync complete"
+`;
+
     writeFile('.github/workflows/phase-change.yml', phaseChangeWorkflow);
     writeFile('.github/workflows/status-change.yml', statusChangeWorkflow);
+    writeFile('.github/workflows/sync-on-pr-review.yml', syncOnPRReviewWorkflow);
     
     logSuccess('GitHub workflows created');
 }
 
-function createAgentConfigs() {
-    // Cursor rules - only create if it doesn't exist
-    if (!fs.existsSync('.cursorrules')) {
-        const cursorRules = `# FRAIM Cursor Rules
-
-## Core Rules (Always Apply)
-- **ashley-architecture.mdc** - Follow the established architecture patterns
-- **continuous-learning.mdc** - Always review retrospectives and RFCs before starting work
-- **local-development.mdc** - Work locally, coordinate remotely
-- **simplicity.mdc** - Keep it simple, don't over-engineer
-- **software-development-lifecycle.mdc** - Follow the established SDLC
-
-## Phase-Specific Rules (Manual Trigger Only)
-- **prep.mdc** - Preparation phase rules
-- **design.mdc** - Design phase rules
-- **implement.mdc** - Implementation phase rules
-- **test.mdc** - Testing phase rules
-- **resolve.mdc** - Resolution phase rules
-- **cursor-workflow.mdc** - Cursor-specific workflow rules
-
-## Key Behavioral Requirements
-- Always verify actions taken
-- Never expect user verification
-- Run tests to verify expected behavior
-- Link work to issues with "Closes #<n>"
-- Open Draft PRs early for review
-
-## Project Structure Awareness
-- Work in feature branches only
-- Never push to master
-- Use local file system for development
-- Coordinate through GitHub issues and PRs
-
-## Tool Usage Guidelines
-- Use local file system for development work
-- Use GitHub MCP for issue management
-- Use local Git for version control
-- Test locally before committing
-
-## FRAIM Integration
-- Follow the RIGOR methodology
-- Maintain isolation between agents
-- Use GitOps for coordination
-- Enable observability through clear documentation
-`;
-
-        writeFile('.cursorrules', cursorRules);
-        logSuccess('Cursor rules created');
+function createAgentFolders() {
+    // Create .cursor folder at top level with all contents
+    if (fs.existsSync('agents/cursor')) {
+        copyDirectory('agents/cursor', '.cursor');
+        logSuccess('Created .cursor folder with all contents');
     } else {
-        logInfo('Cursor rules already exist, skipping');
+        logWarning('agents/cursor directory not found, skipping .cursor creation');
     }
 
-    // Claude rules - only create if it doesn't exist
-    if (!fs.existsSync('CLAUDE.md')) {
-        const claudeRules = `# FRAIM Claude Rules
-
-## Always-On Rules
-- **ashley-architecture.mdc** - Follow the established architecture patterns
-- **continuous-learning.mdc** - Always review retrospectives and RFCs before starting work
-
-## Phase-Specific Rules (Manual Trigger Only)
-- **design.mdc** - Design phase rules
-- **implement.mdc** - Implementation phase rules
-- **test.mdc** - Testing phase rules
-
-## Key Behavioral Requirements
-- Always verify actions taken
-- Never expect user verification
-- Run tests to verify expected behavior
-- Link work to issues with "Closes #<n>"
-- Open Draft PRs early for review
-
-## Project Structure Awareness
-- Work in feature branches only
-- Never push to master
-- Use local file system for development
-- Coordinate through GitHub issues and PRs
-
-## Tool Usage Guidelines
-- Use local file system for development work
-- Use GitHub MCP for issue management
-- Use local Git for version control
-- Test locally before committing
-
-## FRAIM Integration
-- Follow the RIGOR methodology
-- Maintain isolation between agents
-- Use GitOps for coordination
-- Enable observability through clear documentation
-`;
-
-        writeFile('CLAUDE.md', claudeRules);
-        logSuccess('Claude rules created');
+    // Create .windsurf folder at top level with all contents
+    if (fs.existsSync('agents/windsurf')) {
+        copyDirectory('agents/windsurf', '.windsurf');
+        logSuccess('Created .windsurf folder with all contents');
     } else {
-        logInfo('Claude rules already exist, skipping');
+        logWarning('agents/windsurf directory not found, skipping .windsurf creation');
     }
 
-    // Windsurf rules - only create if it doesn't exist
-    if (!fs.existsSync('.windsurfrules')) {
-        const windsurfRules = `# FRAIM Windsurf Rules
-
-## Core Rules (Always Apply)
-- **ashley-architecture.mdc** - Follow the established architecture patterns
-- **continuous-learning.mdc** - Always review retrospectives and RFCs before starting work
-- **local-development.mdc** - Work locally, coordinate remotely
-- **simplicity.mdc** - Keep it simple, don't over-engineer
-- **issue-resolution-process.mdc** - Follow the established issue resolution process
-
-## Key Behavioral Requirements
-- Always verify actions taken
-- Never expect user verification
-- Run tests to verify expected behavior
-- Link work to issues with "Closes #<n>"
-- Open Draft PRs early for review
-
-## Project Structure Awareness
-- Work in feature branches only
-- Never push to master
-- Use local file system for development
-- Coordinate through GitHub issues and PRs
-
-## Tool Usage Guidelines
-- Use local file system for development work
-- Use GitHub MCP for issue management
-- Use local Git for version control
-- Test locally before committing
-
-## Architecture and Optimization Principles
-- Follow established patterns
-- Optimize for performance and maintainability
-- Document architectural decisions
-- Consider scalability and security
-
-## Your Role in FRAIM
-- Provide technical expertise and optimization
-- Maintain code quality and standards
-- Ensure architectural consistency
-- Support other agents with technical guidance
-`;
-
-        writeFile('.windsurfrules', windsurfRules);
-        logSuccess('Windsurf rules created');
+    // Create CLAUDE.md at top level
+    if (fs.existsSync('agents/claude/CLAUDE.md')) {
+        const claudeContent = fs.readFileSync('agents/claude/CLAUDE.md', 'utf8');
+        writeFile('CLAUDE.md', claudeContent);
+        logSuccess('Created CLAUDE.md at top level');
     } else {
-        logInfo('Windsurf rules already exist, skipping');
+        logWarning('agents/claude/CLAUDE.md not found, skipping CLAUDE.md creation');
     }
 }
 
-function createFRAIMConfig() {
-    const fraimConfig = {
-        version: "1.0.0",
-        framework: "FRAIM",
-        description: "Framework for Rigor-based AI Management",
-        created: new Date().toISOString(),
-        features: [
-            "GitHub label automation",
-            "AI agent coordination",
-            "Phase-based workflows",
-            "RIGOR methodology implementation"
-        ],
-        agents: {
-            cursor: ".cursorrules",
-            claude: "CLAUDE.md",
-            windsurf: ".windsurfrules"
-        },
-        workflows: [
-            ".github/workflows/phase-change.yml",
-            ".github/workflows/status-change.yml"
-        ]
-    };
-
-    writeFile('fraim-config.json', JSON.stringify(fraimConfig, null, 2));
-    logSuccess('FRAIM configuration created');
-}
-
 function runSetup() {
     logHeader('🚀 FRAIM Setup Wizard');
     log('Setting up FRAIM in current repository...\n');
 
     try {
+        // Check if gh CLI is available
+        try {
+            execSync('gh --version', { stdio: 'pipe' });
+        } catch (error) {
+            logError('GitHub CLI (gh) is not installed or not available');
+            logInfo('Please install GitHub CLI: https://cli.github.com/');
+            process.exit(1);
+        }
+
+        // Check if we're in a git repository
+        try {
+            execSync('git rev-parse --git-dir', { stdio: 'pipe' });
+        } catch (error) {
+            logError('Not in a git repository');
+            logInfo('Please run this command from within a git repository');
+            process.exit(1);
+        }
+
         // Create only essential directory structure
         ensureDirectory('.github/workflows');
 
-        // Create only essential components
-        createGitHubLabels();
+        // Create all components
+        createAgentFolders();
         createGitHubWorkflows();
-        createAgentConfigs();
-        createFRAIMConfig();
+        createGitHubLabels();
 
         logHeader('🎉 Setup Complete!');
         logSuccess('FRAIM has been successfully set up in your repository!');
         logInfo('Next steps:');
         logInfo('1. Commit and push these files to GitHub');
-        logInfo('2. Import the GitHub labels from .github/labels.json');
+        logInfo('2. The GitHub labels have been created automatically');
         logInfo('3. Create your first issue with phase labels');
         logInfo('4. Start coordinating your AI agents!');